هاست Hono روی Node.js، Bun یا Deno

یک کد، سه رانتایم

Hono روی استانداردهای وب ساخته شده و روی Node.js، Bun و Deno بدون تغییر منطق اجرا می‌شود. در سکو کلود رانتایم را hono می‌گذارید و با --hono-runtime مشخص می‌کنید زیر آن کدام رانتایم اجرا شود؛ پیش‌فرض Node.js است.

روی Node.js از @hono/node-server استفاده کنید، روی Bun شیء app را export کنید یا Bun.serve را صدا بزنید، و روی Deno app.fetch را به Deno.serve بدهید.

مسیر بیلد Hono

1. تشخیص

   وابستگی hono در package.json یا import map در deno.json.

   "hono": "^4"

2. انتخاب رانتایم

   مقدار --hono-runtime تعیین می‌کند بیلد با Node.js، Bun یا Deno انجام شود.

   --hono-runtime bun

3. نصب

   وابستگی‌ها با ابزار همان رانتایم نصب می‌شوند.

   bun install

4. اجرا

   اسکریپت start روی رانتایم انتخاب‌شده اجرا می‌شود.

   bun run src/index.ts

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

$ sakoocloud deploy
✔ Packed 0.6MB
✔ 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-hono.sakooapps.ir

Hono روی Node.js

روی Node.js سرور را با @hono/node-server روی پورت PORT بالا بیاورید.

import { Hono } from "hono";
import { serve } from "@hono/node-server";

const app = new Hono();
app.get("/health", (c) => c.json({ ok: true }));

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

sakoocloud apps create --name my-hono --runtime hono \
  --hono-runtime nodejs --port 3000
sakoocloud deploy

تنظیمات

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

دیتابیس را به اپ لینک کنید؛ متغیرهای DATABASE_URL، DATABASE_HOST و بقیه به محیط اپ تزریق می‌شوند و اپ دوباره مستقر می‌شود. رمز عبور هیچ‌جا در کد نمی‌آید.

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

import pg from "pg";

export const pool = new pg.Pool({
  connectionString: process.env.DATABASE_URL,
});

datasource db {
  provider = "postgresql"
  url      = env("DATABASE_URL")
}

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

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

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

خطاهای رایج

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

sakoocloud apps scale --memory 1Gi

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

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