Amazon ECS-optimized Linux AMI 메타데이터 검색

Amazon ECS-optimized AMI 메타데이터를 프로그래밍 방식으로 검색할 수 있어요. 메타데이터에는 AMI 이름, Amazon ECS 컨테이너 에이전트 버전, Docker 버전을 포함하는 Amazon ECS 런타임 버전이 포함돼요. 콘솔을 사용해 클러스터를 만들면 Amazon ECS는 선택한 운영 체제와 연결된 최신 AMI로 인스턴스용 launch template을 만들어요. CloudFormation으로 클러스터를 만들면 SSM 파라미터는 Auto Scaling 그룹 인스턴스용 Amazon EC2 launch template의 일부가 돼요. 템플릿을 구성해 동적 Systems Manager 파라미터를 사용해 배포할 Amazon ECS Optimized AMI를 결정할 수 있어요. 이 파라미터는 스택을 배포할 때마다 EC2 인스턴스에 적용해야 할 업데이트가 있는지 확인하도록 보장해요. Systems Manager 파라미터 사용 예제는 AWS CloudFormation User Guide의 Create an Amazon ECS cluster with the Amazon ECS-optimized Amazon Linux 2023 AMI를 참고하세요.

출처: 문서

본문

Amazon ECS-optimized AMI 각 변형의 AMI ID, 이미지 이름, 운영 체제, 컨테이너 에이전트 버전, 소스 이미지 이름, 런타임 버전은 Systems Manager Parameter Store API를 조회해 프로그래밍 방식으로 검색할 수 있어요. Systems Manager Parameter Store API에 대한 자세한 내용은 GetParameters와 GetParametersByPath를 참고하세요.

참고: 관리 사용자는 Amazon ECS-optimized AMI 메타데이터를 검색하려면 다음 IAM 권한이 있어야 해요. 이 권한들은 AmazonECS_FullAccess IAM 정책에 추가되었어요.

ssm:GetParameters
ssm:GetParameter
ssm:GetParametersByPath

Systems Manager Parameter Store 파라미터 형식

다음은 각 Amazon ECS-optimized AMI 변형의 파라미터 이름 형식이에요.

Linux Amazon ECS-optimized AMI

Amazon Linux 2023 AMI 메타데이터:

/aws/service/ecs/optimized-ami/amazon-linux-2023/<version>

Amazon Linux 2023 (arm64) AMI 메타데이터:

/aws/service/ecs/optimized-ami/amazon-linux-2023/arm64/<version>

Amazon Linux 2023 (Neuron) AMI 메타데이터:

/aws/service/ecs/optimized-ami/amazon-linux-2023/neuron/<version>

Amazon Linux 2023 (GPU) AMI 메타데이터:

/aws/service/ecs/optimized-ami/amazon-linux-2023/gpu/<version>

Amazon Linux 2 AMI 메타데이터:

/aws/service/ecs/optimized-ami/amazon-linux-2/<version>

Amazon Linux 2 kernel 5.10 AMI 메타데이터:

/aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/<version>

Amazon Linux 2 (arm64) AMI 메타데이터:

/aws/service/ecs/optimized-ami/amazon-linux-2/arm64/<version>

Amazon Linux 2 kernel 5.10 (arm64) AMI 메타데이터:

/aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/arm64/<version>

Amazon ECS GPU-optimized kernel 5.10 AMI 메타데이터:

/aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/gpu/<version>

Amazon Linux 2 (GPU) AMI 메타데이터:

/aws/service/ecs/optimized-ami/amazon-linux-2/gpu/<version>

Amazon ECS optimized Amazon Linux 2 (Neuron) kernel 5.10 AMI 메타데이터:
```
/aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/inf/<version>
```

Amazon Linux 2 (Neuron) AMI 메타데이터:

/aws/service/ecs/optimized-ami/amazon-linux-2/inf/<version>

다음 파라미터 이름 형식은 image_id 하위 파라미터를 사용해 최신 권장 Amazon ECS-optimized Amazon Linux 2 AMI의 이미지 ID를 검색해요.

/aws/service/ecs/optimized-ami/amazon-linux-2/recommended/image_id

다음 파라미터 이름 형식은 AMI 이름을 지정해 특정 Amazon ECS-optimized AMI 버전의 메타데이터를 검색해요.

Amazon ECS-optimized Amazon Linux 2 AMI 메타데이터:

/aws/service/ecs/optimized-ami/amazon-linux-2/amzn2-ami-ecs-hvm-2.0.20181112-x86_64-ebs

참고: 모든 Amazon ECS-optimized Amazon Linux 2 AMI 버전을 검색할 수 있어요. Amazon ECS-optimized AMI 버전 amzn-ami-2017.09.l-amazon-ecs-optimized(Linux) 이상만 검색할 수 있어요.

예제 (Examples)

다음 예제는 각 Amazon ECS-optimized AMI 변형의 메타데이터를 검색할 수 있는 방법을 보여 줘요.

최신 권장 Amazon ECS-optimized AMI의 메타데이터 검색

다음 AWS CLI 명령으로 최신 권장 Amazon ECS-optimized AMI를 검색할 수 있어요.

Amazon ECS-optimized Amazon Linux 2023 AMI의 경우:

aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2023/recommended --region us-east-1

Amazon ECS-optimized Amazon Linux 2023 (arm64) AMI의 경우:

aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2023/arm64/recommended --region us-east-1

Amazon ECS-optimized Amazon Linux 2023 (Neuron) AMI의 경우:

aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2023/neuron/recommended --region us-east-1

Amazon ECS-optimized Amazon Linux 2023 GPU AMI의 경우:

aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2023/gpu/recommended --region us-east-1

Amazon ECS-optimized Amazon Linux 2 kernel 5.10 AMI의 경우:

aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/recommended --region us-east-1

Amazon ECS-optimized Amazon Linux 2 AMI의 경우:

aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/recommended --region us-east-1

Amazon ECS-optimized Amazon Linux 2 kernel 5.10 (arm64) AMI의 경우:

aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/arm64/recommended --region us-east-1

Amazon ECS-optimized Amazon Linux 2 (arm64) AMI의 경우:

aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/arm64/recommended --region us-east-1

Amazon ECS GPU-optimized kernel 5.10 AMI의 경우:

aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/gpu/recommended --region us-east-1

Amazon ECS GPU-optimized AMI의 경우:

aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/gpu/recommended --region us-east-1

Amazon ECS optimized Amazon Linux 2 (Neuron) kernel 5.10 AMI의 경우:

aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/inf/recommended --region us-east-1

Amazon ECS optimized Amazon Linux 2 (Neuron) AMI의 경우:

aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/inf/recommended --region us-east-1

특정 Amazon ECS-optimized Amazon Linux 2 AMI 버전의 메타데이터 검색

다음 AWS CLI 명령으로 특정 Amazon ECS-optimized Amazon Linux AMI 버전의 메타데이터를 검색하세요. AMI 이름을 검색할 Amazon ECS-optimized Amazon Linux AMI의 이름으로 바꾸세요.

aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/amzn2-ami-ecs-hvm-2.0.20200928-x86_64-ebs --region us-east-1

Systems Manager GetParametersByPath API로 Amazon ECS-optimized Amazon Linux 2 kernel 5.10 AMI 메타데이터 검색

다음 명령으로 AWS CLI에서 Systems Manager GetParametersByPath API로 Amazon ECS-optimized Amazon Linux 2 AMI 메타데이터를 검색하세요.

aws ssm get-parameters-by-path --path /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/ --region us-east-1

CloudFormation 템플릿에서 최신 권장 Amazon ECS-optimized AMI 사용

Systems Manager 파라미터 저장소 이름을 참조해 CloudFormation 템플릿에서 최신 권장 Amazon ECS-optimized AMI를 참조할 수 있어요.

Linux 예제

Parameters:kernel-5.10
  LatestECSOptimizedAMI:
    Description: AMI ID
    Type: AWS::SSM::Parameter::Value<AWS::EC2::Image::Id>
    Default: /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/recommended/image_id

Amazon ECS-optimized Linux AMI 메타데이터 검색