Install and sign in
注釈:本資料はAI技術を用いて翻訳されています。
概要
AGS CLI をインストールして、AGS 環境にサインインします。
インストール
Homebrew (macOS)
brew install accelbyte/tap/ags-cli
Homebrew ユーザーは通常の brew upgrade フローで更新を受け取れます。
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 -ExecutionPolicy Bypass -c "irm https://github.com/AccelByte/accelbyte-ags-cli/releases/latest/download/accelbyte-ags-cli-installer.ps1 | iex"
AGS CLI のバイナリはまだコード署名されていません。初回起動時にオペレーティングシステムが警告を表示する場合があります。macOS では、システム設定でバイナリのプロパティを開いて実行を許可してください。Windows では、SmartScreen に促された場合は Run anyway を選択してください。
サインイン
ブラウザログイン(インタラクティブ)
ags auth login
ブラウザウィンドウが開き、サインインフローが完了します。リダイレクト URI として http://127.0.0.1:<port> が設定されたパブリック IAM クライアントが必要です。デフォルトのポートは 8080 です。そのポートが使用中の場合は --port で変更してください。
フラグ、環境変数、またはプロファイルで設定しない限り、CLI は 2 つの値を入力するよう求めます:
- Base URL: ゲームの AGS 環境のアドレスです。たとえば
https://<YourStudioID>-<YourTitleID>.prod.gamingservices.accelbyte.ioです。<YourStudioID>-<YourTitleID>を、ゲームの Namespace ID に置き換えてください。これは、スタジオ ID とゲームのタイトル ID をハイフンでつなげたものです。Admin Portal はスタジオのアドレスで開きますが、これはゲームの Base URL ではありません。 - Client ID: IAM クライアントの ID です。たとえば
2c7308eb4f3d48e3b892fa0794f14a9cです。クライアント名ではありません。
CLI は、ブラウザを開く前に、IAM でクライアントを確認します:
- IAM が認識しない ID を入力すると、プロンプトが再度表示されます。3 回続けて拒否されると、コマンドは停止します。
- ID が
--client-id、AGS_CLIENT_ID、またはプロファイルから取得されたもので、IAM がその ID を認識しない場合、コマンドはエラーで停止します。 - CLI が IAM に接続できない場合は、警告が表示され、ログインは続行されます。
- クライアントのリダイレクト URI がこのログインに戻れない場合 (たとえば別のポートを使用している場合) は、CLI がブラウザを待つ前に警告とヒントを表示します。
ブラウザを開く前に、CLI はサインインに使用するクライアントを表示します: Signing in with IAM client <id>。
まだその IAM クライアントをお持ちでない場合は、ログインプロンプトから作成してください:
-
Client ID プロンプトで Enter を押してください。CLI がクライアントを作成する namespace を尋ねた場合は、入力してください。CLI は Admin Portal の IAM クライアントフォームへのリンクを表示します。そのリンクは AGS CLI テンプレートを選択し、リダイレクト URI として
http://127.0.0.1:8080が設定されたパブリッククライアントを作成します。 -
リンクを開き、クライアントを作成してください。Admin Portal に AGS CLI テンプレートがない場合、フォームは空で開きます。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 はリンクの下に同じリマインダーを表示します。 -
新しいクライアントの ID を
Paste the new client's Client ID:プロンプトに貼り付けてください。
CI ログイン(クライアント認証情報)
ags auth login --grant client-credentials
CI パイプラインやサービスアカウントで使用します。コンフィデンシャル IAM クライアントとクライアントシークレットが必要です。クライアントシークレットは CI のシークレット変数として保存してください。ログイン後、同じセッション内の後続の ags コマンドは、毎回認証情報を渡すことなく保存済みトークンを使用します。