Release 0.5.0

Last updated on September 15, 2026

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

概要​

AGS CLI 0.5.0 は、2026 年 7 月 21 日の 0.4.0 以来初のリリースです。アーリープレビューとして 3 つの新機能エリアを追加しています: 統合 Extend ツール、AMS イメージアップロード、カスタムワークフローファイル。また、全プラットフォーム向けのワンコマンドインストーラーと自動更新通知も導入しています。アーリープレビューエリアのコマンド名、フラグ、ファイルフォーマットはまだ変更される可能性があるため、今のところそれらに対する自動化の構築は避けてください。

ハイライト​

統合 Extend ツール（アーリープレビュー）​

extend-helper-cli のコマンドが AGS CLI 内で利用可能になりました。これによりひとつのツールで両方をカバーできます。

ags extend の新しいコマンド:

  • ags extend clone-template: Extend アプリのスターターテンプレートをクローンします
  • ags extend docker-login: Extend コンテナレジストリにログインします
  • ags extend image-upload: コンテナイメージをビルドして Extend レジストリにプッシュします
  • ags extend tunnel: Extend アプリの Pod への TCP トンネルを開きます
  • ags extend update-var および ags extend update-secret: CSM アプリの設定変数とシークレットを更新または作成します
  • ags extend app-ui create、upload、setup-env: Extend App UI の作成、アップロード、設定を行います
  • ags extend remote-debug enable、disable、connect: リモートデバッグセッションを管理します

ags extend --help には、extend-helper-cli の呼び出し形式に合わせた移行ショートカットも一覧表示されます。各ショートカットには転送先の正規の ags csm アドレスが表示されるため、永続的なアドレスを確認し、準備ができたらスクリプトを更新できます。

AGS CLI の Extend ショートカット

AMS イメージアップロード（アーリープレビュー）​

別のツールなしに専用サーバーイメージを AMS にアップロードできるようになりました。

ags ams upload --path ./build --executable server --image-name my-server-image

このコマンドはビルドディレクトリをアーカイブし、アップロードし、ひとつのステップでイメージを登録します。Create と Update を持つ AMS:UPLOAD 権限が必要で、名前空間なしで入力します。これは ags ams images の背後にある AMS:IMAGE 権限とは異なるため、イメージをリスト表示できることだけでは不十分です。

専用サーバーイメージのアップロード

カスタムワークフローファイル（アーリープレビュー）​

CLI に同梱されている組み込みワークフローに加えて、YAML で独自のワークフローファイルを記述して実行できるようになりました。

コマンド実行内容
ags workflow templateスキーマがインラインで文書化されたスターターワークフローファイルを生成します
ags workflow add <file>ID で実行できるようにワークフローファイルを登録します
ags workflow remove <id>登録済みワークフローを削除します
ags workflow run <id>登録済みワークフローを実行します

ワークフローのステップは AGS オペレーションを呼び出すか、組み込みセットのローカルアクションを実行できます。ワークフローの入力はファイルピッカーとして宣言でき、パスの入力を求める代わりにディレクトリブラウザーを開きます。

すべてのワークフローファイルは、記述の対象としたプロトコルバージョンを宣言します。

workflow_protocol_version: "1.0.0"

このフィールドがないファイルや、有効なバージョン番号ではない値を宣言したファイルは、ags workflow add で拒否されます。ags workflow template は、このフィールドが入力済みのスターターファイルを生成します。宣言されたバージョンが CLI のサポートするバージョンと異なる場合、ワークフローの実行時に CLI が短いメモを出力します。

ワークフローの作成

インストーラーと更新通知​

以前のリリースでは、自分でダウンロードして解凍する必要があるアーカイブを公開していました。0.5.0 では macOS、Linux、Windows 向けのワンコマンドインストーラーが追加されました。

# macOS および Linux
curl --proto '=https' --tlsv1.2 -LsSf \
  https://github.com/AccelByte/accelbyte-ags-cli/releases/latest/download/accelbyte-ags-cli-installer.sh | sh

# Windows (PowerShell にて)
powershell -ExecutionPolicy Bypass -c \
  "irm https://github.com/AccelByte/accelbyte-ags-cli/releases/latest/download/accelbyte-ags-cli-installer.ps1 | iex"

# macOS および Linux (Homebrew にて)
brew install accelbyte/tap/ags-cli

インストーラーは macOS および Linux では ~/.cargo/bin に、Windows では %USERPROFILE%\.cargo\bin に ags を配置します。

CLI はコマンドを遅延させないバックグラウンドプロセスで 1 日 1 回、より新しいリリースが利用可能かどうかを確認するようになりました。新しいリリースが見つかった場合は標準エラー出力に 1 行を出力します。AGS_NO_UPDATE_CHECK=1 を設定するか、設定で update-check を false に設定するとこの機能をオフにできます。--format json を使用している場合、標準エラー出力がターミナルでない場合、または CI 環境では確認は実行されません。

テレメトリー​

CLI はデフォルトで匿名の使用データを記録するため、チームはどのコマンドが重要でどこで失敗するかを把握できます。DO_NOT_TRACK=1 を設定するとオフにできます。詳細については コマンド ページを参照してください。

完全なリリースノート​

変更点の完全なリスト、修正されたバグ、互換性に関する注意事項については、GitHub の 0.5.0 リリース を参照してください。

に最終更新
On this page