Crescendo Lab 文件
正體中文
註冊開始用

從 Dockerfile 部署網頁服務

從含 Dockerfile 的原始碼,部署一個持續執行的服務,例如 webhook、API 或給 agent 用的工具。

最後更新

事前準備#

  • 一個會回應 HTTP 請求的程式。
  • 專案最上層有 Dockerfile。

1. 寫 Dockerfile#

以下是 Node.js 的例子。伺服器監聽 $PORT,映像檔只 EXPOSE 一個通訊埠,並用非 root 的使用者執行:

Dockerfile
FROM node:22-slim
WORKDIR /app
COPY package*.json ./
RUN npm ci --omit=dev
COPY . .
USER node
EXPOSE 8080
CMD ["node", "server.js"]
server.js
import { createServer } from "node:http";

const port = Number(process.env.PORT ?? 8080);

createServer((req, res) => {
  res.writeHead(200, { "content-type": "application/json" });
  res.end(JSON.stringify({ ok: true, path: req.url }));
}).listen(port);

映像檔要符合這幾點,完整規則見容器執行合約:

  • 有 CMD 或 ENTRYPOINT 啟動伺服器。
  • 在 $PORT 提供 HTTP。
  • 為 linux/amd64 建置。
  • 除了 /tmp,檔案系統是唯讀的;/tmp 也有自己的限制。

2. 上傳原始碼#

在專案的「部署」分頁,把原始碼資料夾或它的 .zip 拖進上傳區,再按「上傳並建置」。Dockerfile 要在最上層。自己壓 zip 時,記得排除 node_modules、.git 和 .env:

bash
zip -r ../app.zip . -x 'node_modules/*' '.git/*' '.env*'

平台會建置映像檔,掃描漏洞與外洩的金鑰,並檢查映像檔是否符合執行合約。平台幫你調整過的地方會以提示列在版本頁,例如「映像檔以 root 執行,改用 uid 10001 執行」。

3. 上線並確認執行狀態#

專案的第一個版本建置成功後會自動上線,之後的版本要到「部署」分頁按「上線」。

「執行」分頁會顯示正在服務的版本,以及有幾個執行個體已經就緒。

版本一直沒有就緒

最常見的原因是伺服器沒有監聽平台給的通訊埠。處理方式見部署失敗排除。

4. 加入機敏值#

API 金鑰這類不能外流的值,在專案的「環境變數」新增,打開那一列的「機敏值」開關,程式一樣從環境變數讀取。服務正在執行時,存檔會在確認後一併重新啟動,新的執行個體就緒前,舊的會繼續服務。詳見專案設定。

不要把金鑰放進原始碼

掃描發現映像檔裡有金鑰時,請把它從原始碼拿掉、改成專案的機敏值,並且換一把新的金鑰。

限制#

記憶體與 CPU

每個執行個體都依專案的規格執行,可以在專案「設定」的「規格」更改:

規格CPU記憶體
S0.5 vCPU512 MiB
M1 vCPU1 GiB
L2 vCPU2 GiB

記憶體是硬上限,用超過的執行個體會被停掉再重新啟動。如果用 --max-old-space-size 調高 Node.js 的 heap,請讓它低於記憶體的四分之三,因為程式的其他部分也要用記憶體。超過時,版本頁的「建置提醒」會出現警告。

/tmp 裡的檔案

/tmp 是程式唯一能寫入的地方。

  • 最多 256 MiB。檔案存在磁碟上,不算進上面的記憶體。
  • 執行個體每次重新啟動、每次有新版本上線,/tmp 都會清空。每個執行個體各有一份。
  • 寫超過 256 MiB,執行個體會被停掉,換一個新的上來,新的 /tmp 是空的。

這裡適合放快取和暫存檔,不要放需要保留的資料。

不要在容器裡跑資料庫

在映像檔裡啟動的資料庫,例如 PostgreSQL、MySQL、MongoDB 或 Redis,資料都存在執行個體裡面。執行個體重新啟動或新版本上線,資料就不見了,而且資料庫還會跟你的程式搶記憶體。Dockerfile 安裝或啟動資料庫時,「建置提醒」也會出現警告。

需要保留的資料,請改放到 Agent Lab 資料庫(PostgreSQL 或 MySQL)或 Redis 快取,程式透過環境變數連線。