هاست Astro، استاتیک یا با رندر سرور

یک فریم‌ورک، دو نوع خروجی

Astro به‌طور پیش‌فرض HTML استاتیک می‌سازد. در این حالت پوشه‌ی dist با nginx سرو می‌شود و در زمان اجرا هیچ سرور Node.js لازم نیست.

اگر output را server یا hybrid گذاشته‌اید، adapter رسمی @astrojs/node را در حالت standalone اضافه کنید. سرور تولیدشده روی پورت 4321 بالا می‌آید و HOST را از محیط می‌خواند.

مسیر بیلد Astro

1. تشخیص

   وابستگی astro؛ مقدار output در astro.config نوع خروجی را تعیین می‌کند.

   astro.config.mjs

2. نصب

   پکیج‌منیجر از روی لاک‌فایل انتخاب می‌شود.

   npm ci

3. بیلد

   صفحه‌ها و در حالت server، سرور Node.js ساخته می‌شود.

   astro build

4. اجرا

   در SSR سرور standalone اجرا می‌شود؛ در حالت استاتیک nginx فایل‌ها را سرو می‌کند.

   node ./dist/server/entry.mjs

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

$ sakoocloud deploy
✔ Packed 2.4MB
✔ Source uploaded
ℹ Build started · dep_7k2m9q
#4 [builder 1/5] FROM node:22-alpine
#6 [builder 3/5] RUN npm ci
#8 [builder 4/5] RUN npm run build
#10 [stage-1 2/3] COPY dist ./dist
#12 exporting to image
✔ Deployed — app is running.
→ https://my-astro.sakooapps.ir

تنظیم برای SSR

adapter نود را در حالت standalone اضافه کنید و HOST را 0.0.0.0 بگذارید.

import { defineConfig } from "astro/config";
import node from "@astrojs/node";

export default defineConfig({
  output: "server",
  adapter: node({ mode: "standalone" }),
});

{
  "scripts": {
    "build": "astro build",
    "start": "node ./dist/server/entry.mjs"
  }
}

sakoocloud apps create --name my-astro --runtime astro --port 4321
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 روی شاخه‌ی هدف بیلد و مستقر می‌شود.

خطاهای رایج

HOST=0.0.0.0

sakoocloud apps scale --memory 1Gi

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

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