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

การแก้ปัญหาการดีพลอย

เมื่อเวอร์ชันล้มเหลว ให้อ่านสาเหตุในหน้าเวอร์ชันก่อน ถ้าเนื้อหาถูกปฏิเสธ ให้แก้แล้วอัปโหลดใหม่ ถ้าแพลตฟอร์มขัดข้อง ให้ลองอีกครั้ง

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

เนื้อหาถูกปฏิเสธ#

สิ่งที่เห็นสาเหตุวิธีแก้
ไม่รู้ว่าจะบิลด์ซอร์สนี้อย่างไรชั้นบนสุดของ zip ไม่มี package.json, index.html หรือ Dockerfileบีบอัดจากในโฟลเดอร์โปรเจกต์ หรือดูดีพลอยจากซอร์สโค้ด
โปรเจกต์เป็นบริการ แต่สิ่งที่อัปโหลดถูกอ่านเป็นไฟล์ธรรมดาชั้นบนสุดของ zip ไม่มี Dockerfile หรือไฟล์กำหนด (package.json, go.mod, pyproject.toml, requirements.txt, setup.py) โปรเจกต์อยู่ในโฟลเดอร์ย่อย เช่น backend/ตั้งไดเรกทอรีราก (Root Directory) เป็นโฟลเดอร์นั้นที่ การตั้งค่า › การตั้งค่าการบิลด์ แล้วดีพลอยอีกครั้ง ความล้มเหลวจะแสดงโฟลเดอร์ที่เป็นไปได้
ไม่พบ index.htmlบีบอัดทั้งโฟลเดอร์แทนที่จะเป็นเนื้อหาในโฟลเดอร์บีบอัดจากในโฟลเดอร์ให้ index.html อยู่ชั้นบนสุด
พบความลับในไฟล์ไฟล์ที่อัปโหลดมีข้อความคล้าย API key หรือโทเค็นลบออกจากไฟล์ เปลี่ยนคีย์ใหม่ ป้อนใน ตั้งค่า ของโปรเจกต์ แล้วอัปโหลดใหม่
อิมเมจไม่มี CMDDockerfile ไม่มีคำสั่งเริ่มต้นเพิ่ม CMD หรือ ENTRYPOINT
ไม่มี USER นี้Dockerfile ระบุผู้ใช้ที่ไม่มีในอิมเมจใช้ uid ที่เป็นตัวเลข หรือผู้ใช้ที่อิมเมจมี เช่น node
ช่องโหว่ร้ายแรงแพ็กเกจในอิมเมจมีช่องโหว่ร้ายแรงที่รู้จักแล้วอัปเกรดแพ็กเกจเป็นเวอร์ชันที่ผลการสแกนระบุ หรือเปลี่ยนไปใช้อิมเมจฐานรุ่นใหม่ที่มีเวอร์ชันนั้น

บิลด์ทำงานแล้วแต่ล้มเหลว#

รหัสความล้มเหลวคือ buildFailed บิลด์เริ่มทำงานแล้ว แต่มีขั้นตอนหนึ่งล้มเหลว ความล้มเหลวจะแสดงขั้นตอนนั้น สิ่งที่ขั้นตอนนั้นพิมพ์ออกมา และ exit code ที่จบด้วย ในคอนโซล ให้อ่านบันทึกที่ตัดมาในแถบแจ้งความล้มเหลวบนหน้าเวอร์ชัน ผ่าน MCP ให้อ่าน failure.buildLog ใน sites_deploy_status

Exit codeสาเหตุวิธีแก้
127บิลด์เรียกใช้คำสั่งที่ไม่ได้ติดตั้ง เช่น บิลด์เรียก tsc แต่ไม่มี typescript ทั้งใน dependencies และ devDependencies ของ package.jsonเพิ่มแพ็กเกจนั้น หรือนำคำสั่งนั้นออกจากคำสั่งบิลด์

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

ที่อยู่พรีวิวไม่ตอบ#

  • หน้าเว็บ (เว็บไซต์แบบสแตติก): ที่อยู่พรีวิวจะตอบ 404 site not found จนกว่าเวอร์ชันจะเผยแพร่
  • บริการ: เวอร์ชันที่ไม่เคยเผยแพร่จะยังไม่ถูกเริ่มทำงาน ที่อยู่พรีวิวจึงตอบ 502 service unavailable พร้อมเฮดเดอร์ X-Sites-Refusal: relay-unavailable จนกว่าจะเผยแพร่ ซึ่งไม่ใช่บิลด์ล้มเหลว

หลังเผยแพร่ ให้เปิดที่อยู่สาธารณะตรวจทันที ถ้าใช้งานไม่ได้ ให้แก้แล้วดีพลอยอีกครั้ง หากต้องการพบปัญหาก่อนผู้เข้าชม ให้ลองเวอร์ชันในสภาพแวดล้อมแยก เช่น staging ก่อน

รอการยืนยัน#

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

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

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

  1. ดูว่าหน้าเวอร์ชันมีประกาศ imagePortsAmbiguous หรือไม่
  2. ให้เซิร์ฟเวอร์รอรับที่ตัวแปรสภาพแวดล้อม PORT หรือใส่พอร์ตที่เซิร์ฟเวอร์รอรับจริงใน ตั้งค่า › การตั้งค่าการทำงาน › พอร์ต
  3. เลือก รีสตาร์ตบริการ

รีสตาร์ตซ้ำไปเรื่อย ๆ#

สาเหตุที่พบบ่อยคือโปรแกรมเขียนไฟล์นอก /tmp บนระบบไฟล์แบบอ่านอย่างเดียว ให้ย้ายไปเขียนที่ /tmp ดูข้อกำหนดการรันคอนเทนเนอร์

แพลตฟอร์มขัดข้อง#

เมื่อสาเหตุมาจากแพลตฟอร์มเอง ให้ลองเวอร์ชันเดิมอีกครั้ง ไม่ต้องแก้ไขหรืออัปโหลดใหม่

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

ถ้าส่งเวอร์ชันเข้าคิวโดยไม่ได้ตั้งใจ หรือไม่อยากรอ ให้ยกเลิกระหว่างที่ยังรอคิวอยู่ ดูยกเลิกบิลด์ที่รอคิว

ยังแก้ไม่ได้#

  • ในแท็บ การทำงาน ดูสถานะอินสแตนซ์และบันทึกล่าสุด
  • ในหน้าเวอร์ชัน อ่านประกาศที่แพลตฟอร์มแสดงไว้
  • ขอให้เครื่องมือ AI ที่เชื่อมต่อ Agent Lab MCP อ่านสถานะการดีพลอยให้ ซึ่งเห็นรหัสเดียวกับหน้านี้