Amazon ECS 최적화 AMI 메타데이터 검색 - Amazon Elastic Container Service

Amazon ECS 최적화 AMI 메타데이터 검색

AMI ID, 이미지 이름, 운영 체제, 컨테이너 에이전트 버전 및 Amazon ECS 최적화 AMI의 각 변형에 대한 런타임 버전은 Systems Manager Parameter Store API를 쿼리함으로써 프로그래밍 방식으로 가져올 수 있습니다. Systems Manager Parameter Store API에 대한 자세한 정보는 GetParametersGetParametersByPath를 참조하세요.

참고

Amazon ECS 최적화 AMI 메타데이터를 검색하려면 사용자 계정에 다음과 같은 IAM 권한이 있어야 합니다. 이러한 권한은 AmazonECS_FullAccess IAM 정책에 추가되었습니다.

  • ssm:GetParameters

  • ssm:GetParameter

  • ssm:GetParametersByPath

Systems Manager Parameter Store 파라미터 형식

다음은 각 Amazon ECS 최적화 AMI 변형에 대한 파라미터 이름의 형식입니다.

  • Windows Server 2022 Full AMI 메타데이터:

    /aws/service/ami-windows-latest/Windows_Server-2022-English-Full-ECS_Optimized
  • Windows Server 2022 Core AMI 메타데이터:

    /aws/service/ami-windows-latest/Windows_Server-2022-English-Core-ECS_Optimized
  • Windows Server 2019 Full AMI 메타데이터:

    /aws/service/ami-windows-latest/Windows_Server-2019-English-Full-ECS_Optimized
  • Windows Server 2019 Core AMI 메타데이터:

    /aws/service/ami-windows-latest/Windows_Server-2019-English-Core-ECS_Optimized
  • Windows Server 2016 Full AMI 메타데이터:

    /aws/service/ami-windows-latest/Windows_Server-2016-English-Full-ECS_Optimized

다음 파라미터 이름 형식은 recommended를 사용하여 안정적인 최신 Amazon ECS 최적화 Amazon Linux 2 AMI의 메타데이터를 검색합니다.

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

다음은 파라미터 값에 대해 반환된 JSON 객체의 예입니다.

{
	"schema_version": 1,
	"image_name": "amzn2-ami-ecs-hvm-2.0.20181017-x86_64-ebs",
	"image_id": "ami-04a4fb062c609f55b",
	"os": "Amazon Linux 2",
	"ecs_runtime_version": "Docker version 18.06.1-ce",
	"ecs_agent_version": "1.21.0"
}

위 출력의 각 필드를 하위 파라미터 쿼리에 사용할 수 있습니다. 선택한 AMI 경로에 하위 파라미터 이름을 추가해 하위 파라미터에 대한 파라미터 경로를 구성합니다. 다음 하위 파라미터를 사용할 수 있습니다.

  • schema_version

  • image_id

  • image_name

  • os

  • ecs_agent_version

  • ecs_runtime_version

다음 파라미터 이름 형식은 하위 파라미터 image_id를 사용하여 안정적인 최신 Amazon ECS 최적화 Amazon Linux 2 AMI의 이미지 ID를 검색합니다.

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

다음 파라미터 이름 형식은 AMI 이름을 지정함으로써 특정 Amazon ECS 최적화 AMI 버전의 메타데이터를 가져옵니다.

  • Amazon ECS 최적화 Amazon Linux 2 AMI 메타데이터:

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

Amazon ECS 최적화 Amazon Linux 2 AMI의 버전을 모두 검색할 수 있습니다. Amazon ECS 최적화 AMI 버전 amzn-ami-2017.09.l-amazon-ecs-optimized(Linux) 이후 버전만 가져올 수 있습니다. 자세한 정보는 Amazon ECS 최적화 AMI 버전을 참조하세요.

다음 예에서는 Amazon ECS 최적화 AMI 변형에 대한 메타데이터를 검색할 수 있는 방법을 보여 줍니다.

안정적인 최신 Amazon ECS 최적화 AMI의 메타데이터 검색

AWS CLI와 다음 AWS CLI 명령을 사용하여 안정적인 최신 Amazon ECS 최적화 AMI를 가져올 수 있습니다.

  • Amazon ECS 최적화 Windows Server 2022 Full AMI의 경우:

    aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2022-English-Full-ECS_Optimized --region us-east-1
  • Amazon ECS 최적화 Windows Server 2022 Core AMI의 경우:

    aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2022-English-Core-ECS_Optimized --region us-east-1
  • Amazon ECS 최적화 Windows Server 2019 Full AMI의 경우:

    aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2019-English-Full-ECS_Optimized --region us-east-1
  • Amazon ECS 최적화 Windows Server 2019 Core AMI의 경우:

    aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2019-English-Core-ECS_Optimized --region us-east-1
  • Amazon ECS 최적화 Windows Server 2016 Full AMI의 경우:

    aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2016-English-Full-ECS_Optimized --region us-east-1

AWS CloudFormation 템플릿에서 최신 권장 Amazon ECS 최적화 AMI 사용

Systems Manager 파라미터 스토어 이름을 참조하여 AWS CloudFormation 템플릿에서 최신 Amazon ECS 최적화 AMI를 참조할 수 있습니다.

Parameters: LatestECSOptimizedAMI: Description: AMI ID Type: AWS::SSM::Parameter::Value<AWS::EC2::Image::Id> Default: /aws/service/ami-windows-latest/Windows_Server-2019-English-Full-ECS_Optimized/image_id