翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# コンテナフリートの Amazon GameLift Servers コンテナグループ定義を更新する
個々のコンテナ定義を含め、コンテナグループ定義のほとんどのプロパティを更新できます。コンテナグループ定義にはバージョン番号があります。コンテナグループ定義を更新すると、Amazon GameLift Servers は更新を保存し、定義のバージョン番号を増分します。コンテナフリートを構成するときに、どのバージョンのコンテナグループ定義をデプロイするかを指定できます。
コンテナグループ定義を更新した後、新しいバージョンを新規または既存のコンテナフリートにデプロイできます。
## ゲームサーバーコンテナグループ定義を更新する
このトピックでは、 Amazon GameLift Serversコンソールまたは AWS CLI ツールを使用してゲームサーバーコンテナグループ定義を更新する方法について説明します。オプション機能の詳細については、「[Amazon GameLift Servers コンテナフリートをカスタマイズする](containers-design-fleet.md)」を参照してください。
**コンテナグループ定義を更新するには:**
------
#### [ Console ]
[Amazon GameLift Servers コンソール](https://console.aws.amazon.com/gamelift/)で、コンテナグループ AWS リージョン を作成する を選択します。
コンソールの左側のナビゲーションバーを開き、**[マネージドコンテナ: グループ定義]** を選択します。コンテナグループ定義ページで、更新するコンテナグループ定義とバージョンを選択します。
更新を保存したら、新しいバージョンを使用して新しいコンテナフリートを作成するか、既存のコンテナフリートに更新をデプロイできます。
**ステップ 1: コンテナグループ定義の詳細を定義する**
+ 合計メモリと vCPU の制限設定を更新できます。
**ステップ 2: コンテナ定義を追加する**
次のコンテナ定義を更新できます。
+ 既存のコンテナ定義を更新します。
+ 新しいサポートコンテナ定義を追加します。
+ サポートコンテナ定義を削除します。
1. **ECR イメージ URI **を更新できます。新しいイメージと一致するように **Server SDK バージョン**設定を更新してください。
1. 必要に応じて**内部コンテナのポート範囲**を更新できます。これらの設定を変更すると、これらの変更がフリートにデプロイされると、コンテナフリートの接続ポート設定に影響する可能性があります。詳細については、[ネットワーク接続を構成する](containers-design-fleet.md#containers-custom-network)を参照してください。
**ステップ 3: 依存関係を設定する**
+ 必要に応じて依存関係を変更できます。詳細については、「[コンテナの依存関係の設定](containers-design-fleet.md#containers-design-fleet-dependencies)」を参照してください。
**ステップ 3: 確認して作成する**
+ コンテナグループ定義の更新を確認します。**編集**を使用して、任意のセクションで追加の変更を加えます。完了したら、**作成**を選択してコンテナグループ定義の新しいバージョンを生成します。
リクエストが成功すると、コンソールに新しいコンテナグループ定義リソースの詳細ページが表示されます。最初、ステータスは `COPYING` です。Amazon GameLift Servers はグループのすべてのコンテナイメージのスナップショットの作成を開始します。このフェーズが完了すると、コンテナグループ定義のステータスは `READY` に変わります。コンテナグループ定義でコンテナフリートを作成する前に、コンテナグループ定義が `READY` ステータスになっている必要があります。
------
#### [ AWS CLI ]
AWS CLI を使用してコンテナグループ定義を作成または更新する場合は、コンテナ定義の設定を別の`JSON`ファイルに維持します。CLI コマンドでファイルを参照できます。スキーマの例については、「[コンテナ定義`JSON`ファイルを作成する](containers-create-groups.md#containers-definitions-create)」を参照してください。
定義を更新するときは、更新する値を指定するだけで済みます。Amazon GameLift Servers は、更新リクエストに含まれていない値を保持します。コンテナ定義を変更する場合。ただし、コンテナ定義を変更する場合は、完全なセットを指定します。
**コンテナグループ定義を更新するには**
新しいコンテナグループ定義を更新するには、`update-container-group-definition` CLI コマンドを使用します。このコマンドの詳細については、「*AWS CLI コマンドリファレンス*」の「[update-container-group-definition](https://docs.aws.amazon.com/cli/latest/reference/gamelift/update-container-group-definition.html)」を参照してください。
**Example : ゲームサーバーコンテナグループ**
コンテナグループ定義を取得、更新、または削除するとき、またはコンテナフリートを作成または更新するときに、コンテナグループ定義バージョンを指定できます。各コンテナグループ定義にはバージョンプロパティがあります。さらに、定義の 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 コンソール](https://console.aws.amazon.com/gamelift/)の左側のナビゲーションペインで、**[コンテナグループ] **を選択します。
1. **コンテナグループ**リストページで、クローンを作成する既存のコンテナグループを選択します。コンテナグループを選択すると、**[クローン]** ボタンがアクティブになります。
1. **[クローンを作成]** を選択します。このアクションにより、事前入力された設定でコンテナグループ作成ウィザードが開きます。
1. クローンされたコンテナグループの新しい名前を入力します。同じリージョンのコンテナグループには一意の名前が必要です。
1. コンテナグループとコンテナ定義ページをステップスルーし、新しいコンテナグループを確認して**作成**します。