Image repositories for Amazon SAM - Amazon Serverless Application Model
Image repository URIsExamples
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 (PDF).

Image repositories for Amazon SAM

Amazon SAM simplifies continuous integration and continuous delivery (CI/CD) tasks for serverless applications with the help of build container images. The images that Amazon SAM provides include the Amazon SAM command line interface (CLI) and build tools for a number of supported Amazon Lambda runtimes. This make it easier to build and package serverless applications using the Amazon SAM CLI. You can use these images with CI/CD systems to automate the building and deployment of Amazon SAM applications. For examples, see Deploy with CI/CD systems and pipelines.

Amazon SAM build container image URIs are tagged with the version of the Amazon SAM CLI included in that image. If you specify the untagged URI, then the latest version is used. For example, public.ecr.aws/sam/build-nodejs20.x uses the latest image. However, public.ecr.aws/sam/build-nodejs20.x:1.24.1 uses the the image containing Amazon SAM CLI version 1.24.1.

Starting with version 1.33.0 of the Amazon SAM CLI, both x86_64 and arm64 container images are available for supported runtimes. For more information, see Lambda runtimes in the Amazon Lambda Developer Guide.

Note

Prior to version 1.22.0 of the Amazon SAM CLI, DockerHub was the default repository that the Amazon SAM CLI pulled the container image from. Starting with version 1.22.0, the default repository changed to Amazon Elastic Container Registry Public (Amazon ECR Public). To pull a container image from a repository other than the current default, you can use the sam build command with the --build-image option. The examples at the end of this topic show how to build applications using DockerHub repository images.

Image repository URIs

The following table lists the URIs of Amazon ECR Public build container images that you can use to build and package serverless applications with Amazon SAM.

Note

Amazon ECR Public replaced DockerHub starting with the Amazon SAM CLI version 1.22.0. If you are using an earlier version of the Amazon SAM CLI, we recommend that you upgrade.

Runtime Amazon ECR Public
Custom runtime (AL2023) public.ecr.aws/sam/build-provided.al2023
Custom runtime (AL2) public.ecr.aws/sam/build-provided.al2
Custom runtime public.ecr.aws/sam/build-provided
Java 21 public.ecr.aws/sam/build-java21
Java 17 public.ecr.aws/sam/build-java17
Java 11 public.ecr.aws/sam/build-java11
Java 8 public.ecr.aws/sam/build-java8
.NET 9 public.ecr.aws/sam/build-dotnet9
.NET 8 public.ecr.aws/sam/build-dotnet8
.NET 7 public.ecr.aws/sam/build-dotnet7
.NET 6 public.ecr.aws/sam/build-dotnet6
Node.js 22 public.ecr.aws/sam/build-nodejs22.x
Node.js 20 public.ecr.aws/sam/build-nodejs20.x
Node.js 18 public.ecr.aws/sam/build-nodejs18.x
Node.js 16 public.ecr.aws/sam/build-nodejs16.x
Python 3.13 public.ecr.aws/sam/build-python3.13
Python 3.12 public.ecr.aws/sam/build-python3.12
Python 3.11 public.ecr.aws/sam/build-python3.11
Python 3.10 public.ecr.aws/sam/build-python3.10
Python 3.9 public.ecr.aws/sam/build-python3.9
Python 3.8 public.ecr.aws/sam/build-python3.8
Ruby 3.4 public.ecr.aws/sam/build-ruby3.4
Ruby 3.3 public.ecr.aws/sam/build-ruby3.3
Ruby 3.2 public.ecr.aws/sam/build-ruby3.2

Examples

The following two example commands build applications using container images from the image repository:

Build a Node.js 22 application using a container image pulled from Amazon ECR:

$ sam build --use-container --build-image public.ecr.aws/sam/build-nodejs22.x

Build a function resource using the Python 3.13 container image pulled from Amazon ECR:

$ sam build --use-container --build-image Function1=public.ecr.aws/sam/build-python3.13