擷取 Amazon ECS 最佳化 Linux AMI 中繼資料 - Amazon Elastic Container Service
Systems Manager 參數存放區參數格式。範例

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

擷取 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 Optimized AMI。此參數可確保每次部署堆疊時，都會檢查是否有需要套用至 EC2 執行個體的可用更新。如需如何使用 Systems Manager 參數的範例，請參閱《 使用者指南》中的使用 Amazon ECS 最佳化 Amazon Linux 2023 AMI 建立 Amazon ECS 叢集。 AWS CloudFormation

透過查詢 Systems Manager 參數存放區 API，可以程式設計方式擷取 Amazon ECS 最佳化 AMI 的每個變體的 AMI ID、映像名稱、作業系統、容器代理程式版本、來源映像名稱以及執行時間版本。如需有關 Systems Manager 參數存放區 API 的詳細資訊，請參閱 GetParameters 和 GetParametersByPath。

注意

您的管理使用者必須擁有以下 IAM 許可，才能擷取 Amazon ECS 最佳化 AMI 中繼資料。已將這些權限新增至 AmazonECS_FullAccess IAM 政策。

  • ssm:GetParameters

  • ssm:GetParameter

  • ssm:GetParametersByPath

Systems Manager 參數存放區參數格式。

以下是每個 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 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 核心 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>

下列參數名稱格式會使用 子參數 擷取最新建議的 Amazon ECS 最佳化 Amazon Linux 2 AMI 影像 IDimage_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) AMIs：

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

  • 對於 Amazon ECS 最佳化 Amazon Linux 2023 GPU AMIs：

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2023/gpu/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 AMIs：

    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 AMIs：

    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 中繼資料

使用 Systems Manager GetParametersByPath API 搭配 AWS CLI 下列命令擷取 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

您可以使用 子參數 擷取最新建議的 Amazon ECS 最佳化 Amazon Linux 2 核心 5.10 AMI ID 的影像 ID。 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

若只要擷取 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