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

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

Amazon ECS 최적화 AMI 메타데이터를 프로그래밍 방식으로 검색할 수 있습니다. 메타데이터에는 AMI 이름, Amazon ECS 컨테이너 에이전트 버전, Docker 버전이 포함된 Amazon ECS 런타임 버전이 포함됩니다.

콘솔을 사용하여 클러스터를 생성하면 Amazon ECS는 선택한 운영 체제와 연결된 최신 AMI를 사용하여 인스턴스에 대한 시작 템플릿을 생성합니다.

AWS CloudFormation을 사용하여 클러스터를 생성할 때 SSM 파라미터는 Auto Scaling 그룹 인스턴스용 Amazon EC2 시작 템플릿의 일부입니다. 동적 Systems Manager 파라미터를 사용하여 배포할 Amazon ECS 최적화 AMI를 결정하도록 템플릿을 구성할 수 있습니다. 이 파라미터를 사용하면 스택을 배포할 때마다 EC2 인스턴스에 적용해야 하는 업데이트가 있는지 확인할 수 있습니다. Systems Manager 파라미터를 사용하는 방법에 대한 예제는 AWS CloudFormation 사용 설명서의 Create an Amazon ECS cluster with the Amazon ECS-optimized Amazon Linux 2023 AMI를 참조하세요.

Amazon ECS 최적화 AMI의 각 변형에 대한 AMI ID, 이미지 이름, 운영 체제, 컨테이너 에이전트 버전, 소스 이미지 이름 및 런타임 버전은 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 변형에 대한 파라미터 이름의 형식입니다.

Linux Amazon ECS 최적화 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 2 AMI 메타데이터:

    /aws/service/ecs/optimized-ami/amazon-linux-2/<version>
  • Amazon Linux 2 커널 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 커널 5.10(arm64) AMI 메타데이터:

    /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/arm64/<version>
  • Amazon ECS GPU 최적화 커널 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 최적화 Amazon Linux 2(Neuron) 커널 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 최적화 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의 메타데이터 검색

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

Linux Amazon ECS 최적화 AMI

  • Amazon ECS 최적화 Amazon Linux 2023 AMI의 경우:

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2023/recommended --region us-east-1
  • Amazon ECS 최적화 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 최적화 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 최적화 Amazon Linux 2 커널 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 최적화 Amazon Linux 2 AMI의 경우:

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/recommended --region us-east-1
  • Amazon ECS 최적화 Amazon Linux 2 커널 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 최적화 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 최적화 커널 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 최적화 AMI의 경우:

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/gpu/recommended --region us-east-1
  • Amazon ECS 최적화 Amazon Linux 2(Neuron) 커널 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 최적화 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 최적화 Amazon Linux 2023 AMI의 이미지 ID 검색

하위 파라미터 image_id를 사용하여 권장되는 최신 Amazon ECS 최적화 Amazon Linux 2023 AMI ID의 이미지 ID를 검색할 수 있습니다.

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

image_id 값만 검색하기 위해, 다음 예와 같이 특정 파라미터 값을 쿼리할 수 있습니다.

aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2023/recommended/image_id --region us-east-1 --query "Parameters[0].Value"

특정 Amazon ECS 최적화 Amazon Linux 2 AMI 버전의 메타데이터 검색

AWS CLI와 AWS CLI 명령을 사용하여 다음 특정 Amazon ECS 최적화 Amazon Linux AMI 버전의 메타데이터를 가져옵니다. AMI 이름을 검색할 Amazon ECS 최적화 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 최적화 Amazon Linux 2 커널 5.10 AMI 메타데이터 검색

다음 명령과 AWS CLI를 사용한 Systems Manager GetParametersByPath API로 Amazon ECS 최적화 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

권장되는 최신 Amazon ECS 최적화 Amazon Linux 2 커널 5.10 AMI의 이미지 ID 검색

하위 파라미터 image_id를 사용하여 권장되는 최신 Amazon ECS 최적화 Amazon Linux 2 커널 5.10 AMI ID의 이미지 ID를 검색할 수 있습니다.

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

image_id 값만 검색하기 위해, 다음 예와 같이 특정 파라미터 값을 쿼리할 수 있습니다.

aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/recommended/image_id --region us-east-1 --query "Parameters[0].Value"

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

Systems Manager 파라미터 스토어 이름을 참조하여 AWS CloudFormation 템플릿에서 최신 Amazon ECS 최적화 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