Zeabur CLI
Zeabur CLI 讓你在終端中管理所有 Zeabur 資源——部署服務、查看日誌、管理專案,無需打開 Dashboard。
登入帳號
瀏覽器登入
npx zeabur@latest auth login按下 Enter 打開瀏覽器登入頁面,點選 Confirm 按鈕後,你會被重新導向到終端並看到登入成功的訊息。
Token 登入
適合 CI/CD 或無法打開瀏覽器的環境:
npx zeabur@latest auth login --token <your-token>部署服務
在你的專案目錄中執行:
npx zeabur@latest deployCLI 會自動偵測框架,並引導你選擇或建立一個專案。部署完成後,終端會顯示服務的 URL。
工作區(團隊)
工作區是 CLI 操作所依據的帳號:你的個人帳號,或是你所屬的其中一個團隊。工作區是你上下文的最外層範圍——切換工作區會清除已儲存的專案、環境與服務,因為資源 ID 並不會在個人帳號與團隊之間共用。
預設情況下,CLI 會在你的個人帳號上操作。在處理團隊資源之前,請先切換到該團隊的工作區(或加上 --workspace),否則指令會在你的個人帳號上執行。
列出工作區
顯示你的個人工作區,以及你所屬的每一個團隊,並標示你在各團隊中的角色。目前所在的工作區會被標記出來。
npx zeabur@latest workspace list顯示目前的工作區
npx zeabur@latest workspace current切換到團隊
參數為團隊的名稱或其 24 字元 ID。若名稱對應到多個團隊,CLI 會列出候選項目,讓你以 ID 來選擇。
npx zeabur@latest workspace switch <team-name-or-id>回到個人工作區
npx zeabur@latest workspace clear單次覆寫
使用全域的 --workspace 旗標,可在另一個工作區中執行單一指令,而不變更已儲存的工作區。這在 CI 與腳本中相當方便:
npx zeabur@latest --workspace <team-name-or-id> project ls專案管理
列出專案
npx zeabur@latest project ls設定當前專案 Context
npx zeabur@latest context set project互動模式下會列出你的所有專案供選擇。設定後,後續指令會自動套用到該專案。
服務管理
列出服務
npx zeabur@latest service ls設定當前服務 Context
npx zeabur@latest context set service重啟服務
npx zeabur@latest service restart部署資訊與日誌
查看部署狀態
npx zeabur@latest deployment get查看 Runtime 日誌
npx zeabur@latest deployment log -t=runtime查看 Build 日誌
npx zeabur@latest deployment log -t=build環境切換
npx zeabur@latest context set env切換到不同的部署環境(例如 production、staging)。
Non-Interactive 模式
在 CI/CD 管線或自動化腳本中,你可以加上 -i=false 停用互動模式,並直接傳入參數:
透過名稱指定專案和服務
npx zeabur@latest context set project --name <project-name>
npx zeabur@latest context set service --name <service-name>
npx zeabur@latest context set env --id <env-id>透過 ID 指定
npx zeabur@latest context set project --id <project-id>
npx zeabur@latest context set service --id <service-id>一行完成操作
不設定 context,直接在指令中傳入所有參數:
npx zeabur@latest service restart --env-id <env-id> --service-name <service-name>
npx zeabur@latest deployment get --env-id <env-id> --service-name <service-name>
npx zeabur@latest deployment log -t=runtime --env-id <env-id> --service-name <service-name>取得指令說明
任何指令都可以加上 --help 查看用法:
npx zeabur@latest --help
npx zeabur@latest deployment --help