แอปพลิเคชัน Node.js, Next.js และ Nuxt
วิธีที่ระบบตรวจจับและเริ่มโปรเจกต์ Node.js: เวอร์ชัน Node, package manager, Next.js และ Nuxt (แบบเซิร์ฟเวอร์หรือสแตติก), SvelteKit, Astro, Express และอื่น ๆ, ตัวแปร PORT และ migration ของ Prisma
รีโพสิทอรีที่มี package.json คือโปรเจกต์ Node.js เราเลือกเฟรมเวิร์ก package manager และเวอร์ชัน Node ให้ แล้ว build และเริ่มทำงาน คุณแค่ push โค้ด
เวอร์ชัน Node และ package manager
- Node.js — อ่านจาก
engines.nodeในpackage.jsonหรือจาก.nvmrcโดยใช้เวอร์ชันใหม่ที่สุดใน 24, 22, 20, 18 หรือ 16 ที่ตรงเงื่อนไข หากไม่มีทั้งสองอย่าง จะใช้ Node.js 22 - Package manager — ดูจาก lock file:
pnpm-lock.yaml→ pnpm,yarn.lock→ yarn นอกนั้นใช้ npm (npm ciเมื่อมีpackage-lock.json) - Build — สคริปต์
buildหากpackage.jsonมี
เฟรมเวิร์ก
| เฟรมเวิร์ก | วิธีรัน |
|---|---|
| Next.js | เป็นเซิร์ฟเวอร์ (next start) — server rendering, API routes และ middleware ทำงานตามปกติ |
Next.js ที่มี output: 'export' | เป็นเว็บไซต์สแตติกจาก out |
| Nuxt | เป็นเซิร์ฟเวอร์ (.output/server/index.mjs) |
Nuxt ที่มี ssr: false และสคริปต์ generate | เป็นเว็บไซต์สแตติกจาก .output/public |
| SvelteKit | เป็นเซิร์ฟเวอร์ด้วย adapter-node หากใช้ adapter-static จะเป็นเว็บไซต์สแตติก |
| Astro | เป็นเว็บไซต์สแตติก หากใช้ @astrojs/node จะเป็นเซิร์ฟเวอร์ |
| NestJS | dist/main.js หลัง build |
| Express, Fastify, Koa, Hono และเซิร์ฟเวอร์อื่น ๆ | ไฟล์ใน scripts.start (node server.js) ถ้าไม่มีใช้ main ถ้าไม่มีอีกใช้ server.js, app.js, index.js หรือ main.js |
โปรเจกต์ที่มีแต่ front-end เช่น Vite, Create React App, Angular, Vue CLI และอื่น ๆ จะให้บริการเป็นเว็บไซต์สแตติก ดูเพิ่มเติมที่ เว็บไซต์สแตติก
รอรับที่ PORT
เซิร์ฟเวอร์ต้องรอรับการเชื่อมต่อที่พอร์ตในตัวแปร PORT บนทุก interface:
const port = process.env.PORT || 3000
app.listen(port, '0.0.0.0')Next.js และ Nuxt ทำส่วนนี้ให้เอง หากแอปพลิเคชันของคุณรอรับที่พอร์ตตายตัว จะไม่ได้รับผู้เข้าชม การ deploy จะหยุดที่การตรวจสอบตอนเริ่มทำงาน และเวอร์ชันก่อนหน้าจะยังทำงานต่อไป
ค่าที่ใช้ตอน build
ตัวแปรจากแท็บ ตัวแปร ส่งถึงแอปพลิเคชันขณะทำงาน ไม่ใช่ตอน build ค่าที่การ build เขียนลงในโค้ดฝั่ง client เช่น NEXT_PUBLIC_… ใน Next.js หรือ VITE_… จะอ่านจากรีโพสิทอรีของคุณ เช่น จากไฟล์ .env.production ที่ commit ไว้ ส่วนโค้ดฝั่งเซิร์ฟเวอร์อ่านค่าจากแท็บ ตัวแปร ตามปกติ
คำสั่งเริ่มต้นของคุณเอง
หากวิธีเริ่มที่ระบบตรวจพบไม่ใช่สิ่งที่คุณต้องการ ให้ตั้ง การตั้งค่า → การตั้งค่า build → คำสั่งเริ่มต้น เช่น node dist/server.js หรือ npm run start:prod คำสั่งติดตั้งและคำสั่ง build ก็เปลี่ยนได้ที่นั่นเช่นกัน
ฐานข้อมูลและ Prisma
เพิ่ม PostgreSQL หรือ MySQL ให้โปรเจกต์ แล้วอ่าน DATABASE_URL ซึ่งตั้งไว้ให้แล้ว หากมี Prisma ใน dependencies คำสั่ง release ที่แนะนำคือ npx prisma migrate deploy ซึ่งรันในทุกการ deploy ก่อนที่เวอร์ชันใหม่จะเริ่มรับผู้เข้าชม ดูเพิ่มเติมที่ การ deploy
สำหรับคิวด้วย BullMQ ให้เพิ่ม Valkey แล้วใช้ REDIS_URL รัน queue worker เป็น background worker ที่แท็บ โปรเซส หรือเป็นเซอร์วิสแยกที่มีทรัพยากรของตัวเอง ดูเพิ่มเติมที่ เซอร์วิสของโปรเจกต์
ไฟล์ที่คงอยู่ข้ามการ deploy
ทุกการ deploy เริ่มจากสำเนาใหม่ของรีโพสิทอรี ไฟล์ที่แอปพลิเคชันเขียนลงใน /data จะคงอยู่ข้ามการ deploy และสำรองข้อมูลทุกวัน ส่วนไฟล์ที่เขียนไว้ที่อื่นจะหายไปหลัง deploy ครั้งถัดไป สำหรับไฟล์อัปโหลดและสื่อ object storage มักเป็นตัวเลือกที่ดีกว่า
Monorepo
สำหรับรีโพสิทอรีที่มีหลายโปรเจกต์ ให้ตั้ง โฟลเดอร์โปรเจกต์ ตอนสร้างแอปพลิเคชัน (เช่น apps/web) โฟลเดอร์อื่นในรีโพสิทอรีเดียวกันรันเป็นเว็บเซอร์วิสแยกได้ ดูที่ เซอร์วิสของโปรเจกต์