Zeabur CLI
Zeabur CLI を使えば、ターミナルからすべての Zeabur リソースを管理できます——サービスのデプロイ、ログの確認、プロジェクトの管理がダッシュボードを開かずに行えます。
ログイン
ブラウザログイン
npx zeabur@latest auth loginEnter を押してブラウザでログインページを開き、Confirm をクリックします。ターミナルにリダイレクトされ、ログイン成功メッセージが表示されます。
トークンログイン
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プロジェクトコンテキストの設定
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