@aws-cdk/aws-ecr

What is @aws-cdk/aws-ecr?

@aws-cdk/aws-ecr is an AWS Cloud Development Kit (CDK) library that allows you to define and manage Amazon Elastic Container Registry (ECR) resources using code. ECR is a fully managed Docker container registry that makes it easy to store, manage, and deploy Docker container images.

What are @aws-cdk/aws-ecr's main functionalities?

Create a new ECR Repository

This code sample demonstrates how to create a new ECR repository named 'my-repo' using the AWS CDK.

const ecr = require('@aws-cdk/aws-ecr');
const cdk = require('@aws-cdk/core');

class MyStack extends cdk.Stack {
  constructor(scope, id, props) {
    super(scope, id, props);

    new ecr.Repository(this, 'MyRepository', {
      repositoryName: 'my-repo'
    });
  }
}

const app = new cdk.App();
new MyStack(app, 'MyStack');

Add lifecycle policy to ECR Repository

This code sample demonstrates how to add a lifecycle policy to an ECR repository to retain only the last 5 images with the 'prod' tag.

const ecr = require('@aws-cdk/aws-ecr');
const cdk = require('@aws-cdk/core');

class MyStack extends cdk.Stack {
  constructor(scope, id, props) {
    super(scope, id, props);

    const repository = new ecr.Repository(this, 'MyRepository', {
      repositoryName: 'my-repo'
    });

    repository.addLifecycleRule({
      tagPrefixList: ['prod'],
      maxImageCount: 5
    });
  }
}

const app = new cdk.App();
new MyStack(app, 'MyStack');

Grant permissions to a user

This code sample demonstrates how to grant pull permissions to an IAM user for an ECR repository.

const ecr = require('@aws-cdk/aws-ecr');
const iam = require('@aws-cdk/aws-iam');
const cdk = require('@aws-cdk/core');

class MyStack extends cdk.Stack {
  constructor(scope, id, props) {
    super(scope, id, props);

    const repository = new ecr.Repository(this, 'MyRepository', {
      repositoryName: 'my-repo'
    });

    const user = new iam.User(this, 'MyUser');

    repository.grantPull(user);
  }
}

const app = new cdk.App();
new MyStack(app, 'MyStack');

Other packages similar to @aws-cdk/aws-ecr

aws-sdk

The aws-sdk package is the official AWS SDK for JavaScript, which provides a comprehensive set of tools for interacting with AWS services, including ECR. Unlike @aws-cdk/aws-ecr, which is used for defining infrastructure as code, aws-sdk is used for making API calls to AWS services.

serverless

The serverless framework is a toolkit for deploying and operating serverless architectures. It supports various AWS services, including ECR, for managing container images. While @aws-cdk/aws-ecr focuses on infrastructure as code, serverless provides a higher-level abstraction for deploying serverless applications.

terraform

Terraform is an open-source infrastructure as code software tool that provides a consistent CLI workflow to manage hundreds of cloud services, including AWS ECR. Terraform and @aws-cdk/aws-ecr both serve the purpose of defining cloud infrastructure, but Terraform is cloud-agnostic and can be used with multiple cloud providers.

README

Amazon ECR Construct Library

---

---

This package contains constructs for working with Amazon Elastic Container Registry.

Repositories

Define a repository by creating a new instance of Repository. A repository holds multiple verions of a single container image.

const repository = new ecr.Repository(this, 'Repository');

Automatically clean up repositories

You can set life cycle rules to automatically clean up old images from your repository. The first life cycle rule that matches an image will be applied against that image. For example, the following deletes images older than 30 days, while keeping all images tagged with prod (note that the order is important here):

repository.addLifecycleRule({ tagPrefixList: ['prod'], maxImageCount: 9999 });
repository.addLifecycleRule({ maxImageAgeDays: cdk.Duration.days(30) });

Changelog

1.12.0 (2019-10-07)

Bug Fixes

• apigateway: defaultChild on RestApi returns the underlying L1 (#4318) (53db8bc), closes #3234
• cloudmap: fix CloudMap Service import, expose ECS CloudMap Service (#4313) (c968c96), closes #4286
• codebuild: validate if a CodePipeline action that is cross-account does not have outputs (#4171) (1744f8a), closes #4032
• custom-resources: support region for AwsCustomResource (#4298) (934d36f), closes #4292
• ecr-assets: exclude option (#4354) (f96b2fb), closes #4353 #4353
• ecs: nat network mode for windows tasks (#4317) (9ceb995), closes #4272
• lambda-event-sources: add missing export of streams.ts (#4362) (032b70c), closes #4352

Features

• cloudformation: nested stacks (#2821) (5225306), closes #239 #395 #3437 #1439 #3463
• ecs: add a new API for registering ECS targets (#4212) (de84c4a)
• ecs: add support for ProxyConfiguration in ECS TaskDefinition (#4007) (68e1e85)
• ecs: Add warning message when pulling ECR image (#4334) (bd36c6c)
• ecs-patterns: add CloudMapOptions to load balanced services (#4369) (de0a028)
• rds: add support for monitoring to database cluster (#2828) (910c8bf), closes #2826
• stepfunctions: add support for Map state (#4145) (c8f0bcf)

BREAKING CHANGES TO EXPERIMENTAL FEATURES

• cloudmap: cloudmap.Service.fromServiceAttributes takes a newly required argument namespace.