本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 更新容器機群的Amazon GameLift Servers容器群組定義
<a name="containers-modify-groups"></a>

您可以更新容器群組定義的大部分屬性，包括個別容器定義。容器群組定義具有版本編號。當您更新容器群組定義時， 會Amazon GameLift Servers儲存更新並遞增定義的版本編號。設定容器機群時，您可以指定要部署的容器群組定義版本。

更新容器群組定義後，您可以將新版本部署到新的或現有的容器機群。

## 更新遊戲伺服器容器群組定義
<a name="containers-modify-groups-edit"></a>

本主題說明如何使用Amazon GameLift Servers主控台或 CLI AWS 工具更新遊戲伺服器容器群組定義。如需選用功能的詳細資訊，請參閱 [自訂Amazon GameLift Servers容器機群](containers-design-fleet.md)。

**若要更新容器群組定義：**

------
#### [ Console ]

在 [Amazon GameLift Servers主控台](https://console.aws.amazon.com/gamelift/)中，選取您要建立容器群組的 AWS 區域 。

開啟主控台的左側導覽列，然後選擇**受管容器：群組定義**。在容器群組定義頁面上，選擇要更新的容器群組定義和版本。

儲存更新之後，您可以使用新版本建立新的容器機群，也可以將更新部署到現有的容器機群。

**步驟 1：定義容器群組定義詳細資訊**
+ 您可以更新總記憶體和 vCPU 限制設定。

**步驟 2：新增容器定義**

您可以進行下列容器定義更新：
+ 更新現有的容器定義。
+ 新增支援容器定義。
+ 移除支援容器定義。

1. 您可以更新 **ECR 映像 URI**。請務必更新**伺服器 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保留您未包含在更新請求中的任何值。如果您要變更容器定義。不過，變更容器定義時，請提供完整的集合。

**更新容器群組定義**  
若要更新新的容器群組定義，請使用 CLI `update-container-group-definition` 命令。如需此命令的詳細資訊，請參閱 *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
```

------

## 複製容器群組定義
<a name="containers-create-groups-clone"></a>

您可以使用 Amazon GameLift Servers主控台來複製現有的容器群組定義。

**複製容器群組**

1. 在 [Amazon GameLift Servers主控台](https://console.aws.amazon.com/gamelift/)中，前往左側導覽窗格，然後選擇**容器群組**。

1. 在**容器群組**清單頁面上，選取要複製的現有容器群組。選取容器群組後，**複製**按鈕會處於作用中狀態。

1. 選擇**複製**。此動作會使用預先填入的設定開啟容器群組建立精靈。

1. 輸入複製的容器群組的新名稱。相同區域中的容器群組必須具有唯一的名稱。

1. 逐步完成容器群組和容器定義頁面、檢閱和**建立新的**容器群組。