Skip to content
This repository has been archived by the owner on Nov 8, 2022. It is now read-only.

Releases: 99designs/aws-ecr-gc

v1.0.1: handle large GC by deleting in batches

06 Jul 06:27
@pda pda
v1.0.1
96fb8f9
Compare
Choose a tag to compare
v1.0.1: handle large GC by deleting in batches Latest
Latest

The ECR BatchDeleteImage operation does not support deleting batches of more than 100 images. When attempting to do so, aws-ecr-gc v1.0.0 panics like so:

panic: InvalidParameterException:
  Invalid parameter at 'imageIds' failed to satisfy constraint:
    'Member must have length less than or equal to 100'

aws-ecr-gc v1.0.1 deletes in batches of 100; see https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_BatchDeleteImage.html

Thanks @ags for the contribution.

Assets 4
Loading

v1.0.0: aws-ecr-gc

23 Mar 05:14
@pda pda
v1.0.0
22b1c7d
This commit was signed with the committer’s verified signature.
pda Paul Annesley
GPG key ID: C90225CEB8768E7B
Learn about vigilant mode.
Compare
Choose a tag to compare
v1.0.0: aws-ecr-gc

aws-ecr-gc

A garbage collector to delete old Docker images from Amazon EC2 Container Registry (ECR), which by default has a limit of 1,000 images per repository.

Given a list of tag prefixes, aws-ecr-gc deletes all but the newest N images matching those prefixes. Images with tags not matching the listed prefixes are not deleted. Optionally, untagged images are also deleted.

AWS authentication via the standard strategies as implemented in aws-sdk-go. We recommend aws-vault to manage these.

Usage

Usage of aws-ecr-gc:
  --delete-untagged
        whether to delete untagged images
  --keep value
        map of image tag prefixes to how many to keep, e.g. --keep release=4 --keep build=8
  --region string
        AWS region (defaults to AWS_DEFAULT_REGION in environment)
  --repo string
        AWS ECR repository name

Example

From the testrepo ECR repository in the us-east-1 AWS region:

  • delete all untagged images,
  • delete all but the latest 4 images with tags starting with release-production,
  • delete all but the latest 8 images with tags starting with build.
$ export AWS_DEFAULT_REGION=us-east-1
$ aws-ecr-gc --repo testrepo --delete-untagged=true --keep release-production=4 --keep build=8
Total images in testrepo (us-east-1): 47
Images to delete (3)
  2017-03-20 03:51:41: sha256:2a1fce5b2... [build-64cd372]
  2017-03-17 17:12:07: sha256:4fe1451fc... [build-1d293f7]
  2017-03-17 16:58:15: sha256:e0a2a1b4f... [build-6d12484]
Deleted (3)
  sha256:2a1fce5b2... (build-64cd372)
  sha256:4fe1451fc... (build-1d293f7)
  sha256:e0a2a1b4f... (build-6d12484)
Failures (0)
Assets 4
Loading