Loading documentation…
استقرار Node.js در ابران
برنامه‌های Express، Fastify، Koa و NestJS را با build و start command درست در ابران deploy کنید.
آخرین بازبینی:
این صفحه مفید بود؟
بازخورد شما به بهترشدن مستندات کمک می‌کند.
برنامه‌های Express، Fastify، Koa و NestJS را با build و start command درست در ابران deploy کنید.
آخرین بازبینی:
Loading documentation…
این صفحه مفید بود؟
بازخورد شما به بهترشدن مستندات کمک می‌کند.
package.jsonGenerated builder ابران برنامه‌های Node.js و frameworkهایی مانند Express، Fastify، Koa و NestJS را از package.json تشخیص می‌دهد. یک server قابل‌استقرار باید command شروع مشخص داشته باشد و روی آدرس و پورت runtime گوش دهد.
پورت را از PORT بخوانید و روی 0.0.0.0 bind کنید. نمونه Express:
import express from 'express'
const app = express()
const port = Number(process.env.PORT || 3000)
app.get('/health', (_request, response) => response.status(200).send('ok'))
app.listen(port, '0.0.0.0')برای Fastify از listen({ host: '0.0.0.0', port }) استفاده کنید. در NestJS نیز await app.listen(port, '0.0.0.0') را صریح بنویسید.
برنامه JavaScript ساده باید start داشته باشد:
{
"engines": { "node": "22" },
"scripts": {
"start": "node server.js"
},
"dependencies": {
"express": "^5.0.0"
}
}برای برنامه compileشونده، build و start artifact را جدا کنید:
{
"scripts": {
"build": "nest build",
"start": "node dist/main.js"
}
}NestJS از روی dependency تشخیص داده می‌شود و script build اجرا می‌شود. برای Express، Fastify یا Koa نوشته‌شده با TypeScript، build خودکار صرفاً از نام framework نتیجه‌گیری نمی‌شود؛ commandها را در abrun.yaml صریح کنید:
builder:
platform: node
build_command: npm run build
run_command: node dist/server.js
runtime:
port: 3000
health: /healthabrun app create my-api --plan <plan> --port 3000
abrun deploy my-api --logsBuilder نسخه Node را از engines.node می‌خواند و در نبود آن از نسخه پیش‌فرض پشتیبانی‌شده استفاده می‌کند. package manager از pnpm-lock.yaml، yarn.lock، package-lock.json یا field مربوط در package.json تشخیص داده می‌شود.
Generated build فعلی npm، pnpm و Yarn را پشتیبانی می‌کند. برای Bun از Dockerfile استفاده کنید.
secretها و connection stringها را به‌صورت environment variable وارد کنید:
abrun app env set my-api 'DATABASE_URL=<connection-url>'
abrun app env set my-api NODE_ENV=production
abrun app restart my-apiمقدار واقعی secret را در command نمونه، repository یا log منتشر نکنید. برای اتصال امن، راهنمای اتصال دیتابیس را ببینید.
abrun deploy my-api . --root-directory apps/apiاگر package هدف از dependencyهای workspace استفاده می‌کند، repository root باید workspaceها را تعریف و package هدف باید name داشته باشد. در غیر این صورت build context مستقل را انتخاب یا Dockerfile بنویسید.
run command could not be resolved: یک script به نام start یا builder.run_command معتبر اضافه کنید.dist/main.js را صریح کنید.0.0.0.0 تغییر دهید.