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

ข้อกำหนดการรันคอนเทนเนอร์

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

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

กฎ#

รายการข้อกำหนดถ้าไม่เป็นไปตามข้อกำหนด
คำสั่งเริ่มต้นต้องมี CMD หรือ ENTRYPOINTเวอร์ชันถูกปฏิเสธ
พอร์ตให้บริการ HTTP ที่ $PORTเลือกตามลำดับ การตั้งค่า → EXPOSE → 8080 ดูการตั้งค่าโปรเจกต์
แพลตฟอร์มlinux/amd64Agent 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_IDID ของเวอร์ชันที่คอนเทนเนอร์นี้รัน เป็น ID เดียวกับที่เครื่องมือ AI ได้จากสถานะการดีพลอย
AGENTLAB_ENVIRONMENTสภาพแวดล้อมที่รันอยู่ โปรดักชันคือ main สภาพแวดล้อมอื่นคือชื่อของสภาพแวดล้อมนั้น

เพิ่มตัวแปรหรือความลับด้วยชื่อเหล่านี้ไม่ได้ ถ้าโปรเจกต์มี AGENTLAB_RELEASE_ID หรือ AGENTLAB_ENVIRONMENT อยู่แล้วก่อนที่แพลตฟอร์มจะตั้งสองตัวนี้ ค่านั้นจะยังอยู่และยังบันทึกการตั้งค่าอื่นได้ตามปกติ แต่คอนเทนเนอร์จะได้ค่าของแพลตฟอร์ม ควรลบค่าของคุณออกเมื่อสะดวก

เวอร์ชันที่ดีพลอยก่อนเพิ่มสองตัวแปรนี้จะไม่มีตัวแปรเหล่านี้ ให้ดีพลอยเวอร์ชันใหม่เพื่อให้ได้

เมื่อเวอร์ชันใหม่เผยแพร่#

  1. เวอร์ชันใหม่เริ่มทำงาน เวอร์ชันก่อนหน้ายังให้บริการด้วยอินสแตนซ์ทั้งหมดจนกว่าเวอร์ชันใหม่จะพร้อม
  2. สลับทราฟฟิก ภายในไม่กี่วินาที คำขอใหม่จากผู้เยี่ยมชมและการเรียกจากงานตามกำหนดเวลาจะไปที่เวอร์ชันใหม่ คำขอที่เวอร์ชันก่อนหน้ากำลังทำอยู่จะทำต่อจนเสร็จที่นั่น
  3. เวอร์ชันก่อนหน้าเหลืออินสแตนซ์เดียว หลังสลับ เวอร์ชันก่อนหน้าจะรันต่อด้วยอินสแตนซ์เดียวได้นานสูงสุด 15 นาที ไม่ได้รับคำขอใหม่ แต่งานที่มันทำเองจะยังทำต่อ เช่น การรับงานจากคิว การโพลเป็นระยะ หรือตัวจับเวลา
  4. เวอร์ชันก่อนหน้าหยุด โปรเซสได้รับ SIGTERM และถ้ายังไม่จบภายใน 30 วินาทีจะถูกบังคับหยุด

ดังนั้นหลังสลับ โค้ดของเวอร์ชันก่อนหน้าอาจยังรันอยู่ได้นานสูงสุด 15 นาที 30 วินาที นอกจากนี้ การรีสตาร์ตจะแทนที่อินสแตนซ์ทีละตัว อินสแตนซ์ของเวอร์ชันเดียวกันจึงซ้อนกันชั่วครู่ และโปรเจกต์ที่มีหลายอินสแตนซ์ก็มีหลายตัวรันพร้อมกันอยู่แล้ว

เวิร์กเกอร์เบื้องหลัง#

ถ้าโปรเจกต์ดึงงานจากที่ที่ใช้ร่วมกัน เช่น ตารางงานหรือคิว ให้เขียนเวิร์กเกอร์ให้ทำงานได้ถูกต้องแม้มีหลายตัวรันพร้อมกัน

  • จบการทำงานเมื่อได้รับ SIGTERM หยุดรับงานใหม่ ทำงานที่ถืออยู่ให้เสร็จหรือคืนกลับ แล้วจบภายใน 30 วินาที
  • จองงานแต่ละชิ้นก่อนทำ ใช้การล็อกแถว (SELECT … FOR UPDATE SKIP LOCKED) หรือสัญญาเช่าที่มีเวลาหมดอายุและเวิร์กเกอร์ต่ออายุเป็นระยะ งานชิ้นเดียวจะไม่ถูกสองโปรเซสทำพร้อมกัน และงานของโปรเซสที่ตายไปจะมีตัวอื่นมารับต่อ
  • ให้เวอร์ชันที่เผยแพร่อยู่เป็นผู้ทำงาน เวิร์กเกอร์รู้ว่าตัวเองเป็นของเวอร์ชันไหนจาก AGENTLAB_RELEASE_ID ถ้าจะรู้ว่าเวอร์ชันไหนเผยแพร่อยู่ ให้เพิ่มเอนด์พอยต์ที่ตอบ AGENTLAB_RELEASE_ID แล้วให้เวิร์กเกอร์เรียกที่อยู่สาธารณะของโปรเจกต์ตัวเอง เฉพาะเวอร์ชันที่เผยแพร่อยู่เท่านั้นที่ตอบ ถ้า ID ที่ได้กลับมาไม่ตรงกับของตัวเอง ให้หยุดรับงานใหม่
  • บันทึกว่าใครทำ เขียน AGENTLAB_RELEASE_ID ลงในบันทึกและในแถวที่เวิร์กเกอร์แก้ไข จะได้รู้ว่างานไหนเวอร์ชันใดเป็นผู้ทำ
worker.js
// เว็บเซิร์ฟเวอร์ตอบ 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

Dockerfile
FROM nginxinc/nginx-unprivileged:alpine
COPY dist/ /usr/share/nginx/html/

แค่ให้บริการไฟล์สแตติก?

ให้ดีพลอยเป็นเว็บไซต์แบบสแตติกแทน ไม่ต้องรัน nginx เอง