Building your own Amazon ECS-optimized Windows AMI - Amazon Elastic Container Service
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China.

Building your own Amazon ECS-optimized Windows AMI

EC2 Image Builder can be used to build your own custom Amazon ECS-optimized Windows AMI. This makes it easy to use a Windows AMI with your own license on Amazon ECS. Amazon ECS provides a managed Image Builder component which provides the system configuration needed to run Windows instances to host your containers. Each Amazon ECS managed component includes a specific container agent and Docker version. You can customize your image to use either the latest Amazon ECS managed component, or if an older container agent or Docker version is needed you can specify a different component.

For a full walkthrough of using EC2 Image Builder, see Getting started with EC2 Image Builder in the EC2 Image Builder User Guide.

When building your own Amazon ECS-optimized Windows AMI using EC2 Image Builder, you create an image recipe. Your image recipe must meet the following requirements:

  • The Source image should be based on Windows Server 2004 Core, Windows Server 2016 Full, Windows Server 2019 Core, Windows Server 2019 Full, Windows Server 2022 Core, or Windows Server 2022 Full. Any other Windows operating system is not supported and may not be compatible with the component.

  • When specifying the Build components, the ecs-optimized-ami-windows component is required. The update-windows component is recommended, which ensures the image contains the latest security updates.

                        The required components for building a custom Amazon ECS
                            Windows-optimized AMI

    To specify a different component version, expand the Versioning options menu and specify the component version you want to use. For more information, see Listing the ecs-optimized-ami-windows component versions.

Listing the ecs-optimized-ami-windows component versions

When creating an EC2 Image Builder recipe and specifying the ecs-optimized-ami-windows component, you can either use the default option or you can specify a specific component version. To determine what component versions are available, along with the Amazon ECS container agent and Docker versions contained within the component, you can use the Amazon Web Services Management Console.

To list the available ecs-optimized-ami-windows component versions

  1. Open the EC2 Image Builder console at

  2. On the navigation bar, select the Region that are building your image in.

  3. In the navigation pane, under the Saved configurations menu, choose Components.

  4. On the Components page, in the search bar type ecs-optimized-ami-windows and pull down the qualification menu and select Quick start (Amazon-managed).

  5. Use the Description column to determine the component version with the Amazon ECS container agent and Docker version your image requires.