# 推送 Docker 映像檔， 直接部署上線。

> 安裝 Agent Lab CLI、在瀏覽器登入，用 docker push 推送到組織的映像檔登錄檔，再部署成新版本。附指令、映像檔規則，以及 CLI 與 MCP 的差別。

Web page: https://agentlab.cresclab.com/deploy/cli  
English (Markdown): https://agentlab.cresclab.com/en/deploy/cli.md

Agent Lab CLI · Crescendo Agent Lab 部署

Agent Lab CLI 幫你登入，讓 docker 可以推送到組織的映像檔登錄檔。把自己建好的映像檔推上去，就能用它部署專案的新版本。

[直接看指令](https://agentlab.cresclab.com/deploy/cli#steps) [免費開始](https://app.agentlab.cresclab.com/?lang=zh-Hant&intent=deploy)

一段終端機操作：從 npm 安裝 Agent Lab CLI、登入、讓 docker 使用這個登入，再建置映像檔並推送到組織的映像檔登錄檔。

指令

## 安裝、登入、推送、部署

把 <org-id> 換成你的組織 ID。主控台的映像檔登錄檔頁面會顯示已經填好 ID 的指令。

1. 1
   ### 安裝 CLI
   ```
   npm install --global @crescendolab/agentlab-cli@alpha
   agentlab --version
   ```
   從 npm 安裝。需要 Node.js 24 以上，支援 macOS、Linux、Windows 的 x64 與 arm64。目前是 alpha 版，指令可能還會調整。
2. 2
   ### 登入並設定 Docker
   ```
   agentlab login
   agentlab auth configure-docker
   agentlab status
   ```
   agentlab login 會開瀏覽器讓你登入並選擇組織；接著執行 agentlab auth configure-docker，docker 就會用這個登入存取登錄檔，不必再 docker login。
3. 3
   ### 建置並推送映像檔
   ```
   docker build --platform linux/amd64 -t registry.agentlab.cresclab.com/<org-id>/web:v1 .
   docker push registry.agentlab.cresclab.com/<org-id>/web:v1
   ```
   以 linux/amd64 建置（專案只在這個平台上執行），推送到你組織 ID 底下。
4. 4
   ### 部署上線
   在專案的「部署」分頁，於「部署新版本的來源」選「從映像檔」，再選倉庫與標籤。專案的第一個版本準備好就會自動上線，之後的版本按「上線」。
   想從原始碼建置？請看[用 Dockerfile 部署](https://agentlab.cresclab.com/docs/zh-tw/deploy/container-app)。

映像檔規則

## 映像檔要符合這幾點

自己推送的映像檔和從 Dockerfile 建置的映像檔，規則都一樣。

執行

### 通訊埠、使用者、平台

- 在 `$PORT` 提供 HTTP：依序取專案設定的通訊埠、映像檔唯一 EXPOSE 的通訊埠，都沒有就是 8080。
- 沒有設定非 root 的 `USER` 時，改用 uid 10001、群組 0 執行。
- 只支援 `linux/amd64`，推送其他平台的映像檔會被拒絕。
- 要有 `CMD` 或 `ENTRYPOINT` 啟動伺服器。
- 除了 `/tmp`，檔案系統都是唯讀。

CLI

### 常用指令

- `agentlab login [--org <uuid>]`：用瀏覽器登入。
- `agentlab auth configure-docker`：讓 docker 用這個登入存取登錄檔。
- `agentlab status`：顯示帳號、組織與登入到期時間。
- `agentlab logout`：登出，並移除這台電腦儲存的登入資料。

完整規則與提示說明見[容器執行合約](https://agentlab.cresclab.com/docs/zh-tw/deploy/runtime-contract)；安裝細節見 [npm 上的套件頁](https://www.npmjs.com/package/@crescendolab/agentlab-cli)。

CLI 還是 MCP

## 兩種入口，同一個平台

MCP server 適合從 AI 工具部署；CLI 適合部署自己建好的 Docker 映像檔。

Agent Lab CLI 與 Agent Lab MCP server 比較

|  | Agent Lab CLI | Agent Lab MCP server |
| --- | --- | --- |
| 適合的情況 | 你已經自己（或在 CI 裡）建置 Docker 映像檔 | 你請 Claude Code、Codex 或 Cursor 幫你部署 |
| 送出的內容 | 建好的映像檔，用 docker 推送 | 原始碼檔案，在平台上建置 |
| 登入方式 | agentlab login，在瀏覽器登入 | 從 AI 工具發起，在瀏覽器 OAuth 登入 |
| 安裝 | npm 套件（alpha 版） | 每個 AI 工具一行設定，不用安裝 |

常見問題

## 推送映像檔之前

**Agent Lab CLI 怎麼安裝？**

執行 npm install --global @crescendolab/agentlab-cli@alpha。需要 Node.js 24 以上，支援 macOS、Linux、Windows 的 x64 與 arm64，不需要安裝 Go。

**還需要 docker login 嗎？**

不用。執行 agentlab login，再執行一次 agentlab auth configure-docker，docker 就會用你的身分推送。在 CI 裡，請到主控台的部署設定建立 robot token，搭配 docker login 使用。

**映像檔要推送到哪個位址？**

registry.agentlab.cresclab.com/<org-id>/<名稱>:<標籤>，<org-id> 是你的組織 ID。主控台的映像檔登錄檔頁面會顯示完整指令。

**Apple silicon 的 Mac 建出來的 arm64 映像檔可以推送嗎？**

專案只在 linux/amd64 上執行，推送其他平台的映像檔會被拒絕。請用 docker build --platform linux/amd64 建置。

**哪些方案有映像檔登錄檔？**

Pro、Team 與 Business 方案有，Free 方案沒有。各方案保留幾個映像檔版本、多少儲存空間，請見方案頁。 [方案與價格](https://agentlab.cresclab.com/deploy#pricing)

**CLI 和 MCP server 差在哪？**

MCP server 讓 Claude Code、Codex 等 AI 工具幫你把原始碼部署上線；CLI 則是你自己建好 Docker 映像檔後，用它推送並部署。 [設定 MCP server](https://agentlab.cresclab.com/mcp)