Migrate from extend-helper-cli
注釈:本資料は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-cli | AGS CLI |
|---|---|
extend-helper-cli create-app --scenario service-extension --confirm | ags extend create-app --json '{"scenario":"service-extension"}' --yes |
extend-helper-cli get-app-info | ags extend get-app-info |
extend-helper-cli get-app-info --path <field> | ags extend get-app-info --format json |
extend-helper-cli list-images | ags extend list-images |
extend-helper-cli deploy-app --image-tag v1.0.0 | ags extend deploy-app --json '{"imageTag":"v1.0.0"}' |
extend-helper-cli start-app / stop-app | ags extend start-app / ags extend stop-app |
extend-helper-cli delete-app --confirm | ags extend delete-app --yes |
extend-helper-cli dockerlogin | ags extend docker-login |
extend-helper-cli image-upload | ags extend image-upload |
extend-helper-cli tunnel | ags extend database-tunnel |
extend-helper-cli update-var / update-secret | ags 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 --confirm | ags extend remote-debug enable --yes |
extend-helper-cli logs stream | ags 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 で使います。