本地 Docker 部署

執行受支援的本地服務堆疊以進行評估與整合測試。

受支援的本地 Docker 服務堆疊會一起執行 Gateway、Web、Identity、PostgreSQL、Redis 與物件儲存。舊的 SQLite 單一映像設定已退役,因為目前的 Gateway 需要 PostgreSQL。

啟動最小化配置

在已簽出的儲存庫根目錄執行:

bash
bun run docker:up

閘道監聽 http://127.0.0.1:8877。發送請求前請等待容器健康檢查通過。

健康檢查

bash
curl http://127.0.0.1:8877/healthz
curl http://127.0.0.1:8877/readyz

資料與憑證

  • PostgreSQL、Redis 與物件儲存資料會保存在具名 Docker volume 中。
  • 範例 Compose 檔案包含僅用於開發的 bootstrap 憑證。
  • 與他人共享環境前必須替換所有 bootstrap secret。
  • 請勿將此配置直接暴露至公網。

生產邊界

最小化配置不是生產拓撲。生產部署需要外部 PostgreSQL、Redis、受控金鑰、物件儲存、獨立 Web 與 Identity 服務、TLS ingress、遷移、備份和回滾證據。規劃私有化生產部署前請聯絡技術支援。

停止配置但保留資料卷:

bash
bun run docker:down