Migrate from extend-helper-cli

Last updated on September 15, 2026

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

概要​

extend-helper-cli は引き続き使用できます。AGS CLI は現在すべての extend-helper-cli Service コマンドをカバーしており、ags csm に正規のアドレスを追加しています。以下に示す各コマンドは、移行期間中は ags extend ショートカットアドレスでも動作します。

サインイン​

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

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

コマンドマッピング​

extend-helper-cliAGS CLI（正規）AGS CLI（ショートカット）
extend-helper-cli create-appags csm apps createags extend create-app
extend-helper-cli get-app-infoags csm apps getags extend get-app-info
extend-helper-cli list-imagesags csm images listags extend list-images
extend-helper-cli deploy-appags csm deployments createags extend deploy-app
extend-helper-cli start-appags csm apps startags extend start-app
extend-helper-cli stop-appags csm apps stopags extend stop-app
extend-helper-cli delete-appags csm apps deleteags extend delete-app
extend-helper-cli remote-debug enableags csm debug updateags extend remote-debug enable
extend-helper-cli remote-debug disableags csm debug updateags extend remote-debug disable
extend-helper-cli appui createags csm app-ui createags extend app-ui create

新しいスクリプトには正規の ags csm アドレスを使用してください。ags extend ショートカットは移行をスムーズに行うために存在し、extend-helper-cli と同じ呼び出し形式に従っています。

注記

remote-debug enable および remote-debug disable ショートカットは、実行前に確認を求めます。アプリのステータスを最初に読み取り、アプリが予期した状態にない場合は一時停止します。旧来のツールはこの動作を行いませんでした。

ags extend で既に利用可能なコマンド​

以下のコマンドは AGS CLI でも変更なく同じアドレスで動作します。

  • ags extend clone-template
  • ags extend docker-login
  • ags extend image-upload
  • ags extend tunnel
  • ags extend update-var
  • ags extend update-secret
  • ags extend app-ui upload および ags extend app-ui setup-env
  • 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 レジストリの問題については、extend-helper-cli ガイドの Docker ログインが失敗する を参照してください。そこに示された原因と解決策は AGS CLI にも適用されます。

その他の変更点​

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