1. Resources
  2. /
  3. Plugins
  4. /
  5. create-ecr-buildkite-plugin

Create ECR Buildkite Plugin

GitHub Release

A Buildkite plugin to create and manage an Amazon ECR repository.

Example

The following pipeline creates an ECR repository my-repo if it does not already exist, and sets the lifecycle policy to the default policies/default-lifecycle-policy.json:

steps:
  - command: echo 'use your new ECR repo here'
    label: ecr
    plugins:
      - seek-oss/create-ecr#v1.4.0:
          name: my-repo

A custom lifecycle policy and repository policy may be specified:

steps:
  - command: echo 'use your new ECR repo here'
    label: ecr
    plugins:
      - seek-oss/create-ecr#v1.4.0:
          lifecycle-policy: path/to/lifecycle-policy.json
          name: my-repo
          repository-policy: path/to/repository-policy.json

A custom ECR repository tags file may be specified:

steps:
  - command: echo 'use your new ECR repo here'
    label: ecr
    plugins:
      - seek-oss/create-ecr#v1.4.0:
          name: my-repo
          repository-tags-file: path/to/repository-tags-file.json

Multiple regions can be specified:

steps:
  - command: echo 'use your new ECR repo here'
    label: ecr
    plugins:
      - seek-oss/create-ecr#v1.4.0:
          name: my-repo
          regions:
            - us-west-2
            - ap-southeast-2

Configuration

  • name (required, string)

    Name of the ECR repository.

  • scan-on-push (optional, boolean)

    Whether to automatically scan images pushed to the ECR repository for vulnerabilities. Omitting this option will leave the existing image scanning configuration untouched.

  • repository-policy (optional, string)

    Path in local repository to the repository policy file.

  • lifecycle-policy (optional, string)

    Path in local repository to the lifecycle policy file.

  • repository-tags-file (optional, string)

    Path in local repository to the ecr repository tags file.

  • regions (optional, array of strings)

    Regions to push the images to. If not mentioned, current region is pulled from runtime config.

  • image-tag-mutability (optional, string)

    Sets the mutability settings for the repository. Can be MUTABLE or IMMUTABLE. Omitting this option will leave the mutability configuration untouched. When using seek-oss/docker-ecr-publish you should set add-latest-tag to false.

Troubleshooting

🚨 Error: No command has been provided

This plugin runs on a pre-command hook to allow it to be chained with other commands and plugins, like the docker-ecr-publish plugin. You will need to specify a command for the step, even if it is just a simple echo like in the examples above.

License

MIT (see LICENSE)

The plugins listed on this webpage are provided for informational purposes only. They have not undergone any formal security review or assessment. While we strive to provide useful resources, we cannot guarantee the safety, reliability, or integrity of these plugins. Users are strongly advised to conduct their own security evaluations before downloading, installing, or using any plugin. By using these plugins, you acknowledge and accept any risks associated with their use. We disclaim any liability for any harm or damages arising from the use of the plugins listed.

Start turning complexity into an advantage

Create an account to get started with a 30-day free trial. No credit card required.

Buildkite Pipelines

Platform

  1. Pipelines
  2. Pipeline templates
  3. Public pipelines
  4. Test Engine
  5. Package Registries
  6. Mobile Delivery Cloud
  7. Pricing

Hosting options

  1. Self-hosted agents
  2. Mac hosted agents
  3. Linux hosted agents

Resources

  1. Docs
  2. Blog
  3. Changelog
  4. Webinars
  5. Plugins
  6. Case studies
  7. Events
  8. Migration Services
  9. Comparisons

Company

  1. About
  2. Careers
  3. Press
  4. Brand assets
  5. Contact

Solutions

  1. Replace Jenkins
  2. Workflows for AI/ML
  3. Testing at scale
  4. Monorepo mojo
  5. Bazel orchestration

Legal

  1. Terms of Service
  2. Acceptable Use Policy
  3. Privacy Policy
  4. Subprocessors
  5. Service Level Agreement

Support

  1. System status
  2. Forum
© Buildkite Pty Ltd 2025