メインコンテンツまでスキップ

Migrate from extend-helper-cli

Last updated on October 29, 2026

注釈:本資料はAI技術を用いて翻訳されています。

概要​

Extend Helper CLI は非推奨です。現行の作業には AGS CLI の ags extend を使ってください。サポート終了日は Extend Helper CLI のページにあります。手順は AGS CLI for Extend を参照してください。

サインイン​

2 つのログインモードについては、インストールとサインイン を参照してください。

extend-helper-cli の login、logout、status コマンドは、ags auth login、ags auth logout、ags auth status に置き換えられています。各コマンドに認証情報を渡す代わりに、セッションごとに 1 回サインインするだけで済みます。

AGS CLI が読む環境変数は AGS_BASE_URL、AGS_CLIENT_ID、AGS_CLIENT_SECRET、AGS_ACCESS_TOKEN です。AB_BASE_URL、AB_CLIENT_ID、AB_CLIENT_SECRET は読みません。

コマンドマッピング​

extend-helper-cliAGS CLI
extend-helper-cli create-app --scenario service-extension --confirmags extend create-app --json '{"scenario":"service-extension"}' --yes
extend-helper-cli get-app-infoags extend get-app-info
extend-helper-cli get-app-info --path <field>ags extend get-app-info --format json
extend-helper-cli list-imagesags extend list-images
extend-helper-cli deploy-app --image-tag v1.0.0ags extend deploy-app --json '{"imageTag":"v1.0.0"}'
extend-helper-cli start-app / stop-appags extend start-app / ags extend stop-app
extend-helper-cli delete-app --confirmags extend delete-app --yes
extend-helper-cli dockerloginags extend docker-login
extend-helper-cli image-uploadags extend image-upload
extend-helper-cli tunnelags extend database-tunnel
extend-helper-cli update-var / update-secretags extend update-var / ags extend update-secret
extend-helper-cli clone-template --scenario "Extend App UI" --template <name>ags extend clone-template --template "Extend App UI :: <name> :: JavaScript"
extend-helper-cli appui create --name <name>ags extend app-ui create --json '{"name":"<name>"}'
extend-helper-cli appui setup-env --name <name>ags extend app-ui setup-env --name <name>
extend-helper-cli appui upload --name <name>ags extend app-ui upload --name <name>
extend-helper-cli remote-debug enable --confirmags extend remote-debug enable --yes
extend-helper-cli logs streamags extend logs stream

--namespace は引き続きゲームネームスペースを選ぶフラグです。--confirm は --yes になりました。

database-tunnel は AGS CLI 0.5.3 以降が必要です。logs stream は AGS CLI 0.5.2 以降が必要です。

dockerlogin と appui はエイリアスとして受け付けられません。

データベーストンネル​

extend-helper-cli tunnel は AGS CLI 0.5.3 以降では ags extend database-tunnel です。0.5.2 ではコマンドは ags extend tunnel です。Extend データベース(NoSQL、SQL、または Key Value Store)へのローカル TCP ポートを開きます。0.5.3 では ags extend tunnel もこのコマンドを実行しますが、ags extend --help には表示されません。後のリリースで削除されるため、スクリプトでは ags extend database-tunnel を使ってください。

ags extend database-tunnel --resource-name <resource-name> --namespace <namespace> --local-port <port>

-r は --resource-name、-p は --local-port の短縮形です。このコマンドに --pod-name はありません。デバッグのために特定のアプリ Pod へ接続するには ags extend remote-debug connect を使用します。

Windows での Docker ログイン​

Windows の Docker Desktop は認証情報ヘルパーを通じてレジストリ認証情報を保存します。Extend レジストリが発行するトークンは約 2,924 バイトあり、Windows 資格情報マネージャーの 2,560 バイト制限を超えるため、ags extend docker-login および ags extend image-upload --login はネイティブ Windows では失敗します。--print および --print-format token オプションを使用してトークンを出力し、手動で docker login に渡してください。

ags extend docker-login --namespace <namespace> --app <app> --print --print-format token \
| docker login --username <username> --password-stdin <registry>

その他の Docker レジストリの問題については、AGS CLI for Extend ページの Docker ログインが失敗する を参照してください。

その他の変更点​

  • ags extend database-tunnel および ags extend remote-debug connect は実行中にセッションイベントを報告します。各イベント行にはコマンド開始からの経過時間が含まれるため、長いセッションがまだアクティブであることを確認できます。
  • ags extend remote-debug disable は実行中のアプリを再起動する前に確認を求めます。自動化でプロンプトをスキップするには --yes を渡してください。
  • 結果を返すコマンドは --format json による機械可読な出力をサポートします。ags extend database-tunnel はセッションイベントを stderr に書き、--format json はそれらのイベントを JSON に切り替えます。--no-input はインタラクティブプロンプトを無効にし、スクリプトや CI で使います。