View a markdown version of this page

Mengambil metadata AMI Amazon ECS-optimized Linux - Amazon Elastic Container Service

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Mengambil metadata AMI Amazon ECS-optimized Linux

Anda dapat mengambil metadata Amazon AMI ECS-optimized secara terprogram. Metadata mencakup nama AMI, versi agen penampung Amazon ECS, dan versi runtime Amazon ECS yang mencakup versi Docker.

Saat Anda membuat klaster menggunakan konsol, Amazon ECS membuat template peluncuran untuk instans Anda dengan AMI terbaru yang terkait dengan sistem operasi yang dipilih.

Saat Anda menggunakan CloudFormation untuk membuat klaster, parameter SSM adalah bagian dari template peluncuran Amazon EC2 untuk instans grup Auto Scaling. Anda dapat mengonfigurasi template untuk menggunakan parameter Systems Manager dinamis untuk menentukan apa yang akan digunakan oleh Amazon ECS Optimized AMI. Parameter ini memastikan bahwa setiap kali Anda menerapkan tumpukan itu akan memeriksa untuk melihat apakah ada pembaruan yang tersedia yang perlu diterapkan ke instans EC2. Untuk contoh cara menggunakan parameter Systems Manager, lihat Membuat klaster Amazon ECS dengan Amazon ECS-optimized Amazon Linux 2023 AMI di AWS CloudFormation Panduan Pengguna.

ID AMI, nama gambar, sistem operasi, versi agen kontainer, nama gambar sumber, dan versi runtime untuk setiap varian ECS-optimized AMI Amazon dapat diambil secara terprogram dengan menanyakan Systems Manager Parameter Store API. Untuk informasi selengkapnya tentang Systems Manager Parameter Store API, lihat GetParametersdan GetParametersByPath.

catatan

Pengguna administratif Anda harus memiliki izin IAM berikut untuk mengambil metadata Amazon AMI ECS-optimized . Izin ini telah ditambahkan ke kebijakan AmazonECS_FullAccess IAM.

  • ssm: GetParameters

  • ssm: GetParameter

  • ssm: GetParametersByPath

Systems Manager Parameter Menyimpan format parameter

Berikut ini adalah format nama parameter untuk setiap varian Amazon ECS-optimized AMI.

ECS-optimized AMI Amazon Linux

  • Metadata AMI Amazon Linux 2023:

    /aws/service/ecs/optimized-ami/amazon-linux-2023/<version>
  • Amazon Linux 2023 (arm64) metadata AMI:

    /aws/service/ecs/optimized-ami/amazon-linux-2023/arm64/<version>
  • Amazon Linux 2023 (Neuron) metadata AMI:

    /aws/service/ecs/optimized-ami/amazon-linux-2023/neuron/<version>
  • Amazon Linux 2023 (GPU) metadata AMI:

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

    Amazon Linux 2 AMI metadata:

    /aws/service/ecs/optimized-ami/amazon-linux-2/<version>
  • Amazon Linux 2 kernel 5.10 metadata AMI:

    /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/<version>
  • Amazon Linux 2 (arm64) AMI metadata:

    /aws/service/ecs/optimized-ami/amazon-linux-2/arm64/<version>
  • Amazon Linux 2 kernel 5.10 (arm64) metadata AMI:

    /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/arm64/<version>
  • GPU-optimized Kernel Amazon ECS 5.10 metadata AMI:

    /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/gpu/<version>
  • Amazon Linux 2 (GPU) AMI metadata:

    /aws/service/ecs/optimized-ami/amazon-linux-2/gpu/<version>
  • Amazon ECS mengoptimalkan metadata kernel Amazon Linux 2 (Neuron) 5.10 AMI:

    /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/inf/<version>
  • Amazon Linux 2 (Neuron) metadata AMI:

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

Format nama parameter berikut mengambil ID gambar dari Amazon ECS-optimized Amazon Linux 2 AMI terbaru yang direkomendasikan dengan menggunakan image_id sub-parameter.

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

Format nama parameter berikut mengambil metadata versi Amazon AMI tertentu dengan menentukan nama ECS-optimized AMI.

  • Amazon ECS-optimized Amazon Linux 2 metadata AMI:

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

Semua versi Amazon ECS-optimized Amazon Linux 2 AMI tersedia untuk diambil. Hanya versi Amazon ECS-optimized AMI amzn-ami-2017.09.l-amazon-ecs-optimized (Linux) dan yang lebih baru yang dapat diambil.

Contoh

Contoh berikut menunjukkan cara Anda dapat mengambil metadata untuk setiap varian Amazon AMI ECS-optimized .

Mengambil metadata dari Amazon AMI terbaru yang direkomendasikan ECS-optimized

Anda dapat mengambil Amazon ECS-optimized AMI terbaru yang AWS CLI direkomendasikan menggunakan AWS CLI perintah berikut.

ECS-optimized AMI Amazon Linux

  • Untuk 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
  • Untuk 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
  • Untuk 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
  • Untuk AMI GPU ECS-optimized Amazon Amazon Linux 2023:

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2023/gpu/recommended --region us-east-1
  • Untuk 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
  • Untuk 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
  • Untuk 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
  • Untuk 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
  • Untuk GPU-optimized kernel Amazon ECS 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
  • Untuk Amazon ECS GPU-optimized AMI:

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/gpu/recommended --region us-east-1
  • Untuk Amazon ECS yang dioptimalkan 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
  • Untuk Amazon ECS yang dioptimalkan Amazon Linux 2 (Neuron) AMI:

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

Mengambil ID gambar dari Amazon ECS-optimized Amazon Linux 2023 AMI terbaru yang direkomendasikan

Anda dapat mengambil ID gambar dari ID AMI Amazon ECS-optimized Amazon Linux 2023 terbaru yang direkomendasikan dengan menggunakan sub-parameter. image_id

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

Untuk mengambil nilai image_id saja, Anda dapat meng-kueri nilai parameter tertentu; misalnya:

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

Mengambil metadata dari versi AMI Amazon ECS-optimized Amazon Linux 2 tertentu

Ambil metadata versi AMI Amazon Amazon ECS-optimized Linux tertentu menggunakan perintah AWS CLI berikut. AWS CLI Ganti nama AMI dengan nama Amazon ECS-optimized Amazon Linux AMI untuk diambil.

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

Mengambil metadata AMI kernel ECS-optimized Amazon Amazon Linux 2 5.10 AMI menggunakan Systems Manager API GetParametersByPath

Ambil metadata ECS-optimized Amazon Amazon Linux 2 AMI dengan Systems Manager GetParametersByPath API menggunakan perintah AWS CLI berikut.

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

Mengambil ID gambar dari kernel Amazon ECS-optimized Amazon Linux 2 terbaru yang direkomendasikan 5.10 AMI

Anda dapat mengambil ID gambar dari ID AMI kernel 5.10 Amazon ECS-optimized Amazon Linux 2 terbaru yang direkomendasikan dengan menggunakan sub-parameter. image_id

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

Untuk mengambil nilai image_id saja, Anda dapat meng-kueri nilai parameter tertentu; misalnya:

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

Menggunakan Amazon ECS-optimized AMI terbaru yang direkomendasikan dalam CloudFormation template

Anda dapat mereferensikan Amazon ECS-optimized AMI terbaru yang direkomendasikan dalam CloudFormation template dengan mereferensikan nama penyimpanan parameter Systems Manager.

Contoh 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