ดีพลอยเว็บเซอร์วิสจาก Dockerfile
ดีพลอยบริการที่ทำงานต่อเนื่อง เช่น webhook, API หรือเครื่องมือสำหรับเอเจนต์ จากซอร์สโค้ดที่มี Dockerfile
ก่อนเริ่มต้น#
- โปรแกรมที่ตอบคำขอ HTTP
Dockerfileที่ชั้นบนสุดของโปรเจกต์
1. เขียน Dockerfile#
ตัวอย่าง Node.js นี้ให้เซิร์ฟเวอร์รอรับที่ $PORT อิมเมจ EXPOSE พอร์ตเดียว และรันด้วยผู้ใช้ที่ไม่ใช่ root
FROM node:22-slim
WORKDIR /app
COPY package*.json ./
RUN npm ci --omit=dev
COPY . .
USER node
EXPOSE 8080
CMD ["node", "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
zip -r ../app.zip . -x 'node_modules/*' '.git/*' '.env*'แพลตฟอร์มจะบิลด์อิมเมจ สแกนหาช่องโหว่และความลับ และตรวจว่าตรงตามข้อกำหนดการรันหรือไม่ สิ่งที่แพลตฟอร์มปรับให้จะแสดงเป็นประกาศในหน้าเวอร์ชัน เช่น "อิมเมจรันด้วย root จึงเปลี่ยนไปรันด้วย uid 10001"
3. เผยแพร่และตรวจสถานะการทำงาน#
เวอร์ชันแรกของโปรเจกต์จะเผยแพร่เองเมื่อบิลด์สำเร็จ เวอร์ชันถัดไปให้เลือก เผยแพร่ ในแท็บ ดีพลอย
แท็บ การทำงาน แสดงเวอร์ชันที่ให้บริการอยู่และจำนวนอินสแตนซ์ที่พร้อม
เวอร์ชันไม่พร้อมเสียที
สาเหตุที่พบบ่อยคือพอร์ต เซิร์ฟเวอร์ไม่ได้รอรับที่พอร์ตที่แพลตฟอร์มกำหนด ดูวิธีแก้ที่การแก้ปัญหาการดีพลอย
4. เพิ่มความลับ#
ป้อน API key และค่าลับอื่น ๆ ใน ตั้งค่า ของโปรเจกต์ แล้วให้โค้ดอ่านจากตัวแปรสภาพแวดล้อม ขณะที่บริการทำงานอยู่ การบันทึกจะรีสตาร์ตบริการในขั้นตอนเดียวหลังยืนยัน และอินสแตนซ์เดิมจะให้บริการต่อจนกว่าอินสแตนซ์ใหม่จะพร้อม ดูการตั้งค่าโปรเจกต์
อย่าใส่ความลับไว้ในซอร์สโค้ด
ถ้าการสแกนพบคีย์ในอิมเมจ ให้เอาออกจากซอร์สโค้ด ตั้งเป็นความลับของโปรเจกต์แทน และเปลี่ยนคีย์ใหม่
ขีดจำกัด#
หน่วยความจำและ CPU
ทุกอินสแตนซ์ทำงานตามขนาดของโปรเจกต์ ซึ่งเปลี่ยนได้ที่ ขนาด ใน ตั้งค่า ของโปรเจกต์
| ขนาด | CPU | หน่วยความจำ |
|---|---|---|
| S | 0.5 vCPU | 512 MiB |
| M | 1 vCPU | 1 GiB |
| L | 2 vCPU | 2 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 แทน โค้ดเชื่อมต่อผ่านตัวแปรสภาพแวดล้อม