Crescendo Lab เอกสาร
ไทย
สมัครใช้งาน

ดีพลอยเว็บเซอร์วิสจาก Dockerfile

ดีพลอยบริการที่ทำงานต่อเนื่อง เช่น webhook, API หรือเครื่องมือสำหรับเอเจนต์ จากซอร์สโค้ดที่มี Dockerfile

อัปเดตล่าสุด
ดู Markdown เปิดใน Claude เปิดใน ChatGPT

ก่อนเริ่มต้น#

  • โปรแกรมที่ตอบคำขอ HTTP
  • Dockerfile ที่ชั้นบนสุดของโปรเจกต์

1. เขียน Dockerfile#

ตัวอย่าง Node.js นี้ให้เซิร์ฟเวอร์รอรับที่ $PORT อิมเมจ EXPOSE พอร์ตเดียว และรันด้วยผู้ใช้ที่ไม่ใช่ root

Dockerfile
FROM node:22-slim
WORKDIR /app
COPY package*.json ./
RUN npm ci --omit=dev
COPY . .
USER node
EXPOSE 8080
CMD ["node", "server.js"]
server.js
import { createServer } from "node:http";

const port = Number(process.env.PORT ?? 8080);

createServer((req, res) => {
  res.writeHead(200, { "content-type": "application/json" });
  res.end(JSON.stringify({ ok: true, path: req.url }));
}).listen(port);

อิมเมจต้องเป็นไปตามข้อกำหนดเหล่านี้ ดูกฎทั้งหมดได้ที่ข้อกำหนดการรันคอนเทนเนอร์

  • มี CMD หรือ ENTRYPOINT ที่เริ่มเซิร์ฟเวอร์
  • ให้บริการ HTTP ที่ $PORT
  • บิลด์สำหรับ linux/amd64
  • ระบบไฟล์เป็นแบบอ่านอย่างเดียว ยกเว้น /tmp ซึ่งมีขีดจำกัดของตัวเอง

2. อัปโหลดซอร์สโค้ด#

ในแท็บ ดีพลอย ของโปรเจกต์ ลากโฟลเดอร์ซอร์สโค้ดหรือไฟล์ .zip มาวางในพื้นที่อัปโหลด แล้วเลือก อัปโหลดและบิลด์ โดย Dockerfile ต้องอยู่ชั้นบนสุด ถ้าบีบอัด zip เอง อย่าใส่ node_modules, .git และ .env

bash
zip -r ../app.zip . -x 'node_modules/*' '.git/*' '.env*'

แพลตฟอร์มจะบิลด์อิมเมจ สแกนหาช่องโหว่และความลับ และตรวจว่าตรงตามข้อกำหนดการรันหรือไม่ สิ่งที่แพลตฟอร์มปรับให้จะแสดงเป็นประกาศในหน้าเวอร์ชัน เช่น "อิมเมจรันด้วย root จึงเปลี่ยนไปรันด้วย uid 10001"

3. เผยแพร่และตรวจสถานะการทำงาน#

เวอร์ชันแรกของโปรเจกต์จะเผยแพร่เองเมื่อบิลด์สำเร็จ เวอร์ชันถัดไปให้เลือก เผยแพร่ ในแท็บ ดีพลอย

แท็บ การทำงาน แสดงเวอร์ชันที่ให้บริการอยู่และจำนวนอินสแตนซ์ที่พร้อม

เวอร์ชันไม่พร้อมเสียที

สาเหตุที่พบบ่อยคือพอร์ต เซิร์ฟเวอร์ไม่ได้รอรับที่พอร์ตที่แพลตฟอร์มกำหนด ดูวิธีแก้ที่การแก้ปัญหาการดีพลอย

4. เพิ่มความลับ#

ป้อน API key และค่าลับอื่น ๆ ใน ตั้งค่า ของโปรเจกต์ แล้วให้โค้ดอ่านจากตัวแปรสภาพแวดล้อม ขณะที่บริการทำงานอยู่ การบันทึกจะรีสตาร์ตบริการในขั้นตอนเดียวหลังยืนยัน และอินสแตนซ์เดิมจะให้บริการต่อจนกว่าอินสแตนซ์ใหม่จะพร้อม ดูการตั้งค่าโปรเจกต์

อย่าใส่ความลับไว้ในซอร์สโค้ด

ถ้าการสแกนพบคีย์ในอิมเมจ ให้เอาออกจากซอร์สโค้ด ตั้งเป็นความลับของโปรเจกต์แทน และเปลี่ยนคีย์ใหม่

ขีดจำกัด#

หน่วยความจำและ CPU

ทุกอินสแตนซ์ทำงานตามขนาดของโปรเจกต์ ซึ่งเปลี่ยนได้ที่ ขนาด ใน ตั้งค่า ของโปรเจกต์

ขนาดCPUหน่วยความจำ
S0.5 vCPU512 MiB
M1 vCPU1 GiB
L2 vCPU2 GiB

หน่วยความจำเป็นขีดจำกัดตายตัว อินสแตนซ์ที่ใช้เกินจะถูกหยุดแล้วเริ่มใหม่ ถ้าเพิ่ม heap ของ Node.js ด้วย --max-old-space-size ให้ตั้งไว้ต่ำกว่าสามในสี่ของหน่วยความจำ เพราะส่วนอื่นของโปรเซสก็ต้องใช้หน่วยความจำด้วย ถ้าตั้งสูงกว่านั้น หมายเหตุการบิลด์ในหน้าเวอร์ชันจะเตือน

ไฟล์ใน /tmp

/tmp เป็นที่เดียวที่โปรแกรมเขียนไฟล์ได้

  • เก็บได้สูงสุด 256 MiB ไฟล์อยู่บนดิสก์ และไม่นับรวมในหน่วยความจำข้างต้น
  • จะว่างเปล่าทุกครั้งที่อินสแตนซ์เริ่มใหม่และทุกครั้งที่เวอร์ชันใหม่เผยแพร่ แต่ละอินสแตนซ์มี /tmp ของตัวเอง
  • ถ้าเขียนเกิน 256 MiB อินสแตนซ์จะถูกหยุด และอินสแตนซ์ใหม่ที่มาแทนจะมี /tmp ว่างเปล่า

ใช้สำหรับแคชและไฟล์ชั่วคราว อย่าใช้เก็บข้อมูลที่ต้องอยู่ต่อ

อย่ารันฐานข้อมูลในคอนเทนเนอร์

ฐานข้อมูลที่เริ่มในอิมเมจ เช่น PostgreSQL, MySQL, MongoDB หรือ Redis จะเก็บข้อมูลไว้ในอินสแตนซ์ ข้อมูลจะหายเมื่ออินสแตนซ์เริ่มใหม่หรือเวอร์ชันใหม่เผยแพร่ และยังแย่งหน่วยความจำจากโปรแกรมด้วย หมายเหตุการบิลด์จะเตือนเมื่อ Dockerfile ติดตั้งหรือเริ่มฐานข้อมูล

ให้เก็บข้อมูลไว้ในฐานข้อมูลของ Agent Lab (PostgreSQL หรือ MySQL) หรือแคช Redis แทน โค้ดเชื่อมต่อผ่านตัวแปรสภาพแวดล้อม