コンテナフリートの Amazon GameLift Servers コンテナグループ定義を更新する - Amazon GameLift Servers
ゲームサーバーコンテナグループ定義を更新するコンテナグループ定義のクローンを作成する

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

コンテナフリートの Amazon GameLift Servers コンテナグループ定義を更新する

個々のコンテナ定義を含め、コンテナグループ定義のほとんどのプロパティを更新できます。コンテナグループ定義にはバージョン番号があります。コンテナグループ定義を更新すると、Amazon GameLift Servers は更新を保存し、定義のバージョン番号を増分します。コンテナフリートを構成するときに、どのバージョンのコンテナグループ定義をデプロイするかを指定できます。

コンテナグループ定義を更新した後、新しいバージョンを新規または既存のコンテナフリートにデプロイできます。

ゲームサーバーコンテナグループ定義を更新する

このトピックでは、Amazon GameLift Servers コンソールまたは AWS CLI ツールを使用してゲームサーバーコンテナグループ定義を更新する方法について説明します。オプション機能の詳細については、「Amazon GameLift Servers コンテナフリートをカスタマイズする」を参照してください。

コンテナグループ定義を更新するには:

Console

Amazon GameLift Servers コンソールで、コンテナグループを作成する AWS リージョン を選択します。

コンソールの左側のナビゲーションバーを開き、[マネージドコンテナ: グループ定義] を選択します。コンテナグループ定義ページで、更新するコンテナグループ定義とバージョンを選択します。

更新を保存したら、新しいバージョンを使用して新しいコンテナフリートを作成するか、既存のコンテナフリートに更新をデプロイできます。

ステップ 1: コンテナグループ定義の詳細を定義する

  • 合計メモリと vCPU の制限設定を更新できます。

ステップ 2: コンテナ定義を追加する

次のコンテナ定義を更新できます。

  • 既存のコンテナ定義を更新します。

  • 新しいサポートコンテナ定義を追加します。

  • サポートコンテナ定義を削除します。

  1. ECR イメージ URI を更新できます。新しいイメージと一致するように Server SDK バージョン設定を更新してください。

  2. 必要に応じて内部コンテナのポート範囲を更新できます。これらの設定を変更すると、これらの変更がフリートにデプロイされると、コンテナフリートの接続ポート設定に影響する可能性があります。詳細については、「ネットワーク接続を構成する」を参照してください。

ステップ 3: 依存関係を設定する
ステップ 3: 確認して作成する

  • コンテナグループ定義の更新を確認します。編集を使用して、任意のセクションで追加の変更を加えます。完了したら、作成を選択してコンテナグループ定義の新しいバージョンを生成します。

    リクエストが成功すると、コンソールに新しいコンテナグループ定義リソースの詳細ページが表示されます。最初、ステータスは COPYING です。Amazon GameLift Servers はグループのすべてのコンテナイメージのスナップショットの作成を開始します。このフェーズが完了すると、コンテナグループ定義のステータスは READY に変わります。コンテナグループ定義でコンテナフリートを作成する前に、コンテナグループ定義が READY ステータスになっている必要があります。

AWS CLI

AWS CLI を使用してコンテナグループ定義を作成する場合は、コンテナ定義の設定を別の JSON ファイルに維持します。CLI コマンドでファイルを参照できます。スキーマの例については、「コンテナ定義JSONファイルを作成する」を参照してください。

定義を更新するときは、更新する値を指定するだけで済みます。Amazon GameLift Servers は、更新リクエストに含まれていない値を保持します。コンテナ定義を変更する場合。ただし、コンテナ定義を変更する場合は、完全なセットを指定します。

コンテナグループ定義を更新するには

新しいコンテナグループ定義を更新するには、update-container-group-definition CLI コマンドを使用します。このコマンドの詳細については、「AWS CLI コマンドリファレンス」の「update-container-group-definition」を参照してください。

例: ゲームサーバーコンテナグループ

コンテナグループ定義を取得、更新、または削除するとき、またはコンテナフリートを作成または更新するときに、コンテナグループ定義バージョンを指定できます。各コンテナグループ定義にはバージョンプロパティがあります。さらに、定義の ARN 値はバージョン番号を指定します。

この例は、ゲームサーバーコンテナグループ定義の変更要求を示しています。このグループのコンテナ定義を含む JSON ファイルを作成済みであることを前提としています。この例では、定義名に ARN 値を使用し、更新をバージョン 1 に指定します。

aws gamelift update-container-group-definition \
    --name arn:aws:gamelift:us-west-2:111122223333:containergroupdefinition/MyAdventureGameContainerGroup:1 \
    --operating-system AMAZON_LINUX_2023 \
    --container-group-type GAME_SERVER \
    --total-memory-limit-mebibytes 4096 \
    --total-vcpu-limit 1 \
    --container-definitions file://SimpleServer.json

コンテナグループ定義のクローンを作成する

Amazon GameLift Servers コンソールを使用して、既存のコンテナグループ定義のクローンを作成できます。

コンテナグループのクローンを作成するには

  1. Amazon GameLift Servers コンソールの左側のナビゲーションペインで、[コンテナグループ] を選択します。

  2. コンテナグループリストページで、クローンを作成する既存のコンテナグループを選択します。コンテナグループを選択すると、[クローン] ボタンがアクティブになります。

  3. [クローンを作成] を選択します。このアクションにより、事前入力された設定でコンテナグループ作成ウィザードが開きます。

  4. クローンされたコンテナグループの新しい名前を入力します。同じリージョンのコンテナグループには一意の名前が必要です。

  5. コンテナグループとコンテナ定義ページをステップスルーし、新しいコンテナグループを確認して作成します。