從 Dockerfile 部署網頁服務
從含 Dockerfile 的原始碼,部署一個持續執行的服務,例如 webhook、API 或給 agent 用的工具。
事前準備#
- 一個會回應 HTTP 請求的程式。
- 專案最上層有
Dockerfile。
1. 寫 Dockerfile#
以下是 Node.js 的例子。伺服器監聽 $PORT,映像檔只 EXPOSE 一個通訊埠,並用非 root 的使用者執行:
FROM node:22-slim
WORKDIR /app
COPY package*.json ./
RUN npm ci --omit=dev
COPY . .
USER node
EXPOSE 8080
CMD ["node", "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:
zip -r ../app.zip . -x 'node_modules/*' '.git/*' '.env*'平台會建置映像檔,掃描漏洞與外洩的金鑰,並檢查映像檔是否符合執行合約。平台幫你調整過的地方會以提示列在版本頁,例如「映像檔以 root 執行,改用 uid 10001 執行」。
3. 上線並確認執行狀態#
專案的第一個版本建置成功後會自動上線,之後的版本要到「部署」分頁按「上線」。
「執行」分頁會顯示正在服務的版本,以及有幾個執行個體已經就緒。
版本一直沒有就緒
最常見的原因是伺服器沒有監聽平台給的通訊埠。處理方式見部署失敗排除。
4. 加入機敏值#
API 金鑰這類不能外流的值,在專案的「環境變數」新增,打開那一列的「機敏值」開關,程式一樣從環境變數讀取。服務正在執行時,存檔會在確認後一併重新啟動,新的執行個體就緒前,舊的會繼續服務。詳見專案設定。
不要把金鑰放進原始碼
掃描發現映像檔裡有金鑰時,請把它從原始碼拿掉、改成專案的機敏值,並且換一把新的金鑰。
限制#
記憶體與 CPU
每個執行個體都依專案的規格執行,可以在專案「設定」的「規格」更改:
| 規格 | CPU | 記憶體 |
|---|---|---|
| S | 0.5 vCPU | 512 MiB |
| M | 1 vCPU | 1 GiB |
| L | 2 vCPU | 2 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 快取,程式透過環境變數連線。