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 ECS-optimized AMI secara terprogram. Metadata termasuk nama AMI, versi agen wadah Amazon ECS, dan versi runtime Amazon ECS yang menyertakan versi Docker.

Saat Anda membuat cluster 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 cluster, parameter SSM adalah bagian dari template peluncuran Amazon EC2 untuk instans grup Penskalaan Otomatis. Anda dapat mengonfigurasi template untuk menggunakan parameter Manajer Sistem dinamis untuk menentukan AMI yang dioptimalkan Amazon ECS yang akan diterapkan. 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 Manajer Sistem, lihat Membuat cluster Amazon ECS dengan Amazon ECS-optimized Amazon Linux 2023 AMI di Panduan AWS CloudFormation 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 API Penyimpanan Parameter System Manager. Untuk informasi selengkapnya tentang API Penyimpanan Parameter Manajer Sistem, lihat GetParameters dan GetParametersByPath.

catatan

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

  • SSM: GetParameters

  • SSM: GetParameter

  • SSM: GetParametersByPath

Format parameter Penyimpanan Parameter Manajer Sistem

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

Linux Amazon ECS-optimized AMI

  • Metadata AMI Amazon Linux 2023:

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

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

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

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

    Amazon Linux 2 AMI metadata:

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

    /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>
  • Metadata AMI GPU-optimized kernel Amazon ECS 5.10:

    /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 AMI kernel Amazon Linux 2 (Neuron) 5.10:

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

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

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

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

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

  • Metadata AMI ECS-optimized Amazon Amazon Linux 2:

    /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 di mana Anda dapat mengambil metadata untuk setiap varian Amazon ECS-optimized AMI.

Mengambil metadata dari Amazon ECS-optimized AMI terbaru yang direkomendasikan

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

Linux Amazon ECS-optimized AMI

  • Untuk AMI Amazon ECS-optimized Amazon Linux 2023:

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2023/recommended --region us-east-1
  • Untuk AMI Amazon ECS-optimized Amazon Linux 2023 (arm64):

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2023/arm64/recommended --region us-east-1
  • Untuk AMI Amazon ECS-optimized Amazon Linux 2023 (Neuron):

    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 AMI kernel ECS-optimized Amazon Amazon Linux 2 5.10:

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/recommended --region us-east-1
  • Untuk AMI Amazon ECS-optimized Amazon Linux 2:

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/recommended --region us-east-1
  • Untuk AMI kernel ECS-optimized Amazon Amazon Linux 2 5.10 (arm64):

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/arm64/recommended --region us-east-1
  • Untuk AMI Amazon ECS-optimized Amazon Linux 2 (arm64):

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/arm64/recommended --region us-east-1
  • Untuk AMI GPU-optimized kernel Amazon ECS 5.10:

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/gpu/recommended --region us-east-1
  • Untuk AMI Amazon ECS GPU-optimized :

    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 AMI Amazon Linux 2 (Neuron) yang dioptimalkan Amazon ECS:

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

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

Anda dapat mengambil ID gambar dari ID AMI Amazon ECS-optimized Amazon Linux 2023 terbaru yang direkomendasikan dengan menggunakan sub-parameterimage_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 versi AMI Amazon ECS-optimized Amazon Linux 2 tertentu

Ambil metadata versi AMI ECS-optimized Amazon Amazon Linux tertentu menggunakan AWS CLI perintah berikut. AWS CLI Ganti nama AMI dengan nama AMI Amazon ECS-optimized Amazon Linux 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 Amazon ECS-optimized Amazon Linux 2 kernel 5.10 AMI menggunakan API Manajer Sistem GetParametersByPath

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

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 Amazon ECS-optimized Amazon Linux 2 kernel 5.10 AMI terbaru yang direkomendasikan

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

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 templat

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

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