開発者ツールCLI

Zeabur CLI

Zeabur CLI を使えば、ターミナルからすべての Zeabur リソースを管理できます——サービスのデプロイ、ログの確認、プロジェクトの管理がダッシュボードを開かずに行えます。

ログイン

ブラウザログイン

npx zeabur@latest auth login

Enter を押してブラウザでログインページを開き、Confirm をクリックします。ターミナルにリダイレクトされ、ログイン成功メッセージが表示されます。

トークンログイン

CI/CD やヘッドレス環境の場合:

npx zeabur@latest auth login --token <your-token>

サービスをデプロイ

プロジェクトディレクトリで以下のコマンドを実行:

npx zeabur@latest deploy

CLI がフレームワークを自動検出し、プロジェクトの選択または作成をガイドします。デプロイ完了後、サービス 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

プロジェクトコンテキストの設定

npx zeabur@latest context set project

インタラクティブモードでは、すべてのプロジェクトが一覧表示されて選択できます。以降のコマンドは選択したプロジェクトに自動的に適用されます。

サービス管理

サービス一覧

npx zeabur@latest service ls

サービスコンテキストの設定

npx zeabur@latest context set service

サービスの再起動

npx zeabur@latest service restart

デプロイ情報とログ

デプロイステータスの確認

npx zeabur@latest deployment get

ランタイムログの表示

npx zeabur@latest deployment log -t=runtime

ビルドログの表示

npx zeabur@latest deployment log -t=build

環境の切り替え

npx zeabur@latest context set env

デプロイ環境(本番、ステージングなど)を切り替えます。

非インタラクティブモード

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>

ワンライナー操作

コンテキスト設定をスキップし、すべてのパラメータをインラインで渡す:

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