Node adapter & bentuk hasil build

Sebelum menulis Dockerfile, kamu perlu tahu bentuk artefaknya — karena separuh kesalahan deploy berasal dari menyalin hal yang salah.

Konfigurasi

// astro.config.mjs
import node from "@astrojs/node";

export default defineConfig({
  site: "https://portal.contoh.id",
  output: "server",
  adapter: node({ mode: "standalone" }),
});

Bentuk dist/

dist/
├── server/
│   ├── entry.mjs            ← titik masuk; ini yang dijalankan
│   ├── manifest_*.mjs
│   ├── pages/               ← satu modul per rute on-demand
│   ├── chunks/
│   └── renderers.mjs
└── client/
    ├── _astro/              ← JS & CSS ber-hash
    ├── favicon.ico          ← isi public/ disalin apa adanya
    └── robots.txt

pnpm build
du -sh dist/server dist/client
find dist/client/_astro -name '*.js' | wc -l

Variabel lingkungan yang dibaca adapter

Server pembungkus untuk hal yang tidak diurus Astro

// server.mjs — dijalankan alih-alih entry.mjs langsung
import { handler as astro } from "./dist/server/entry.mjs";
import { createServer } from "node:http";
import { db, dbBaca, dbTulis } from "./dist/server/lib-db.mjs";

const PORT = Number(process.env.PORT ?? 4321);
let sedangMati = false;
let aktif = 0;

const server = createServer((req, res) => {
  // Health check TIDAK menyentuh database — lihat catatan di bawah.
  if (req.url === "/sehat") {
    res.writeHead(sedangMati ? 503 : 200, { "Content-Type": "text/plain" });
    return res.end(sedangMati ? "mati" : "ok");
  }

  aktif++;
  res.on("finish", () => aktif--);
  res.on("close", () => aktif--);

  astro(req, res, (err) => {
    if (err) {
      console.error(JSON.stringify({ level: "error", e: String(err) }));
      res.writeHead(500).end("error");
    } else {
      res.writeHead(404).end("not found");
    }
  });
});

// Timeout server — sama pentingnya dengan timeout kueri (Fase 2).
server.headersTimeout = 20_000;
server.requestTimeout = 30_000;
server.keepAliveTimeout = 65_000;    // HARUS lebih besar dari idle timeout ALB

server.listen(PORT, "0.0.0.0", () => {
  console.log(JSON.stringify({ level: "info", pesan: "siap", port: PORT }));
});

Graceful shutdown

async function matikan(sinyal) {
  if (sedangMati) return;
  sedangMati = true;

  console.log(JSON.stringify({ level: "info", pesan: "mulai mati", sinyal, aktif }));

  // 1. Health check langsung 503 → ALB berhenti mengirim request baru.
  // 2. Beri waktu ALB menyadarinya sebelum menutup listener.
  await new Promise((r) => setTimeout(r, 5000));

  // 3. Berhenti menerima koneksi baru; selesaikan yang berjalan.
  server.close();

  // 4. Tunggu request yang sedang jalan, maksimal 20 detik.
  const batas = Date.now() + 20_000;
  while (aktif > 0 && Date.now() < batas) {
    await new Promise((r) => setTimeout(r, 200));
  }

  // 5. Tutup pool database.
  await Promise.allSettled([dbBaca.destroy(), dbTulis.destroy()]);

  console.log(JSON.stringify({ level: "info", pesan: "mati bersih", sisa: aktif }));
  process.exit(0);
}

process.on("SIGTERM", () => matikan("SIGTERM"));
process.on("SIGINT", () => matikan("SIGINT"));

Dua health check yang berbeda

// /sehat — untuk ALB. TIDAK menyentuh database.
// /siap — untuk pemeriksaan manual & alarm. Menyentuh database.

if (req.url === "/siap") {
  try {
    await sql`SELECT 1`.execute(dbBaca);
    res.writeHead(200).end(JSON.stringify({ ok: true }));
  } catch (e) {
    res.writeHead(503).end(JSON.stringify({ ok: false, e: String(e) }));
  }
  return;
}