기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # 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**를 업데이트할 수 있습니다. 새 이미지와 일치하도록 **서버 SDK 버전** 설정을 업데이트해야 합니다. 1. 필요에 따라 **내부 컨테이너 포트 범위**를 업데이트할 수 있습니다. 이러한 설정을 변경하면 이러한 변경 사항이 플릿에 배포될 때 컨테이너 플릿의 연결 포트 설정에 영향을 미칠 수 있습니다. 자세한 내용은 [네트워크 연결 구성](containers-design-fleet.md#containers-custom-network) 섹션을 참조하세요. **3단계: 종속성 구성** + 필요에 따라 종속성을 변경할 수 있습니다. 자세한 내용은 [컨테이너 종속성 설정](containers-design-fleet.md#containers-design-fleet-dependencies) 단원을 참조하십시오. **3단계: 검토 및 생성** + 컨테이너 그룹 정의 업데이트를 검토합니다. **편집**을 사용하여 모든 섹션에 추가 변경 사항을 적용합니다. 완료되면 **생성**을 선택하여 컨테이너 그룹 정의의 새 버전을 생성합니다. 요청이 성공하면 콘솔에 새 컨테이너 그룹 정의 리소스에 대한 세부 정보 페이지가 표시됩니다. Amazon GameLift Servers가 그룹에 대한 모든 컨테이너 이미지의 스냅샷을 생성하기 시작하므로 처음에 상태는 `COPYING`입니다. 이 단계가 완료되면 컨테이너 그룹 정의 상태가 `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. 컨테이너 그룹 및 컨테이너 정의 페이지를 단계별로 살펴보고 새 컨테이너 그룹을 검토 및 **생성**합니다.