기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # Amazon GameLift Streams 스트림 그룹을 사용하여 스트리밍 관리 Amazon GameLift Streams 애플리케이션을 설정한 후에는 컴퓨팅 리소스를 관리하고 배포하여 애플리케이션을 실행하고 스트리밍할 준비가 되었습니다. Amazon GameLift Streams *스트림 그룹은* 이러한 컴퓨팅 리소스의 모음을 나타냅니다. 스트림 용량을 조정하여 지원할 최대 동시 스트림 수를 지정합니다. Amazon GameLift Streams는 스트림 그룹을 생성하는 AWS 리전 에 컴퓨팅 리소스를 할당합니다. 스트림 그룹에 원격 위치를 추가하고 위치당 용량을 관리할 수도 있습니다. 최종 사용자와 지리적으로 가까운 위치에서 스트림 세션을 호스팅하는 것이 가장 좋습니다. 이를 통해 지연 시간을 최소화하고 스트림 품질을 개선할 수 있습니다. 자세한 정보는 [AWS 리전 Amazon GameLift Streams에서 지원하는 및 스트리밍 위치](regions-quotas-rande.md) 섹션을 참조하세요. 스트림 그룹에서 스트림 그룹이 스트리밍할 수 있는 Amazon GameLift Streams 애플리케이션을 하나 이상 지정할 수 있습니다. 단일 애플리케이션은 여러 스트림 그룹에 있을 수 있으므로 동일한 애플리케이션을 스트리밍하도록 다양한 구성 또는 유형의 컴퓨팅 리소스를 설정할 수 있습니다. 예를 들어 애플리케이션을 스트리밍하기 위한 두 가지 그래픽 품질 옵션을 제공하기 위해 서로 다른 스트림 클래스 구성으로 두 개의 스트림 그룹을 설정하고 동일한 애플리케이션에 연결할 수 있습니다. 반대로 단일 스트림 그룹에는 스트림 그룹을 생성할 때 설정할 수 있는 *기본 애플리케이션*과 *연결된* 추가 애플리케이션 등 여러 애플리케이션이 있을 수 있습니다. 자세한 정보는 [다중 애플리케이션 스트림 그룹 개요](multi-apps.md) 섹션을 참조하세요. 스트림 그룹과 애플리케이션을 연결하는 방법은 사용 사례에 따라 다르지만 관계는 many-to-many일 수 있습니다. 스트림 그룹은 중요한 서비스 업데이트 및 수정 사항을 선택하기 위해 3\$14주마다 다시 생성해야 합니다. 자세한 정보는 [스트림 그룹 수명 주기](#stream-groups-lifecycle) 섹션을 참조하세요. ## 스트림 용량 정보 스트림 그룹의 용량 또는 *스트림 용량을* 설정하여 최종 사용자에게 동시에 제공할 수 있는 스트림 수를 관리합니다. 스트림 용량은 스트림 그룹이 지원할 수 있는 동시 스트림 세션 수를 나타냅니다. 각 위치에서 구성됩니다. + **상시 가동 용량:** 이 설정은 0이 아닌 경우 사용자에게 할당되고 서비스로 다시 릴리스되지 않는 최소 스트리밍 용량을 나타냅니다. 사용량이든 유휴 상태이든 관계없이 항상 이 기본 용량 수준에 대한 비용을 지불합니다. + **최대 용량:** 서비스가 할당할 수 있는 최대 용량을 나타냅니다. 새로 생성된 스트림을 시작하는 데 몇 분 정도 걸릴 수 있습니다. 유휴 상태일 때 용량이 서비스로 다시 해제됩니다. 릴리스될 때까지 할당된 용량에 대해 비용을 지불합니다. + **목표 유휴 용량:** 향후 활동을 예상하여 서비스가 미리 할당하고 보관하는 유휴 용량을 나타냅니다. 이렇게 하면 용량 할당 지연으로부터 사용자를 보호할 수 있습니다. 의도적인 유휴 상태로 유지되는 이 용량에 대해 비용을 지불합니다. 한 위치에 최대 용량이 100으로 설정된 스트림 그룹이 있는 경우 스트림 그룹에는 해당 위치에서 100명의 최종 사용자에게 동시에 스트리밍할 수 있는 충분한 리소스가 있습니다. 사용자 수요 변화에 맞게 언제든지 각 위치(현재 할당량까지)에서 스트림 용량을 늘리거나 줄일 수 있습니다. Amazon GameLift Streams는 먼저 이미 할당된 유휴 용량을 사용하여 새 세션 요청을 이행하려고 시도합니다. 이로 인해 유휴 용량이 목표 유휴 용량 아래로 떨어지면 새 용량이 비동기적으로 할당됩니다. 유휴 용량을 사용할 수 없는 경우 새 용량이 온디맨드로 할당되는 동안 스트림 그룹의 최대 용량까지 요청이 일시 중지됩니다. 최대값에 도달했지만 여전히 사용 가능한 유휴 용량이 없는 경우 세션 요청은 기존 세션이 종료되고 여유 용량이 확보될 때까지 기다립니다. 세션이 종료되면 해당 용량이 유휴 상태로 표시됩니다. 목표 유휴 값보다 유휴 용량이 많으면 잠시 지연된 후 초과 용량이 할당 해제되고 서비스로 반환됩니다. 구성된 최소 용량(0일 수 있음) 미만으로 용량 수준이 떨어지면 서비스가 유휴 용량을 할당 해제하지 않습니다. 다중 테넌트 스트림 클래스(컴퓨팅 리소스당 1개 이상의 세션을 스트리밍할 수 있음)가 있는 스트림 그룹에서 스트림 용량을 지정하는 경우 용량은 테넌시의 배수여야 합니다. 예를 들어 `gen6n_high` 스트림 클래스의 멀티테넌시는 2입니다. 즉, 스트림 그룹에 할당된 각 컴퓨팅 리소스는 2개의 클라이언트로 스트리밍할 수 있습니다. 따라서 요청하는 용량은 2의 배수여야 합니다. 용량 조정은 스트림 그룹의 총 비용에 반영됩니다. Amazon GameLift Streams 비용을 관리하기 위해 결제 알림을 설정해야 합니다. 자세한 내용은 [결제 알림을 생성하여 사용량 모니터링](pricing.md#pricing-billing-alerts) 항목을 참조하세요. 스트림 그룹 용량을 변경하려면 스트림 그룹 설정을 편집하고 용량 설정에 새 값을 입력합니다. 상시 작동 용량을 변경하면 Amazon GameLift Streams는 새 리소스를 프로비저닝하거나 기존 리소스를 종료하여 새 값과 일치하도록 할당된 리소스를 조정합니다. 리소스를 즉시 사용할 수 없는 경우 상시 가동 용량을 늘리는 데 몇 분 이상 걸릴 수 있습니다. 상시 가동 용량을 줄이려면 할당된 리소스의 프로비저닝을 해제하는 데 몇 분 정도 걸립니다. ### 예: 스트림 용량 구성 다음 예제에서는 다양한 사용 사례에 대한 일반적인 스트림 용량 구성을 보여줍니다. 1. **비용 중심의 개발 단계:** 비용을 절감하려는 개발자입니다. `Minimum (always-on) capacity` = 0, `Maximum capacity` = 10, `Target Idle (pre-warmed) capacity` = 1로 설정합니다. 이렇게 하면 빠른 시작을 위해 하나 이상의 세션을 사용할 수 있습니다. 1. **수요가 고정된 계획된 이벤트:** 수요가 알려진 계획된 이벤트에 대해 빠른 세션 시작을 원합니다. `Minimum (always-on) capacity` = 200, `Maximum capacity` = 200, `Target Idle (pre-warmed) capacity` = 0으로 설정합니다. 200개 용량만 지불하면 됩니다. 수요가 알려져 있기 때문에 규모 조정 지연이 발생하지 않습니다. 1. **버스트 용량이 있는 대규모 이벤트:** 피크 시간에 분당 100개의 새 세션이 있는 1,000명의 사용자를 계획하고 있습니다. `Minimum` = 0, `Maximum` = 1,000, `Target Idle` = 100으로 설정합니다. 이렇게 하면 유휴 시 비용을 절약할 수 있습니다. 이렇게 하면 빠른 시작을 위해 최소 100개의 세션을 사용할 수 있습니다. **참고** `OnDemandCapacity` 입력 파라미터는 더 이상 사용되지 않습니다. `MaximumCapacity` 대신 API를 통해 용량을 구성할 때를 사용합니다. ## 용량 및 서비스 할당량 Amazon GameLift Streams 사용에는 계정에서 스트리밍을 위해 구성할 수 있는 총 GPUs(컴퓨팅 리소스) 수를 제한하는 서비스 할당량이 적용됩니다. 기본 할당량 및 할당량 사용률은 GameLift Streams용 Service Quota 콘솔에서 확인할 수 있습니다. 이러한 할당량이 스트림 용량과 상호 작용하는 방식을 이해하면 스트리밍 인프라를 계획하고 용량 제한을 방지하는 데 도움이 됩니다. 보다 구체적으로, GPU 서비스 할당량은 계정의 모든 스트림 그룹에 걸쳐 위치당 요청할 수 있는 특정 스트림 클래스 패밀리의 최대 GPUs 수를 지정합니다. 예를 들어 계정에의 `gen6n` GPUs 한도가 5개인 경우 모든 스트림 그룹에 `us-west-2` 대해 `us-west-2`의 총 스트림 용량을 제공하는 데 필요한 `gen6n` GPUs 합계는 5보다 작거나 같아야 합니다. 여기에는 상시 가동 용량과 온디맨드 용량 모두에 대한 GPUs 포함됩니다. Amazon GameLift Streams는 할당된 GPU 합계를 기준으로 서비스 할당량을 측정합니다. 일부 스트림 클래스(예: `gen6n_high` 또는 `gen6n_small`)는 동시 세션 간에 GPU를 공유한다는 점을 기억해야 합니다. `gen6n_ultra` 및와 같은 다른 스트림 클래스는 동시 세션당 하나의 전체 GPU를 `gen6n_ultra_win2022` 사용합니다. 따라서 10GPUs를 `gen6n_ultra` 스트림 그룹의 MaximumCapacity 10 또는 `gen6n_medium` 스트림 클래스의 MaximumCapacity 40으로 할당할 수 있습니다. ### 예: 할당량이 용량에 미치는 영향 다음 예제에서는 서비스 할당량이 여러 스트림 그룹 및 위치에서 스트림 용량과 상호 작용하는 방법을 보여줍니다. 이 예제에서는 계정에 위치당 10개의 `gen6n` GPUs. 1. **단일 테넌트 스트림 그룹 생성:**에서 총 용량(항상 켜짐 및 온디맨드)이 5개인 스트림 클래스를 사용하여 `gen6n_ultra` 스트림 그룹을 생성합니다`us-east-2`. 이 스트림 클래스에는 1:1 테넌시(GPU당 스트림 1개)가 있으므로 총 5개 용량에 대해 GPUs 5개가 필요합니다. 이렇게 하면에 남은 GPUs가 5개 남습니다`us-east-2`. 1. **다중 테넌트 스트림 그룹 생성:**에서 총 용량이 6인 스트림 클래스를 사용하여 다른 `gen6n_high` 스트림 그룹을 생성합니다`us-east-2`. 이 스트림 클래스에는 1:2 테넌시(GPU당 스트림 2개)가 있으므로 총 6개 용량에 대해 GPUs 3개만 필요합니다. 이렇게 하면에 남은 GPUs가 2개 남습니다`us-east-2`. 1. **다른 위치에 용량 추가:** 이러한 스트림 그룹을 생성한 후에 2GPUs가 `us-east-2`있지만 `us-west-2` 또는와 같은 다른 위치에서는 여전히 10GPUs를 사용할 수 있습니다`eu-west-1`. 이러한 위치를 이전에 생성한 스트림 그룹 중 하나에 추가하거나 이러한 위치가 있는 새 스트림 그룹을 생성할 수 있습니다. 이 예제는 할당량이 위치별 및 모든 스트림 그룹에 적용되므로 서비스 제한을 유지하면서 여러 지리적 리전에 스트리밍 용량을 분산할 수 있음을 보여줍니다. **참고** GameLift 스트림을 AWS 서비스로 선택하여 Service Quotas 콘솔에서 해당 할당량 사용률을 포함한 적용된 계정 수준 또는 기본 할당량을 볼 수 있습니다. 자세한 내용은 [Amazon GameLift Streams 서비스 할당량](quotas.md) 단원을 참조하십시오. ## 위치 정보 위치는 Amazon GameLift Streams가 컴퓨팅 리소스를 할당하여 애플리케이션을 호스팅하고 사용자에게 스트리밍하는 위치입니다. 지연 시간을 줄이고 품질을 높이려면 사용자에게 더 가까운 위치를 선택해야 합니다. 기본적으로 *기본 위치*라고 하는 스트림 그룹을 AWS 리전 생성한에서 스트리밍할 수 있습니다. 또한 스트림 그룹은 적용 범위를 확장하여 *원격 위치라고 하는 지원되는 다른 위치에서 스트리밍할 수 있습니다*. 지원되는 위치의 전체 목록은 섹션을 참조하세요[AWS 리전 및 스트리밍 위치](regions-quotas-rande.md). **다중 위치 스트림 그룹** 기본 위치(스트림 그룹을 AWS 리전 생성한 위치) 외에도 여러 위치에서 애플리케이션 및 스트림 세션을 호스팅하도록 구성된 스트림 그룹입니다. 각 위치의 용량을 관리합니다. ## 스트림 그룹 생성 ------ #### [ Console ] **Amazon GameLift Streams 콘솔에서 스트림 그룹을 생성하려면** 1. 에 로그인 AWS Management Console 하고 [Amazon GameLift Streams 콘솔](https://console.aws.amazon.com/gameliftstreams/)을 엽니다. 스트림 그룹을 생성할 AWS 리전 을 선택합니다. 이 리전은 스트림 그룹으로 스트리밍하려는 애플리케이션의 리전과 동일해야 합니다. 자세한 내용은 시작 안내서의 [리전 선택을](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/select-region.html) 참조하세요. *AWS Management Console * 1. 생성 워크플로를 열려면 탐색 창에서 **스트림 그룹을** 선택한 다음 **스트림 그룹 생성을** 선택합니다. 1. **스트림 그룹 정의**에 다음을 입력합니다. 1. **설명** 사람이 읽을 수 있는 스트림 그룹 레이블입니다. 이 값은 고유하지 않아도 됩니다. 모범 사례를 따라 스트림 그룹에 의미 있는 설명, 이름 또는 레이블을 사용하세요. 이 필드는 언제든지 편집할 수 있습니다. 1. **Tags** 태그는 AWS 리소스를 구성하는 데 도움이 될 수 있는 레이블입니다. 자세한 내용은 [AWS 리소스 태그 지정](https://docs.aws.amazon.com/tag-editor/latest/userguide/tagging.html)을 참조하세요. 1. **스트림 클래스 선택**에서 스트림 그룹의 스트림 클래스를 선택합니다. 1. **스트림 클래스 옵션** 애플리케이션을 실행하고 스트리밍할 컴퓨팅 리소스의 유형입니다. 이 선택은 스트리밍 경험의 품질과 비용에 영향을 미칩니다. 스트림 그룹당 하나의 스트림 클래스만 지정할 수 있습니다. 애플리케이션에 가장 적합한 클래스를 선택합니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/gameliftstreams/latest/developerguide/stream-groups.html) 계속하려면 **다음**을 선택합니다. 1. **애플리케이션 연결**에서 스트리밍할 애플리케이션을 선택하거나 "애**플리케이션 없음**"을 선택하여 나중에 하나를 선택합니다. 스트림 그룹을 생성한 후 편집하여 애플리케이션을 추가하거나 제거할 수 있습니다. `Ready` 상태이고 선택한 스트림 클래스와 호환되는 런타임이 있는 애플리케이션만 연결할 수 있습니다. 기본적으로 이러한 애플리케이션만 테이블에 표시됩니다. `Ready` 상태의 모든 애플리케이션을 보려면 드롭다운 목록에서 `All runtimes`를 선택합니다. **참고** 애플리케이션이 나열되지 않으면 현재 AWS 리전 설정을 확인합니다. 애플리케이션을 동일한 리전에 있는 스트림 그룹에만 연결할 수 있습니다. 계속하려면 **다음**을 선택합니다. 1. **스트림 설정 구성**의 **위치 및 용량에서** 스트림 그룹에 애플리케이션을 스트리밍할 용량이 있는 위치를 하나 이상 선택합니다. 기본적으로 *기본 위치*라고 하는 스트림 그룹을 생성하는 리전은 스트림 그룹에 이미 추가되었으며 제거할 수 없습니다. 추가하려는 각 위치 옆의 확인란을 선택하여 위치를 추가할 수 있습니다. 지연 시간을 줄이고 스트리밍 품질을 높이려면 사용자에게 더 가까운 위치를 선택해야 합니다. 각 위치에 대해 *스트리밍 용량을* 지정할 수 있습니다. 스트림 용량은 한 번에 활성화할 수 있는 동시 스트림 수를 나타냅니다. 각 스트림 그룹의 위치별로 스트림 용량을 설정합니다. + **상시 가동 용량:** 이 설정은 0이 아닌 경우 사용자에게 할당되고 서비스로 다시 릴리스되지 않는 최소 스트리밍 용량을 나타냅니다. 사용량이든 유휴 상태이든 관계없이 항상 이 기본 용량 수준에 대한 비용을 지불합니다. + **최대 용량:** 서비스가 할당할 수 있는 최대 용량을 나타냅니다. 새로 생성된 스트림을 시작하는 데 몇 분 정도 걸릴 수 있습니다. 유휴 상태일 때 용량이 서비스로 다시 해제됩니다. 릴리스될 때까지 할당된 용량에 대해 비용을 지불합니다. + **목표 유휴 용량:** 향후 활동을 예상하여 서비스가 미리 할당하고 보관하는 유휴 용량을 나타냅니다. 이렇게 하면 용량 할당 지연으로부터 사용자를 보호할 수 있습니다. 의도적인 유휴 상태로 유지되는 이 용량에 대해 비용을 지불합니다. 어느 용량이든 조정하여 위치에 대한 사용자 수요의 변화를 충족하기 위해 언제든지 총 스트림 용량을 늘리거나 줄일 수 있습니다. Amazon GameLift Streams는 사용 가능한 경우 상시 작동 용량 풀의 유휴 사전 할당된 리소스를 사용하여 스트리밍 요청을 이행합니다. 모든 상시 작동 용량이 사용 중인 경우 Amazon GameLift Streams는 온디맨드 용량에 지정된 최대 수까지 추가 컴퓨팅 리소스를 프로비저닝합니다. 할당된 용량이 조정되면 변경 사항이 스트림 그룹의 총 비용에 반영됩니다. 연결된 애플리케이션은 활성화된 각 위치에 자동으로 복제됩니다. 원격 위치에서 스트림을 호스팅하려면 애플리케이션이 원격 위치에서 복제를 완료해야 합니다. 복제 상태를 확인하려면 스트림 그룹을 생성한 후 열고 연결된 애플리케이션 테이블의 **복제 상태** 열을 참조하세요. 현재 상태를 클릭하여 추가된 각 위치의 복제 상태를 확인합니다. **참고** 애플리케이션 데이터는이 스트림 그룹의 기본 위치를 포함하여 활성화된 모든 위치에 저장됩니다. 스트림 세션 데이터는 기본 위치와 스트리밍이 발생한 위치 모두에 저장됩니다. 1. **스트림 그룹 검토 및 생성**에서 스트림 그룹 구성을 확인하고 필요에 따라 변경합니다. 모든 것이 올바르면 **스트림 그룹 생성을** 선택합니다. ------ #### [ CLI ] **사전 조건** 사용자 자격 증명과 선택한를 AWS CLI 사용하여를 구성해야 합니다 AWS 리전. 설정 지침은 단원을 참조하십시오[다운로드 AWS CLI](setting-up.md#setting-up-prereqs). **를 사용하여 스트림 그룹을 생성하려면 AWS CLI** 에서 콘텐츠에 맞게 사용자 지정된 [CreateStreamGroup](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_CreateStreamGroup.html) 명령을 AWS CLI 사용합니다. ``` aws gameliftstreams create-stream-group \ --description "Test_gen4_high" \ --default-application-identifier arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6 \ --stream-class gen4n_high \ --location-configurations '[{"LocationName": "us-east-1", "AlwaysOnCapacity": 2, "MaximumCapacity": 6, "TargetIdleCapacity": 1}]' ``` where `description`: 사람이 읽을 수 있는 스트림 그룹 레이블입니다. 이 값은 고유하지 않아도 됩니다. 모범 사례를 따라 스트림 그룹에 의미 있는 설명, 이름 또는 레이블을 사용하세요. 이 필드는 언제든지 편집할 수 있습니다. `default-application-identifier` [Amazon GameLift Streams 애플리케이션 리소스에 할당된 Amazon 리소스 이름(ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) 값 또는 ID입니다. GameLift 애플리케이션은 `READY` 상태여야 합니다. ARN 예제: `arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6` ID 예제: `a-9ZY8X7Wv6` `stream-class` **스트림 클래스 옵션** 애플리케이션을 실행하고 스트리밍할 컴퓨팅 리소스의 유형입니다. 이 선택은 스트리밍 경험의 품질과 비용에 영향을 미칩니다. 스트림 그룹당 하나의 스트림 클래스만 지정할 수 있습니다. 애플리케이션에 가장 적합한 클래스를 선택합니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/gameliftstreams/latest/developerguide/stream-groups.html) `location-configurations` 이 스트림 그룹에 추가할 위치 집합 및 용량입니다. 기본적으로 용량이 지정되지 않은 경우 Amazon GameLift Streams는 스트림 그룹이 생성된 위치에서 하나의 스트림을 시작하기에 충분한 상시 가동 스트림 용량만 할당합니다. Amazon GameLift Streams가 지원하는 위치의 전체 목록은 섹션을 참조하세요[AWS 리전 Amazon GameLift Streams에서 지원하는 및 스트리밍 위치](regions-quotas-rande.md). 용량 값은 스트림 그룹 스트림 클래스의 테넌시 값의 정수 배수여야 합니다. 요청이 성공하면 Amazon GameLift Streams는 다음과 유사한 응답을 반환합니다. ``` { "Arn": "arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4", "Description": "Test_gen4_high", "DefaultApplication": { "Id": "a-9ZY8X7Wv6" }, "StreamClass": "gen4n_high", "Id": "sg-1AB2C3De4", "Status": "ACTIVATING", "LastUpdatedAt": "2024-11-18T15:49:01.482000-08:00", "CreatedAt": "2024-11-18T15:49:01.482000-08:00" } ``` ------ Amazon GameLift Streams는 할당되지 않은 컴퓨팅 리소스를 검색하고 새 스트림 그룹에 프로비저닝하기 시작합니다.이 작업은 몇 분 정도 걸릴 수 있습니다. 이 시간 동안 새 스트림 그룹은 **활성화** 중 상태입니다. 상태가 **활성**일 때 스트림 그룹의 용량을 조정할 수 있습니다. 자세한 정보는 [용량 편집](#stream-groups-edit-capacity) 섹션을 참조하세요. 스트림 그룹이 **활성** 상태이면 스트리밍을 위해 리소스를 배포할 준비가 된 것입니다. 스트리밍을 시작하려면 단원을 참조하십시오[Amazon GameLift Streams로 스트림 세션 시작](stream-sessions.md). ## 일반 설정 편집 Amazon GameLift Streams는 콘솔에서 **상태**, **스트림 그룹** **ID, 설명******, **스트림 그룹 ARN**, **스트림 클래스** 등의 설정을 그룹화합니다. 이 중에서 새 스트림 그룹을 생성하지 않고 업데이트할 수 있는 유일한 항목은 **설명**입니다. ------ #### [ Console ] 1. 에 로그인 AWS Management Console 하고 [Amazon GameLift Streams 콘솔](https://console.aws.amazon.com/gameliftstreams/)을 엽니다. 1. 탐색 모음에서 **스트림 그룹을** 선택하여 기존 스트림 그룹 목록을 봅니다. 편집할 스트림 그룹을 선택합니다. 1. 스트림 그룹 세부 정보 페이지에서 **설정 편집**을 선택합니다. 1. 설명을 업데이트하려면 새 값을 입력합니다. ------ #### [ CLI ] **사전 조건** 사용자 자격 증명과 선택한를 AWS CLI 사용하여를 구성해야 합니다 AWS 리전. 설정 지침은 단원을 참조하십시오[다운로드 AWS CLI](setting-up.md#setting-up-prereqs). **를 사용하여 스트림 그룹의 설명을 편집하려면 AWS CLI** 에서 콘텐츠에 맞게 사용자 지정된 [UpdateStreamGroup](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_UpdateStreamGroup.html) 명령을 AWS CLI 사용합니다. ``` aws gameliftstreams update-stream-group \ --identifier arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4 \ --description "MyGame - Ultra" ``` where `identifier` 스트림 그룹 [리소스를 고유하게 식별하는 Amazon 리소스 이름(ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) 또는 ID입니다. ARN 예제: `arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4` ID 예제: `sg-1AB2C3De4` `description` 사람이 읽을 수 있는 스트림 그룹 레이블입니다. 이 값은 고유하지 않아도 됩니다. 모범 사례를 따라 스트림 그룹에 의미 있는 설명, 이름 또는 레이블을 사용하세요. 이 필드는 언제든지 편집할 수 있습니다. ------ ## 용량 편집 각 위치의 용량을 조정하여 스트림 그룹을 확장합니다. AWS 계정위치별 스트림 그룹 용량 할당량과 이러한 할당량을 늘리는 방법에 대한 [Amazon GameLift Streams 서비스 할당량](quotas.md) 자세한 내용은 섹션을 참조하세요. ------ #### [ Console ] 1. 에 로그인 AWS Management Console 하고 [Amazon GameLift Streams 콘솔](https://console.aws.amazon.com/gameliftstreams/)을 엽니다. 1. 탐색 모음에서 **스트림 그룹을** 선택하여 기존 스트림 그룹 목록을 봅니다. 편집할 스트림 그룹을 선택합니다. 1. 스트림 그룹 세부 정보 페이지에서 **구성 편집**을 선택합니다. 1. 각 위치에 대해 테이블의 관련 셀에 새 상시 작동 용량, 최대 용량 및 대상 유휴 용량 값을 입력합니다. 용량 값은 스트림 그룹 스트림 클래스의 테넌시 값의 정수 배수여야 합니다. 상시 작동 용량 값을 0으로 설정하면 스트림 그룹이 스트림에 호스트를 할당하지 않습니다. ------ #### [ CLI ] **사전 조건** 사용자 자격 증명과 선택한를 AWS CLI 사용하여를 구성해야 합니다 AWS 리전. 설정 지침은 단원을 참조하십시오[다운로드 AWS CLI](setting-up.md#setting-up-prereqs). **를 사용하여 스트림 용량을 편집하려면 AWS CLI** 에서 콘텐츠에 맞게 사용자 지정된 [UpdateStreamGroup](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_UpdateStreamGroup.html) 명령을 AWS CLI 사용합니다. ``` aws gameliftstreams update-stream-group \ --identifier arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4 \ --location-configurations '[{"LocationName": "us-east-1", "AlwaysOnCapacity": 4, "MaximumCapacity": 8}, \ {"LocationName": "ap-northeast-1", "AlwaysOnCapacity": 0, "MaximumCapacity": 2, "TargetIdleCapacity": 1}]' ``` where `identifier` 스트림 그룹 [리소스를 고유하게 식별하는 Amazon 리소스 이름(ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) 또는 ID입니다. ARN 예제: `arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4` ID 예제: `sg-1AB2C3De4` `location-configurations` 이 스트림 그룹에서 새 용량으로 업데이트할 위치 집합입니다. 용량 값은 스트림 그룹 스트림 클래스의 테넌시 값의 정수 배수여야 합니다. ------ 스트림 그룹 위치의 용량을 업데이트하면 Amazon GameLift Streams가 요청을 처리하기 시작하므로 시간이 걸릴 수 있습니다. 이 기간 동안 Amazon GameLift Streams는 설정한 원하는 상시 가동 스트림 용량을 충족하기 위해 필요에 따라 스트림 그룹에 리소스를 할당하거나 릴리스합니다. Amazon GameLift Streams 콘솔에서 **스트림 그룹 세부 정보** 페이지를 보거나 [GetStreamGroup](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_GetStreamGroup.html) API를 호출하여 스트림 용량의 프로비저닝 상태를 볼 수 있습니다. 스트림 그룹이 **활성** 상태이고 사용 가능한 스트림 용량이 있으며 애플리케이션이 스트리밍하려는 위치로 복제를 완료한 경우 스트리밍을 시작할 수 있습니다. 자세한 정보는 [Amazon GameLift Streams로 스트림 세션 시작](stream-sessions.md) 섹션을 참조하세요. ## 용량 축소 동작 용량을 축소하면 Amazon GameLift Streams는 호스트가 유휴 상태가 될 때까지 기다렸다가 릴리스합니다. 호스트는 1개 또는 2개의 세션을 지원할 수 있으므로 호스트의 모든 활성 세션이 종료될 때만 호스트가 유휴 상태입니다. 스트림 세션은 사용자가 세션을 종료하거나 세션 시간이 초과될 때 종료됩니다. 따라서 기존 세션이 가능한 최대 기간에 도달하도록 허용되는 극단적인 상황에서는 원하는 용량에 도달하는 데 최대 24시간이 걸릴 수 있습니다. 스트림 그룹의 모든 활성 스트림 세션을 강제로 종료하려면 콘솔에서 또는 [DeleteStreamGroup](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_DeleteStreamGroup.html) API를 사용하여 스트림 그룹을 삭제하거나 [TerminateStreamSession](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_TerminateStreamSession.html) API를 사용하여 활성 세션을 한 번에 하나씩 종료할 수 있습니다. ## 스트림 그룹에 위치 추가 ------ #### [ Console ] **Amazon GameLift Streams 콘솔을 사용하여 스트림 그룹에 위치를 추가하려면** 1. 탐색 모음에서 **스트림 그룹을** 선택하여 기존 스트림 그룹 목록을 봅니다. 새 위치를 추가할 스트림 그룹을 선택합니다. 1. **스트림 그룹 세부 정보** 페이지에서 **구성 편집**을 선택합니다. 1. 이 스트림 그룹에 추가할 위치(들) 옆의 확인란을 선택한 다음 용량을 설정합니다. 1. 스트림 용량 비용을 포함하여 선택한 위치의 요약을 검토합니다. **저장**을 선택하여 선택을 확인합니다. ------ #### [ CLI ] **사전 조건** 사용자 자격 증명과 선택한를 AWS CLI 사용하여를 구성해야 합니다 AWS 리전. 설정 지침은 단원을 참조하십시오[다운로드 AWS CLI](setting-up.md#setting-up-prereqs). **를 사용하여 스트림 그룹에 위치를 추가하려면 AWS CLI** 에서 콘텐츠에 맞게 사용자 지정된 [AddStreamGroupLocations](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_AddStreamGroupLocations.html) 명령을 AWS CLI 사용합니다. ``` aws gameliftstreams add-stream-group-locations \ --identifier arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4 --location-configurations '[{"LocationName": "us-east-1", "AlwaysOnCapacity": 2, "MaximumCapacity": 4, "TargetIdleCapacity": 1}]' ``` where `identifier` 스트림 그룹 [리소스를 고유하게 식별하는 Amazon 리소스 이름(ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) 또는 ID입니다. ARN 예제: `arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4` ID 예제: `sg-1AB2C3De4` `location-configurations` 이 스트림 그룹에 추가할 위치 집합과 해당 용량입니다. Amazon GameLift Streams가 지원하는 위치의 전체 목록은 섹션을 참조하세요[AWS 리전 Amazon GameLift Streams에서 지원하는 및 스트리밍 위치](regions-quotas-rande.md). 용량 값은 스트림 그룹 스트림 클래스의 테넌시 값의 정수 배수여야 합니다. ------ 애플리케이션이 새 위치(들)로 복제를 완료하고 스트림 그룹에 사용 가능한 스트림 용량이 있으면 새 위치(들)에서 스트리밍을 시작할 수 있습니다. 스트리밍에 대한 자세한 내용은 섹션을 참조하세요[Amazon GameLift Streams로 스트림 세션 시작](stream-sessions.md). Amazon GameLift Streams가 요청 처리를 시작합니다. 이 기간 동안 Amazon GameLift Streams는 애플리케이션을 복제하고 새 위치에 컴퓨팅 리소스를 할당합니다. 복제 상태 열의 상태를 클릭하여 **스트림 그룹 세부 정보** 페이지의 **연결된 애플리케이션** 섹션에서 **복제 상태를** 볼 수 있습니다. ## 스트림 그룹의 위치 제거 특정 위치의 컴퓨팅 리소스 사용을 중지하려면 스트림 그룹에서 위치를 제거할 수 있습니다. 스트림 그룹의 기본 위치는 제거할 수 없습니다. 그러나 해당 위치에 컴퓨팅 리소스를 원하지 않는 경우 스트림 용량을 0으로 설정할 수 있습니다. **주의** 스트림 그룹의 위치를 제거하면 Amazon GameLift Streams는 해당 위치에서 활성 스트림의 연결을 해제하여 연결된 최종 사용자의 스트림을 중지합니다. ------ #### [ Console ] **Amazon GameLift Streams 콘솔을 사용하여 스트림 그룹에서 위치를 제거하려면** 1. 탐색 창에서 **스트림 그룹을** 선택하여 기존 스트림 그룹 목록을 봅니다. 1. 위치를 제거할 스트림 그룹의 이름을 선택합니다. 1. **스트림 그룹 세부 정보** 페이지에서 **구성 편집**을 선택합니다. 1. 제거하려는 위치 이름 옆의 확인란을 선택 취소합니다. 1. **저장**을 선택합니다. ------ #### [ CLI ] **사전 조건** 사용자 자격 증명과 선택한를 AWS CLI 사용하여를 구성해야 합니다 AWS 리전. 설정 지침은 단원을 참조하십시오[다운로드 AWS CLI](setting-up.md#setting-up-prereqs). **를 사용하여 스트림 그룹에서 위치를 제거하려면 AWS CLI** 에서 콘텐츠에 맞게 사용자 지정된 [RemoveStreamGroupLocations](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_RemoveStreamGroupLocations.html) 명령을 AWS CLI 사용합니다. ``` aws gameliftstreams remove-stream-group-locations \ --identifier arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4 --locations us-east-1 eu-central-1 ``` where `identifier` 스트림 그룹 [리소스를 고유하게 식별하는 Amazon 리소스 이름(ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) 또는 ID입니다. ARN 예제: `arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4` ID 예제: `sg-1AB2C3De4` `locations` 이 스트림 그룹에서 제거할 위치 집합입니다. Amazon GameLift Streams가 지원하는 위치의 전체 목록은 섹션을 참조하세요[AWS 리전 Amazon GameLift Streams에서 지원하는 및 스트리밍 위치](regions-quotas-rande.md). ------ ## 스트림 그룹 삭제 모든 상태의 스트림 그룹을 삭제할 수 있습니다. 이 작업은 스트림 그룹을 영구적으로 삭제하고 해당 컴퓨팅 리소스를 해제합니다. 진행 중인 스트림이 있는 경우이 작업은 스트림을 중지하고 최종 사용자는 더 이상 스트림을 볼 수 없습니다. 스트림 그룹을 삭제하기 전에 진행 중인 스트림을 확인하고 중지 조치를 취하는 것이 가장 좋습니다. ------ #### [ Console ] **Amazon GameLift Streams 콘솔을 사용하여 스트림 그룹을 삭제하려면** 1. 에 로그인 AWS Management Console 하고 [Amazon GameLift Streams 콘솔](https://console.aws.amazon.com/gameliftstreams/)을 엽니다. 1. 기존 스트림 그룹 목록을 보려면 탐색 창에서 **스트림 그룹을** 선택합니다. 1. 삭제할 스트림 그룹의 이름을 선택합니다. 1. 스트림 그룹 세부 정보 페이지에서 **삭제**를 선택합니다. 1. **삭제** 대화 상자에서 삭제 작업을 확인합니다. ------ #### [ CLI ] **사전 조건** 사용자 자격 증명과 선택한를 AWS CLI 사용하여를 구성해야 합니다 AWS 리전. 설정 지침은 단원을 참조하십시오[다운로드 AWS CLI](setting-up.md#setting-up-prereqs). **를 사용하여 스트림 그룹을 삭제하려면 AWS CLI** 에서 콘텐츠에 맞게 사용자 지정된 [DeleteStreamGroup](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_DeleteStreamGroup.html) 명령을 AWS CLI 사용합니다. ``` aws gameliftstreams delete-stream-group \ --identifier arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4 ``` where `identifier` 스트림 그룹 [리소스를 고유하게 식별하는 Amazon 리소스 이름(ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) 또는 ID입니다. ARN 예제: `arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4` ID 예제: `sg-1AB2C3De4` ------ Amazon GameLift Streams는 컴퓨팅 리소스를 해제하고 스트림 그룹을 삭제하기 시작합니다. 이 시간 동안 스트림 그룹은 **삭제** 중 상태입니다. Amazon GameLift Streams가 스트림 그룹을 삭제한 후에는 더 이상 검색할 수 없습니다. ## 연결된 애플리케이션 동일한 컴퓨팅 리소스 풀을 사용하여 여러 애플리케이션을 스트리밍하려는 경우 여러 애플리케이션을 동일한 스트림 그룹에 연결할 수 있습니다. 마찬가지로 다양한 컴퓨팅 리소스 세트를 사용하여 애플리케이션을 스트리밍하려는 경우 애플리케이션을 여러 스트림 그룹에 연결할 수 있습니다. 애플리케이션을 스트림 그룹에 연결하는 방법에 대한 자세한 내용은 섹션을 참조하세요[다중 애플리케이션 스트림 그룹 개요](multi-apps.md). ## 스트림 그룹 수명 주기 스트림 그룹의 최대 수명은 365일입니다. 중요한 서비스 업데이트 및 수정 사항을 수신하고 최적의 성능을 보장하려면 3\$14주마다 스트림 그룹을 다시 생성하는 것이 좋습니다. 스트림 그룹을 다시 생성해도 업로드된 애플리케이션에는 영향을 주지 않습니다. 스트림 그룹의 수명에 따라 다음과 같은 제한이 적용됩니다. + **180일:** 새 애플리케이션 연결로 스트림 그룹을 더 이상 업데이트할 수 없습니다. + **365일**: 스트림 그룹이 만료되어 더 이상 세션을 스트리밍할 수 없음 스트림 그룹과 연결된 계정은에서 두 개의 알림 알림을 수신합니다. AWS Health하나는 45일에, 두 번째 알림은 150일에 수신됩니다. 이러한 알림은 180일 이내에 애플리케이션 연결 기능이 손실됨을 알려줍니다. 또한 스트림 그룹이 365일에 만료됨을 알리는 335일 최종 알림이 하나 있을 예정입니다. 유지 관리 경고는 AWS Health 대시보드와 Amazon GameLift Streams 콘솔의 스트림 그룹 페이지에도 표시됩니다. 스트림 그룹의 만료 날짜를 찾으려면 콘솔에서 **스트림 그룹 세부 정보** 페이지를 보거나 [GetStreamGroup](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_GetStreamGroup.html) API 응답의 `ExpiresAt` 필드를 사용합니다. 만료된 스트림 그룹의 상태는 `EXPIRED` 이고 읽기 전용이 됩니다. 업데이트하거나 새 스트림 세션을 시작할 수 없습니다. 기능을 다시 얻으려면 스트림 그룹을 다시 생성합니다. ## 스트림 그룹 유지 관리 새 스트림 그룹을 사용해야 하는 기능이 릴리스될 때마다 스트림 그룹의 세부 정보 페이지 상단에 만료되었음을 알리는 "유지 관리 필요" 메시지가 표시됩니다. 스트림 그룹을 다시 생성하는 것은 수동 프로세스이지만, 이를 위해 메시지의 **스트림 그룹 생성** 버튼을 사용하여 프로세스를 시작합니다. 일부 필드는 자동으로 채워집니다. 스트림 그룹이 생성된 지 180일이 넘은 경우에도 스트림 그룹 유지 관리가 필요합니다. 기존 스트림 그룹을 다시 생성하기 전까지는 새 애플리케이션을 이러한 오래된 스트림 그룹에 더 이상 연결할 수 없습니다. 365일째가 되면 스트림 그룹에서 스트리밍할 수 없으며 스트림 그룹을 변경할 수 없습니다.