Release 0.5.1

Last updated on September 24, 2026

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

概要

AGS CLI 0.5.1 は 0.5.0 に対するパッチリリースです。以下の各項目には、影響する領域を示すタグを付けています: [Extend]、[AMS]、[全般]。

セキュリティアセスメントは Admin Portal からも利用できます。AGS 2026.5.1 リリースノート を参照してください。

既存のスクリプトに影響する変更がひとつあります: ags ams upload は結果を標準エラー出力ではなく標準出力に書き込むようになりました。改善 を参照してください。

ハイライト

[Extend] Extend アプリのセキュリティアセスメント（アーリープレビュー）

Extend アプリのエンドポイントに対してペネトレーションテストを依頼し、完了後にレポートをダウンロードできます。

ags extend security-assessment request --app my-app --namespace my-game
ags extend security-assessment result --app my-app --namespace my-game

request はアプリのテスト可能なエンドポイントを検出し、対象に含めるものを選択させます。対話式のチェックリストを省略するには、--all-endpoints を渡すか、--operation-ids にリストを渡してください。

PUT、PATCH、DELETE を受け付けるエンドポイントは、リクエストの送信前に一覧表示され、確認を求められます。アセスメントがそれらのエンドポイントを通じて既存データを変更または削除するテストケースを生成する可能性があるためです。確認を省略するには --yes を渡します。スクリプトではこのフラグが必要です。

--wait を追加すると、エンゲージメントが COMPLETED または FAILED に達するまで処理をブロックします。10 秒ごとにポーリングし、上限は --wait-limit 秒（デフォルト 1800）です。待機時間を超過した場合の終了コードは 6 で、API エラーの 3 とは区別されます。これにより、スクリプトは「エンゲージメントはまだ完了する可能性がある」状態と「サーバーが拒否した」状態を判別できます。

result はアプリの完了済みエンゲージメントを一覧表示し、レポートを PDF または Markdown としてダウンロードします。macOS と Linux では、ファイルは所有者のみが読み取れるパーミッションで書き込まれます。

このコマンドを使うには、アプリが実行中であり、CSM がそのアプリの OpenAPI 仕様を検出済みである必要があります。また、セキュリティアセスメントのエンドポイントを提供する CSM のバージョンが必要なため、すべての環境で利用できるわけではありません。

アセスメントの対象範囲、アプリのエンドポイントを準備する方法、および管理ポータルからの同じワークフローについては、セキュリティアセスメントのリクエストを参照してください。

[全般] CLI から CLI を更新する

0.5.0 では、新しいリリースが存在する場合に通知を表示していました。0.5.1 では、その通知に対して実行できるコマンドを追加します。

ags update             # 新しいリリースの有無を報告し、アップグレードコマンドを表示します
ags update --install   # 確認後、このコピーをその場でアップグレードします

ags update は GitHub に最新リリースを問い合わせ、このコピーのインストール方法（インストーラースクリプト、Homebrew、手動ダウンロード）に応じたアップグレードコマンドをひとつだけ表示します。このコマンド自体は何も変更しません。スクリプトでは --format json を使用してください。

ags update --install は最新リリースのインストーラースクリプトをダウンロードし、このコピーに対して実行します。実行前に確認を求め、スクリプトでは --yes がその確認に応答します。以前のバイナリは新しいバイナリの隣に保持され、アップグレードが失敗した場合は復元されます。Homebrew でインストールされたコピーは、その管理を Homebrew が担っているため拒否され、代わりに ags update が brew コマンドを表示します。

CLI が指示なく自身を更新することはありません。コマンドを入力するまで何も起こりません。

[全般] 別のツールに渡すためにセッショントークンを表示する

ags auth token は現在のアクセストークンのみを標準出力に表示します。これにより、別のツールが独自にログインすることなく、既存のセッションを再利用できます。

curl -H "Authorization: Bearer $(ags auth token)" https://your-namespace.accelbyte.io/...

トークンは API 呼び出しと同じ方法で解決され、期限切れの場合は更新も行われます。したがって、表示されるトークンは次のリクエストが送信するものと同一です。トークンは標準出力にのみ書き込まれ、標準エラー出力やテレメトリーには送られません。--format json を使うと、有効期限とトークンの取得元が追加されます。

改善

[AMS] ags ams upload が結果を標準出力に書き込むようになりました

イメージ ID、アーキテクチャ、エントリーポイント、アーカイブサイズ、アップロードホストを含む結果ブロックは標準出力に出力されます。Image "<name>" uploaded のバナーは標準エラー出力に出力されます。

これまでは逆であったため、ags ams upload ... > result.txt はバナーを保存し、イメージ ID を失っていました。ターミナルでは引き続きバナーが結果ブロックより先に表示され、--format json の出力は変更ありません。

このコマンドの出力を読み取るスクリプトを確認してください

イメージ ID は標準エラー出力ではなく、標準出力から読み取ってください。

[Extend] アプリ操作の完了を待機する（アーリープレビュー）

ags extend create-app、deploy-app、start-app、stop-app、delete-app は --wait を受け付けます。これは操作が完了するまで処理をブロックし、--wait-interval（デフォルト 10 秒）と --wait-limit（デフォルト 600 秒）を指定できます。extend-helper-cli と同じ形式のため、移行したスクリプトはそのままの形で動作します。

待機時間を超過した場合の終了コードは 6 で、API エラーの 3 とは区別されます。これにより CI ジョブは「まだ実行中」と「失敗した」を判別できます。

[Extend] アプリライフサイクルコマンドが CSM v5 API を使用します（アーリープレビュー）

deploy-app、delete-app、get-app-info、start-app、stop-app、list-images は CSM v5 のエンドポイントを呼び出すようになり、update-secret と update-var も同様に移行します。v5 のエンドポイントは今後の標準インターフェースであり、サービス間で一貫したコントラクトとより優れたトランザクション処理を提供します。置き換えられる従来の v2 のエンドポイントは廃止される予定です。v5 のエンドポイントは v2 と同じ IAM 権限リソースを使用するため、これまで動作していたロールはそのまま動作します。

アップグレードすると、コマンドカタログは自動的に更新されます。CLI はカタログをキャッシュし、CLI のバージョンが変わるとそのキャッシュを破棄するため、アップグレード後に ags refresh-specs を実行する必要はありません。

その他の改善

• [Extend] ags extend <shortcut> --help は、入力していないコマンドの使用法ではなく、そのショートカット自身のヘルプページを表示します。
• [AMS] 最初の進捗行 Validating <directory> は標準エラー出力の通常の行として書き込まれるため、出力を取得した実行でも表示されます。これまでは一時的なステータス表示であったため、ターミナルでは上書きされ、出力を取得した実行では完全に失われていました。
• [全般] コマンドが複数の API バージョンに存在する場合、出力に使用したバージョンが表示されます。このラベルは標準エラー出力に出力されるため、スクリプトが解析する --format json の出力は変更されません。

バグ修正

• [Extend] ags extend deploy-app --wait と start-app --wait は、アプリが起動後にクラッシュした場合（不正なイメージ、レディネスチェックの失敗、クラッシュループなど）、ロールアウトの失敗を速やかに報告します。これまでは上限時間まで待機したうえでタイムアウトを報告していました。
• [Extend] ags extend deploy-app --wait は、実行中の任意のデプロイではなく、待機対象として指示されたデプロイをアプリが報告していることを確認します。
• [AMS] エラーメッセージは、解決後のパスではなく、入力したままの --executable の値を引用します。
• [AMS] アップロードの最終処理中に 403 が返された場合、権限全体が不足していると示唆するのではなく、AMS:UPLOAD の Update アクションが不足していると表示します。
• [AMS] ags ams upload --dry-run は、実際のアップロードと同じ方法で --upload-url を検証します。これにより、不正な値は検証されずにそのまま返されるのではなく、ドライランの時点で失敗します。
• [全般] DO_NOT_TRACK のオプトアウトリンクは https://donottrack.sh を指します。以前のドメインは無関係なコンテンツを配信しています。

完全なリリースノート

変更点の完全なリストについては、GitHub の 0.5.1 リリース を参照してください。