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

ดีพลอยจากซอร์สโค้ด

อัปโหลดโปรเจกต์ JavaScript ได้ทันทีโดยไม่ต้องมี Dockerfile Agent Lab จะตรวจหาเฟรมเวิร์ก บิลด์ให้ และทำเป็นหน้าเว็บหรือเว็บเซอร์วิส

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

สิ่งที่เกิดขึ้น#

บีบอัดโปรเจกต์เป็น zip โดยให้ package.json อยู่ชั้นบนสุด แล้วอัปโหลด แพลตฟอร์มจะอ่านโปรเจกต์ สร้างแผนการบิลด์ และบิลด์ให้

  • โปรเจกต์ที่สร้างเฉพาะไฟล์สำหรับเบราว์เซอร์จะกลายเป็นหน้าเว็บ ให้บริการผ่าน CDN เส้นทางของ SPA (single-page application) เช่น /orders/42 จะตอบด้วย index.html ทั้งหมด
  • โปรเจกต์ที่รันเซิร์ฟเวอร์จะกลายเป็นเว็บเซอร์วิส บิลด์เป็นอิมเมจที่รันด้วยผู้ใช้ที่ไม่ใช่ root บนพอร์ต 8080

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

ไม่ต้องใส่สิ่งเหล่านี้ใน zip

node_modules, .git, dist และ .env แพลตฟอร์มติดตั้งแพ็กเกจเอง และจะข้ามไปถ้ามีอยู่

เฟรมเวิร์กที่รองรับ#

กลายเป็นหน้าเว็บกลายเป็นเว็บเซอร์วิส
Vite (React, Vue, Svelte), Create React App, Vue CLINext.js (ถ้าตั้ง output: "export" จะเป็นหน้าเว็บ)
Angular, Astro แบบสแตติก, HTML ที่มีสคริปต์บิลด์Nuxt, SvelteKit, Remix, React Router 7, Astro แบบ SSR
Express, Fastify, Koa, Hono, NestJS และเซิร์ฟเวอร์ Node อื่น

npm, pnpm, Yarn และ Bun ตรวจจาก lockfile หรือฟิลด์ packageManager เวอร์ชัน Node.js มาจาก engines.node, .nvmrc หรือ .node-version ถ้าไม่มีจะใช้ LTS ล่าสุด (24) ใช้ได้ 18, 20, 22 และ 24

สภาพแวดล้อมการบิลด์#

การบิลด์ทำงานบนอิมเมจ node:<เวอร์ชัน> แบบเต็ม ซึ่งมี git, python3, make และ g++ ส่วนเว็บเซอร์วิสทำงานบน node:<เวอร์ชัน>-slim ที่เล็กกว่า ขั้นตอนติดตั้งและบิลด์ใช้ git ได้ สคริปต์ที่เรียก git rev-parse HEAD จึงได้คำตอบ:

  • การบิลด์จาก GitHub ได้ commit ที่ push มา ดึงมาที่ความลึก 1 อยู่บนสาขาชื่อเดียวกับสาขาที่ push
  • การอัปโหลดจะได้ repository ที่มี commit เดียวซึ่งเก็บไฟล์ที่อัปโหลด โฟลเดอร์ .git ในไฟล์อัปโหลดจะไม่ถูกใช้

ระหว่างบิลด์มีตัวแปรสามตัวที่บอกข้อมูล commit: AGENTLAB_GIT_COMMIT_SHA, AGENTLAB_GIT_COMMIT_REF (สาขา) และ AGENTLAB_GIT_REPO (owner/name) มีค่าเฉพาะการบิลด์จาก GitHub และว่างเมื่ออัปโหลด ตัวแปรที่คุณตั้งด้วยชื่อเหล่านี้จะถูกละเว้น และจะไม่ส่งต่อให้โปรเจกต์ที่กำลังทำงาน โปรเจกต์ที่ใช้ Dockerfile ของตัวเองจะได้รับเมื่อประกาศด้วย ARG และจะมี git ก็ต่อเมื่ออิมเมจของตัวเองมี

ตัวแปรสภาพแวดล้อม#

แผนจะแสดงตัวแปรที่โค้ดอ่าน (จาก .env.example, process.env.*, import.meta.env.*) และทำเครื่องหมายตัวที่ดูเหมือนข้อมูลลับ หรือจำเป็นตอนบิลด์ (เช่น VITE_*, NEXT_PUBLIC_*)

สำหรับ Nuxt 3 ขึ้นไป แผนจะอ่านคีย์ที่เขียนไว้ใต้ runtimeConfig ใน nuxt.config ด้วย runtimeConfig.apiSecret คือ NUXT_API_SECRET และ runtimeConfig.public.apiBase คือ NUXT_PUBLIC_API_BASE ถ้าใช้ nuxt-auth-utils จะแสดง NUXT_SESSION_PASSWORD คีย์ที่เพิ่มด้วยการกระจาย (...shared) มาจาก layer หรือจากโมดูลอื่นจะหาไม่เจอ ให้เขียนไว้ใน .env.example

ข้อมูลลับแต่ละตัวจะบอกด้วยว่าใครเป็นผู้ให้ค่า (source)

  • generate: ค่าที่ขอแค่เป็นค่าสุ่มและไม่ต้องมีใครรู้ เช่น NUXT_SESSION_PASSWORD, SESSION_SECRET, AUTH_SECRET, SECRET_KEY_BASE สร้างได้ในคอนโซลตามความยาวที่เฟรมเวิร์กกำหนด หรือให้ผู้ช่วยสร้างและบันทึกผ่าน sites_secrets_generate โดยผู้ช่วยไม่เห็นค่า
  • person: ข้อมูลลับอื่นทั้งหมด เช่น คีย์ API, ซีเคร็ตสำหรับลงนามของ webhook, รหัสผ่านฐานข้อมูล มีแค่คุณที่รู้ค่า ชื่อที่มีชื่อบริการอย่าง STRIPE_ หรือ LINE_ เป็น person เสมอ และชื่อที่แพลตฟอร์มไม่รู้จักก็เช่นกัน
  1. กรอกก่อนดีพลอย: เว็บเซอร์วิสกรอกใน การตั้งค่า › การตั้งค่าการทำงาน (ข้อมูลลับใน ข้อมูลลับ) หน้าเว็บกรอกใน การตั้งค่า › ตัวแปรการบิลด์ เวอร์ชันที่บิลด์จากซอร์สจะแสดงตัวแปรที่โค้ดอ่านแต่ยังไม่ได้ตั้ง
  2. ตัวแปรจะถูกส่งให้การบิลด์ด้วย ตัวแปรตอนบิลด์จะถูกฝังในหน้าเว็บ จึงห้ามใส่ข้อมูลลับในตัวแปร VITE_ หรือ NEXT_PUBLIC_
  3. ข้อมูลลับจะถูกเมานต์ให้ขั้นตอนติดตั้งและบิลด์ (เช่น โทเคนของรีจิสทรีส่วนตัว) และจะไม่ถูกเขียนลงอิมเมจ

การตั้งค่าการบิลด์#

ถ้าการตรวจหาผิด ให้แก้ใน การตั้งค่า › การตั้งค่าการบิลด์ ช่องที่เว้นว่างจะตรวจหาเอง

การตั้งค่าตัวอย่างตัวแปร
เวอร์ชัน Node.js22ALPACK_NODE_VERSION
คำสั่งติดตั้งnpm ciALPACK_INSTALL_CMD
คำสั่งบิลด์npm run build:prodALPACK_BUILD_CMD
คำสั่งเริ่มทำงานnode dist/server.jsALPACK_START_CMD
โฟลเดอร์ผลลัพธ์dist/browserALPACK_OUTPUT_DIR
ไม่ใช้ Dockerfile ของโปรเจกต์เปิดALPACK_IGNORE_DOCKERFILE
ไดเรกทอรีราก (Root Directory)apps/web—

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

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

Monorepo#

ถ้า repository มีหลายโปรเจกต์ ให้อัปโหลดทั้ง repository แล้วตั้ง ไดเรกทอรีราก (Root Directory) ในการตั้งค่าการบิลด์เป็นโฟลเดอร์ของโปรเจกต์ เช่น apps/web แพลตฟอร์มจะตรวจหาและบิลด์ในโฟลเดอร์นั้น ดังนั้น package.json และ lockfile ของโฟลเดอร์นั้นจะกำหนดการบิลด์ แพ็กเกจจากส่วนอื่นของ repository เช่น dependency แบบ workspace:* ยังใช้ไม่ได้

โปรเจกต์ใหม่ที่อัปโหลดหรือ push ครั้งแรกแล้วระดับบนสุดไม่มีอะไรให้ดีพลอย (ไม่มี Dockerfile ไม่มี package.json, go.mod, pyproject.toml, requirements.txt หรือ setup.py และไม่มี index.html) แต่มีโปรเจกต์อยู่ในโฟลเดอร์ลึกลงไปหนึ่งหรือสองชั้น (เช่น repository ที่แยกเป็น frontend/ และ backend/) จะไม่ถูกเผยแพร่ เวอร์ชันนั้นจะแสดงโฟลเดอร์ได้สูงสุดห้าโฟลเดอร์ให้คุณเลือกว่าจะดีพลอยโฟลเดอร์ไหน และโปรเจกต์ยังไม่ถูกกำหนดประเภท เมื่อเลือกแล้วจะตั้ง ไดเรกทอรีราก (Root Directory) และดีพลอยอีกครั้ง: commit ล่าสุดจาก GitHub หรือไฟล์เดิมในคอนโซล ไฟล์ที่มี index.html อยู่ระดับบนสุดยังคงเป็นหน้าเว็บ แม้จะมีซอร์สอยู่ในโฟลเดอร์ข้างๆ

เมื่อการบิลด์ล้มเหลว#

สิ่งที่เห็นวิธีแก้
ไม่รู้ว่าจะบิลด์ซอร์สนี้อย่างไรวาง package.json ไว้ชั้นบนสุดของ zip หรือตั้งคำสั่งเริ่มทำงาน
การบิลด์ไม่ได้สร้างไฟล์ใดเลยตั้งโฟลเดอร์ผลลัพธ์เป็นที่ที่การบิลด์เขียนไฟล์จริง
สิ่งที่อัปโหลดให้เว็บเซอร์วิสเป็นแค่หน้าเว็บเว็บเซอร์วิสเปลี่ยนกลับเป็นหน้าเว็บไม่ได้ ให้สร้างโปรเจกต์ใหม่ หรือตั้งคำสั่งเริ่มทำงาน
คอมไพล์โมดูลเนทีฟไม่สำเร็จคอมมิต lockfile อิมเมจสำหรับบิลด์มีคอมไพเลอร์ (python3, make, g++) อยู่แล้ว

ดูแต่ละขั้นตอนได้ในบันทึกการบิลด์ของหน้าเวอร์ชัน ถ้าใช้เครื่องมือ AI ให้ขอแผนการบิลด์ก่อน ดูเครื่องมือ MCP

Go และ Python#

อัปโหลด go.mod, pyproject.toml, requirements.txt หรือ setup.py ที่รากของโปรเจกต์ หากมี Dockerfile ระบบจะใช้ไฟล์นั้น หากไม่มีระบบจะสร้างให้ Go รองรับ main package ที่รากหรือ cmd/*/main.go เพียงหนึ่งรายการ ถ้ามีหลายรายการให้ระบุคำสั่ง build และ start ส่วน Python รองรับ pip, Poetry, uv และ Django WSGI, Flask, FastAPI

ใช้ ALPACK_GO_VERSION, ALPACK_PYTHON_VERSION และ ALPACK_PORT เพื่อกำหนดเวอร์ชันและพอร์ต Python อ่าน .python-version หรือข้อกำหนดใน manifest รองรับ 3.10–3.14 และใช้ 3.12 หากไม่ได้ระบุ ใช้ ALPACK_BUILD_PACKAGES และ ALPACK_RUNTIME_PACKAGES สำหรับชื่อแพ็กเกจ Debian ที่คั่นด้วยช่องว่าง อิมเมจที่สร้างทำงานแบบ non-root ต้องตั้งค่าฐานข้อมูล Redis และ credentials แยกต่างหาก ขีดจำกัดซอร์สคือ 128 MiB ต่อไฟล์ รวม 512 MiB หลังแตกไฟล์ และ 20,000 ไฟล์