Using Bottlerocket with Amazon ECS - Amazon Elastic Container Service

Using Bottlerocket with Amazon ECS

Bottlerocket is a Linux-based open source operating system that is purpose-built by AWS for running containers. For more information, see Bottlerocket OS on GitHub.

An Amazon ECS-optimized AMI variant of the Bottlerocket operating system is provided as an AMI you can use when launching Amazon ECS container instances. For a detailed walkthrough of how to get started with the Bottlerocket operating system on Amazon ECS, see Using a Bottlerocket AMI with Amazon ECS on GitHub.

You can request new features on the GitHub page. For more information, see Bottlerocket Issues on GitHub.

Amazon ECS-optimized Bottlerocket AMI variants

You can use the following Amazon ECS-optimized Bottlerocket AMI variants for your Amazon EC2 instances.

Considerations

Consider the following when using a Bottlerocket AMI with Amazon ECS.

  • Bottlerocket is optimized for container workloads and has a focus on security. It does not include a package manager and is immutable by default. For information about the security features and guidance, see Security Features and Security Guidance on the GitHub website.

  • Amazon EC2 instances with x86 or arm64 processors are supported.

  • Amazon EC2 instances with Inferentia chips are not supported.

  • The awsvpc network mode is supported when using Bottlerocket AMI version 1.1.0 or later.

  • The initProcessEnabled task definition parameter is not supported.

  • The following features are not supported:

    • App Mesh in task definitions

    • ECS Anywhere

    • ECS Exec

    • Amazon EFS file system volumes

    • Amazon EFS in encrypted mode and awsvpc network mode

    • Elastic Inference

    • FireLens in task definitions

Retrieving an Amazon ECS-optimized Bottlerocket AMI

You can use one of the following ways to retrieve an Amazon ECS-optimized Bottlerocket AMI variant.

  • Use AWS Systems Manager parameters in a AWS CLI command

  • Click the AMI link for a specific region, variant, and architecture in the tables on this page

Use AWS Systems Manager parameters in a AWS CLI command

Use AWS Systems Manager parameters in the following AWS CLI command to retrieve the latest stable aws-ecs-1 Bottlerocket AMI variant by Region and architecture. To retrieve a version other than the latest, replace latest with the version number.

  • For the 64-bit (x86_64) architecture:

    aws ssm get-parameter --region us-east-1 --name "/aws/service/bottlerocket/aws-ecs-1/x86_64/latest/image_id" --query Parameter.Value --output text
  • For the 64-bit ARM (arm64) architecture:

    aws ssm get-parameter --region us-east-1 --name "/aws/service/bottlerocket/aws-ecs-1/arm64/latest/image_id" --query Parameter.Value --output text

Click the AMI link

The following table provides a link to retrieve the latest Amazon ECS-optimized Bottlerocket AMI variant aws-ecs-1, by Region and architecture.

Region Name

Region

x86_64 AMI ID

arm64 AMI ID

US East (N. Virginia)

us-east-1

View AMI ID

View AMI ID

US East (Ohio)

us-east-2

View AMI ID

View AMI ID

US West (N. California)

us-west-1

View AMI ID

View AMI ID

US West (Oregon)

us-west-2

View AMI ID

View AMI ID

Africa (Cape Town)

af-south-1

View AMI ID

View AMI ID

Asia Pacific (Hong Kong)

ap-east-1

View AMI ID

View AMI ID

Asia Pacific (Tokyo)

ap-northeast-1

View AMI ID

View AMI ID

Asia Pacific (Seoul)

ap-northeast-2

View AMI ID

View AMI ID

Asia Pacific (Osaka)

ap-northeast-3

View AMI ID

View AMI ID

Asia Pacific (Mumbai)

ap-south-1

View AMI ID

View AMI ID

Asia Pacific (Singapore)

ap-southeast-1

View AMI ID

View AMI ID

Asia Pacific (Sydney)

ap-southeast-2

View AMI ID

View AMI ID

Asia Pacific (Jakarta)

ap-southeast-3

View AMI ID

View AMI ID

Canada (Central)

ca-central-1

View AMI ID

View AMI ID

Europe (Frankfurt)

eu-central-1

View AMI ID

View AMI ID

Europe (Stockholm)

eu-north-1

View AMI ID

View AMI ID

Europe (Ireland)

eu-west-1

View AMI ID

View AMI ID

Europe (London)

eu-west-2

View AMI ID

View AMI ID

Europe (Paris)

eu-west-3

View AMI ID

View AMI ID

Europe (Milan)

eu-south-1

View AMI ID

View AMI ID

Middle East (Bahrain)

me-south-1

View AMI ID

View AMI ID

Middle East (UAE)

me-central-1

View AMI ID

View AMI ID

South America (São Paulo)

sa-east-1

View AMI ID

View AMI ID

AWS GovCloud (US-East)

us-gov-east-1

View AMI ID

View AMI ID

AWS GovCloud (US-West)

us-gov-west-1

View AMI ID

View AMI ID

Use AWS Systems Manager parameters a AWS CLI command

Use AWS Systems Manager parameters in the following AWS CLI command to retrieve the latest stable aws-ecs-1-nvidia Bottlerocket AMI variant by Region and architecture. To retrieve a version other than the latest, replace latest with the version number.

  • For the 64-bit (x86_64) architecture:

    aws ssm get-parameter --region us-east-1 --name "/aws/service/bottlerocket/aws-ecs-1-nvidia/x86_64/latest/image_id" --query Parameter.Value --output text
  • For the 64-bit ARM (arm64) architecture:

    aws ssm get-parameter --region us-east-1 --name "/aws/service/bottlerocket/aws-ecs-1-nvidia/arm64/latest/image_id" --query Parameter.Value --output text

Click the AMI link

The following table provides a link to retrieve the latest Amazon ECS-optimized Bottlerocket AMI variant aws-ecs-1-nvidia, by Region and architecture.

Region Name

Region

x86_64 AMI ID

arm64 AMI ID

US East (N. Virginia)

us-east-1

View AMI ID

View AMI ID

US East (Ohio)

us-east-2

View AMI ID

View AMI ID

US West (N. California)

us-west-1

View AMI ID

View AMI ID

US West (Oregon)

us-west-2

View AMI ID

View AMI ID

Africa (Cape Town)

af-south-1

View AMI ID

View AMI ID

Asia Pacific (Hong Kong)

ap-east-1

View AMI ID

View AMI ID

Asia Pacific (Tokyo)

ap-northeast-1

View AMI ID

View AMI ID

Asia Pacific (Seoul)

ap-northeast-2

View AMI ID

View AMI ID

Asia Pacific (Osaka)

ap-northeast-3

View AMI ID

View AMI ID

Asia Pacific (Mumbai)

ap-south-1

View AMI ID

View AMI ID

Asia Pacific (Singapore)

ap-southeast-1

View AMI ID

View AMI ID

Asia Pacific (Sydney)

ap-southeast-2

View AMI ID

View AMI ID

Asia Pacific (Jakarta)

ap-southeast-3

View AMI ID

View AMI ID

Canada (Central)

ca-central-1

View AMI ID

View AMI ID

Europe (Frankfurt)

eu-central-1

View AMI ID

View AMI ID

Europe (Stockholm)

eu-north-1

View AMI ID

View AMI ID

Europe (Ireland)

eu-west-1

View AMI ID

View AMI ID

Europe (London)

eu-west-2

View AMI ID

View AMI ID

Europe (Paris)

eu-west-3

View AMI ID

View AMI ID

Europe (Milan)

eu-south-1

View AMI ID

View AMI ID

Middle East (Bahrain)

me-south-1

View AMI ID

View AMI ID

Middle East (UAE)

me-central-1

View AMI ID

View AMI ID

South America (São Paulo)

sa-east-1

View AMI ID

View AMI ID

AWS GovCloud (US-East)

us-gov-east-1

View AMI ID

View AMI ID

AWS GovCloud (US-West)

us-gov-west-1

View AMI ID

View AMI ID