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 で変更してください。
まだその IAM クライアントをお持ちでない場合は、ログインプロンプトから作成してください:
-
Client ID プロンプトで Enter を押してください。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 を Client ID プロンプトに貼り付けてください。
CI ログイン(クライアント認証情報)
ags auth login --grant client-credentials
CI パイプラインやサービスアカウントで使用します。コンフィデンシャル IAM クライアントとクライアントシークレットが必要です。クライアントシークレットは CI のシークレット変数として保存してください。ログイン後、同じセッション内の後続の ags コマンドは、毎回認証情報を渡すことなく保存済みトークンを使用します。