ดีพลอยจากซอร์สโค้ด
อัปโหลดโปรเจกต์ JavaScript ได้ทันทีโดยไม่ต้องมี Dockerfile Agent Lab จะตรวจหาเฟรมเวิร์ก บิลด์ให้ และทำเป็นหน้าเว็บหรือเว็บเซอร์วิส
สิ่งที่เกิดขึ้น#
บีบอัดโปรเจกต์เป็น 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 CLI | Next.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เสมอ และชื่อที่แพลตฟอร์มไม่รู้จักก็เช่นกัน
- กรอกก่อนดีพลอย: เว็บเซอร์วิสกรอกใน การตั้งค่า › การตั้งค่าการทำงาน (ข้อมูลลับใน ข้อมูลลับ) หน้าเว็บกรอกใน การตั้งค่า › ตัวแปรการบิลด์ เวอร์ชันที่บิลด์จากซอร์สจะแสดงตัวแปรที่โค้ดอ่านแต่ยังไม่ได้ตั้ง
- ตัวแปรจะถูกส่งให้การบิลด์ด้วย ตัวแปรตอนบิลด์จะถูกฝังในหน้าเว็บ จึงห้ามใส่ข้อมูลลับในตัวแปร
VITE_หรือNEXT_PUBLIC_ - ข้อมูลลับจะถูกเมานต์ให้ขั้นตอนติดตั้งและบิลด์ (เช่น โทเคนของรีจิสทรีส่วนตัว) และจะไม่ถูกเขียนลงอิมเมจ
การตั้งค่าการบิลด์#
ถ้าการตรวจหาผิด ให้แก้ใน การตั้งค่า › การตั้งค่าการบิลด์ ช่องที่เว้นว่างจะตรวจหาเอง
| การตั้งค่า | ตัวอย่าง | ตัวแปร |
|---|---|---|
| เวอร์ชัน Node.js | 22 | ALPACK_NODE_VERSION |
| คำสั่งติดตั้ง | npm ci | ALPACK_INSTALL_CMD |
| คำสั่งบิลด์ | npm run build:prod | ALPACK_BUILD_CMD |
| คำสั่งเริ่มทำงาน | node dist/server.js | ALPACK_START_CMD |
| โฟลเดอร์ผลลัพธ์ | dist/browser | ALPACK_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 ไฟล์