هاست Bun برای سرویس‌های TypeScript

Bun، بدون تنظیمات اضافه

وجود bun.lock یا bun.lockb کنار package.json کافی است تا پروژه Bun شناخته شود. وابستگی‌ها با bun install و از میرور داخلی نصب می‌شوند و برنامه با اسکریپت start یا فیلد main اجرا می‌شود.

Bun فایل‌های TypeScript را مستقیم اجرا می‌کند، پس برای یک API ساده مرحله‌ی build لازم ندارید. اگر خروجی باندل‌شده می‌خواهید، اسکریپت build را تعریف کنید تا قبل از اجرا ساخته شود.

مسیر بیلد Bun

1. تشخیص

   package.json و یکی از bun.lock یا bun.lockb در ریشه.

   bun.lock

2. نصب

   وابستگی‌ها با نسخه‌های قفل‌شده نصب می‌شوند.

   bun install --frozen-lockfile

3. بیلد

   اگر اسکریپت build باشد اجرا می‌شود؛ برای اجرای مستقیم TypeScript لازم نیست.

   bun run build

4. اجرا

   اسکریپت start یا فایل main اجرا می‌شود.

   bun run index.ts

خروجی یک استقرار واقعی

$ sakoocloud deploy
✔ Packed 0.9MB
✔ Source uploaded
ℹ Build started · dep_7k2m9q
#4 [build 1/4] FROM oven/bun:1-alpine
#6 [build 2/4] RUN bun install --frozen-lockfile
#8 [build 3/4] COPY . .
#10 exporting to image
✔ Deployed — app is running.
→ https://my-bun-api.sakooapps.ir

کمترین چیزی که لازم دارید

Bun.serve را روی پورت PORT و 0.0.0.0 بالا بیاورید و اسکریپت start را تعریف کنید.

const port = Number(process.env.PORT) || 3000;

Bun.serve({
  port,
  hostname: "0.0.0.0",
  fetch() {
    return Response.json({ ok: true });
  },
});

{
  "scripts": {
    "start": "bun run index.ts"
  },
  "engines": { "bun": "1.2.x" }
}

bun install
sakoocloud apps create --name my-bun-api --runtime bun --port 3000
sakoocloud deploy

تنظیمات

اتصال به دیتابیس

بعد از لینک کردن دیتابیس، DATABASE_URL در process.env و Bun.env در دسترس است.

sakoocloud apps link-db <db-id> --app my-bun-api

import postgres from "postgres";

export const sql = postgres(process.env.DATABASE_URL!);

همراه هر استقرار

این‌ها به رانتایم بستگی ندارند و برای هر اپ روی سکو کلود فعال‌اند. بعضی، مثل مقیاس‌دهی خودکار و کران‌جاب، به پلن بستگی دارند.

• دامنه‌ی اختصاصی و SSLدامنه را اضافه کنید؛ گواهی خودکار صادر و تمدید می‌شود.
• متغیرهای محیطی و سکرتمقادیر رمزگذاری‌شده فقط در زمان اجرا به اپ می‌رسند.
• مرحله‌ی انتشارmigration بعد از بیلد و پیش از جایگزینی نسخه‌ی قبلی اجرا می‌شود.
• لاگ زندهلاگ بیلد و زمان اجرا، در CLI و کنسول.
• بازگشت به نسخه‌ی قبلهر استقرار قبلی با یک دستور برمی‌گردد.
• مقیاس‌دهیمنابع و تعداد نمونه‌ها را تغییر دهید یا خودکارش کنید.
• دیسک ماندگاربرای فایل‌هایی که باید بعد از هر استقرار بمانند.
• کران‌جابدستور زمان‌بندی‌شده با همان ایمیج و متغیرها.
• استقرار خودکار با گیتهر push روی شاخه‌ی هدف بیلد و مستقر می‌شود.

خطاهای رایج

Bun.serve({ port: Number(process.env.PORT) || 3000, hostname: "0.0.0.0", fetch });

sakoocloud apps scale --memory 1Gi

پرسش‌های متداول

جزئیات بیشتر در راهنمای Bun در مستندات و مرجع CLI.