# Amazon ECS Linux 컨테이너 인스턴스 관리 Amazon ECS 워크로드에 EC2 인스턴스를 사용하는 경우 인스턴스를 유지 관리할 책임은 사용자에게 있습니다. **Topics** + [컨테이너 인스턴스 시작](launch_container_instance.md) + [Linux 컨테이너 인스턴스 부트스트래핑](bootstrap_container_instance.md) + [스팟 인스턴스 알림을 수신하도록 컨테이너 인스턴스 구성](spot-instance-draining-linux-container.md) + [컨테이너 인스턴스를 시작할 때 스크립트 실행](start_task_at_launch.md) + [Amazon ECS Linux 컨테이너 인스턴스 네트워크 인터페이스 증가](container-instance-eni.md) + [컨테이너 인스턴스 메모리 예약](memory-management.md) + [원격으로 컨테이너 인스턴스 관리](ec2-run-command.md) + [Linux 컨테이너 인스턴스에 HTTP 프록시 사용](http_proxy_config.md) + [Auto Scaling 그룹에 대해 사전 초기화된 인스턴스 구성](using-warm-pool.md) + [Amazon ECS 컨테이너 에이전트 업데이트](ecs-agent-update.md) 각 Amazon ECS 컨테이너 에이전트 버전은 서로 다른 기능 세트를 지원하며 이전 버전에 대한 버그 수정을 제공합니다. 기능한 한 최신 버전의 Amazon ECS 컨테이너 에이전트를 사용할 것이 좋습니다. 컨테이너 에이전트를 최신 버전으로 업데이트하려면 [Amazon ECS 컨테이너 에이전트 업데이트](ecs-agent-update.md) 섹션을 참조하세요. 각 에이전트 릴리스에 포함된 기능 및 기능 향상을 보려면 [https://github.com/aws/amazon-ecs-agent/releases](https://github.com/aws/amazon-ecs-agent/releases)를 참조하세요. **중요** 신뢰할 수 있는 지표를 위한 최소 Docker 버전은 Docker 버전 `v20.10.13` 이상이며, Amazon ECS 최적화 AMI `20220607` 이상 버전에 포함되어 있습니다. Amazon ECS 에이전트 버전 `1.20.0` 이상에서는 `18.01.0` 이전 Docker 버전에 대한 지원이 중단되었습니다. # Amazon ECS Linux 컨테이너 인스턴스 시작 Amazon EC2 콘솔을 사용하여 Amazon ECS 컨테이너 인스턴스를 생성할 수 있습니다. Amazon EC2 콘솔, AWS CLI 및 SDK을 비롯한 다양한 방법으로 인스턴스를 시작할 수 있습니다. 인스턴스를 시작하는 다른 방법에 대한 자세한 정보는 *Amazon EC2 사용 설명서*의 [인스턴스 시작](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/LaunchingAndUsingInstances.html)을 참조하세요. 시작 마법사에 대한 자세한 내용은 *Amazon EC2 사용 설명서*의 [새 인스턴스 시작 마법사를 사용하여 인스턴스 시작](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-launch-instance-wizard.html)을 참조하세요. 시작하기 전에 [Amazon ECS 사용 설정](get-set-up-for-amazon-ecs.md)의 단계를 완료해야 합니다. 새 Amazon EC2 마법사를 사용하여 인스턴스를 시작할 수 있습니다. 인스턴스 시작 마법사는 인스턴스를 시작하는 데 필요한 시작 파라미터를 지정합니다. **Topics** + [절차](#linux-liw-initiate-instance-launch) + [이름 및 태그](#linux-liw-name-and-tags) + [애플리케이션 및 OS 이미지(Amazon Machine Image)](#linux-liw-ami) + [인스턴스 유형](#linux-liw-instance-type) + [키 페어(로그인)](#linux-liw-key-pair) + [네트워크 설정](#linux-liw-network-settings) + [스토리지 구성](#linux-liw-storage) + [고급 세부 정보](#linux-liw-advanced-details) ## 절차 시작하기 전에 [Amazon ECS 사용 설정](get-set-up-for-amazon-ecs.md)의 단계를 완료해야 합니다. 1. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)에서 Amazon EC2 콘솔을 엽니다. 1. 화면 상단의 탐색 모음에는 현재 AWS 리전이 표시됩니다(예: 미국 동부(오하이오)). 인스턴스를 시작할 리전을 선택합니다. 1. Amazon EC2 콘솔 대시보드에서 **인스턴스 시작**을 선택합니다. ## 이름 및 태그 인스턴스 이름은 태그이며, 여기서 키는 **이름**이고 값은 사용자가 지정하는 이름입니다. 인스턴스, 볼륨 및 Elastic Graphics에 태그를 지정할 수 있습니다. 스팟 인스턴스의 경우 스팟 인스턴스 요청만 태깅할 수 있습니다. 인스턴스 이름과 추가 태그를 지정하는 것은 선택 사항입니다. + **이름(Name)**에 인스턴스를 설명하는 이름을 입력합니다. 이름을 지정하지 않으면 인스턴스를 시작할 때 자동으로 생성되는 ID로 인스턴스를 식별할 수 있습니다. + 태그를 추가하려면 **추가 태그 추가(Add additional tags)**를 선택합니다. **태그 추가(Add tag)**를 선택한 다음 키와 값을 입력하고 태그를 지정할 리소스 유형을 선택합니다. 추가할 각 추가 태그에 대해 **태그 추가(Add tag)**를 다시 선택합니다. ## 애플리케이션 및 OS 이미지(Amazon Machine Image) Amazon Machine Image(AMI)에는 인스턴스를 생성하는 데 필요한 정보가 포함되어 있습니다. 예를 들어 AMI에는 웹 서버 역할을 수행하는 데 필요한 소프트웨어가 포함될 수 있습니다(예: Apache, 사용자의 웹 사이트). **검색창**을 사용하여 AWS에서 공개한 적절한 Amazon ECS 최적화 AMI를 찾습니다. 1. 다음 용어 중 하나를 **검색창**에 입력합니다. + **ami-ecs** + Amazon ECS 최적화 AMI의 **값.** 최신 Amazon ECS 최적화 AMI 및 이들의 값은 [Linux Amazon ECS 최적화 AMI](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-optimized_AMI.html#ecs-optimized-ami-linux)를 참조하세요. 1. **Enter**를 누릅니다. 1. **Amazon Machine Image(AMI) 선택** 페이지에서 **AWSMarketplace AMIs** 탭을 선택합니다. 1. 왼쪽의 **결과 구체화(Refine results)** 창에서 **Amazon Web Services**를 **게시자(Publisher)**로 선택합니다. 1. 사용하려는 AMI 행에서 **선택(Select)**을 선택합니다. 또는, AMI를 선택하지 않고 시작 인스턴스 마법사로 돌아가려면 **취소(Cancel)**(오른쪽 상단)를 선택합니다. 기본 AMI가 선택됩니다. AMI가 [Amazon ECS 최적화 Linux AMI](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-optimized_AMI.html)에 설명된 요구 사항을 충족하는지 확인하세요. ## 인스턴스 유형 인스턴스 유형은 인스턴스의 하드웨어 구성과 크기를 정의합니다. 대형 인스턴스는 CPU와 메모리가 더 높습니다. 자세한 내용을 알아보려면 *Amazon EC2 사용 설명서*의 [인스턴스 유형](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html)을 참조하세요. IPv6 전용 워크로드를 실행하려는 경우 특정 인스턴스 유형은 IPv6 주소를 지원하지 않습니다. 자세한 내용은 *Amazon EC2 사용 설명서의*의 [IPv6 주소](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-instance-addressing.html#ipv6-addressing)를 참조하세요. + **인스턴스 유형(Instance type)**에서 인스턴스에 대한 인스턴스 유형을 선택합니다. 여기서 선택하는 인스턴스 유형은 실행할 작업에 사용 가능한 리소스를 결정합니다. ## 키 페어(로그인) **키 페어 이름(Key pair name)**에서 기존 키 페어를 선택하거나 **새로운 키 페어 생성(Create new key pair)**을 선택하여 새로 생성합니다. **중요** **키 페어 없이 진행(Proceed without key pair)**(권장하지 않음) 옵션을 선택할 경우 사용자가 다른 방법으로 로그인할 수 있도록 구성된 AMI를 선택해야만 인스턴스에 연결할 수 있습니다. ## 네트워크 설정 양식의 **네트워크 설정** 섹션에 대한 **편집** 버튼을 선택한 후 필요에 따라 네트워크 설정을 구성합니다. + **VPC**에서 인스턴스를 시작하려는 VPC를 선택합니다. IPv6 전용 워크로드를 실행하려면 IPv4 및 IPv6 CIDR 블록을 모두 포함하는 듀얼 스택 VPC를 선택합니다. + **서브넷**에서 인스턴스를 시작할 서브넷을 선택합니다. 가용 영역, 로컬 영역, Wavelength Zone 또는 Outposts와 연결된 서브넷에서 인스턴스를 시작할 수 있습니다. 가용 영역에서 인스턴스를 시작하려면 인스턴스를 시작할 서브넷을 선택합니다. 새 서브넷을 생성하려면 **새 서브넷 생성**을 선택하여 Amazon VPC 콘솔로 이동합니다. 마친 후에 인스턴스 시작 마법사로 돌아와 새로 고침 아이콘을 선택하면 해당 서브넷이 목록에 로딩됩니다. 로컬 영역에서 인스턴스를 시작하려면 로컬 영역에 생성된 서브넷을 선택합니다. Outposts에서 인스턴스를 시작하려면 Outposts와 연결된 VPC의 서브넷을 선택합니다. IPv6 전용 워크로드를 실행하려면 IPv6 CIDR 블록만 포함하는 서브넷을 선택합니다. + **퍼블릭 IP 자동 할당(Auto-assign Public IP)**: 인터넷에서 인스턴스에 액세스할 수 있어야 한다면 **퍼블릭 IP 자동 할당(Auto-assign Public IP)** 필드가 **사용 설정(Enable)**으로 설정되어 있는지 확인합니다. 이렇게 설정이 되어 있지 않으면 이 필드를 **비활성화(Disable)**로 설정합니다. **참고** 컨테이너 인스턴스는 Amazon ECS 서비스 엔드포인트와 통신하기 위한 액세스 권한이 필요합니다. 액세스 권한은 인터페이스 VPC 엔드포인트를 통하거나 퍼블릭 IP 주소가 있는 컨테이너 인스턴스를 통해 부여할 수 있습니다. 인터페이스 VPC 엔드포인트에 대한 자세한 정보는 [Amazon ECS 및 인터페이스 VPC 엔드포인트(AWS PrivateLink)](vpc-endpoints.md) 섹션을 참조하세요. 인터페이스 VPC 엔드포인트가 구성되어 있지 않고 컨테이너 인스턴스 컴퓨팅 리소스에 퍼블릭 IP 주소가 없는 경우, NAT(Network Address Translation)를 사용하여 이 액세스 권한을 제공해야 합니다. 자세한 정보는 [Amazon VPC 사용 설명서](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-nat-gateway.html)의 *NAT 게이트웨이* 및 이 가이드의 [Amazon ECS Linux 컨테이너 인스턴스에 HTTP 프록시 사용](http_proxy_config.md) 섹션을 참조하세요. + 듀얼 스택 VPC 및 IPv6 전용 서브넷을 선택하는 경우 **IPv6 IP 자동 할당**에서 **활성화**를 선택합니다. + **방화벽(보안 그룹)(Firewall (security groups))**: 보안 그룹을 사용하여 컨테이너 인스턴스의 방화벽 규칙을 정의합니다. 이 규칙은 컨테이너 인스턴스에 전달되는 수신 네트워크 트래픽을 지정합니다. 다른 모든 트래픽은 무시됩니다. + 기존 보안 그룹을 선택하려면 **기존 보안 그룹 선택(Select an existing security group)**을 선택하고 [Amazon ECS 사용 설정](get-set-up-for-amazon-ecs.md)에서 생성한 보안 그룹을 선택합니다. + IPv6 전용 워크로드에 대해 인스턴스를 시작하는 경우 **고급 네트워크 구성**을 선택한 다음 **기본 IPv6 IP 할당**에서 **예**를 선택합니다. **참고** 기본 IPv6 주소가 없으면 호스트 또는 브리지 네트워크 모드의 컨테이너 인스턴스에서 실행되는 태스크가 로드 밸런서 또는 AWS Cloud Map에 등록되지 않습니다. ## 스토리지 구성 선택한 AMI에는 루트 볼륨을 포함한 하나 이상의 스토리지 볼륨이 있습니다. 인스턴스에 연결할 추가 볼륨을 지정할 수 있습니다. **간단(Simple)** 보기를 사용할 수 있습니다. + **스토리지 유형(Storage type)**: 컨테이너 인스턴스의 스토리지를 구성합니다. Amazon ECS 최적화 Amazon Linux 2 AMI를 사용하는 경우, 운영 체제와 Docker 간에 공유하는 단일 30GiB 볼륨이 인스턴스에 구성됩니다. Amazon ECS 최적화 AMI를 사용하는 경우, 인스턴스에는 2개의 볼륨이 구성되어 있습니다. **Root** 볼륨은 운영 체제가 사용하고, 두 번째 Amazon EBS 볼륨(`/dev/xvdcz`에 연결)은 Docker가 사용합니다. 애플리케이션 요구에 맞춰 인스턴스의 볼륨 크기를 선택적으로 늘리거나 줄일 수 있습니다. ## 고급 세부 정보 **고급 세부 정보**에서 필드를 볼 수 있도록 섹션을 확장하고 인스턴스를 위한 추가 파라미터를 지정합니다. + **구매 옵션(Purchasing option)**: 스팟 인스턴스를 요청하려면 **스팟 인스턴스 요청(Request Spot Instances)**을 선택합니다. 스팟 인스턴스와 관련된 다른 필드도 설정해야 합니다. 자세한 정보는 [스팟 인스턴스 요청](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/spot-requests.html)을 참조하세요. **참고** 스팟 인스턴스를 사용하는 경우 `Not available` 메시지가 표시되면 다른 인스턴스 유형을 선택해야 할 수 있습니다. + **IAM 인스턴스 프로파일(IAM instance profile)**: 컨테이너 인스턴스 IAM 역할을 선택합니다. 이는 일반적으로 `ecsInstanceRole`로 이름이 지정됩니다. **중요** 적절한 IAM 권한을 사용하여 컨테이너 인스턴스를 시작하지 않으면 Amazon ECS 에이전트가 클러스터에 연결할 수 없습니다. 자세한 내용은 [Amazon ECS 컨테이너 인스턴스 IAM 역할](instance_IAM_role.md) 섹션을 참조하세요. + **사용자 데이터**: 사용자 데이터(예: [Amazon ECS 컨테이너 에이전트 구성](ecs-agent-config.md)의 에이전트 환경 변수)로 Amazon ECS 컨테이너 인스턴스를 구성합니다. Amazon EC2 사용자 데이터 스크립트는 인스턴스가 처음 시작될 때 한 번만 실행됩니다. 다음은 사용자 데이터의 일반적인 용례입니다. + 기본적으로 컨테이너 인스턴스는 기본 클러스터로 시작됩니다. 기본이 아닌 클러스터로 시작하려면 **고급 세부 정보(Advanced Details)** 목록을 선택합니다. 그런 다음 **사용자 데이터(User data)** 필드에 다음 스크립트를 붙여 넣고 *your\$1cluster\$1name*을 클러스터 이름으로 대체합니다. ``` #!/bin/bash echo ECS_CLUSTER=your_cluster_name >> /etc/ecs/ecs.config ``` + Amazon S3에 `ecs.config` 파일이 있고 컨테이너 인스턴스 역할에 대한 Amazon S3 읽기 전용 액세스가 활성화된 경우, **고급 세부 정보(Advanced Details)** 목록을 선택합니다. 그런 다음 **사용자 데이터(User data)** 필드에 다음 스크립트를 붙여 넣고 *your\$1bucket\$1name*을 AWS CLI를 설치할 버킷 이름으로 대체하고 시작 시 구성 파일을 작성합니다. **참고** 이 구성에 대한 자세한 정보는 [Amazon S3에 Amazon ECS 컨테이너 인스턴스 구성 저장](ecs-config-s3.md) 섹션을 참조하세요. ``` #!/bin/bash yum install -y aws-cli aws s3 cp s3://your_bucket_name/ecs.config /etc/ecs/ecs.config ``` + `ECS_CONTAINER_INSTANCE_TAGS` 구성 파라미터를 사용하여 컨테이너 인스턴스의 태그를 지정합니다. 이렇게 하면 오로지 Amazon ECS과 연결된 태그가 생성되며, 이러한 태그는 Amazon EC2 API를 사용하여 볼 수 없습니다. **중요** Amazon EC2 Auto Scaling 그룹을 사용하여 컨테이너 인스턴스를 시작한 경우 ECS\$1CONTAINER\$1INSTANCE\$1TAGS 에이전트 구성 파라미터를 사용하여 태그를 추가해야 합니다. 이는 Auto Scaling을 사용하여 시작된 Amazon EC2 인스턴스에 태그가 추가되는 방식 때문입니다. ``` #!/bin/bash cat <<'EOF' >> /etc/ecs/ecs.config ECS_CLUSTER=your_cluster_name ECS_CONTAINER_INSTANCE_TAGS={"tag_key": "tag_value"} EOF ``` + 컨테이너 인스턴스의 태그를 지정한 다음, `ECS_CONTAINER_INSTANCE_PROPAGATE_TAGS_FROM` 구성 파라미터를 사용하여 Amazon EC2에서 Amazon ECS로 태그를 전파합니다. 컨테이너 인스턴스와 연결된 태그를 전파하고 `your_cluster_name`이라고 하는 클러스터에 컨테이너 인스턴스를 등록하는 사용자 데이터 스크립트의 예는 다음과 같습니다. ``` #!/bin/bash cat <<'EOF' >> /etc/ecs/ecs.config ECS_CLUSTER=your_cluster_name ECS_CONTAINER_INSTANCE_PROPAGATE_TAGS_FROM=ec2_instance EOF ``` + 기본적으로 Amazon ECS 컨테이너 에이전트는 인스턴스의 기본 IPv4 및 IPv6 경로를 보고 IPv6 전용 구성에 대한 컨테이너 인스턴스의 호환성을 감지하려고 시도합니다. 이 동작을 재정의하려면 인스턴스 `/etc/ecs/ecs.config` 파일에서 ` ECS_INSTANCE_IP_COMPATIBILITY` 파라미터를 `ipv4` 또는 `ipv6`으로 설정할 수 있습니다. ``` #!/bin/bash cat <<'EOF' >> /etc/ecs/ecs.config ECS_CLUSTER=your_cluster_name ECS_INSTANCE_IP_COMPATIBILITY=ipv6 EOF ``` 자세한 내용은 [데이터 전달을 위한 Amazon ECS Linux 컨테이너 인스턴스 부트스트래핑](bootstrap_container_instance.md) 섹션을 참조하세요. # 데이터 전달을 위한 Amazon ECS Linux 컨테이너 인스턴스 부트스트래핑 Amazon EC2 인스턴스를 시작하면 사용자 데이터를 EC2 인스턴스에 전달할 수 있습니다. 이 데이터는 일반적인 구성 태스크를 자동으로 수행하는 데 사용할 수 있고, 인스턴스가 부팅될 때 스크립트를 실행하는 데 사용할 수도 있습니다. Amazon ECS의 경우 사용자 데이터의 가장 일반적인 사용 사례는 구성 정보를 Docker 대몬 및 Amazon ECS 컨테이너 에이전트에 전달하는 것입니다. 클라우드 boothook, 셸 스크립트, `cloud-init` 명령을 비롯하여 여러 유형의 사용자 데이터를 Amazon EC2에 전달할 수 있습니다. 이러한 유형 및 다른 형식 유형에 대한 자세한 정보는 [Cloud-Init 설명서](https://cloudinit.readthedocs.io/en/latest/explanation/format.html)를 참조하세요. Amazon EC2 시작 마법사를 사용할 때 사용자 데이터를 전달하려면 [Amazon ECS Linux 컨테이너 인스턴스 시작](launch_container_instance.md) 섹션을 참조하세요. 컨테이너 에이전트 구성 또는 Docker 대몬 구성의 데이터를 전달하도록 컨테이너 인스턴스를 구성할 수 있습니다. ## Amazon ECS 컨테이너 에이전트 Linux 변형의 Amazon ECS 최적화 AMI는 컨테이너 에이전트가 시작될 때 `/etc/ecs/ecs.config` 파일에서 에이전트 구성 데이터를 찾습니다. 시작 시 Amazon EC2 사용자 데이터를 사용하여 이 구성 데이터를 지정할 수 있습니다. 사용 가능한 Amazon ECS 컨테이너 에이전트 구성 변수에 대한 자세한 정보는 [Amazon ECS 컨테이너 에이전트 구성](ecs-agent-config.md) 섹션을 참조하세요. 클러스터 이름과 같이 단일 에이전트 구성 변수만 설정하려면 **echo**를 사용하여 구성 파일에 변수를 복사합니다. ``` #!/bin/bash echo "ECS_CLUSTER=MyCluster" >> /etc/ecs/ecs.config ``` `/etc/ecs/ecs.config`에 작성할 여러 변수가 있는 경우 다음 `heredoc` 형식을 사용합니다. 이 형식은 **cat**으로 시작하는 라인과 `EOF` 사이의 모든 항목을 구성 파일에 작성합니다. ``` #!/bin/bash cat <<'EOF' >> /etc/ecs/ecs.config ECS_CLUSTER=MyCluster ECS_ENGINE_AUTH_TYPE=docker ECS_ENGINE_AUTH_DATA={"https://index.docker.io/v1/":{"username":"my_name","password":"my_password","email":"email@example.com"}} ECS_LOGLEVEL=debug ECS_WARM_POOLS_CHECK=true EOF ``` 사용자 지정 인스턴스 속성을 설정하려면 `ECS_INSTANCE_ATTRIBUTES` 환경 변수를 설정합니다. ``` #!/bin/bash cat <<'EOF' >> ecs.config ECS_INSTANCE_ATTRIBUTES={"envtype":"prod"} EOF ``` ## Docker 대몬 Amazon EC2 사용자 데이터를 사용하여 Docker 대몬 구성 정보를 지정할 수 있습니다. 이 구성 옵션에 대한 자세한 정보는 [Docker 대몬 설명서](https://docs.docker.com/reference/cli/dockerd/)를 참조하세요. **참고** 사용자 지정 Docker 구성은 경우에 따라 경고 없이 향후 Amazon ECS 변경 사항이나 기능과 충돌할 수 있으므로 AWS에서 지원하지 않습니다. 아래 예에서 사용자 정의 옵션이 Docker 대몬 구성 파일 `/etc/docker/daemon.json`에 추가되며, 파일은 인스턴스가 시작될 때 사용자 데이터에 지정됩니다. ``` #!/bin/bash cat </etc/docker/daemon.json {"debug": true} EOF systemctl restart docker --no-block ``` 아래 예에서 사용자 정의 옵션이 Docker 대몬 구성 파일 `/etc/docker/daemon.json`에 추가되며, 파일은 인스턴스가 시작될 때 사용자 데이터에 지정됩니다. 이 예제에서는 Docker 대몬(daemon) 구성 파일에서 docker-proxy를 비활성화하는 방법을 보여줍니다. ``` #!/bin/bash cat </etc/docker/daemon.json {"userland-proxy": false} EOF systemctl restart docker --no-block ``` # 스팟 인스턴스 알림을 수신하도록 Amazon ECS Linux 컨테이너 인스턴스 구성 스팟 가격이 요청의 최고가를 초과하거나 용량이 더 이상 제공되지 않는 경우 Amazon EC2는 스팟 인스턴스를 종료, 중지 또는 최대 절전 모드로 전환합니다. Amazon EC2는 종료 및 중지 작업에 대해 스팟 인스턴스 2분 중단 알림을 제공합니다. 최대 절전 모드 작업에 대한 2분 알림을 제공하지 않습니다. 인스턴스에서 Amazon ECS 스팟 인스턴스 드레이닝이 활성화된 경우 Amazon ECS는 스팟 인스턴스 중단 알림을 수신하고 인스턴스를 `DRAINING` 상태로 둡니다. **중요** Amazon ECS는 Auto Scaling 용량 재분배에 의해 인스턴스가 제거될 때 Amazon EC2로부터 알림을 받지 않습니다. 자세한 정보는 [Amazon EC2 Auto Scaling 용량 재분배](https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-capacity-rebalancing.html)를 참조하세요. 컨테이너 인스턴스를 `DRAINING`으로 설정할 경우 Amazon ECS는 새 작업이 컨테이너 인스턴스에서 배치를 위해 예약되지 않도록 합니다. 드레이닝 컨테이너 인스턴스에서 `PENDING` 상태인 서비스 작업이 즉시 중지됩니다. 클러스터에 사용 가능한 컨테이너 인스턴스가 있는 경우 거기서 대체 서비스 작업이 시작됩니다. 스팟 인스턴스 드레이닝은 기본적으로 꺼져 있습니다. 인스턴스를 시작할 때 스팟 인스턴스 드레인을 켤 수 있습니다. **사용자 데이터** 필드에 다음 스크립트를 추가합니다. *MyCluster*를 컨테이너 인스턴스를 등록할 클러스터의 이름으로 바꿉니다. ``` #!/bin/bash cat <<'EOF' >> /etc/ecs/ecs.config ECS_CLUSTER=MyCluster ECS_ENABLE_SPOT_INSTANCE_DRAINING=true EOF ``` 자세한 내용은 [Amazon ECS Linux 컨테이너 인스턴스 시작](launch_container_instance.md) 섹션을 참조하세요. **기존 컨테이너 인스턴스에 스팟 인스턴스 드레이닝 사용 설정** 1. SSH를 통해 스팟 인스턴스에 연결합니다. 1. `/etc/ecs/ecs.config` 파일을 편집하고 다음을 추가합니다. ``` ECS_ENABLE_SPOT_INSTANCE_DRAINING=true ``` 1. `ecs` 서비스를 다시 시작합니다. + Amazon ECS 최적화 Amazon Linux 2 AMI의 경우: ``` sudo systemctl restart ecs ``` 1. (선택 사항) 에이전트 내부 검사 API 태스크를 쿼리하여 에이전트가 실행 중인지 확인하고 새 컨테이너 인스턴스에 대한 일부 정보를 볼 수 있습니다. 자세한 내용은 [Amazon ECS 컨테이너 내부 검사](ecs-agent-introspection.md) 섹션을 참조하세요. ``` curl http://localhost:51678/v1/metadata ``` # Amazon ECS Linux 컨테이너 인스턴스를 시작할 때 스크립트 실행 모니터링, 보안, 지표, 서비스 검색 또는 로깅과 같은 작업 또는 보안 문제를 처리하기 위해 모든 컨테이너 인스턴스에서 특정 컨테이너를 실행해야 할 수도 있습니다. 이렇게 하려면 시작 시 사용자 데이터 스크립트와 함께 **docker run** 명령(또는 일부 init 시스템에서는 Upstart나 **systemd** 등)을 호출하도록 컨테이너 인스턴스를 구성하는 것입니다. 이 방법은 효과적이지만 몇 가지 단점도 있는데, Amazon ECS는 컨테이너에 대한 지식이 없고 사용되는 CPU, 메모리, 포트 또는 기타 리소스를 모니터링할 수 없기 때문입니다. Amazon ECS가 모든 작업 리소스를 적절히 고려하도록 하려면 컨테이너 인스턴스에서 실행할 컨테이너의 태스크 정의를 생성합니다. 그런 다음 Amazon ECS를 사용하여 Amazon EC2 사용자 데이터와 함께 시작 시간에 태스크를 배치합니다. 다음 절차의 Amazon EC2 사용자 데이터 스크립트는 Amazon ECS 내부 검사 API를 사용하여 컨테이너 인스턴스를 식별한 다음 AWS CLI와 **start-task** 명령을 사용하여 시작 도중 지정된 태스크를 자체에서 실행합니다. **컨테이너 인스턴스 시작 시간에 태스크를 시작하려면** 1. `ecsInstanceRole` IAM 역할을 수정하여 `StartTask` API 작업에 대한 권한을 추가합니다. 자세한 내용은 *AWS Identity and Access Management 사용 설명서*의 [역할 권한 업데이트](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles_update-role-permissions.html)를 참조하세요. 1. Amazon ECS 최적화 Amazon Linux 2 AMI를 사용하여 하나 이상의 컨테이너 인스턴스를 시작합니다. 새 컨테이너 인스턴스를 시작하고 EC2 사용자 데이터에서 다음 예제 스크립트를 사용합니다. *your\$1cluster\$1name*을 등록할 컨테이너 인스턴스의 클러스터로, *my\$1task\$1def*를 시작 시 인스턴스에서 실행할 태스크 정의로 바꿉니다. 자세한 내용은 [Amazon ECS Linux 컨테이너 인스턴스 시작](launch_container_instance.md) 섹션을 참조하세요. **참고** 아래의 MIME 멀티파트 콘텐츠는 셸 스크립트를 사용하여 구성 값을 설정하고 패키지를 설치합니다. 또한 **ecs** 서비스가 실행되고 내부 검사 API를 사용할 수 있게 된 후 systemd 태스크를 사용하여 태스크를 시작합니다. ``` Content-Type: multipart/mixed; boundary="==BOUNDARY==" MIME-Version: 1.0 --==BOUNDARY== Content-Type: text/x-shellscript; charset="us-ascii" #!/bin/bash # Specify the cluster that the container instance should register into cluster=your_cluster_name # Write the cluster configuration variable to the ecs.config file # (add any other configuration variables here also) echo ECS_CLUSTER=$cluster >> /etc/ecs/ecs.config START_TASK_SCRIPT_FILE="/etc/ecs/ecs-start-task.sh" cat <<- 'EOF' > ${START_TASK_SCRIPT_FILE} exec 2>>/var/log/ecs/ecs-start-task.log set -x # Install prerequisite tools yum install -y jq aws-cli # Wait for the ECS service to be responsive until curl -s http://localhost:51678/v1/metadata do sleep 1 done # Grab the container instance ARN and AWS Region from instance metadata instance_arn=$(curl -s http://localhost:51678/v1/metadata | jq -r '. | .ContainerInstanceArn' | awk -F/ '{print $NF}' ) cluster=$(curl -s http://localhost:51678/v1/metadata | jq -r '. | .Cluster' | awk -F/ '{print $NF}' ) region=$(curl -s http://localhost:51678/v1/metadata | jq -r '. | .ContainerInstanceArn' | awk -F: '{print $4}') # Specify the task definition to run at launch task_definition=my_task_def # Run the AWS CLI start-task command to start your task on this container instance aws ecs start-task --cluster $cluster --task-definition $task_definition --container-instances $instance_arn --started-by $instance_arn --region $region EOF # Write systemd unit file UNIT="ecs-start-task.service" cat <<- EOF > /etc/systemd/system/${UNIT} [Unit] Description=ECS Start Task Requires=ecs.service After=ecs.service [Service] Restart=on-failure RestartSec=30 ExecStart=/usr/bin/bash ${START_TASK_SCRIPT_FILE} [Install] WantedBy=default.target EOF # Enable our ecs.service dependent service with `--no-block` to prevent systemd deadlock # See https://github.com/aws/amazon-ecs-agent/issues/1707 systemctl enable --now --no-block "${UNIT}" --==BOUNDARY==-- ``` 1. 컨테이너 인스턴스가 올바른 클러스터로 시작되고 태스크가 시작되었는지 확인합니다. 1. [https://console.aws.amazon.com/ecs/v2](https://console.aws.amazon.com/ecs/v2)에서 콘솔을 엽니다. 1. 탐색 모음에서 클러스터가 속한 리전을 선택합니다. 1. 탐색 창에서 **클러스터**를 선택하고 컨테이너 인스턴스를 호스팅하는 클러스터를 선택합니다. 1. **Cluster**(클러스터) 페이지에서 **Tasks**(작업)를 선택한 다음 작업을 선택합니다. 실행한 각 컨테이너 인스턴스에서 작업이 실행 중이어야 합니다. 작업이 보이지 않는 경우, SSH를 사용하여 컨테이너 인스턴스에 로그인하고 `/var/log/ecs/ecs-start-task.log` 파일에서 디버깅 정보를 확인할 수 있습니다. # Amazon ECS Linux 컨테이너 인스턴스 네트워크 인터페이스 증가 **참고** 이 기능은 Fargate에서 사용할 수 없습니다. `awsvpc` 네트워크 모드를 사용하는 각 작업은 고유한 탄력적 네트워크 인터페이스(ENI)를 수신합니다. 이 인터페이스는 이를 호스팅하는 컨테이너 인스턴스에 연결되어 있습니다. Amazon EC2 인스턴스에 연결할 수 있는 네트워크 인터페이스 수에 대한 기본 제한이 있으며 기본 네트워크 인터페이스는 한 개로 계산됩니다. 예를 들어 기본적으로 `c5.large` 인스턴스에는 ENI를 3개까지 연결할 수 있습니다. 인스턴스에 대한 기본 네트워크 인터페이스는 한 개로 계산되므로 인스턴스에 ENI를 2개 더 연결할 수 있습니다. `awsvpc` 네트워크 모드를 사용하는 각 작업에는 ENI가 필요하므로 대개 이 인스턴스 유형에서는 이러한 작업을 2개만 실행할 수 있습니다. Amazon ECS에서는 지원되는 Amazon EC2 인스턴스 유형을 사용하여 늘어난 ENI 밀도와 함께 컨테이너 인스턴스를 시작할 수 있습니다. 이러한 인스턴스 유형을 사용하고 `awsvpcTrunking` 계정 설정을 활성화하면 새로 시작된 컨테이너 인스턴스에서 추가 ENI를 사용할 수 있습니다. 이 구성을 통해 각 컨테이너 인스턴스에 추가 작업을 배치할 수 있습니다. 콘솔을 사용하여 기능을 켜려면 [Amazon ECS 계정 설정 수정](ecs-modifying-longer-id-settings.md) 섹션을 참조하세요. AWS CLI를 사용하여 기능을 켜려면 [AWS CLI를 사용하여 Amazon ECS 계정 설정 관리](account-setting-management-cli.md) 섹션을 참조하세요. 예를 들어 `awsvpcTrunking`이 있는 `c5.large` 인스턴스의 경우 ENI 제한이 12로 증가합니다. 컨테이너 인스턴스는 기본 네트워크 인터페이스를 가지며 Amazon ECS는 “트렁크” 네트워크 인터페이스를 생성하여 컨테이너 인스턴스에 연결합니다. 따라서 이 구성을 통해 컨테이너 인스턴스에서 현재 두 개의 작업 대신 10개의 태스크를 시작할 수 있습니다. 트렁크 네트워크 인터페이스는 Amazon ECS에 의해 완전히 관리되며 클러스터에서 컨테이너 인스턴스를 종료하거나 등록 취소할 때 삭제됩니다. 자세한 내용은 [EC2에 대한 Amazon ECS 태스크 네트워킹 옵션](task-networking.md) 섹션을 참조하세요. ## 고려 사항 ENI 트렁킹 기능을 사용하는 경우에는 다음을 고려하세요. + Amazon ECS 최적화 AMI의 Linux 변형 또는 버전 `1.28.1` 이상의 컨테이너 에이전트 및 버전 `1.28.1-2` 이상의 ecs-init 패키지를 포함하는 Amazon Linux 변형에서만 늘어난 ENI 제한을 지원합니다. Amazon ECS 최적화 AMI의 최신 Linux 변형을 사용하는 경우 이러한 요구 사항이 충족됩니다. Windows 컨테이너는 현재 지원되지 않습니다. + `awsvpcTrunking`을 활성화한 후 시작된 새 Amazon EC2 인스턴스만 늘어난 ENI 제한 및 트렁크 네트워크 인터페이스를 수신합니다. 이전에 시작한 인스턴스는 수행된 작업에 상관없이 이러한 기능을 받지 않습니다. + Amazon EC2 인스턴스에는 리소스 기반 IPv4 DNS 요청이 꺼져 있어야 합니다. 이 옵션을 비활성화하려면 Amazon EC2 콘솔에서 새 인스턴스를 생성할 때 **리소스 기반 IPV4(A 레코드) DNS 요청 활성화** 옵션을 삭제합니다. AWS CLI을(를) 사용하여 이 옵션을 비활성화하려면 다음 명령을 사용합니다. ``` aws ec2 modify-private-dns-name-options --instance-id i-xxxxxxx --no-enable-resource-name-dns-a-record --no-dry-run ``` + 공유 서브넷의 Amazon EC2 인스턴스는 지원되지 않습니다. 이 인스턴스를 사용하는 경우 클러스터에 등록하지 못합니다. + 태스크는 `awsvpc` 네트워크 모드 및 EC2를 사용해야 합니다. Fargate를 사용하는 태스크는 시작한 인스턴스의 개수에 상관없이 항상 전용 ENI를 수신하기 때문에 이 기능은 필요하지 않습니다. + 작업은 컨테이너 인스턴스와 동일한 Amazon VPC에서 시작해야 합니다. 작업이 동일한 VPC 내에 있지 않으면 속성 오류로 인해 태스크를 시작하지 못할 수 있습니다. + 새 컨테이너 인스턴스를 시작할 때 인스턴스가 `REGISTERING` 상태로 전환되며 해당 인스턴스에 대해 트렁크 탄력적 네트워크 인터페이스가 프로비저닝됩니다. 등록이 실패하면 인스턴스가 `REGISTRATION_FAILED` 상태로 전환됩니다. 실패 이유를 설명하는 `statusReason` 필드를 확인하기 위해 컨테이너 인스턴스를 설명하여 실패한 등록 문제를 해결할 수 있습니다. 입니다. 그런 다음 컨테이너 인스턴스를 수동으로 등록 취소하거나 종료할 수 있습니다. 컨테이너 인스턴스가 성공적으로 등록 취소되거나 종료되면 Amazon ECS가 트렁크 ENI를 삭제합니다. **참고** Amazon ECS는 컨테이너 인스턴스 상태 변경 이벤트를 발생시켜 사용자가 `REGISTRATION_FAILED` 상태로 전환하는 인스턴스를 모니터링할 수 있습니다. 자세한 정보는 [Amazon ECS 컨테이너 인스턴스 상태 변경 이벤트](ecs_container_instance_events.md) 섹션을 참조하세요. + 컨테이너 인스턴스가 종료되면 인스턴스가 `DEREGISTERING` 상태로 전환되며 트렁크 탄력적 네트워크 인터페이스가 프로비저닝 해제됩니다. 그런 다음 인스턴스가 `INACTIVE` 상태로 전환됩니다. + 늘어난 ENI 제한이 있는 퍼블릭 서브넷의 컨테이너 인스턴스가 중지된 후 다시 시작되면 인스턴스의 해당 퍼블릭 IP 주소가 없어지고 컨테이너 에이전트의 연결이 끊어집니다. + `awsvpcTrunking`을 활성화하면 컨테이너 인스턴스는 VPC의 기본 보안 그룹을 사용하는 추가 ENI를 수신하며 Amazon ECS에서 관리됩니다. 기본 VPC는 각 가용 영역의 퍼블릭 서브넷, 인터넷 게이트웨이 및 DNS 확인 활성화 설정과 함께 제공됩니다. 기본 라우팅 테이블은 인터넷으로 대상 주소가 정해진 서브넷의 트래픽을 인터넷 게이트웨이로 전송하기 때문에 서브넷은 퍼블릭 서브넷입니다. 대상 주소 0.0.0.0/0에서 인터넷 게이트웨이로의 라우팅을 제거함으로써 기본 서브넷을 프라이빗 서브넷으로 만들 수 있습니다. 하지만 이렇게 하면 해당 서브넷에서 실행하는 컨테이너 인스턴스는 인터넷에 액세스할 수 없습니다. 보안 그룹 규칙을 추가하거나 삭제하여 서브넷으로 들어오고 나가는 트래픽을 제어할 수 있습니다. 자세한 내용은 *Amazon Virtual Private Cloud 사용 설명서*의 [보안 그룹 규칙](https://docs.aws.amazon.com/vpc/latest/userguide/security-group-rules.html)을 참조하세요. ## 사전 조건 늘어난 ENI 제한이 있는 컨테이너 인스턴스를 시작하기 전에 다음 필수 조건을 완료해야 합니다. + Amazon ECS에 대한 서비스 연결 역할을 생성해야 합니다. Amazon ECS 서비스 연결 역할은 Amazon ECS에 사용자를 대신해서 다른 AWS 서비스를 호출할 수 있는 권한을 제공합니다. 이 역할은 클러스터를 생성하거나 AWS Management Console에서 서비스를 생성 또는 업데이트할 때 자동으로 생성됩니다. 자세한 정보는 [Amazon ECS에 대해 서비스 연결 역할 사용](using-service-linked-roles.md) 섹션을 참조하세요. 다음 AWS CLI 명령을 사용하여 서비스 연결 역할을 생성할 수도 있습니다. ``` aws iam [create-service-linked-role](https://docs.aws.amazon.com/cli/latest/reference/iam/create-service-linked-role.html) --aws-service-name ecs.amazonaws.com ``` + 계정 또는 컨테이너 인스턴스 IAM 역할이 `awsvpcTrunking` 계정 설정으로 활성화해야 합니다. 2개의 컨테이너 인스턴스 역할(`ecsInstanceRole`)을 생성하는 것이 좋습니다. 그런 다음, 역할 하나에 `awsvpcTrunking` 계정 설정을 활성화하고 ENI 트렁킹이 필요한 작업에 해당 역할을 사용할 수 있습니다. 컨테이너 인스턴스 역할에 대한 자세한 내용은 [Amazon ECS 컨테이너 인스턴스 IAM 역할](instance_IAM_role.md) 섹션을 참조하세요. 필수 조건이 충족되면 지원되는 Amazon EC2 인스턴스 유형 중 하나를 사용하여 새 컨테이너 인스턴스를 시작할 수 있으며, 해당 인스턴스에 늘어난 ENI 제한이 포함됩니다. 지원되는 인스턴스 유형의 목록은 [증가한 Amazon ECS 컨테이너 네트워크 인터페이스에 대해 지원되는 인스턴스](eni-trunking-supported-instance-types.md) 섹션을 참조하세요. 컨테이너 인스턴스에는 버전 `1.28.1` 이상의 컨테이너 에이전트 및 버전 `1.28.1-2` 이상의 ecs-init 패키지가 있어야 합니다. Amazon ECS 최적화 AMI의 최신 Linux 변형을 사용하는 경우 이러한 요구 사항이 충족됩니다. 자세한 내용은 [Amazon ECS Linux 컨테이너 인스턴스 시작](launch_container_instance.md) 섹션을 참조하세요. **중요** Amazon EC2 인스턴스에는 리소스 기반 IPv4 DNS 요청이 꺼져 있어야 합니다. 이 옵션을 비활성화하려면 **리소스 기반 IPV4(A 레코드) DNS 요청 활성화** 옵션이 Amazon EC2 콘솔을 사용하여 새 인스턴스를 생성할 때 선택 취소되었는지 확인합니다. AWS CLI을(를) 사용하여 이 옵션을 비활성화하려면 다음 명령을 사용합니다. ``` aws ec2 modify-private-dns-name-options --instance-id i-xxxxxxx --no-enable-resource-name-dns-a-record --no-dry-run ``` **AWS CLI를 사용하여 늘어난 ENI 제한이 있는 컨테이너 인스턴스를 보는 방법** 각 컨테이너 인스턴스에는 트렁크 네트워크 인터페이스라고 하는 기본 네트워크 인터페이스가 있습니다. 다음 명령을 통해 `ecs.awsvpc-trunk-id` 속성을 쿼리하여 늘어난 ENI 제한이 있는 컨테이너 인스턴스를 나열합니다. 이는 컨테이너 인스턴스에 트렁크 네트워크 인터페이스가 있음을 나타냅니다. + [list-attributes](https://docs.aws.amazon.com/cli/latest/reference/ecs/list-attributes.html)(AWS CLI) ``` aws ecs list-attributes \ --target-type container-instance \ --attribute-name ecs.awsvpc-trunk-id \ --cluster cluster_name \ --region us-east-1 ``` + [Get-ECSAttributeList](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-ECSAttributeList.html)(AWS Tools for Windows PowerShell) ``` Get-ECSAttributeList -TargetType container-instance -AttributeName ecs.awsvpc-trunk-id -Region us-east-1 ``` # 증가한 Amazon ECS 컨테이너 네트워크 인터페이스에 대해 지원되는 인스턴스 다음은 지원되는 Amazon EC2 인스턴스 유형 및 `awsvpcTrunking` 계정 설정을 활성화하기 전과 후 각 인스턴스 유형에서 `awsvpc` 네트워크 모드를 사용하는 여러 작업을 시작할 수 있는 방법을 보여줍니다. **중요** 다른 인스턴스 유형이 동일한 인스턴스 패밀리에서 지원되지만 `a1.metal`, `c5.metal`, `c5a.8xlarge`, `c5ad.8xlarge`, `c5d.metal`, `m5.metal`, `p3dn.24xlarge`, `r5.metal`, `r5.8xlarge` 및 `r5d.metal` 인스턴스 유형은 지원되지 않습니다. `c5n`, `d3`, `d3en`, `g3`, `g3s`, `g4dn`, `i3`, `i3en`, `inf1`, `m5dn`, `m5n`, `m5zn`, `mac1`, `r5b`, `r5n`, `r5dn`, `u-12tb1`, `u-6tb1`, `u-9tb1` 및 `z1d` 인스턴스 패밀리는 지원되지 않습니다. **Topics** + [범용](#eni-branch-gp) + [컴퓨팅 최적화](#eni-branch-co) + [메모리 최적화](#eni-branch-mo) + [스토리지 최적화](#eni-branch-so) + [가속 컴퓨팅](#eni-branch-ac) + [고성능 컴퓨팅](#eni-branch-hpc) ## 범용 | 인스턴스 유형 | ENI 트렁킹이 없는 작업 제한 | ENI 트렁킹을 포함하는 작업 제한 | | --- | --- | --- | | a1.medium | 1 | 10 | | a1.large | 2 | 10 | | a1.xlarge | 3 | 20 | | a1.2xlarge | 3 | 40 | | a1.4xlarge | 7 | 60 | | m5.large | 2 | 10 | | m5.xlarge | 3 | 20 | | m5.2xlarge | 3 | 40 | | m5.4xlarge | 7 | 60 | | m5.8xlarge | 7 | 60 | | m5.12xlarge | 7 | 60 | | m5.16xlarge | 14 | 120 | | m5.24xlarge | 14 | 120 | | m5a.large | 2 | 10 | | m5a.xlarge | 3 | 20 | | m5a.2xlarge | 3 | 40 | | m5a.4xlarge | 7 | 60 | | m5a.8xlarge | 7 | 60 | | m5a.12xlarge | 7 | 60 | | m5a.16xlarge | 14 | 120 | | m5a.24xlarge | 14 | 120 | | m5ad.large | 2 | 10 | | m5ad.xlarge | 3 | 20 | | m5ad.2xlarge | 3 | 40 | | m5ad.4xlarge | 7 | 60 | | m5ad.8xlarge | 7 | 60 | | m5ad.12xlarge | 7 | 60 | | m5ad.16xlarge | 14 | 120 | | m5ad.24xlarge | 14 | 120 | | m5d.large | 2 | 10 | | m5d.xlarge | 3 | 20 | | m5d.2xlarge | 3 | 40 | | m5d.4xlarge | 7 | 60 | | m5d.8xlarge | 7 | 60 | | m5d.12xlarge | 7 | 60 | | m5d.16xlarge | 14 | 120 | | m5d.24xlarge | 14 | 120 | | m5d.metal | 14 | 120 | | m6a.large | 2 | 10 | | m6a.xlarge | 3 | 20 | | m6a.2xlarge | 3 | 40 | | m6a.4xlarge | 7 | 60 | | m6a.8xlarge | 7 | 90 | | m6a.12xlarge | 7 | 120 | | m6a.16xlarge | 14 | 120 | | m6a.24xlarge | 14 | 120 | | m6a.32xlarge | 14 | 120 | | m6a.48xlarge | 14 | 120 | | m6a.metal | 14 | 120 | | m6g.medium | 1 | 4 | | m6g.large | 2 | 10 | | m6g.xlarge | 3 | 20 | | m6g.2xlarge | 3 | 40 | | m6g.4xlarge | 7 | 60 | | m6g.8xlarge | 7 | 60 | | m6g.12xlarge | 7 | 60 | | m6g.16xlarge | 14 | 120 | | m6g.metal | 14 | 120 | | m6gd.medium | 1 | 4 | | m6gd.large | 2 | 10 | | m6gd.xlarge | 3 | 20 | | m6gd.2xlarge | 3 | 40 | | m6gd.4xlarge | 7 | 60 | | m6gd.8xlarge | 7 | 60 | | m6gd.12xlarge | 7 | 60 | | m6gd.16xlarge | 14 | 120 | | m6gd.metal | 14 | 120 | | m6i.large | 2 | 10 | | m6i.xlarge | 3 | 20 | | m6i.2xlarge | 3 | 40 | | m6i.4xlarge | 7 | 60 | | m6i.8xlarge | 7 | 90 | | m6i.12xlarge | 7 | 120 | | m6i.16xlarge | 14 | 120 | | m6i.24xlarge | 14 | 120 | | m6i.32xlarge | 14 | 120 | | m6i.metal | 14 | 120 | | m6id.large | 2 | 10 | | m6id.xlarge | 3 | 20 | | m6id.2xlarge | 3 | 40 | | m6id.4xlarge | 7 | 60 | | m6id.8xlarge | 7 | 90 | | m6id.12xlarge | 7 | 120 | | m6id.16xlarge | 14 | 120 | | m6id.24xlarge | 14 | 120 | | m6id.32xlarge | 14 | 120 | | m6id.metal | 14 | 120 | | m6idn.large | 2 | 10 | | m6idn.xlarge | 3 | 20 | | m6idn.2xlarge | 3 | 40 | | m6idn.4xlarge | 7 | 60 | | m6idn.8xlarge | 7 | 90 | | m6idn.12xlarge | 7 | 120 | | m6idn.16xlarge | 14 | 120 | | m6idn.24xlarge | 14 | 120 | | m6idn.32xlarge | 15 | 120 | | m6idn.metal | 15 | 120 | | m6in.large | 2 | 10 | | m6in.xlarge | 3 | 20 | | m6in.2xlarge | 3 | 40 | | m6in.4xlarge | 7 | 60 | | m6in.8xlarge | 7 | 90 | | m6in.12xlarge | 7 | 120 | | m6in.16xlarge | 14 | 120 | | m6in.24xlarge | 14 | 120 | | m6in.32xlarge | 15 | 120 | | m6in.metal | 15 | 120 | | m7a.medium | 1 | 4 | | m7a.large | 2 | 10 | | m7a.xlarge | 3 | 20 | | m7a.2xlarge | 3 | 40 | | m7a.4xlarge | 7 | 60 | | m7a.8xlarge | 7 | 90 | | m7a.12xlarge | 7 | 120 | | m7a.16xlarge | 14 | 120 | | m7a.24xlarge | 14 | 120 | | m7a.32xlarge | 14 | 120 | | m7a.48xlarge | 14 | 120 | | m7a.metal-48xl | 14 | 120 | | m7g.medium | 1 | 4 | | m7g.large | 2 | 10 | | m7g.xlarge | 3 | 20 | | m7g.2xlarge | 3 | 40 | | m7g.4xlarge | 7 | 60 | | m7g.8xlarge | 7 | 60 | | m7g.12xlarge | 7 | 60 | | m7g.16xlarge | 14 | 120 | | m7g.metal | 14 | 120 | | m7gd.medium | 1 | 4 | | m7gd.large | 2 | 10 | | m7gd.xlarge | 3 | 20 | | m7gd.2xlarge | 3 | 40 | | m7gd.4xlarge | 7 | 60 | | m7gd.8xlarge | 7 | 60 | | m7gd.12xlarge | 7 | 60 | | m7gd.16xlarge | 14 | 120 | | m7gd.metal | 14 | 120 | | m7i.large | 2 | 10 | | m7i.xlarge | 3 | 20 | | m7i.2xlarge | 3 | 40 | | m7i.4xlarge | 7 | 60 | | m7i.8xlarge | 7 | 90 | | m7i.12xlarge | 7 | 120 | | m7i.16xlarge | 14 | 120 | | m7i.24xlarge | 14 | 120 | | m7i.48xlarge | 14 | 120 | | m7i.metal-24xl | 14 | 120 | | m7i.metal-48xl | 14 | 120 | | m7i-flex.large | 2 | 4 | | m7i-flex.xlarge | 3 | 10 | | m7i-flex.2xlarge | 3 | 20 | | m7i-flex.4xlarge | 7 | 40 | | m7i-flex.8xlarge | 7 | 60 | | m7i-flex.12xlarge | 7 | 120 | | m7i-flex.16xlarge | 14 | 120 | | m8a.medium | 1 | 4 | | m8a.large | 2 | 10 | | m8a.xlarge | 3 | 20 | | m8a.2xlarge | 3 | 40 | | m8a.4xlarge | 7 | 60 | | m8a.8xlarge | 9 | 90 | | m8a.12xlarge | 11 | 120 | | m8a.16xlarge | 15 | 120 | | m8a.24xlarge | 15 | 120 | | m8a.48xlarge | 23 | 120 | | m8a.metal-24xl | 15 | 120 | | m8a.metal-48xl | 23 | 120 | | m8azn.medium | 2 | 4 | | m8azn.large | 3 | 10 | | m8azn.xlarge | 3 | 20 | | m8azn.3xlarge | 7 | 40 | | m8azn.6xlarge | 7 | 60 | | m8azn.12xlarge | 15 | 120 | | m8azn.24xlarge | 15 | 120 | | m8azn.metal-12xl | 15 | 120 | | m8azn.metal-24xl | 15 | 120 | | m8g.medium | 1 | 4 | | m8g.large | 2 | 10 | | m8g.xLarge | 3 | 20 | | m8g.2xlarge | 3 | 40 | | m8g.4xlarge | 7 | 60 | | m8g.8xlarge | 7 | 60 | | m8g.12xlarge | 7 | 60 | | m8g.16xlarge | 14 | 120 | | m8g.24xlarge | 14 | 120 | | m8g.48xlarge | 14 | 120 | | m8g.metal-24xl | 14 | 120 | | m8g.metal-48xl | 14 | 120 | | m8gb.medium | 1 | 4 | | m8gb.large | 2 | 10 | | m8gb.xlarge | 3 | 20 | | m8gb.2xlarge | 3 | 40 | | m8gb.4xlarge | 7 | 60 | | m8gb.8xlarge | 9 | 60 | | m8gb.12xlarge | 11 | 60 | | m8gb.16xlarge | 15 | 120 | | m8gb.24xlarge | 23 | 120 | | m8gb.48xlarge | 23 | 120 | | m8gb.metal-24xl | 23 | 120 | | m8gb.metal-48xl | 23 | 120 | | m8gd.medium | 1 | 4 | | m8gd.large | 2 | 10 | | m8gd.xlarge | 3 | 20 | | m8gd.2xlarge | 3 | 40 | | m8gd.4xlarge | 7 | 60 | | m8gd.8xlarge | 7 | 60 | | m8gd.12xlarge | 7 | 60 | | m8gd.16xlarge | 14 | 120 | | m8gd.24xlarge | 14 | 120 | | m8gd.48xlarge | 14 | 120 | | m8gd.metal-24xl | 14 | 120 | | m8gd.metal-48xl | 14 | 120 | | m8gn.medium | 1 | 4 | | m8gn.large | 2 | 10 | | m8gn.xlarge | 3 | 20 | | m8gn.2xlarge | 3 | 40 | | m8gn.4xlarge | 7 | 60 | | m8gn.8xlarge | 9 | 60 | | m8gn.12xlarge | 11 | 60 | | m8gn.16xlarge | 15 | 120 | | m8gn.24xlarge | 23 | 120 | | m8gn.48xlarge | 23 | 120 | | m8gn.metal-24xl | 23 | 120 | | m8gn.metal-48xl | 23 | 120 | | m8i.large | 2 | 10 | | m8i.xlarge | 3 | 20 | | m8i.2xlarge | 3 | 40 | | m8i.4xlarge | 7 | 60 | | m8i.8xlarge | 9 | 90 | | m8i.12xlarge | 11 | 120 | | m8i.16xlarge | 15 | 120 | | m8i.24xlarge | 15 | 120 | | m8i.32xlarge | 23 | 120 | | m8i.48xlarge | 23 | 120 | | m8i.96xlarge | 23 | 120 | | m8i.metal-48xl | 23 | 120 | | m8i.metal-96xl | 23 | 120 | | m8id.large | 2 | 10 | | m8id.xlarge | 3 | 20 | | m8id.2xlarge | 3 | 40 | | m8id.4xlarge | 7 | 60 | | m8id.8xlarge | 9 | 90 | | m8id.12xlarge | 11 | 120 | | m8id.16xlarge | 15 | 120 | | m8id.24xlarge | 15 | 120 | | m8id.32xlarge | 23 | 120 | | m8id.48xlarge | 23 | 120 | | m8id.96xlarge | 23 | 120 | | m8id.metal-48xl | 23 | 120 | | m8id.metal-96xl | 23 | 120 | | m8i-flex.large | 2 | 4 | | m8i-flex.xlarge | 3 | 10 | | m8i-flex.2xlarge | 3 | 20 | | m8i-flex.4xlarge | 7 | 40 | | m8i-flex.8xlarge | 9 | 60 | | m8i-flex.12xlarge | 11 | 120 | | m8i-flex.16xlarge | 15 | 120 | | mac2.metal | 7 | 12 | | mac2-m1ultra.metal | 7 | 12 | | mac2-m2.metal | 7 | 12 | | mac2-m2pro.metal | 7 | 12 | | mac-m4.metal | 7 | 12 | | mac-m4pro.metal | 7 | 12 | ## 컴퓨팅 최적화 | 인스턴스 유형 | ENI 트렁킹이 없는 작업 제한 | ENI 트렁킹을 포함하는 작업 제한 | | --- | --- | --- | | c5.large | 2 | 10 | | c5.xlarge | 3 | 20 | | c5.2xlarge | 3 | 40 | | c5.4xlarge | 7 | 60 | | c5.9xlarge | 7 | 60 | | c5.12xlarge | 7 | 60 | | c5.18xlarge | 14 | 120 | | c5.24xlarge | 14 | 120 | | c5a.large | 2 | 10 | | c5a.xlarge | 3 | 20 | | c5a.2xlarge | 3 | 40 | | c5a.4xlarge | 7 | 60 | | c5a.12xlarge | 7 | 60 | | c5a.16xlarge | 14 | 120 | | c5a.24xlarge | 14 | 120 | | c5ad.large | 2 | 10 | | c5ad.xlarge | 3 | 20 | | c5ad.2xlarge | 3 | 40 | | c5ad.4xlarge | 7 | 60 | | c5ad.12xlarge | 7 | 60 | | c5ad.16xlarge | 14 | 120 | | c5ad.24xlarge | 14 | 120 | | c5d.large | 2 | 10 | | c5d.xlarge | 3 | 20 | | c5d.2xlarge | 3 | 40 | | c5d.4xlarge | 7 | 60 | | c5d.9xlarge | 7 | 60 | | c5d.12xlarge | 7 | 60 | | c5d.18xlarge | 14 | 120 | | c5d.24xlarge | 14 | 120 | | c6a.large | 2 | 10 | | c6a.xlarge | 3 | 20 | | c6a.2xlarge | 3 | 40 | | c6a.4xlarge | 7 | 60 | | c6a.8xlarge | 7 | 90 | | c6a.12xlarge | 7 | 120 | | c6a.16xlarge | 14 | 120 | | c6a.24xlarge | 14 | 120 | | c6a.32xlarge | 14 | 120 | | c6a.48xlarge | 14 | 120 | | c6a.metal | 14 | 120 | | c6g.medium | 1 | 4 | | c6g.large | 2 | 10 | | c6g.xlarge | 3 | 20 | | c6g.2xlarge | 3 | 40 | | c6g.4xlarge | 7 | 60 | | c6g.8xlarge | 7 | 60 | | c6g.12xlarge | 7 | 60 | | c6g.16xlarge | 14 | 120 | | c6g.metal | 14 | 120 | | c6gd.medium | 1 | 4 | | c6gd.large | 2 | 10 | | c6gd.xlarge | 3 | 20 | | c6gd.2xlarge | 3 | 40 | | c6gd.4xlarge | 7 | 60 | | c6gd.8xlarge | 7 | 60 | | c6gd.12xlarge | 7 | 60 | | c6gd.16xlarge | 14 | 120 | | c6gd.metal | 14 | 120 | | c6gn.medium | 1 | 4 | | c6gn.large | 2 | 10 | | c6gn.xlarge | 3 | 20 | | c6gn.2xlarge | 3 | 40 | | c6gn.4xlarge | 7 | 60 | | c6gn.8xlarge | 7 | 60 | | c6gn.12xlarge | 7 | 60 | | c6gn.16xlarge | 14 | 120 | | c6i.large | 2 | 10 | | c6i.xlarge | 3 | 20 | | c6i.2xlarge | 3 | 40 | | c6i.4xlarge | 7 | 60 | | c6i.8xlarge | 7 | 90 | | c6i.12xlarge | 7 | 120 | | c6i.16xlarge | 14 | 120 | | c6i.24xlarge | 14 | 120 | | c6i.32xlarge | 14 | 120 | | c6i.metal | 14 | 120 | | c6id.large | 2 | 10 | | c6id.xlarge | 3 | 20 | | c6id.2xlarge | 3 | 40 | | c6id.4xlarge | 7 | 60 | | c6id.8xlarge | 7 | 90 | | c6id.12xlarge | 7 | 120 | | c6id.16xlarge | 14 | 120 | | c6id.24xlarge | 14 | 120 | | c6id.32xlarge | 14 | 120 | | c6id.metal | 14 | 120 | | c6in.large | 2 | 10 | | c6in.xlarge | 3 | 20 | | c6in.2xlarge | 3 | 40 | | c6in.4xlarge | 7 | 60 | | c6in.8xlarge | 7 | 90 | | c6in.12xlarge | 7 | 120 | | c6in.16xlarge | 14 | 120 | | c6in.24xlarge | 14 | 120 | | c6in.32xlarge | 15 | 120 | | c6in.metal | 15 | 120 | | c7a.medium | 1 | 4 | | c7a.large | 2 | 10 | | c7a.xlarge | 3 | 20 | | c7a.2xlarge | 3 | 40 | | c7a.4xlarge | 7 | 60 | | c7a.8xlarge | 7 | 90 | | c7a.12xlarge | 7 | 120 | | c7a.16xlarge | 14 | 120 | | c7a.24xlarge | 14 | 120 | | c7a.32xlarge | 14 | 120 | | c7a.48xlarge | 14 | 120 | | c7a.metal-48xl | 14 | 120 | | c7g.medium | 1 | 4 | | c7g.large | 2 | 10 | | c7g.xlarge | 3 | 20 | | c7g.2xlarge | 3 | 40 | | c7g.4xlarge | 7 | 60 | | c7g.8xlarge | 7 | 60 | | c7g.12xlarge | 7 | 60 | | c7g.16xlarge | 14 | 120 | | c7g.metal | 14 | 120 | | c7gd.medium | 1 | 4 | | c7gd.large | 2 | 10 | | c7gd.xlarge | 3 | 20 | | c7gd.2xlarge | 3 | 40 | | c7gd.4xlarge | 7 | 60 | | c7gd.8xlarge | 7 | 60 | | c7gd.12xlarge | 7 | 60 | | c7gd.16xlarge | 14 | 120 | | c7gd.metal | 14 | 120 | | c7gn.medium | 1 | 4 | | c7gn.large | 2 | 10 | | c7gn.xlarge | 3 | 20 | | c7gn.2xlarge | 3 | 40 | | c7gn.4xlarge | 7 | 60 | | c7gn.8xlarge | 7 | 60 | | c7gn.12xlarge | 7 | 60 | | c7gn.16xlarge | 14 | 120 | | c7gn.metal | 14 | 120 | | c7i.large | 2 | 10 | | c7i.xlarge | 3 | 20 | | c7i.2xlarge | 3 | 40 | | c7i.4xlarge | 7 | 60 | | c7i.8xlarge | 7 | 90 | | c7i.12xlarge | 7 | 120 | | c7i.16xlarge | 14 | 120 | | c7i.24xlarge | 14 | 120 | | c7i.48xlarge | 14 | 120 | | c7i.metal-24xl | 14 | 120 | | c7i.metal-48xl | 14 | 120 | | c7i-flex.large | 2 | 4 | | c7i-flex.xlarge | 3 | 10 | | c7i-flex.2xlarge | 3 | 20 | | c7i-flex.4xlarge | 7 | 40 | | c7i-flex.8xlarge | 7 | 60 | | c7i-flex.12xlarge | 7 | 120 | | c7i-flex.16xlarge | 14 | 120 | | c8a.medium | 1 | 4 | | c8a.large | 2 | 10 | | c8a.xlarge | 3 | 20 | | c8a.2xlarge | 3 | 40 | | c8a.4xlarge | 7 | 60 | | c8a.8xlarge | 9 | 90 | | c8a.12xlarge | 11 | 120 | | c8a.16xlarge | 15 | 120 | | c8a.24xlarge | 15 | 120 | | c8a.48xlarge | 23 | 120 | | c8a.metal-24xl | 15 | 120 | | c8a.metal-48xl | 23 | 120 | | c8g.medium | 1 | 4 | | c8g.large | 2 | 10 | | c8g.xlarge | 3 | 20 | | c8g.2xlarge | 3 | 40 | | c8g.4xlarge | 7 | 60 | | c8g.8xlarge | 7 | 60 | | c8g.12xlarge | 7 | 60 | | c8g.16xlarge | 14 | 120 | | c8g.24xlarge | 14 | 120 | | c8g.48xlarge | 14 | 120 | | c8g.metal-24xl | 14 | 120 | | c8g.metal-48xl | 14 | 120 | | c8gb.medium | 1 | 4 | | c8gb.large | 2 | 10 | | c8gb.xlarge | 3 | 20 | | c8gb.2xlarge | 3 | 40 | | c8gb.4xlarge | 7 | 60 | | c8gb.8xlarge | 9 | 60 | | c8gb.12xlarge | 11 | 60 | | c8gb.16xlarge | 15 | 120 | | c8gb.24xlarge | 23 | 120 | | c8gb.48xlarge | 23 | 120 | | c8gb.metal-24xl | 23 | 120 | | c8gb.metal-48xl | 23 | 120 | | c8gd.medium | 1 | 4 | | c8gd.large | 2 | 10 | | c8gd.xlarge | 3 | 20 | | c8gd.2xlarge | 3 | 40 | | c8gd.4xlarge | 7 | 60 | | c8gd.8xlarge | 7 | 60 | | c8gd.12xlarge | 7 | 60 | | c8gd.16xlarge | 14 | 120 | | c8gd.24xlarge | 14 | 120 | | c8gd.48xlarge | 14 | 120 | | c8gd.metal-24xl | 14 | 120 | | c8gd.metal-48xl | 14 | 120 | | c8gn.medium | 1 | 4 | | c8gn.large | 2 | 10 | | c8gn.xlarge | 3 | 20 | | c8gn.2xlarge | 3 | 40 | | c8gn.4xlarge | 7 | 60 | | c8gn.8xlarge | 9 | 60 | | c8gn.12xlarge | 11 | 60 | | c8gn.16xlarge | 15 | 120 | | c8gn.24xlarge | 23 | 120 | | c8gn.48xlarge | 23 | 120 | | c8gn.metal-24xl | 23 | 120 | | c8gn.metal-48xl | 23 | 120 | | c8i.large | 2 | 10 | | c8i.xlarge | 3 | 20 | | c8i.2xlarge | 3 | 40 | | c8i.4xlarge | 7 | 60 | | c8i.8xlarge | 9 | 90 | | c8i.12xlarge | 11 | 120 | | c8i.16xlarge | 15 | 120 | | c8i.24xlarge | 15 | 120 | | c8i.32xlarge | 23 | 120 | | c8i.48xlarge | 23 | 120 | | c8i.96xlarge | 23 | 120 | | c8i.metal-48xl | 23 | 120 | | c8i.metal-96xl | 23 | 120 | | c8id.large | 2 | 10 | | c8id.xlarge | 3 | 20 | | c8id.2xlarge | 3 | 40 | | c8id.4xlarge | 7 | 60 | | c8id.8xlarge | 9 | 90 | | c8id.12xlarge | 11 | 120 | | c8id.16xlarge | 15 | 120 | | c8id.24xlarge | 15 | 120 | | c8id.32xlarge | 23 | 120 | | c8id.48xlarge | 23 | 120 | | c8id.96xlarge | 23 | 120 | | c8id.metal-48xl | 23 | 120 | | c8id.metal-96xl | 23 | 120 | | c8i-flex.large | 2 | 4 | | c8i-flex.xlarge | 3 | 10 | | c8i-flex.2xlarge | 3 | 20 | | c8i-flex.4xlarge | 7 | 40 | | c8i-flex.8xlarge | 9 | 60 | | c8i-flex.12xlarge | 11 | 120 | | c8i-flex.16xlarge | 15 | 120 | ## 메모리 최적화 | 인스턴스 유형 | ENI 트렁킹이 없는 작업 제한 | ENI 트렁킹을 포함하는 작업 제한 | | --- | --- | --- | | r5.large | 2 | 10 | | r5.xlarge | 3 | 20 | | r5.2xlarge | 3 | 40 | | r5.4xlarge | 7 | 60 | | r5.12xlarge | 7 | 60 | | r5.16xlarge | 14 | 120 | | r5.24xlarge | 14 | 120 | | r5a.large | 2 | 10 | | r5a.xlarge | 3 | 20 | | r5a.2xlarge | 3 | 40 | | r5a.4xlarge | 7 | 60 | | r5a.8xlarge | 7 | 60 | | r5a.12xlarge | 7 | 60 | | r5a.16xlarge | 14 | 120 | | r5a.24xlarge | 14 | 120 | | r5ad.large | 2 | 10 | | r5ad.xlarge | 3 | 20 | | r5ad.2xlarge | 3 | 40 | | r5ad.4xlarge | 7 | 60 | | r5ad.8xlarge | 7 | 60 | | r5ad.12xlarge | 7 | 60 | | r5ad.16xlarge | 14 | 120 | | r5ad.24xlarge | 14 | 120 | | r5b.16xlarge | 14 | 120 | | r5d.large | 2 | 10 | | r5d.xlarge | 3 | 20 | | r5d.2xlarge | 3 | 40 | | r5d.4xlarge | 7 | 60 | | r5d.8xlarge | 7 | 60 | | r5d.12xlarge | 7 | 60 | | r5d.16xlarge | 14 | 120 | | r5d.24xlarge | 14 | 120 | | r5dn.16xlarge | 14 | 120 | | r6a.large | 2 | 10 | | r6a.xlarge | 3 | 20 | | r6a.2xlarge | 3 | 40 | | r6a.4xlarge | 7 | 60 | | r6a.8xlarge | 7 | 90 | | r6a.12xlarge | 7 | 120 | | r6a.16xlarge | 14 | 120 | | r6a.24xlarge | 14 | 120 | | r6a.32xlarge | 14 | 120 | | r6a.48xlarge | 14 | 120 | | r6a.metal | 14 | 120 | | r6g.medium | 1 | 4 | | r6g.large | 2 | 10 | | r6g.xlarge | 3 | 20 | | r6g.2xlarge | 3 | 40 | | r6g.4xlarge | 7 | 60 | | r6g.8xlarge | 7 | 60 | | r6g.12xlarge | 7 | 60 | | r6g.16xlarge | 14 | 120 | | r6g.metal | 14 | 120 | | r6gd.미디엄 | 1 | 4 | | r6gd.large | 2 | 10 | | r6gd.xlarge | 3 | 20 | | r6gd.2xlarge | 3 | 40 | | r6gd.4xlarge | 7 | 60 | | r6gd.8xlarge | 7 | 60 | | r6gd.12xlarge | 7 | 60 | | r6gd.16xlarge | 14 | 120 | | r6gd.metal | 14 | 120 | | r6i.large | 2 | 10 | | r6i.xlarge | 3 | 20 | | r6g.2xlarge | 3 | 40 | | r6i.4xlarge | 7 | 60 | | r6i.8xlarge | 7 | 90 | | r6i.12xlarge | 7 | 120 | | r6i.16xlarge | 14 | 120 | | r6i.24xlarge | 14 | 120 | | r6i.32xlarge | 14 | 120 | | r6i.metal | 14 | 120 | | r6id.large | 2 | 10 | | r6id.xlarge | 3 | 20 | | r6id.2xlarge | 3 | 40 | | r6id.4xlarge | 7 | 60 | | r6id.8xlarge | 7 | 90 | | r6id.12xlarge | 7 | 120 | | r6id.16xlarge | 14 | 120 | | r6id.24xlarge | 14 | 120 | | r6id.32xlarge | 14 | 120 | | r6id.metal | 14 | 120 | | r6idn.large | 2 | 10 | | r6idn.xlarge | 3 | 20 | | r6idn.2xlarge | 3 | 40 | | r6idn.4xlarge | 7 | 60 | | r6idn.8xlarge | 7 | 90 | | r6idn.12xlarge | 7 | 120 | | r6idn.16xlarge | 14 | 120 | | r6idn.24xlarge | 14 | 120 | | r6idn.32xlarge | 15 | 120 | | r6idn.metal | 15 | 120 | | r6in.large | 2 | 10 | | r6in.xlarge | 3 | 20 | | r6in.2xlarge | 3 | 40 | | r6in.4xlarge | 7 | 60 | | r6in.8xlarge | 7 | 90 | | r6in.12xlarge | 7 | 120 | | r6in.16xlarge | 14 | 120 | | r6in.24xlarge | 14 | 120 | | r6in.32xlarge | 15 | 120 | | r6in.metal | 15 | 120 | | r7a.medium | 1 | 4 | | r7a.large | 2 | 10 | | r7a.xlarge | 3 | 20 | | r7a.2xlarge | 3 | 40 | | r7a.4xlarge | 7 | 60 | | r7a.8xlarge | 7 | 90 | | r7a.12xlarge | 7 | 120 | | r7a.16xlarge | 14 | 120 | | r7a.24xlarge | 14 | 120 | | r7a.32xlarge | 14 | 120 | | r7a.48xlarge | 14 | 120 | | r7a.metal-48xl | 14 | 120 | | r7g.medium | 1 | 4 | | r7g.large | 2 | 10 | | r7g.xlarge | 3 | 20 | | r7g.2xlarge | 3 | 40 | | r7g.4xlarge | 7 | 60 | | r7g.8xlarge | 7 | 60 | | r7g.12xlarge | 7 | 60 | | r7g.16xlarge | 14 | 120 | | r7g.metal | 14 | 120 | | r7gd.medium | 1 | 4 | | r7gd.large | 2 | 10 | | r7gd.xlarge | 3 | 20 | | r7gd.2xlarge | 3 | 40 | | r7gd.4xlarge | 7 | 60 | | r7gd.8xlarge | 7 | 60 | | r7gd.12xlarge | 7 | 60 | | r7gd.16xlarge | 14 | 120 | | r7gd.metal | 14 | 120 | | r7i.large | 2 | 10 | | r7i.xlarge | 3 | 20 | | r7i.2xlarge | 3 | 40 | | r7i.4xlarge | 7 | 60 | | r7i.8xlarge | 7 | 90 | | r7i.12xlarge | 7 | 120 | | r7i.16xlarge | 14 | 120 | | r7i.24xlarge | 14 | 120 | | r7i.48xlarge | 14 | 120 | | r7i.metal-24xl | 14 | 120 | | r7i.metal-48xl | 14 | 120 | | r7iz.large | 2 | 10 | | r7iz.xlarge | 3 | 20 | | r7iz.2xlarge | 3 | 40 | | r7iz.4xlarge | 7 | 60 | | r7iz.8xlarge | 7 | 90 | | r7iz.12xlarge | 7 | 120 | | r7iz.16xlarge | 14 | 120 | | r7iz.32xlarge | 14 | 120 | | r7iz.metal-16xl | 14 | 120 | | r7iz.metal-32xl | 14 | 120 | | r8a.medium | 1 | 4 | | r8a.large | 2 | 10 | | r8a.xlarge | 3 | 20 | | r8a.2xlarge | 3 | 40 | | r8a.4xlarge | 7 | 60 | | r8a.8xlarge | 9 | 90 | | r8a.12xlarge | 11 | 120 | | r8a.16xlarge | 15 | 120 | | r8a.24xlarge | 15 | 120 | | r8a.48xlarge | 23 | 120 | | r8a.metal-24xl | 15 | 120 | | r8a.metal-48xl | 23 | 120 | | r8g.medium | 1 | 4 | | r8g.large | 2 | 10 | | r8g.xlarge | 3 | 20 | | r8g.2xlarge | 3 | 40 | | r8g.4xlarge | 7 | 60 | | r8g.8xlarge | 7 | 60 | | r8g.12xlarge | 7 | 60 | | r8g.16xlarge | 14 | 120 | | r8g.24xlarge | 14 | 120 | | r8g.48xlarge | 14 | 120 | | r8g.metal-24xl | 14 | 120 | | r8g.metal-48xl | 14 | 120 | | r8gb.medium | 1 | 4 | | r8gb.large | 2 | 10 | | r8gb.xlarge | 3 | 20 | | r8gb.2xlarge | 3 | 40 | | r8gb.4xlarge | 7 | 60 | | r8gb.8xlarge | 9 | 60 | | r8gb.12xlarge | 11 | 60 | | r8gb.16xlarge | 15 | 120 | | r8gb.24xlarge | 23 | 120 | | r8gb.48xlarge | 23 | 120 | | r8gb.metal-24xl | 23 | 120 | | r8gb.metal-48xl | 23 | 120 | | r8gd.medium | 1 | 4 | | r8gd.large | 2 | 10 | | r8gd.xlarge | 3 | 20 | | r8gd.2xlarge | 3 | 40 | | r8gd.4xlarge | 7 | 60 | | r8gd.8xlarge | 7 | 60 | | r8gd.12xlarge | 7 | 60 | | r8gd.16xlarge | 14 | 120 | | r8gd.24xlarge | 14 | 120 | | r8gd.48xlarge | 14 | 120 | | r8gd.metal-24xl | 14 | 120 | | r8gd.metal-48xl | 14 | 120 | | r8gn.medium | 1 | 4 | | r8gn.large | 2 | 10 | | r8gn.xlarge | 3 | 20 | | r8gn.2xlarge | 3 | 40 | | r8gn.4xlarge | 7 | 60 | | r8gn.8xlarge | 9 | 60 | | r8gn.12xlarge | 11 | 60 | | r8gn.16xlarge | 15 | 120 | | r8gn.24xlarge | 23 | 120 | | r8gn.48xlarge | 23 | 120 | | r8gn.metal-24xl | 23 | 120 | | r8gn.metal-48xl | 23 | 120 | | r8i.large | 2 | 10 | | r8i.xlarge | 3 | 20 | | r8i.2xlarge | 3 | 40 | | r8i.4xlarge | 7 | 60 | | r8i.8xlarge | 9 | 90 | | r8i.12xlarge | 11 | 120 | | r8i.16xlarge | 15 | 120 | | r8i.24xlarge | 15 | 120 | | r8i.32xlarge | 23 | 120 | | r8i.48xlarge | 23 | 120 | | r8i.96xlarge | 23 | 120 | | r8i.metal-48xl | 23 | 120 | | r8i.metal-96xl | 23 | 120 | | r8id.large | 2 | 10 | | r8id.xlarge | 3 | 20 | | r8id.2xlarge | 3 | 40 | | r8id.4xlarge | 7 | 60 | | r8id.8xlarge | 9 | 90 | | r8id.12xlarge | 11 | 120 | | r8id.16xlarge | 15 | 120 | | r8id.24xlarge | 15 | 120 | | r8id.32xlarge | 23 | 120 | | r8id.48xlarge | 23 | 120 | | r8id.96xlarge | 23 | 120 | | r8id.metal-48xl | 23 | 120 | | r8id.metal-96xl | 23 | 120 | | r8i-flex.large | 2 | 4 | | r8i-flex.xlarge | 3 | 10 | | r8i-flex.2xlarge | 3 | 20 | | r8i-flex.4xlarge | 7 | 40 | | r8i-flex.8xlarge | 9 | 60 | | r8i-flex.12xlarge | 11 | 120 | | r8i-flex.16xlarge | 15 | 120 | | u-3tb1.56xlarge | 7 | 12 | | u-6tb1.56xlarge | 14 | 12 | | u-18tb1.112xlarge | 14 | 12 | | u-18tb1.metal | 14 | 12 | | u-24tb1.112xlarge | 14 | 12 | | u-24tb1.metal | 14 | 12 | | u7i-6tb.112xlarge | 14 | 120 | | u7i-8tb.112xlarge | 14 | 120 | | u7i-12tb.224xlarge | 14 | 120 | | u7in-16tb.224xlarge | 15 | 120 | | u7in-24tb.224xlarge | 15 | 120 | | u7in-32tb.224xlarge | 15 | 120 | | u7inh-32tb.480xlarge | 15 | 120 | | x2gd.medium | 1 | 10 | | x2gd.large | 2 | 10 | | x2gd.xlarge | 3 | 20 | | x2gd.2xlarge | 3 | 40 | | x2gd.4xlarge | 7 | 60 | | x2gd.8xlarge | 7 | 60 | | x2gd.12xlarge | 7 | 60 | | x2gd.16xlarge | 14 | 120 | | x2gd.metal | 14 | 120 | | x2idn.16xlarge | 14 | 120 | | x2idn.24xlarge | 14 | 120 | | x2idn.32xlarge | 14 | 120 | | x2idn.metal | 14 | 120 | | x2iedn.xlarge | 3 | 13 | | x2iedn.2xlarge | 3 | 29 | | x2iedn.4xlarge | 7 | 60 | | x2iedn.8xlarge | 7 | 120 | | x2iedn.16xlarge | 14 | 120 | | x2iedn.24xlarge | 14 | 120 | | x2iedn.32xlarge | 14 | 120 | | x2iedn.metal | 14 | 120 | | x2iezn.2xlarge | 3 | 64 | | x2iezn.4xlarge | 7 | 120 | | x2iezn.6xlarge | 7 | 120 | | x2iezn.8xlarge | 7 | 120 | | x2iezn.12xlarge | 14 | 120 | | x2iezn.metal | 14 | 120 | | x8g.medium | 1 | 4 | | x8g.large | 2 | 10 | | x8g.xlarge | 3 | 20 | | x8g.2xlarge | 3 | 40 | | x8g.4xlarge | 7 | 60 | | x8g.8xlarge | 7 | 60 | | x8g.12xlarge | 7 | 60 | | x8g.16xlarge | 14 | 120 | | x8g.24xlarge | 14 | 120 | | x8g.48xlarge | 14 | 120 | | x8g.metal-24xl | 14 | 120 | | x8g.metal-48xl | 14 | 120 | | x8aedz.large | 3 | 10 | | x8aedz.xlarge | 3 | 20 | | x8aedz.3xlarge | 7 | 40 | | x8aedz.6xlarge | 7 | 60 | | x8aedz.12xlarge | 15 | 120 | | x8aedz.24xlarge | 15 | 120 | | x8aedz.metal-12xl | 15 | 120 | | x8aedz.metal-24xl | 15 | 120 | | x8i.large | 2 | 10 | | x8i.xlarge | 3 | 20 | | x8i.2xlarge | 3 | 40 | | x8i.4xlarge | 7 | 60 | | x8i.8xlarge | 9 | 90 | | x8i.12xlarge | 11 | 120 | | x8i.16xlarge | 15 | 120 | | x8i.24xlarge | 15 | 120 | | x8i.32xlarge | 23 | 120 | | x8i.48xlarge | 23 | 120 | | x8i.64xlarge | 23 | 120 | | x8i.96xlarge | 23 | 120 | | x8i.metal-48xl | 23 | 120 | | x8i.metal-96xl | 23 | 120 | ## 스토리지 최적화 | 인스턴스 유형 | ENI 트렁킹이 없는 작업 제한 | ENI 트렁킹을 포함하는 작업 제한 | | --- | --- | --- | | i4g.large | 2 | 10 | | i4g.xlarge | 3 | 20 | | i4g.2xlarge | 3 | 40 | | i4g.4xlarge | 7 | 60 | | i4g.8xlarge | 7 | 60 | | i4g.16xlarge | 14 | 120 | | i4i.xlarge | 3 | 8 | | i4i.2xlarge | 3 | 28 | | i4i.4xlarge | 7 | 58 | | i4i.8xlarge | 7 | 118 | | i4i.12xlarge | 7 | 118 | | i4i.16xlarge | 14 | 248 | | i4i.24xlarge | 14 | 118 | | i4i.32xlarge | 14 | 498 | | i4i.metal | 14 | 498 | | i7i.large | 2 | 10 | | i7i.xlarge | 3 | 20 | | i7i.2xlarge | 3 | 40 | | i7i.4xlarge | 7 | 60 | | i7i.8xlarge | 7 | 90 | | i7i.12xlarge | 7 | 90 | | i7i.16xlarge | 14 | 120 | | i7i.24xlarge | 14 | 120 | | i7i.48xlarge | 14 | 120 | | i7i.metal-24xl | 14 | 120 | | i7i.metal-48xl | 14 | 120 | | i7ie.large | 2 | 20 | | i7ie.xlarge | 3 | 29 | | i7ie.2xlarge | 3 | 29 | | i7ie.3xlarge | 3 | 29 | | i7ie.6xlarge | 7 | 60 | | i7ie.12xlarge | 7 | 60 | | i7ie.18xlarge | 14 | 120 | | i7ie.24xlarge | 14 | 120 | | i7ie.48xlarge | 14 | 120 | | i7ie.metal-24xl | 14 | 120 | | i7ie.metal-48xl | 14 | 120 | | i8g.large | 2 | 10 | | i8g.xlarge | 3 | 20 | | i8g.2xlarge | 3 | 40 | | i8g.4xlarge | 7 | 60 | | i8g.8xlarge | 7 | 60 | | i8g.12xlarge | 7 | 60 | | i8g.16xlarge | 14 | 120 | | i8g.24xlarge | 14 | 120 | | i8g.48xlarge | 14 | 120 | | i8g.metal-24xl | 14 | 120 | | i8g.metal-48xl | 14 | 120 | | i8ge.large | 2 | 20 | | i8ge.xlarge | 3 | 29 | | i8ge.2xlarge | 3 | 29 | | i8ge.3xlarge | 5 | 29 | | i8ge.6xlarge | 9 | 60 | | i8ge.12xlarge | 11 | 60 | | i8ge.18xlarge | 15 | 120 | | i8ge.24xlarge | 15 | 120 | | i8ge.48xlarge | 23 | 120 | | i8ge.metal-24xl | 15 | 120 | | i8ge.metal-48xl | 23 | 120 | | im4gn.large | 2 | 10 | | im4gn.xlarge | 3 | 20 | | im4gn.2xlarge | 3 | 40 | | im4gn.4xlarge | 7 | 60 | | im4gn.8xlarge | 7 | 60 | | im4gn.16xlarge | 14 | 120 | | is4gen.medium | 1 | 4 | | is4gen.large | 2 | 10 | | is4gen.xlarge | 3 | 20 | | 4gn.2xlarge | 3 | 40 | | is4gen.4xlarge | 7 | 60 | | is4gen.8xlarge | 7 | 60 | ## 가속 컴퓨팅 | 인스턴스 유형 | ENI 트렁킹이 없는 작업 제한 | ENI 트렁킹을 포함하는 작업 제한 | | --- | --- | --- | | dl1.24xlarge | 59 | 120 | | dl2q.24xlarge | 14 | 120 | | f2.6xlarge | 7 | 90 | | f2.12xlarge | 7 | 120 | | f2.48xlarge | 14 | 120 | | g4ad.xlarge | 1 | 12 | | g4dn.2xlarge | 1 | 12 | | g4ad.4xlarge | 2 | 12 | | g4ad.8xlarge | 3 | 12 | | g4ad.16xlarge | 7 | 12 | | g5.xlarge | 3 | 6 | | g5.2xlarge | 3 | 19 | | g5.4xlarge | 7 | 40 | | g5.8xlarge | 7 | 90 | | g5.12xlarge | 14 | 120 | | g5.16xlarge | 7 | 120 | | g5.24xlarge | 14 | 120 | | g5.48xlarge | 6 | 120 | | g5g.xlarge | 3 | 20 | | g5g.2xlarge | 3 | 40 | | g5g.4xlarge | 7 | 60 | | g5g.8xlarge | 7 | 60 | | g5g.16xlarge | 14 | 120 | | g5g.metal | 14 | 120 | | g6.xlarge | 3 | 20 | | g6.2xlarge | 3 | 40 | | g6.4xlarge | 7 | 60 | | g6.8xlarge | 7 | 90 | | g6.12xlarge | 7 | 120 | | g6.16xlarge | 14 | 120 | | g6.24xlarge | 14 | 120 | | g6.48xlarge | 14 | 120 | | g6e.xlarge | 3 | 20 | | g6e.2xlarge | 3 | 40 | | g6e.4xlarge | 7 | 60 | | g6e.8xlarge | 7 | 90 | | g6e.12xlarge | 9 | 120 | | g6e.16xlarge | 14 | 120 | | g6e.24xlarge | 19 | 120 | | g6e.48xlarge | 39 | 120 | | g6f.large | 1 | 10 | | g6f.xlarge | 3 | 20 | | g6f.2xlarge | 3 | 40 | | g6f.4xlarge | 7 | 60 | | gr6.4xlarge | 7 | 60 | | gr6.8xlarge | 7 | 90 | | gr6f.4xlarge | 7 | 60 | | g7e.2xlarge | 3 | 242 | | g7e.4xlarge | 7 | 242 | | g7e.8xlarge | 7 | 242 | | g7e.12xlarge | 9 | 242 | | g7e.24xlarge | 19 | 242 | | g7e.48xlarge | 39 | 242 | | inf2.xlarge | 3 | 20 | | inf2.8xlarge | 7 | 90 | | inf2.24xlarge | 14 | 120 | | inf2.48xlarge | 14 | 120 | | p4d.24xlarge | 59 | 120 | | p4de.24xlarge | 59 | 120 | | p5.4xlarge | 3 | 60 | | p5.48xlarge | 63 | 242 | | p5e.48xlarge | 63 | 242 | | p5en.48xlarge | 63 | 242 | | p6-b200.48xlarge | 31 | 242 | | p6-b300.48xlarge | 67 | 242 | | p6e-gb200.36xlarge | 38 | 120 | | trn1.2xlarge | 3 | 19 | | trn1.32xlarge | 39 | 120 | | trn1n.32xlarge | 79 | 242 | | trn2.3xlarge | 1 | 14 | | trn2.48xlarge | 31 | 242 | | trn2u.48xlarge | 31 | 242 | | vt1.3xlarge | 3 | 40 | | vt1.6xlarge | 7 | 60 | | vt1.24xlarge | 14 | 120 | ## 고성능 컴퓨팅 | 인스턴스 유형 | ENI 트렁킹이 없는 작업 제한 | ENI 트렁킹을 포함하는 작업 제한 | | --- | --- | --- | | hpc6a.48xlarge | 1 | 120 | | hpc6id.32xlarge | 1 | 120 | | hpc7g.4xlarge | 3 | 120 | | hpc7g.8xlarge | 3 | 120 | | hpc7g.16xlarge | 3 | 120 | | hpc8a.96xlarge | 3 | -2 | # Amazon ECS Linux 컨테이너 인스턴스 메모리 예약 Amazon ECS 컨테이너 에이전트가 클러스터에 컨테이너 인스턴스를 등록할 때 에이전트는 컨테이너 인스턴스에서 태스크에 대해 예약할 수 있는 메모리 크기를 결정해야 합니다. 플랫폼 메모리 오버헤드와 운영 체제 커널이 차지하는 메모리로 인해 이 수치가 Amazon EC2 인스턴스에 대해 공급된 설치된 메모리 용량과 다르기 때문입니다 예를 들어, `m4.large` 인스턴스의 설치된 메모리는 8GiB입니다. 그러나 컨테이너 인스턴스 등록 시 항상 작업에 정확히 8,192MiB의 메모리를 사용할 수 있는 것은 아닙니다. ## ECS 관리형 인스턴스 메모리 리소스 결정 Amazon ECS 관리형 인스턴스는 계층적 접근 방식을 사용하여 태스크에 대한 메모리 리소스 요구 사항을 결정합니다. Docker의 메모리 내부 검사에 의존하는 EC2 기반 ECS와 달리 ECS 관리형 인스턴스는 예약 결정 중에 태스크 페이로드에서 직접 메모리 요구 사항을 계산합니다. ECS 관리형 인스턴스 에이전트가 태스크를 수신하면 다음 우선순위에 따라 메모리 요구 사항을 계산합니다. 1. **태스크 수준 메모리(가장 높은 우선순위)** - 태스크 정의에 태스크 수준 메모리가 지정된 경우 에이전트는 이 값을 직접 사용합니다. 이는 모든 컨테이너 수준 메모리 설정보다 우선합니다. 1. **컨테이너 수준 메모리 합계(대체)** - 태스크 수준 메모리가 지정되지 않은 경우(또는 0인 경우) 에이전트는 태스크의 모든 컨테이너에서 메모리 요구 사항을 합산합니다. 각 컨테이너에 대해 다음을 사용합니다. 1. *메모리 예약(소프트 제한)* - 컨테이너가 구성에서 `memoryReservation`을 지정하는 경우 에이전트는 이 값을 사용합니다. 1. *컨테이너 메모리(하드 제한)* - `memoryReservation`이 지정되지 않은 경우 에이전트는 컨테이너의 `memory` 필드를 사용합니다. **Example 지정된 태스크 수준 메모리** 태스크 수준 메모리를 지정하면 컨테이너 수준 설정보다 우선합니다. ``` { "family": "my-task", "memory": "2048", "containerDefinitions": [ { "name": "container1", "memory": 1024, "memoryReservation": 512 } ] } ``` 에이전트는 2,048MiB(태스크 수준 메모리가 우선함)를 예약합니다. **Example 예약 기반 컨테이너 수준 메모리** 태스크 수준 메모리가 지정되지 않은 경우 에이전트는 컨테이너 메모리 요구 사항을 합산합니다. ``` { "family": "my-task", "containerDefinitions": [ { "name": "container1", "memory": 1024, "memoryReservation": 512 }, { "name": "container2", "memory": 512 } ] } ``` 에이전트는 512MiB(container1 예약) \$1 512MiB(container2 메모리) = 총 1,024MiB를 예약합니다. ECS 관리형 인스턴스 에이전트는 3단계로 메모리 계산을 수행합니다. 1. **태스크 수신** - ECS 컨트롤 플레인에서 태스크 페이로드가 도착하면 에이전트는 즉시 필요한 메모리를 계산합니다. 1. **리소스 스토리지** - 계산된 메모리 요구 사항은 나중에 리소스 회계 작업에 사용할 수 있도록 태스크 모델에 저장됩니다. 1. **일정 결정** - 태스크를 수락하기 전에 에이전트는 충분한 메모리를 사용할 수 있는지 확인합니다. 메모리가 부족하면 태스크가 거부되고 리소스를 사용할 수 있을 때까지 ECS 서비스 대기열에 남아 있습니다. **참고** EC2 기반 ECS와 달리 ECS 관리형 인스턴스는 `ECS_RESERVED_MEMORY` 구성 변수를 사용하지 않습니다. 시스템 프로세스에 대한 메모리 예약은 기본 플랫폼의 리소스 관리를 통해 처리되며 에이전트는 태스크 정의를 기반으로 정확한 리소스 회계를 수행합니다. EC2 기반 ECS에서 Amazon ECS 컨테이너 에이전트는 `ECS_RESERVED_MEMORY`라는 구성 변수를 제공합니다. 이를 사용하여 작업에 할당된 풀에서 지정된 메모리 크기(MiB)를 제거할 수 있습니다. 이를 통해 중요 시스템 프로세스에 대한 메모리를 효율적으로 예약합니다. 컨테이너 인스턴스의 모든 메모리를 작업에 사용하는 경우 작업 및 메모리의 중요 시스템 프로세스 경합으로 인해 시스템 오류가 발생할 수 있습니다. 예를 들어, 컨테이너 에이전트 구성 파일에서 `ECS_RESERVED_MEMORY=256`을 지정한 경우 에이전트는 인스턴스에 대해 총 메모리에서 256MiB를 제외하고 등록하며, 이 256MiB의 메모리는 ECS 작업에 할당될 수 없습니다. 에이전트 구성 변수 및 이를 설정하는 방법에 대한 자세한 정보는 [Amazon ECS 컨테이너 에이전트 구성](ecs-agent-config.md) 및 [데이터 전달을 위한 Amazon ECS Linux 컨테이너 인스턴스 부트스트래핑](bootstrap_container_instance.md) 섹션을 참조하세요. 작업에 대해 8,192MiB를 지정하고, 이 요구 사항을 충족하기 위해 8,192MiB 이상의 메모리를 사용할 수 있는 컨테이너 인스턴스가 없는 경우 작업은 클러스터에 배치될 수 없습니다. 관리형 컴퓨팅 환경을 사용 중인 경우 AWS Batch는 요청을 수용하기 위해 더 큰 인스턴스 유형을 시작해야 합니다. Amazon ECS 컨테이너 에이전트는 Docker `ReadMemInfo()` 함수를 사용하여 운영 체제가 사용할 수 있는 전체 메모리를 쿼리합니다. Linux 및 Windows 모두 명령줄 유틸리티를 제공하여 총 메모리를 결정합니다. **Example - Linux 총 메모리 결정** **free** 명령은 운영 체제가 인식한 총 메모리를 반환합니다. ``` $ free -b ``` Amazon ECS 최적화된 Amazon Linux AMI를 실행하는 `m4.large` 인스턴스의 출력 예. ``` total used free shared buffers cached Mem: 8373026816 348180480 8024846336 90112 25534464 205418496 -/+ buffers/cache: 117227520 8255799296 ``` 이 인스턴스의 총 메모리는 8,373,026,816바이트로, 이는 태스크에 대해 7,985MiB를 사용할 수 있음을 의미합니다. **Example - Windows 총 메모리 결정** **wmic** 명령은 운영 체제가 인식한 총 메모리를 반환합니다. ``` C:\> wmic ComputerSystem get TotalPhysicalMemory ``` Amazon ECS 최적화 Windows Server AMI를 실행하는 `m4.large` 인스턴스의 출력 예제. ``` TotalPhysicalMemory 8589524992 ``` 이 인스턴스의 총 메모리는 8,589,524,992바이트로, 이는 작업에 대해 8,191MiB를 사용할 수 있음을 의미합니다. ## 컨테이너 인스턴스 메모리 보기 컨테이너 인스턴스가 Amazon ECS 콘솔(또는 [DescribeContainerInstances](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_DescribeContainerInstances.html) API 작업)에 등록하는 메모리 크기를 확인할 수 있습니다. 특정 인스턴스 유형에 대해 가능한 한 많은 메모리를 작업에 제공하여 리소스 사용률을 극대화하려는 경우 해당 컨테이너 인스턴스에 사용 가능한 메모리를 관찰한 다음, 작업에 그만큼의 메모리를 할당할 수 있습니다. **컨테이너 인스턴스 메모리를 보는 방법** 1. [https://console.aws.amazon.com/ecs/v2](https://console.aws.amazon.com/ecs/v2)에서 콘솔을 엽니다. 1. 탐색 창에서 **클러스터**를 선택하고 컨테이너 인스턴스를 호스팅하는 클러스터를 선택합니다. 1. **인프라**를 선택한 다음, 컨테이너 인스턴스에서 컨테이너 인스턴스를 선택합니다. 1. **리소스** 섹션에서는 컨테이너 인스턴스에 대해 등록된 메모리와 사용 가능한 메모리를 보여줍니다. **등록됨** 메모리 값은 처음 시작할 때 Amazon ECS에 등록된 컨테이너 인스턴스의 값이며, **사용 가능** 메모리 값은 작업에 할당되지 않은 값입니다. # AWS Systems Manager를 사용한 원격으로 Amazon ECS 컨테이너 인스턴스 관리 AWS Systems Manager(Systems Manager)의 Run Command 기능을 사용하면 Amazon ECS 컨테이너 인스턴스의 구성을 원격으로 안전하게 관리할 수 있습니다. Run Command를 사용하면 인스턴스에 로컬로 로그인하지 않고 간단하게 일반적인 관리 태스크를 수행할 수 있습니다. 여러 컨테이너 인스턴스에서 동시에 명령을 실행하여 클러스터의 구성 변경을 전체적으로 관리할 수 있습니다. Run Command는 각 명령의 상태와 결과를 보고합니다. 다음은 Run Command를 사용하여 수행할 수 있는 태스크 유형의 몇 가지 예입니다. + 패키지 설치 또는 제거. + 보안 업데이트 수행. + Docker 이미지 정리. + 서비스 중지 또는 시작. + 시스템 리소스 보기. + 로그 파일 보기. + 파일 작업 수행. Run Command에 대한 자세한 정보는 *AWS Systems Manager 사용 설명서*의 [AWS Systems Manager Run Command](https://docs.aws.amazon.com/systems-manager/latest/userguide/run-command.html)를 참조하세요. 다음은 Amazon ECS에서 Systems Manager를 사용하기 위한 사전 조건입니다. 1. Systems Manager API에 액세스하려면 컨테이너 인스턴스 역할(**ecsInstanceRole**)에 권한을 부여해야 합니다. **AmazonSSMManagedInstanceCore**를 `ecsInstanceRole` 역할에 할당하면 됩니다. 역할에 정책을 연결하는 방법에 대한 자세한 내용은 *AWS Identity and Access Management 사용 설명서*의 [역할 권한 업데이트](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_update-role-permissions.html)를 참조하세요. 1. 컨테이너 인스턴스에 SSM Agent가 설치되었는지 확인합니다. 자세한 정보는 [Linux용 EC2 인스턴스에 수동으로 SSM Agent 설치 및 제거](https://docs.aws.amazon.com/systems-manager/latest/userguide/manually-install-ssm-agent-linux.html)를 참조하세요. Systems Manager 관리형 정책을 AWS Systems Manager에 연결하고 `ecsInstanceRole` 에이전트(SSM Agent)가 컨테이너 인스턴스에 설치되어 있는지 확인한 후 Run Command를 사용하여 컨테이너 인스턴스로 명령 전송을 시작할 수 있습니다. 인스턴스에서 명령 및 shell 스크립트를 실행하고 결과 출력을 보는 방법에 대한 자세한 정보는 *AWS Systems Manager 사용 설명서*의 [Systems Manager Run Command를 사용하여 명령 실행](https://docs.aws.amazon.com/systems-manager/latest/userguide/run-command.html) 및 [Run Command 연습](https://docs.aws.amazon.com/systems-manager/latest/userguide/run-command-walkthroughs.html)을 참조하세요. 일반적인 사용 사례는 실행 명령으로 컨테이너 인스턴스 소프트웨어를 업데이트하는 것입니다. 다음 파라미터를 사용하여 AWS Systems Manager 사용 설명서의 절차를 따를 수 있습니다. | 파라미터 | 값 | | --- | --- | | **명령 문서** | AWS-RunShellScript | | 명령 | 
$ yum update -y
| | 대상 인스턴스 | 사용자의 컨테이너 인스턴스 | # Amazon ECS Linux 컨테이너 인스턴스에 HTTP 프록시 사용 Amazon ECS 컨테이너 에이전트와 Docker 대몬 모두에 대해 HTTP 프록시를 사용하도록 Amazon ECS 컨테이너 인스턴스를 구성할 수 있습니다. 이 구성은 컨테이너 인스턴스가 Amazon VPC 인터넷 게이트웨이, NAT 게이트웨이 또는 인스턴스를 통해 외부 네트워크에 액세스하지 못할 경우 유용합니다. HTTP 프록시를 사용하도록 Amazon ECS Linux 컨테이너 인스턴스를 구성하려면 시작 시(Amazon EC2 사용자 데이터를 사용해) 관련 파일에 있는 다음 변수를 설정합니다. 구성 파일을 수동으로 편집한 다음 에이전트를 재시작할 수도 있습니다. `/etc/ecs/ecs.config`(Amazon Linux 2 및 Amazon Linux AMI) `HTTP_PROXY=10.0.0.131:3128` Amazon ECS 에이전트가 인터넷에 연결하는 데 사용할 HTTP 프록시의 호스트 이름(또는 IP 주소) 및 포트 번호로 이 값을 설정합니다. 예를 들어 컨테이너 인스턴스는 Amazon VPC 인터넷 게이트웨이, NAT 게이트웨이 또는 인스턴스를 통해 외부 네트워크에 액세스하지 못할 수 있습니다. `NO_PROXY=169.254.169.254,169.254.170.2,/var/run/docker.sock` EC2 인스턴스 메타데이터, 작업에 대한 IAM 역할 및 프록시로부터의 Docker 대몬 트래픽을 필터링하려면 이 값을 `169.254.169.254,169.254.170.2,/var/run/docker.sock`으로 설정합니다. `/etc/systemd/system/ecs.service.d/http-proxy.conf`(Amazon Linux 2 전용) `Environment="HTTP_PROXY=10.0.0.131:3128/"` `ecs-init`가 인터넷에 연결하는 데 사용할 HTTP 프록시의 호스트 이름(또는 IP 주소) 및 포트 번호로 이 값을 설정합니다. 예를 들어 컨테이너 인스턴스는 Amazon VPC 인터넷 게이트웨이, NAT 게이트웨이 또는 인스턴스를 통해 외부 네트워크에 액세스하지 못할 수 있습니다. `Environment="NO_PROXY=169.254.169.254,169.254.170.2,/var/run/docker.sock"` EC2 인스턴스 메타데이터, 작업에 대한 IAM 역할 및 프록시로부터의 Docker 대몬 트래픽을 필터링하려면 이 값을 `169.254.169.254,169.254.170.2,/var/run/docker.sock`으로 설정합니다. `/etc/init/ecs.override` (Amazon Linux AMI만 해당) `env HTTP_PROXY=10.0.0.131:3128` `ecs-init`가 인터넷에 연결하는 데 사용할 HTTP 프록시의 호스트 이름(또는 IP 주소) 및 포트 번호로 이 값을 설정합니다. 예를 들어 컨테이너 인스턴스는 Amazon VPC 인터넷 게이트웨이, NAT 게이트웨이 또는 인스턴스를 통해 외부 네트워크에 액세스하지 못할 수 있습니다. `env NO_PROXY=169.254.169.254,169.254.170.2,/var/run/docker.sock` EC2 인스턴스 메타데이터, 작업에 대한 IAM 역할 및 프록시로부터의 Docker 대몬 트래픽을 필터링하려면 이 값을 `169.254.169.254,169.254.170.2,/var/run/docker.sock`으로 설정합니다. `/etc/systemd/system/docker.service.d/http-proxy.conf`(Amazon Linux 2 전용) `Environment="HTTP_PROXY=http://10.0.0.131:3128"` Docker 대몬이 인터넷에 연결하는 데 사용할 HTTP 프록시의 호스트 이름(또는 IP 주소) 및 포트 번호로 이 값을 설정합니다. 예를 들어 컨테이너 인스턴스는 Amazon VPC 인터넷 게이트웨이, NAT 게이트웨이 또는 인스턴스를 통해 외부 네트워크에 액세스하지 못할 수 있습니다. `Environment="NO_PROXY=169.254.169.254,169.254.170.2"` 프록시에서 EC2 인스턴스 메타데이터를 필터링하려면 이 값을 `169.254.169.254,169.254.170.2`로 설정합니다. `/etc/sysconfig/docker` (Amazon Linux AMI 및 Amazon Linux 2 전용) `export HTTP_PROXY=http://10.0.0.131:3128` Docker 대몬이 인터넷에 연결하는 데 사용할 HTTP 프록시의 호스트 이름(또는 IP 주소) 및 포트 번호로 이 값을 설정합니다. 예를 들어 컨테이너 인스턴스는 Amazon VPC 인터넷 게이트웨이, NAT 게이트웨이 또는 인스턴스를 통해 외부 네트워크에 액세스하지 못할 수 있습니다. `export NO_PROXY=169.254.169.254,169.254.170.2` 프록시에서 EC2 인스턴스 메타데이터를 필터링하려면 이 값을 `169.254.169.254,169.254.170.2`로 설정합니다. 이 환경 변수를 위 파일에서 설정하면 Amazon ECS 컨테이너 에이전트, `ecs-init` 및 Docker 대몬에만 영향을 미칩니다. 기타 서비스(예: **yum**)에서는 프록시를 사용하도록 구성하지 않습니다. 프록시를 구성하는 방법에 대한 자세한 내용은 [Amazon Linux 2 또는 Amazon Linux 2023에서 Docker 및 Amazon ECS 컨테이너 에이전트의 HTTP 프록시를 설정하려면 어떻게 해야 하나요?‭](https://repost.aws/knowledge-center/ecs-http-proxy-docker-linux2)를 참조하세요. # Amazon ECS Auto Scaling 그룹에 대해 사전 초기화된 인스턴스 구성 Amazon ECS에서 Amazon EC2 Auto Scaling 웜 풀을 지원합니다. 웜 풀은 서비스에 배치할 준비가 되어 사전 초기화된 Amazon EC2 인스턴스의 그룹입니다. 애플리케이션을 확장해야 할 때마다 Amazon EC2 Auto Scaling은 콜드 인스턴스를 시작하는 대신 웜 풀에서 미리 초기화된 인스턴스를 사용하고 모든 최종 초기화 프로세스가 실행되도록 허용한 다음 인스턴스를 서비스에 배치합니다. 웜 풀 및 Auto Scaling에 웜 풀을 추가하는 방법에 대한 자세한 정보는 *Amazon EC2 Auto Scaling 사용 설명서*의 [Amazon EC2 Auto Scaling의 웜 풀](https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-warm-pools.html)을 참조하세요. Amazon ECS의 Auto Scaling 그룹에 대한 웜 풀을 생성하거나 업데이트할 경우, 스케일 인에서 웜 풀로 인스턴스를 반환하는 옵션을 설정할 수 없습니다(`ReuseOnScaleIn`). 자세한 내용은 *AWS Command Line Interface 참조*의 [put-warm-pool](https://docs.aws.amazon.com/cli/latest/reference/autoscaling/put-warm-pool.html)을 참조하세요. Amazon ECS 클러스터에서 웜 풀을 사용하려면 Amazon EC2 Auto Scaling 그룹 시작 템플릿의 **사용자 데이터(User data)** 필드에서 `ECS_WARM_POOLS_CHECK` 에이전트 구성 변수를 `true`로 설정합니다. 다음은 Amazon EC2 시작 템플릿의 **사용자 데이터(User data)** 필드에 에이전트 구성 변수를 지정하는 방법의 예를 보여줍니다. *MyCluster*를 사용자의 클러스터 이름으로 바꿉니다. ``` #!/bin/bash cat <<'EOF' >> /etc/ecs/ecs.config ECS_CLUSTER=MyCluster ECS_WARM_POOLS_CHECK=true EOF ``` `ECS_WARM_POOLS_CHECK` 변수는 에이전트 버전 `1.59.0` 이상에서만 지원됩니다. 변수에 대한 자세한 정보는 [Amazon ECS 컨테이너 에이전트 구성](ecs-agent-config.md)을 참조하세요. # Amazon ECS 컨테이너 에이전트 업데이트 때때로 버그 수정 및 새로운 기능을 적용하기 위해 Amazon ECS 컨테이너 에이전트를 업데이트해야 할 수도 있습니다. Amazon ECS 컨테이너 에이전트를 업데이트할 때 컨테이너 인스턴스의 실행 작업 또는 서비스가 중단되지 않습니다. 에이전트 업데이트 절차는 컨테이너 인스턴스가 Amazon ECS 최적화 AMI 또는 기타 운영 체제에서 시작되었는지에 따라 다릅니다. **참고** 에이전트 업데이트는 Windows 컨테이너 인스턴스에 적용되지 않습니다. 새로운 컨테이너 인스턴스를 시작하여 Windows 클러스터의 에이전트 버전을 업데이트하는 것을 권장합니다. ## Amazon ECS 컨테이너 에이전트 버전 확인 컨테이너 인스턴스에서 실행 중인 컨테이너 에이전트의 버전을 확인하고 업데이트가 필요한지 판단할 수 있습니다. Amazon ECS 콘솔의 컨테이너 인스턴스 보기에 에이전트 버전이 표시됩니다. 에이전트 버전을 확인하려면 다음 절차를 사용합니다. ------ #### [ Amazon ECS console ] 1. [https://console.aws.amazon.com/ecs/v2](https://console.aws.amazon.com/ecs/v2)에서 콘솔을 엽니다. 1. 탐색 모음에서 외부 인스턴스가 등록되어 있는 리전을 선택합니다. 1. 탐색 창에서 **클러스터**를 선택하고 외부 인스턴스를 호스팅하는 클러스터를 선택합니다. 1. **클러스터: *name*(Cluster : name)** 페이지에서 **인프라(Infrastructure)** 탭을 선택합니다. 1. **컨테이너 인스턴스(Container instances)**에서 컨테이너 인스턴스의 **에이전트 버전(Agent version)** 열을 확인합니다. 컨테이너 인스턴스에 최신 컨테이너 에이전트 버전이 포함되어 있지 않으면 콘솔이 메시지를 통해 경고하고 이전 에이전트 버전에 플래그를 지정합니다. 에이전트 버전이 오래된 경우 다음 절차를 사용하여 컨테이너 에이전트를 업데이트할 수 있습니다. + 컨테이너 인스턴스가 Amazon ECS 최적화 AMI를 실행할 경우 [Amazon ECS 최적화 AMI에서 Amazon ECS 컨테이너 에이전트 업데이트](agent-update-ecs-ami.md)를 참조하세요. + 컨테이너 인스턴스가 Amazon ECS 최적화 AMI를 실행하지 않을 경우 [Amazon ECS 컨테이너 에이전트를 수동으로 업데이트하는 방법(비 Amazon ECS 최적화 AMI)](manually_update_agent.md)를 참조하세요. **중요** Amazon ECS 최적화 AMI에서 v1.0.0 이전의 Amazon ECS 에이전트 버전을 업데이트하려면 현재 컨테이너 인스턴스를 종료하고 최신 AMI 버전을 사용하여 새 인스턴스를 시작하는 것이 좋습니다. 미리 보기 버전을 사용하는 컨테이너 인스턴스는 종료하고 최신 AMI로 대체해야 합니다. 자세한 정보는 [Amazon ECS Linux 컨테이너 인스턴스 시작](launch_container_instance.md)을 참조하세요. ------ #### [ Amazon ECS container agent introspection API ] 컨테이너 인스턴스 자체에서 에이전트 Amazon ECS 컨테이너 에이전트 내부 검사 API 버전을 확인하는 데 이를 사용할 수도 있습니다. 자세한 정보는 [Amazon ECS 컨테이너 내부 검사](ecs-agent-introspection.md)을 참조하세요. **내부 검사 API를 사용하여 Amazon ECS 컨테이너 에이전트가 최신 버전을 실행 중인지 확인하는 방법** 1. SSH를 통해 컨테이너 인스턴스에 로그인합니다. 1. 내부 검사 API를 쿼리합니다. ``` [ec2-user ~]$ curl -s 127.0.0.1:51678/v1/metadata | python3 -mjson.tool ``` **참고** 내부 검사 API는 Amazon ECS 컨테이너 에이전트의 버전 v1.0.0에서 `Version` 정보를 추가했습니다. 내부 검사 API를 쿼리했을 때 `Version`이 없는 경우, 또는 에이전트에 내부 검사 API 자체가 없는 경우 실행되는 버전은 v0.0.3 이하입니다. 버전을 업데이트해야 합니다. ------ # Amazon ECS 최적화 AMI에서 Amazon ECS 컨테이너 에이전트 업데이트 Amazon ECS 최적화 AMI를 사용하는 경우, 최신 버전의 Amazon ECS 컨테이너 에이전트를 얻을 수 있는 옵션은 다음과 같이 여러 가지가 있습니다(권장 순서로 표시). + 컨테이너 인스턴스를 종료하고 (수동으로 또는 Auto Scaling 시작 구성을 최신 AMI로 업데이트하여) 최신 버전의 Amazon ECS 최적화 Amazon Linux 2 AMI를 시작합니다. 그러면 테스트 및 검증된 최신 버전의 Amazon Linux, Docker, `ecs-init` 및 Amazon ECS 컨테이너 에이전트를 포함하는 컨테이너 인스턴스가 새로 시작됩니다. 자세한 정보는 [Amazon ECS 최적화 Linux AMI](ecs-optimized_AMI.md)을 참조하세요. + SSH를 사용하여 인스턴스에 연결하고 `ecs-init` 패키지(및 해당 종속성)를 최신 버전으로 업데이트합니다. 이 작업은 Amazon Linux 리포지토리에서 사용 가능한 테스트 및 검증된 최신 버전의 도커 및 `ecs-init`와 최신 버전의 Amazon ECS 컨테이너 에이전트를 제공합니다. 자세한 정보는 [Amazon ECS 최적화 AMI에서 `ecs-init` 패키지를 업데이트하는 방법](#procedure_update_ecs-init)을 참조하세요. + 콘솔을 통해 또는 AWS CLI 또는 AWS SDK를 사용해 `UpdateContainerAgent` API 작업으로 컨테이너를 업데이트합니다. 자세한 정보는 [`UpdateContainerAgent` API 태스크를 사용하여 Amazon ECS 컨테이너 에이전트 업데이트](#agent-update-api)을 참조하세요. **참고** 에이전트 업데이트는 Windows 컨테이너 인스턴스에 적용되지 않습니다. 새로운 컨테이너 인스턴스를 시작하여 Windows 클러스터의 에이전트 버전을 업데이트하는 것을 권장합니다. **Amazon ECS 최적화 AMI에서 `ecs-init` 패키지를 업데이트하는 방법** 1. SSH를 통해 컨테이너 인스턴스에 로그인합니다. 1. 다음 명령을 사용하여 `ecs-init` 패키지를 업데이트합니다. ``` sudo yum update -y ecs-init ``` **참고** `ecs-init` 패키지와 Amazon ECS 컨테이너 에이전트가 즉시 업데이트됩니다. 그러나 새 버전의 Docker는 Docker 대몬이 다시 시작되기 전에는 로드되지 않습니다. 인스턴스를 재부팅하거나 인스턴스에서 다음 명령을 실행하여 다시 시작하세요. Amazon ECS 최적화 Amazon Linux 2 AMI: ``` sudo systemctl restart docker ``` Amazon ECS 최적화 Amazon Linux AMI: ``` sudo service docker restart && sudo start ecs ``` ## `UpdateContainerAgent` API 태스크를 사용하여 Amazon ECS 컨테이너 에이전트 업데이트 **중요** `UpdateContainerAgent` API는 Amazon ECS 최적화 AMI의 Linux 변형에서만 지원됩니다. 단, Amazon ECS 최적화 Amazon Linux 2(arm64) AMI만 예외입니다. Amazon ECS 최적화 Amazon Linux 2(arm64) AMI를 사용하는 컨테이너 인스턴스의 경우, `ecs-init` 패키지를 업데이트하여 에이전트를 업데이트하세요. 다른 운영 체제를 실행하는 컨테이너 인스턴스의 경우 [Amazon ECS 컨테이너 에이전트를 수동으로 업데이트하는 방법(비 Amazon ECS 최적화 AMI)](manually_update_agent.md) 섹션을 참조하세요. Windows 컨테이너 인스턴스를 사용하고 있을 경우 새로운 컨테이너 인스턴스를 시작하여 Windows 클러스터의 에이전트 버전을 업데이트하는 것을 권장합니다. `UpdateContainerAgent` API 프로세스는 콘솔 또는 AWS CLI나 AWS SDK를 통해 에이전트 업데이트를 요청하면 시작됩니다. Amazon ECS는 현재 에이전트 버전을 사용 가능한 최신 에이전트 버전과 비교하여 업데이트가 가능한지 확인합니다. 업데이트가 가능하지 않으면(예: 이미 최신 버전이 실행 중) `NoUpdateAvailableException`이 반환됩니다. 위에 표시된 업데이트 프로세스의 단계는 다음과 같습니다. `PENDING` 에이전트 업데이트가 가능하고, 업데이트 프로세스가 시작되었습니다. `STAGING` 에이전트가 에이전트 업데이트를 다운로드하기 시작했습니다. 에이전트가 업데이트를 다운로드할 수 없는 경우 또는 업데이트의 내용이 부정확하거나 손상된 경우 에이전트가 실패 알림을 전송하고 업데이트가 `FAILED` 상태로 전환됩니다. `STAGED` 에이전트 다운로드가 완료되었으며 에이전트 내용이 확인되었습니다. `UPDATING` `ecs-init` 서비스가 다시 시작되어 새 에이전트 버전을 선택합니다. 어떤 이유로 에이전트를 다시 시작할 수 없는 경우 업데이트가 `FAILED` 상태로 전환되고, 그렇지 않으면 에이전트가 Amazon ECS에게 업데이트 완료 신호를 보냅니다. **참고** 에이전트 업데이트는 Windows 컨테이너 인스턴스에 적용되지 않습니다. 새로운 컨테이너 인스턴스를 시작하여 Windows 클러스터의 에이전트 버전을 업데이트하는 것을 권장합니다. **콘솔에서 Amazon ECS 최적화 AMI에서 Amazon ECS 컨테이너 에이전트를 업데이트하는 방법** 1. [https://console.aws.amazon.com/ecs/v2](https://console.aws.amazon.com/ecs/v2)에서 콘솔을 엽니다. 1. 탐색 모음에서 외부 인스턴스가 등록되어 있는 리전을 선택합니다. 1. 탐색 창에서 **클러스터**를 선택하고 클러스터를 선택합니다. 1. **클러스터: *name*(Cluster : name)** 페이지에서 **인프라(Infrastructure)** 탭을 선택합니다. 1. **컨테이너 인스턴스**에서 업데이트할 인스턴스를 선택하고 **작업**, **에이전트 업데이트**를 선택합니다. # Amazon ECS 컨테이너 에이전트를 수동으로 업데이트하는 방법(비 Amazon ECS 최적화 AMI) 때때로 버그 수정 및 새로운 기능을 적용하기 위해 Amazon ECS 컨테이너 에이전트를 업데이트해야 할 수도 있습니다. Amazon ECS 컨테이너 에이전트를 업데이트할 때 컨테이너 인스턴스의 실행 작업 또는 서비스가 중단되지 않습니다. **참고** 에이전트 업데이트는 Windows 컨테이너 인스턴스에 적용되지 않습니다. 새로운 컨테이너 인스턴스를 시작하여 Windows 클러스터의 에이전트 버전을 업데이트하는 것을 권장합니다. 1. SSH를 통해 컨테이너 인스턴스에 로그인합니다. 1. 에이전트가 `ECS_DATADIR` 환경 변수를 사용하여 해당 상태를 저장하는지 확인합니다. ``` ubuntu:~$ docker inspect ecs-agent | grep ECS_DATADIR ``` 출력: ``` "ECS_DATADIR=/data", ``` **중요** 이전 명령이 `ECS_DATADIR` 환경 변수를 반환하지 않으면 에이전트를 업데이트하기 전에 이 컨테이너 인스턴스에서 실행 중인 태스크를 모두 중지해야 합니다. `ECS_DATADIR` 환경 변수를 사용하는 새 버전의 에이전트는 해당 상태를 저장하며 태스크가 실행되는 동안 에이전트를 업데이트해도 문제가 발생하지 않습니다. 1. Amazon ECS 컨테이너 에이전트를 중지합니다. ``` ubuntu:~$ docker stop ecs-agent ``` 1. 에이전트 컨테이너를 삭제합니다. ``` ubuntu:~$ docker rm ecs-agent ``` 1. `/etc/ecs` 디렉터리와 Amazon ECS 컨테이너 에이전트 구성 파일이 `/etc/ecs/ecs.config`에 있는지 확인합니다. ``` ubuntu:~$ sudo mkdir -p /etc/ecs && sudo touch /etc/ecs/ecs.config ``` 1. `/etc/ecs/ecs.config` 파일을 편집하고 이 파일에 최소한 다음과 같은 변수 선언이 포함되어 있는지 확인합니다. 컨테이너 인스턴스가 기본 클러스터에 등록되지 않도록 하려면 클러스터 이름을 `ECS_CLUSTER`의 값으로 지정합니다. ``` ECS_DATADIR=/data ECS_ENABLE_TASK_IAM_ROLE=true ECS_ENABLE_TASK_IAM_ROLE_NETWORK_HOST=true ECS_LOGFILE=/log/ecs-agent.log ECS_AVAILABLE_LOGGING_DRIVERS=["json-file","awslogs"] ECS_LOGLEVEL=info ECS_CLUSTER=default ``` 이들을 비롯한 기타 에이전트 런타임 옵션에 대한 자세한 내용은 [Amazon ECS 컨테이너 에이전트 구성](ecs-agent-config.md) 섹션을 참조하세요. **참고** 필요할 경우 (시작 시 Amazon EC2 사용자 데이터를 사용하여 컨테이너 인스턴스에 다운로드할 수 있는) Amazon S3에 에이전트 환경 변수를 저장할 수 있습니다. 프라이빗 리포지토리의 인증 자격 증명과 같은 민감한 정보에는 이 방법을 권장합니다. 자세한 내용은 [Amazon S3에 Amazon ECS 컨테이너 인스턴스 구성 저장](ecs-config-s3.md) 및 [Amazon ECS에서 AWS 컨테이너가 아닌 이미지 사용](private-auth.md) 섹션을 참조하세요. 1. Amazon Elastic Container Registry Public에서 최신 Amazon ECS 컨테이너 에이전트 이미지를 가져옵니다. ``` ubuntu:~$ docker pull public.ecr.aws/ecs/amazon-ecs-agent:latest ``` 출력: ``` Pulling repository amazon/amazon-ecs-agent a5a56a5e13dc: Download complete 511136ea3c5a: Download complete 9950b5d678a1: Download complete c48ddcf21b63: Download complete Status: Image is up to date for amazon/amazon-ecs-agent:latest ``` 1. 컨테이너 인스턴스에서 최신 Amazon ECS 컨테이너 에이전트를 실행합니다. **참고** Docker 재시작 정책 또는 프로세스 관리자(예: **upstart** 또는 **systemd**)를 사용하여 컨테이너 에이전트를 서비스 또는 대몬으로 취급하고 종료 후에 다시 시작되도록 합니다. 이를 위해 Amazon ECS 최적화 AMI는 `ecs-init` RPM을 사용합니다. GitHub에서 [이 RPM의 소스 코드](https://github.com/aws/amazon-ecs-init)를 확인할 수 있습니다. 다음의 에이전트 실행 명령 예제는 각 옵션을 표시하기 위해 여러 줄로 구분되어 있습니다. 이들을 비롯한 기타 에이전트 런타임 옵션에 대한 자세한 내용은 [Amazon ECS 컨테이너 에이전트 구성](ecs-agent-config.md) 섹션을 참조하세요. **중요** 운영 체제에서 SELinux를 사용하는 경우 **docker run** 명령에 `--privileged` 옵션이 필요합니다. 또한 SELinux 사용 컨테이너 인스턴스의 경우에는 `:Z` 옵션을 `/log` 및 `/data` 볼륨 마운트에 추가하는 것이 좋습니다. 그러나 명령을 실행하기 전에 이러한 볼륨에 대한 호스트 마운트가 존재해야 하며 그렇지 않으면 `no such file or directory` 오류가 발생합니다. SELinux 사용 컨테이너 인스턴스에서 Amazon ECS 에이전트를 실행하는 데 문제가 있는 경우 다음 조치를 취하세요. 컨테이너 인스턴스에서 호스트 볼륨 마운트 지점을 생성합니다. ``` ubuntu:~$ sudo mkdir -p /var/log/ecs /var/lib/ecs/data ``` 아래의 **docker run** 명령에 `--privileged` 옵션을 추가합니다. 아래의 **docker run** 명령에 대한 `/log` 및 `/data` 컨테이너 볼륨 마운트(예: `--volume=/var/log/ecs/:/log:Z`)에 `:Z` 옵션을 추가합니다. ``` ubuntu:~$ sudo docker run --name ecs-agent \ --detach=true \ --restart=on-failure:10 \ --volume=/var/run:/var/run \ --volume=/var/log/ecs/:/log \ --volume=/var/lib/ecs/data:/data \ --volume=/etc/ecs:/etc/ecs \ --volume=/etc/ecs:/etc/ecs/pki \ --net=host \ --env-file=/etc/ecs/ecs.config \ amazon/amazon-ecs-agent:latest ``` **참고** `Error response from daemon: Cannot start container` 메시지가 표시되는 경우 **sudo docker rm ecs-agent** 명령을 사용하여 실패한 컨테이너를 삭제하고 에이전트를 다시 실행해볼 수 있습니다.