@aws-sdk/client-ecr

What is @aws-sdk/client-ecr?

@aws-sdk/client-ecr is an AWS SDK for JavaScript package that allows developers to interact with Amazon Elastic Container Registry (ECR). ECR is a fully managed Docker container registry that makes it easy to store, manage, and deploy Docker container images.

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

Create Repository

This feature allows you to create a new repository in Amazon ECR. The code sample demonstrates how to create a repository named 'my-repo' using the ECRClient and CreateRepositoryCommand.

const { ECRClient, CreateRepositoryCommand } = require('@aws-sdk/client-ecr');

const client = new ECRClient({ region: 'us-west-2' });
const command = new CreateRepositoryCommand({ repositoryName: 'my-repo' });

client.send(command).then(
  (data) => console.log(data),
  (error) => console.error(error)
);

List Repositories

This feature allows you to list all repositories in your Amazon ECR. The code sample demonstrates how to use the DescribeRepositoriesCommand to retrieve and log the list of repositories.

const { ECRClient, DescribeRepositoriesCommand } = require('@aws-sdk/client-ecr');

const client = new ECRClient({ region: 'us-west-2' });
const command = new DescribeRepositoriesCommand({});

client.send(command).then(
  (data) => console.log(data.repositories),
  (error) => console.error(error)
);

Delete Repository

This feature allows you to delete a repository from Amazon ECR. The code sample demonstrates how to delete a repository named 'my-repo' using the DeleteRepositoryCommand.

const { ECRClient, DeleteRepositoryCommand } = require('@aws-sdk/client-ecr');

const client = new ECRClient({ region: 'us-west-2' });
const command = new DeleteRepositoryCommand({ repositoryName: 'my-repo', force: true });

client.send(command).then(
  (data) => console.log(data),
  (error) => console.error(error)
);

Push Image

This feature allows you to push a Docker image to an Amazon ECR repository. The code sample demonstrates how to get an authorization token, log in to the ECR registry using Docker, and push an image named 'my-repo:latest'.

const { ECRClient, GetAuthorizationTokenCommand } = require('@aws-sdk/client-ecr');
const { exec } = require('child_process');

const client = new ECRClient({ region: 'us-west-2' });
const command = new GetAuthorizationTokenCommand({});

client.send(command).then(
  (data) => {
    const authData = data.authorizationData[0];
    const authToken = Buffer.from(authData.authorizationToken, 'base64').toString('utf-8').split(':')[1];
    const proxyEndpoint = authData.proxyEndpoint;

    exec(`docker login -u AWS -p ${authToken} ${proxyEndpoint}`, (err, stdout, stderr) => {
      if (err) {
        console.error('Login failed:', stderr);
        return;
      }
      console.log('Login successful:', stdout);
      exec('docker push my-repo:latest', (err, stdout, stderr) => {
        if (err) {
          console.error('Push failed:', stderr);
          return;
        }
        console.log('Push successful:', stdout);
      });
    });
  },
  (error) => console.error(error)
);

Other packages similar to @aws-sdk/client-ecr

dockerode

Dockerode is a Node.js module that provides a Docker Remote API client. It allows you to manage Docker containers, images, and networks. Unlike @aws-sdk/client-ecr, which is specific to Amazon ECR, Dockerode provides a more general interface for interacting with Docker.

node-docker-api

Node-docker-api is another Node.js client for the Docker Remote API. It offers a promise-based interface for managing Docker containers, images, volumes, and networks. Similar to Dockerode, it is not specific to Amazon ECR but provides broader Docker management capabilities.

aws-sdk

The aws-sdk package is the older, monolithic AWS SDK for JavaScript. It includes support for all AWS services, including ECR. However, it is larger and less modular compared to the newer, service-specific packages like @aws-sdk/client-ecr.

README

@aws-sdk/client-ecr

For SDK usage, please step to SDK readme.

Changelog

1.0.0-rc.7 (2020-11-20)

Bug Fixes

• abort-controller: make AbortSignal WHATWG Spec compliant (#1699) (723ec4d)
• codegen: add aws-iam-traits dependency (#1686) (d6fb1f6)
• fetch-http-handler: omit body for HEAD/GET methods (#1698) (778b305)
• node-http-handler: throw TimeoutError for Node.js timeouts (#1693) (96f61bb)
• change paginators to export paginateOperationName (#1692) (6d02935)

Features

• update clients as of 11/18/2020 (#1700) (8adfed1)
• api-reference: add typedoc plugins for api reference (#1694) (2cb016f)
• ci: add GitHub Action to test codegen (#1684) (41e9359)
• node-http-handler: update timeout code and tests (#1691) (9e58bbb)
• service-error-classification: add 429 response as Throttling (#1690) (9a62c0a)

BREAKING CHANGES

• change paginators to export paginateOperationName to be consistent with verb nouns across AWS