Release 0.5.2

Last updated on October 9, 2026

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

概要​

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

既存のスクリプトは変更なしで動作し続けます。0.5.1 からアップグレードするには、ags update --install を実行してください。

ハイライト​

[Extend] Extend アプリのログをストリームする（アーリープレビュー）​

Extend アプリのコンテナログをターミナルから読み取れます。最新の行を出力することも、ライブで新しい行をフォローすることもできます。

ags extend logs stream --app my-app --namespace my-game             # 最新の行を表示して終了
ags extend logs stream --app my-app --namespace my-game --follow    # Ctrl+C を押すまでストリームを継続

--follow なしの場合、コマンドは最新の行（デフォルトはポッドごとに 100 行、--tail-lines で設定）を表示し、ストリームが終了すると終了します。--follow を指定すると、Ctrl+C を押すまで接続を保持し、到着した新しい行を出力し続けます。

ログ行は標準出力に、ステータス行は標準エラー出力に書き込まれるため、> app.log でログのみをキャプチャできます。スクリプトでは --format json を使用してください: すべてのイベント（各ログ行を含む）が 1 行ごとに 1 つの JSON オブジェクトとして出力されます。

プラットフォームは約 10 分ごとに長時間の接続を切断します。--follow を使用すると、コマンドは自動的に再接続し、最後に表示した行の後から再開し、同じ行を 2 回表示しません。1 回の実行で最大 5 回再接続した後、コード 4 で終了します。続きを再開するには、再度実行してください。

--pods はストリームするポッドの数を設定します（デフォルト 1。サーバーは最大 5 つを受け入れます）。--since-seconds は出力を最新の行に制限します。--previous は各ポッドの直前のコンテナのログを表示し、コンテナが再起動前にクラッシュした原因を確認できます。

このコマンドには ADMIN:NAMESPACE:{namespace}:EXTEND:APP [READ] 権限が必要です。名前空間は同時に最大 10 個のログストリームを開くことができます。Ctrl+C で停止したストリームも、約 1 分間その制限にカウントされます。

このコマンドは extend-helper-cli logs stream の置き換えです。extend-helper-cli からの移行 を参照してください。

接続が切断されても Extend アプリのログをフォローする

[全般] ログインプロンプトから IAM クライアントを作成する​

ags auth login には、リダイレクト URI として http://127.0.0.1:8080 が設定されたパブリック IAM クライアントが必要です。まだお持ちでない場合は、ログインプロンプトから作成してください:

  1. Client ID プロンプトで Enter を押してください。CLI は Admin Portal の IAM クライアントフォームへのリンクを表示します。そのリンクは AGS CLI テンプレートを選択します。

  2. リンクを開き、クライアントを作成してください。Admin Portal に AGS CLI テンプレートがない場合、フォームは空で開きます。CLI は入力すべき内容を一覧表示します:

    If the form is empty, enter:
        Client Type:   Public
        Client Name:   AGS CLI
        Redirect URI:  http://127.0.0.1:8080

    --port で 8080 以外のポートを指定してログインする場合は、クライアントのリダイレクト URI を http://127.0.0.1:<port> に設定してください。これは、フォームが AGS CLI テンプレートを使用している場合でも、空で開く場合でも適用されます。CLI はリンクの下に同じリマインダーを表示します。また、CLI が一覧表示するリダイレクト URI はそのポートを使用します。

  3. 新しいクライアントの ID を Client ID プロンプトに貼り付けてください。

リンクは --namespace、AGS_NAMESPACE、またはプロファイルの名前空間を使用します。いずれも設定されていない場合、CLI が入力を求めます。これはブラウザログインにのみ適用されます。クライアントクレデンシャルログイン（--grant client-credentials）は変更ありません。

改善​

  • [全般] --port を使用して 8080 以外のポートでログインした場合、CLI は IAM クライアントのリダイレクト URI が http://127.0.0.1:<port> でなければならないことを警告します。IAM はブラウザをクライアントの登録済みリダイレクト URI に送信するため、不一致が発生するとログインはタイムアウトするまで待機し、その理由が表示されませんでした。

完全なリリースノート​

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

に最終更新
On this page