View a markdown version of this page

AWS::ElasticBeanstalk::ApplicationVersion ImageBuildConfiguration - AWS CloudFormation
SyntaxProperties

This is the new CloudFormation Template Reference Guide. Please update your bookmarks and links. For help getting started with CloudFormation, see the AWS CloudFormation User Guide.

AWS::ElasticBeanstalk::ApplicationVersion ImageBuildConfiguration

Settings that Elastic Beanstalk uses to build a container image from the source bundle of an application version.

Syntax

To declare this entity in your CloudFormation template, use the following syntax:

JSON

{
  "Architecture" : String,
  "Buildpack" : String,
  "CodeBuildServiceRole" : String,
  "ComputeType" : String,
  "DockerfileLocation" : String,
  "TimeoutInMinutes" : Integer,
  "Type" : String
}

YAML

  Architecture: String
  Buildpack: String
  CodeBuildServiceRole: String
  ComputeType: String
  DockerfileLocation: String
  TimeoutInMinutes: Integer
  Type: String

Properties

Architecture

The processor architecture that Elastic Beanstalk builds the container image for. The architecture must match the architecture of the instances in the environment that you deploy the application version to.

Valid values:

  • amd64 – x86-64 instances. This is the default.

  • arm64 – AWS Graviton instances.

Required: No

Type: String

Allowed values: amd64 | arm64

Update requires: Replacement

Buildpack

The Cloud Native Buildpacks builder image that Elastic Beanstalk uses to build the container image. For example, paketobuildpacks/builder-jammy-base.

This member is required when Type is buildpack. Elastic Beanstalk doesn't provide a default builder.

Required: No

Type: String

Update requires: Replacement

CodeBuildServiceRole

The Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) role that AWS CodeBuild assumes to run the build in your AWS account. Elastic Beanstalk rejects a Build that doesn't specify this role.

Required: Yes

Type: String

Pattern: .*\S.*

Update requires: Replacement

ComputeType

The size of the compute resources that run the build. If you don't specify it, Elastic Beanstalk uses BUILD_GENERAL1_MEDIUM.

Valid values:

  • BUILD_GENERAL1_SMALL – Use up to 3 GB memory and 2 vCPUs for builds.

  • BUILD_GENERAL1_MEDIUM – Use up to 7 GB memory and 4 vCPUs for builds.

  • BUILD_GENERAL1_LARGE – Use up to 15 GB memory and 8 vCPUs for builds.

Required: No

Type: String

Allowed values: BUILD_GENERAL1_SMALL | BUILD_GENERAL1_MEDIUM | BUILD_GENERAL1_LARGE

Update requires: Replacement

DockerfileLocation

The path to the Dockerfile within the source bundle, relative to the root of the source bundle. For example, backend/Dockerfile.

Elastic Beanstalk uses this member only when Type is docker. If you don't specify it, Elastic Beanstalk uses the Dockerfile at the root of the source bundle.

Required: No

Type: String

Update requires: Replacement

TimeoutInMinutes

How long, in minutes from 5 to 480 (8 hours), Elastic Beanstalk waits before stopping a build that hasn't completed. The default is 60 minutes.

Required: No

Type: Integer

Update requires: Replacement

Type

How Elastic Beanstalk builds the container image. Elastic Beanstalk rejects a Build that doesn't specify it.

Valid values:

  • docker – Elastic Beanstalk builds the image from a Dockerfile in your source bundle. Specify the Dockerfile with DockerfileLocation.

  • buildpack – Elastic Beanstalk builds the image with a Cloud Native Buildpacks builder. Specify the builder with Buildpack.

Required: Yes

Type: String

Allowed values: docker | buildpack

Update requires: Replacement