gpc-release-flow

リリースフロー

ビルドのアップロード、トラックへの公開、トラック間の昇格、またはロールアウトの管理が必要な場合に、このスキルを使用します。

前提条件

• 認証が設定済みであること（gpc doctor が成功すること）。
• アップロードごとに新しいバージョンコードを使用すること。
• 必ず --package を明示的に指定すること。

アップロードとリリース

AAB をトラックにアップロード

gpc bundles upload --file app.aab --track internal --package com.example.app

リリースノートとコミットを指定してアップロード

gpc bundles upload --file app.aab --track beta \
  --release-notes "Bug fixes and improvements" \
  --release-notes-lang en-US \
  --commit \
  --package com.example.app

段階的ロールアウトを設定してアップロード

gpc bundles upload --file app.aab --track production \
  --rollout 0.1 \
  --package com.example.app

トラック管理

トラック一覧を表示

gpc tracks list --package com.example.app

トラックの詳細を取得

gpc tracks get --track production --package com.example.app

トラックのリリースを更新

gpc tracks update --track production \
  --version-code 42 \
  --status completed \
  --rollout-percentage 1.0 \
  --package com.example.app

トラック間で昇格

gpc tracks promote --from internal --to beta --package com.example.app
gpc tracks promote --from beta --to production \
  --rollout-percentage 0.05 \
  --package com.example.app

段階的ロールアウト

段階的に拡大

gpc tracks update --track production --rollout-percentage 0.05 --package com.example.app
gpc tracks update --track production --rollout-percentage 0.20 --package com.example.app
gpc tracks update --track production --rollout-percentage 0.50 --package com.example.app

ロールアウトを完了（100%）

gpc tracks complete --track production --package com.example.app

ロールアウトを停止

gpc tracks halt --track production --package com.example.app

手動編集のライフサイクル

細かく制御する必要がある場合や、1 回のコミットで複数の変更を行う場合に使用します。

# 1. Create edit session
gpc edits create --package com.example.app

# 2. Make changes (upload, update tracks, etc.)
gpc bundles upload --file app.aab --package com.example.app

# 3. Validate before committing
gpc edits validate --edit-id $EDIT_ID --package com.example.app

# 4. Commit all changes atomically
gpc edits commit --edit-id $EDIT_ID --package com.example.app

バンドル処理を待機

gpc bundles wait --version-code 42 --timeout 600 --interval 30 --package com.example.app

エージェントの動作

• アップロード前に、対象のトラックを必ず確認します。
• 本番リリースでは、利用可能な場合は --dry-run を使用します。
• 変更の前後に gpc tracks get --track <track> の出力を表示します。
• 本番環境では、全面リリースではなく 5% から開始する段階的ロールアウトを推奨します。

注意事項

• 利用可能なトラック（internal、alpha、beta、production、custom）を確認するには、gpc tracks list を使用します。
• リリースノートでは、ロケール固有のノートに --release-notes-lang を指定できます。
• アップロード時に --commit を指定すると編集が自動的にコミットされます。手動編集のライフサイクルを使用する場合は省略してください。