zeabur-variables

Zeabur の変数管理

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

CLI の構文を推測しないでください。 有効なサブコマンドは create、update、delete、env、list のみです。set や add などのサブコマンドは存在せず、エラー出力もなく失敗します。

既知の問題

1. --name ではなく --id を使用してください — 名前での検索は信頼できません
2. ${VAR} が空になります — CLI が受け取る前にシェルで展開されます。シングルクォートを使用してください
3. variable env はすべての変数を置き換えます — .env ファイルの内容で変数セット全体が上書きされ、ファイルにない既存の変数は削除されます

変数を作成する

新しい変数を作成します。キーがすでに存在する場合はエラーになります — 既存のキーを変更するには update を使用してください。

# Always use service ID — use the `zeabur-service-list` skill to get it
npx zeabur@latest variable create --id <service-id> \
  -k "KEY1=value1" \
  -k "KEY2=value2" \
  -y -i=false

変数を更新する

指定したキーのみを更新します。ほかの変数はクリアされません。

npx zeabur@latest variable update --id <service-id> \
  -k "KEY1=new_value1" \
  -k "KEY2=new_value2" \
  -y -i=false

変数を削除する

指定したキーのみを削除します。

npx zeabur@latest variable delete --id <service-id> \
  --delete-keys "KEY1" \
  --delete-keys "KEY2" \
  -y -i=false

変数を一覧表示する

npx zeabur@latest variable list --id <service-id> -i=false

.env ファイルから読み込む

警告： これは、サービス上のすべての変数を .env ファイルの内容で置き換えます。ファイルにない既存の変数は削除されます。

npx zeabur@latest variable env --id <service-id> -f .env

env を実行した後、変更を適用するにはサービスを手動で再起動する必要があります。

変数の参照

警告： CLI の -k フラグでは、Cobra の StringToStringVar パーサーが使用されています。このパーサーは、シングルクォートで囲んでも ${} を含む値を確実に処理できません。値が途中で切り捨てられたり、空になったりすることがあります。詳細は zeabur/cli#201 をご覧ください。

# WRONG — shell expands ${VAR} to empty
npx zeabur@latest variable create --id <service-id> -k "REDIS_URL=${REDIS_URI_INTERNAL}" -y -i=false

# STILL UNRELIABLE — single quotes prevent shell expansion but Cobra's CSV parser may still mangle the value
npx zeabur@latest variable create --id <service-id> -k 'REDIS_URL=${REDIS_URI_INTERNAL}' -y -i=false

# RECOMMENDED — set variable references in Zeabur Dashboard
# Or use GraphQL API with updateEnvironmentVariable(data: Map!) mutation

${POSTGRES_CONNECTION_STRING} のようなサービス間の変数参照については（Zeabur はフラットな名前空間を使用しており、ほかのサービスから公開された変数はすべて直接マージされるため、サービスのプレフィックスは不要です）、CLI のバグが修正されるまでは必ず Zeabur Dashboard を使用してください。

クイックリファレンス

必要な操作	コマンド	動作
新しい変数を追加	npx zeabur@latest variable create --id <service-id> -k "K=V" -y -i=false	キーが存在する場合はエラーになります
既存の変数を変更	npx zeabur@latest variable update --id <service-id> -k "K=V" -y -i=false	指定したキーのみを更新します
特定の変数を削除	npx zeabur@latest variable delete --id <service-id> --delete-keys "K" -y -i=false	指定したキーのみを削除します
ファイルからすべての変数を上書き	npx zeabur@latest variable env --id <service-id> -f .env	変数セット全体を置き換えます
変数を表示	npx zeabur@latest variable list --id <service-id> -i=false	読み取り専用