このページでは、Game Servers デプロイの作成、一覧表示、記述、更新を行う方法について説明します。デプロイメントにより、任意またはすべてのレルムにデプロイできる、1 つ以上のソフトウェア バージョンが管理されます。デプロイメントの作成、構成の追加、ロールアウトの方法のエンドツーエンドの例については、クラスタのスケーリング動作の構成をご覧ください。
始める前に
始める前に、Game Servers の概要の主なコンセプトを理解しておくことをおすすめします。次のタスクも完了していることを確認してください。
- Game Services API が有効になっていることを確認します。 Game Services API を有効にする
- gcloud CLI がインストールされているシェルを選択するか、API クライアントを使用します。
Google Cloud Console に移動します。
コンソールの右上隅にある [Cloud Shell をアクティブにする] ボタン をクリックします。
- サービス アカウントを作成する。
- 秘密鍵を JSON ファイルとしてダウンロードします。
-
環境変数
GOOGLE_APPLICATION_CREDENTIALS
を、認証情報を含む JSON ファイルのパスに設定します。この変数は現在のシェル セッションにのみ適用されるため、新しいセッションを開く場合は、変数を再度設定する必要があります。
Cloud Shell
Cloud Shell を起動するには、次の手順に従います。
コンソールの下部にあるフレーム内で Cloud Shell セッションが開きます。このシェルで gcloud
コマンドを実行します。
ローカルシェル
gcloud CLI をインストールします。
Google Cloud CLI に必要なデフォルトのプロジェクトが設定されていることを確認します(設定されていない場合、後でコマンドごとに --project
フラグを明示的に指定する必要があります)。
gcloud config list project
デフォルト プロジェクトを設定していない場合は、次のコマンドを実行して、デフォルト プロジェクトを設定します。PROJECT_ID
は、設定するプロジェクト ID に置き換えてください。
gcloud config set project PROJECT_ID
次のコマンドを実行して、Google Cloud CLI のバージョンを確認します。Game Servers には、gcloud CLI のバージョン 306.0.0
以降が必要です。
gcloud version
インストールを更新するには、次のコマンドを実行します。
gcloud components update
curl / PowerShell
REST API を curl
または Windows PowerShell で使用するには、次の操作を行います。
クライアント ライブラリ
Google Cloud Game Servers は、クライアント ライブラリを使用して、プログラムで制御できます。ライブラリと認証の手順については、クライアント ライブラリの概要をご覧ください。
Deployment を作成しています
Console
Google Cloud コンソールで、[Game Servers の Deployment] ページに移動します。
[デプロイメントの作成] をクリックします。
[名前] ボックスに、このデプロイの一意の識別子を入力します。
(省略可)[説明] ボックスに、このデプロイメントの説明を入力します。
[作成] をクリックします。
gcloud
Google Cloud CLI を使用してデプロイメントを作成できます。
デプロイメントを作成するには、次のコマンドを実行します。deploymentID は、適切な値に置き換えます。
gcloud game servers deployments create deploymentID
REST
リクエストのデータを使用する前に、次のように置き換えます。
- PROJECT_ID: IAM 設定に載っている Google Cloud プロジェクト ID。
- DEPLOYMENT_ID: 新しいデプロイメントのユーザー定義の識別子。
JSON 本文をリクエストします。
{ "name": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID", }
リクエストを送信するには、次のいずれかのオプションを展開します。
次のような JSON レスポンスが返されます。
{ "name": "projects/PROJECT_ID/locations/global/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.gaming.v1.OperationMetadata", "createTime": CREATE_TIME, "target": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID", "verb": "create", "requestedCancellation": false, "apiVersion": "v1" }, "done": false }
デプロイメントの一覧表示
Console
Google Cloud コンソールで、[Game Servers の Deployment] ページに移動します。
フィルタ ボックスを使用して、デプロイのリストをさまざまなプロパティでフィルタリングできます。
gcloud
Google Cloud CLI を使用してデプロイメントを一覧表示できます。
デプロイメントを一覧表示するには、次のコマンドを実行します。
gcloud game servers deployments list
REST
リクエストのデータを使用する前に、次のように置き換えます。
- PROJECT_ID: IAM 設定に載っている Google Cloud プロジェクト ID。
リクエストを送信するには、次のいずれかのオプションを展開します。
次のような JSON レスポンスが返されます。
{ "gameServerDeployments": [ { "name": "projects/PROJECT_ID/locations/global/gameServerDeployments/my-deployment-1", "createTime": CREATE_TIME, "updateTime": UPDATE_TIME, "etag": "RI8hTm3ZaMNZ3qRVeKVcxcN3W26_oR559JYofnFi69A" }, { "name": "projects/PROJECT_ID/locations/global/gameServerDeployments/my-deployment-2", "createTime": CREATE_TIME, "updateTime": UPDATE_TIME, "etag": "az38kwIY4X3WdP2SA0fkTGib9hwVj7iXLFXAtIzMLpc" } ] }
デプロイメントの詳細表示
Console
Google Cloud コンソールで、[Game Servers の Deployment] ページに移動します。
フィルタ ボックスを使用して、デプロイのリストをさまざまなプロパティでフィルタリングできます。
最後のテーブル列で、省略記号 more_vert をクリックし、[List configs] を選択します。このページで、デプロイメントのアクティブ構成と非アクティブ構成を確認できます。
デプロイの新しい構成を作成するには、[構成の作成] をクリックします。ロールアウトを更新するには、[Manage Rollout] をクリックします。
gcloud
作成時間や更新時間など、デプロイメントに関する詳細は、Google Cloud CLI を使用して取得できます。
デプロイメントを詳細表示するには、次のコマンドを実行します。deploymentID は、以前に作成したデプロイメントの ID に置き換えます。
gcloud game servers deployments describe deploymentID
REST
リクエストのデータを使用する前に、次のように置き換えます。
- PROJECT_ID: IAM 設定に載っている Google Cloud プロジェクト ID。
- DEPLOYMENT_ID: デプロイメントのユーザー定義の識別子。
リクエストを送信するには、次のいずれかのオプションを展開します。
次のような JSON レスポンスが返されます。
{ "name": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID", "createTime": CREATE_TIME, "updateTime": UPDATE_TIME, "etag": "RI8hTm3ZaMNZ3qRVeKVcxcN3W26_oR559JYofnFi69A" }
デプロイメントを更新する
gcloud
デプロイメントのフィールドを更新するには、既存のデプロイメントの deploymentID を置き換えてから gcloud game servers
deployments update
コマンドを実行します。次のコマンドは、デプロイの説明フィールドを更新します。
gcloud game servers deployments update deploymentID --description="My updated description"
他のデプロイ フィールドのフラグを確認するには、gcloud
リファレンスをご覧ください。
REST
次のサンプルでは、description
フィールドを更新します。他のフィールドを更新するには、フィールド名を ?updateMask=
クエリ パラメータに追加して、JSON 本文をリクエストします。
リクエストのデータを使用する前に、次のように置き換えます。
- PROJECT_ID: IAM 設定に載っている Google Cloud プロジェクト ID。
- DEPLOYMENT_ID: デプロイメントのユーザー定義の識別子。
JSON 本文をリクエストします。
{ "description": "My updated description" }
リクエストを送信するには、次のいずれかのオプションを展開します。
次のような JSON レスポンスが返されます。
{ "name": "projects/PROJECT_ID/locations/global/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.gaming.v1.OperationMetadata", "createTime": CREATE_TIME, "target": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID", "verb": "update", "requestedCancellation": false, "apiVersion": "v1" }, "done": false }
次のステップ
- 構成ファイルを作成する方法を学習する。
- ロールアウトを作成または更新する方法を学習する。
- デプロイメントを削除する方法を学習する。