ข้อกำหนดการรันคอนเทนเนอร์
กฎที่อิมเมจของเว็บเซอร์วิสต้องทำตาม ตัวแปรที่แพลตฟอร์มตั้งให้ และเวอร์ชันก่อนหน้ารันต่ออีกนานเท่าไรหลังเวอร์ชันใหม่เผยแพร่
กฎ#
| รายการ | ข้อกำหนด | ถ้าไม่เป็นไปตามข้อกำหนด |
|---|---|---|
| คำสั่งเริ่มต้น | ต้องมี CMD หรือ ENTRYPOINT | เวอร์ชันถูกปฏิเสธ |
| พอร์ต | ให้บริการ HTTP ที่ $PORT | เลือกตามลำดับ การตั้งค่า → EXPOSE → 8080 ดูการตั้งค่าโปรเจกต์ |
| แพลตฟอร์ม | linux/amd64 | Agent Lab บิลด์สำหรับแพลตฟอร์มนี้เสมอ |
| ผู้ใช้ | แนะนำให้ตั้ง USER ที่ไม่ใช่ root | ถ้าเป็น root หรือไม่ได้ตั้ง จะรันด้วย uid 10001 กลุ่ม 0 ส่วน USER ที่ไม่มีในอิมเมจจะถูกปฏิเสธ |
| ระบบไฟล์ | อ่านอย่างเดียว ยกเว้น /tmp | การเขียนที่อื่นจะล้มเหลว |
| ข้อมูลรับรองคลาวด์ | แพลตฟอร์มไม่ได้ให้ | ใช้ความลับของโปรเจกต์เพื่อเชื่อมต่อบริการภายนอก |
เมื่ออิมเมจรันด้วย uid 10001 ไฟล์ที่อิมเมจอ่านต้องให้กลุ่ม 0 อ่านได้
ประกาศ#
สิ่งที่แพลตฟอร์มปรับจะแสดงเป็นประกาศในหน้าเวอร์ชัน เครื่องมือ AI อ่านรหัสเดียวกันได้จากสถานะการดีพลอย
| รหัส | ความหมาย | สิ่งที่ต้องทำ |
|---|---|---|
imageUserForced | อิมเมจรันด้วย root จึงเปลี่ยนไปรันด้วย uid 10001 | ไม่ต้องทำอะไร ถ้าต้องการให้ประกาศหายไป ให้ตั้ง USER ที่ไม่ใช่ root ใน Dockerfile |
imagePortFromExpose | โปรเจกต์รอรับที่พอร์ตเดียวที่อิมเมจ EXPOSE | ไม่ต้องทำอะไร |
imagePortsAmbiguous | อิมเมจ EXPOSE หลายพอร์ตและไม่มี 8080 จึงรันที่ 8080 ซึ่งมักไม่ใช่พอร์ตที่เซิร์ฟเวอร์รอรับ | เลือกพอร์ตที่ถูกต้องใน ตั้งค่า › การตั้งค่าการทำงาน › พอร์ต แล้วรีสตาร์ตบริการ หรือให้ Dockerfile EXPOSE เฉพาะพอร์ตนั้น |
ตัวแปรที่แพลตฟอร์มตั้งให้#
| ตัวแปร | ค่า |
|---|---|
PORT | พอร์ตที่ให้บริการ HTTP |
AGENTLAB_RELEASE_ID | ID ของเวอร์ชันที่คอนเทนเนอร์นี้รัน เป็น ID เดียวกับที่เครื่องมือ AI ได้จากสถานะการดีพลอย |
AGENTLAB_ENVIRONMENT | สภาพแวดล้อมที่รันอยู่ โปรดักชันคือ main สภาพแวดล้อมอื่นคือชื่อของสภาพแวดล้อมนั้น |
เพิ่มตัวแปรหรือความลับด้วยชื่อเหล่านี้ไม่ได้ ถ้าโปรเจกต์มี AGENTLAB_RELEASE_ID หรือ AGENTLAB_ENVIRONMENT อยู่แล้วก่อนที่แพลตฟอร์มจะตั้งสองตัวนี้ ค่านั้นจะยังอยู่และยังบันทึกการตั้งค่าอื่นได้ตามปกติ แต่คอนเทนเนอร์จะได้ค่าของแพลตฟอร์ม ควรลบค่าของคุณออกเมื่อสะดวก
เวอร์ชันที่ดีพลอยก่อนเพิ่มสองตัวแปรนี้จะไม่มีตัวแปรเหล่านี้ ให้ดีพลอยเวอร์ชันใหม่เพื่อให้ได้
เมื่อเวอร์ชันใหม่เผยแพร่#
- เวอร์ชันใหม่เริ่มทำงาน เวอร์ชันก่อนหน้ายังให้บริการด้วยอินสแตนซ์ทั้งหมดจนกว่าเวอร์ชันใหม่จะพร้อม
- สลับทราฟฟิก ภายในไม่กี่วินาที คำขอใหม่จากผู้เยี่ยมชมและการเรียกจากงานตามกำหนดเวลาจะไปที่เวอร์ชันใหม่ คำขอที่เวอร์ชันก่อนหน้ากำลังทำอยู่จะทำต่อจนเสร็จที่นั่น
- เวอร์ชันก่อนหน้าเหลืออินสแตนซ์เดียว หลังสลับ เวอร์ชันก่อนหน้าจะรันต่อด้วยอินสแตนซ์เดียวได้นานสูงสุด 15 นาที ไม่ได้รับคำขอใหม่ แต่งานที่มันทำเองจะยังทำต่อ เช่น การรับงานจากคิว การโพลเป็นระยะ หรือตัวจับเวลา
- เวอร์ชันก่อนหน้าหยุด โปรเซสได้รับ
SIGTERMและถ้ายังไม่จบภายใน 30 วินาทีจะถูกบังคับหยุด
ดังนั้นหลังสลับ โค้ดของเวอร์ชันก่อนหน้าอาจยังรันอยู่ได้นานสูงสุด 15 นาที 30 วินาที นอกจากนี้ การรีสตาร์ตจะแทนที่อินสแตนซ์ทีละตัว อินสแตนซ์ของเวอร์ชันเดียวกันจึงซ้อนกันชั่วครู่ และโปรเจกต์ที่มีหลายอินสแตนซ์ก็มีหลายตัวรันพร้อมกันอยู่แล้ว
เวิร์กเกอร์เบื้องหลัง#
ถ้าโปรเจกต์ดึงงานจากที่ที่ใช้ร่วมกัน เช่น ตารางงานหรือคิว ให้เขียนเวิร์กเกอร์ให้ทำงานได้ถูกต้องแม้มีหลายตัวรันพร้อมกัน
- จบการทำงานเมื่อได้รับ
SIGTERMหยุดรับงานใหม่ ทำงานที่ถืออยู่ให้เสร็จหรือคืนกลับ แล้วจบภายใน 30 วินาที - จองงานแต่ละชิ้นก่อนทำ ใช้การล็อกแถว (
SELECT … FOR UPDATE SKIP LOCKED) หรือสัญญาเช่าที่มีเวลาหมดอายุและเวิร์กเกอร์ต่ออายุเป็นระยะ งานชิ้นเดียวจะไม่ถูกสองโปรเซสทำพร้อมกัน และงานของโปรเซสที่ตายไปจะมีตัวอื่นมารับต่อ - ให้เวอร์ชันที่เผยแพร่อยู่เป็นผู้ทำงาน เวิร์กเกอร์รู้ว่าตัวเองเป็นของเวอร์ชันไหนจาก
AGENTLAB_RELEASE_IDถ้าจะรู้ว่าเวอร์ชันไหนเผยแพร่อยู่ ให้เพิ่มเอนด์พอยต์ที่ตอบAGENTLAB_RELEASE_IDแล้วให้เวิร์กเกอร์เรียกที่อยู่สาธารณะของโปรเจกต์ตัวเอง เฉพาะเวอร์ชันที่เผยแพร่อยู่เท่านั้นที่ตอบ ถ้า ID ที่ได้กลับมาไม่ตรงกับของตัวเอง ให้หยุดรับงานใหม่ - บันทึกว่าใครทำ เขียน
AGENTLAB_RELEASE_IDลงในบันทึกและในแถวที่เวิร์กเกอร์แก้ไข จะได้รู้ว่างานไหนเวอร์ชันใดเป็นผู้ทำ
// เว็บเซิร์ฟเวอร์ตอบ GET /release ด้วย process.env.AGENTLAB_RELEASE_ID
const mine = process.env.AGENTLAB_RELEASE_ID;
let stopping = false;
process.on("SIGTERM", () => {
stopping = true; // เมื่อลูปจบ ปิดเว็บเซิร์ฟเวอร์แล้วจบโปรเซส
});
async function isLive() {
try {
const res = await fetch("https://your-app-address/release");
return res.ok && (await res.text()) === mine;
} catch {
return false;
}
}
async function work() {
while (!stopping) {
if (await isLive()) {
await claimAndRunOne(); // เช่น SELECT … FOR UPDATE SKIP LOCKED
} else {
await new Promise((resolve) => setTimeout(resolve, 10_000));
}
}
}งานตามกำหนดเวลาที่เรียกโปรเจกต์ของคุณจะบันทึกด้วยว่าการรันแต่ละครั้งถูกส่งไปที่เวอร์ชันใด ดูได้ที่ outcome.releaseId ในประวัติการรันของงาน
อิมเมจที่เขียนไฟล์ตอนเริ่มทำงาน#
บางอิมเมจเขียนไฟล์นอก /tmp ตอนเริ่มทำงาน เช่น nginx:alpine เขียนที่ /var/cache/nginx จึงเริ่มไม่ได้บนระบบไฟล์แบบอ่านอย่างเดียว ให้ใช้อิมเมจที่ไม่ต้องเขียนไฟล์ หรือย้ายตำแหน่งที่เขียนไปที่ /tmp
FROM nginxinc/nginx-unprivileged:alpine
COPY dist/ /usr/share/nginx/html/แค่ให้บริการไฟล์สแตติก?
ให้ดีพลอยเป็นเว็บไซต์แบบสแตติกแทน ไม่ต้องรัน nginx เอง