zeabur-update-service

Zeabur サービスの再デプロイなしでの更新

Zeabur CLI の実行には、常に npx zeabur@latest を使用してください。 zeabur を直接実行したり、ほかのインストール方法を使用したりしないでください。npx が利用できない場合は、先に Node.js をインストールしてください。

ワークフロー

# 1. Get service ID (use the `zeabur-service-list` skill)
npx zeabur@latest service list --project-id <project-id> -i=false

# 2. Check current variables
npx zeabur@latest variable list --id <service-id> -i=false

# 3a. Add new variables (errors if key already exists)
npx zeabur@latest variable create --id <service-id> \
  --key "KEY1=value1" \
  --key "KEY2=value2" \
  -i=false -y

# 3b. Update existing variables (only updates specified keys)
npx zeabur@latest variable update --id <service-id> \
  --key "KEY1=new_value1" \
  -i=false -y

# 4. Restart service (use the `zeabur-restart` skill for details)
npx zeabur@latest service restart --id <service-id> -y -i=false

注意事項

問題	解決策
${VAR} の参照	CLI ではなくダッシュボードで設定してください（シェルによって空に展開されます）

イメージタグの更新（サービスのバージョンのアップグレード／ダウングレード）

ビルド済みサービス／マーケットプレイスサービスのバージョンを切り替えるには、イメージタグを更新してください。

バージョンのアップグレードまたはダウングレードに適した方法は、これだけです。 代替手段として zeabur-deploy（または再デプロイ／削除して再作成する手順）を使用しないでください。こうした手順では、サービスにマウントされたディスクが孤立したり、消去されたりする可能性があります。タグを更新すると、新しいイメージでクリーンに再デプロイされ、ボリュームは接続されたままになります。

ワークフロー

# 1. Get service ID (use the `zeabur-service-list` skill)
npx zeabur@latest service list --project-id <project-id> -i=false

# 2. Update tag (triggers redeploy automatically)
npx zeabur@latest service update tag --id <service-id> -t <new-tag> -y -i=false

フラグ

フラグ	説明
--id	サービス ID（必須。--name は使用しないでください）
-t, --tag	デプロイする新しいイメージタグ
--env-id	環境 ID（省略可。自動的に解決されます）
-y, --yes	確認をスキップします

注： タグを更新すると、新しいデプロイが開始されます。更新されたイメージでサービスが再起動します。

使用するケース

• 環境変数の誤記を修正する
• 不足している設定を追加する
• ポート、URL、認証情報を変更する
• ビルド済みサービスを新しいバージョンにアップグレードする
• テンプレート全体を再デプロイする必要はありません