Requirements

• Python

  • CPython 2,7, 3,4, 3.5, 3.6

• Docker

  • API version >= 1.21

Installation

$ pip install ecr-cli

ECR Configuration file

If you place a file in YAML format with the filename .ecr.yml in the same directory as Dockerfile, profile name, region name, registry ID and tag can be set.

.ecr.yml example:

profile_name: null
region_name: us-west-2
registry_id: null
tags:
  - java/amazonlinux-oracle-java:latest
  - java/amazonlinux-oracle-java:2017.12-8u162

NOTE: Command line options override settings in this file.

Usage

Usage: ecr [OPTIONS] COMMAND [ARGS]...

Options:
  --profile TEXT        Use a specific profile from your credential file.
  --region TEXT         The region to use. Overrides config/env settings.
  --registry-id TEXT    AWS account ID that correspond to a Amazon ECR registry that you want to log in to.
  --debug / --no-debug  Turn on debug logging.
  -h, --help            Show this message and exit.

Commands:
  build  Build an image from a Dockerfile.
  pull   Pull an image or a repository from a Amazon ECR registry
  push   Push an image or a repository to a Amazon ECR registry.

Usage: ecr build [OPTIONS] PATH

  Build an image from a Dockerfile.

Options:
  -t, --tag TEXT              Name and optionally a tag in the `name:tag` format.
  --dockerfile PATH           Name of the Dockerfile (Default is `PATH/Dockerfile`).
  --configfile PATH           Name of the ECR configuration file (Default is `PATH/.ecr.yml`).
  --cache / --no-cache        Use cache when building the image.
  --rm / --no-rm              Remove intermediate containers after a successful build.
  --force-rm / --no-force-rm  Always remove intermediate containers.
  --pull / --no-pull          Always attempt to pull a newer version of the image.
  --squash / --no-squash      Squash newly built layers into a single new layer.
  --push / --no-push          Push an image or a repository to a Amazon ECR registry after a successful build.
  --quiet / --no-quiet        Suppress the standard output.
  --no-profile                Forcibly disable the ECR configuration file profile.
  -h, --help                  Show this message and exit.

Usage: ecr push [OPTIONS] NAME...

  Push an image or a repository to a Amazon ECR registry.

Options:
  --quiet / --no-quiet        Suppress the standard output.
  -h, --help  Show this message and exit.

Usage: ecr pull [OPTIONS] NAME...

  Pull an image or a repository from a Amazon ECR registry

Options:
  --quiet / --no-quiet        Suppress the standard output.
  -h, --help  Show this message and exit.

Authentication

Support Boto3 credentials.

Testing

TODO

TODO

1. Progress bar can not be reset :(

2. Vacuum command

3. Tests