A command line tool for managing Amazon ECR repositories.
ecrm can delete "unused" images safety.
"unused" means,
- Images are not used by running tasks in ECS clusters.
- Images are not specified in available ECS service deployments.
- Images are not specified in existing ECS task definitions (latest N revisions).
- Images are not specified by Lambda functions (latest N versions).
Usage: ecrm <command> [flags]
Flags:
-h, --help Show context-sensitive help.
-c, --config="ecrm.yaml" Load configuration from FILE ($ECRM_CONFIG)
--log-level="info" Set log level (debug, info, notice, warn, error)
($ECRM_LOG_LEVEL)
--[no-]color Whether or not to color the output ($ECRM_COLOR)
--version Show version.
Commands:
generate [flags]
Generate a configuration file.
scan [flags]
Scan ECS/Lambda resources. Output image URIs in use.
plan [flags]
Scan ECS/Lambda resources and find unused ECR images that can be deleted
safely.
delete [flags]
Scan ECS/Lambda resources and delete unused ECR images.
version [flags]
Show version.
Configuration file is YAML format. ecrm generate can generate a configuration file.
clusters:
- name: my-cluster
- name_pattern: "prod*"
- name_pattern: "dev*"
task_definitions:
- name: "*"
keep_count: 3
lambda_functions:
- name: "*"
keep_count: 3
repositories:
- name_pattern: "prod/*"
expires: 90days
keep_tag_patterns:
- latest
- name_pattern: "dev/*"
expires: 30daysecrm generate scans ECS, Lambda and ECR resources in an AWS account and generates a configuration file.
Usage: ecrm generate [flags]
Generate ecrm.yaml
ecrm scan scans your AWS account's ECS, Lambda, and ECR resources. It outputs image URIs in use.
ecrm scan --output path/to/file writes the image URIs in use to the file as JSON format.
The scanned files can be used in the next ecrm delete command with --scanned-files option.
The format of the file is a simple JSON array of image URIs.
[
"012345678901.dkr.ecr.ap-northeast-1.amazonaws.com/foo/bar:latest",
"012345678901.dkr.ecr.ap-northeast-1.amazonaws.com/foo/bar@sha256:abcdef1234567890..."
]You can create scanned files manually as you need.
If your workload runs on platforms that ecrm does not support (for example, AWS AppRunner, Amazon EKS, etc.), you can use ecrm with the scanned file you created.
The plan command runs ecrm scan internally and then creates a plan to delete images.
ecrm plan shows summaries of images in ECR repositories that can be deleted safely.
Usage: ecrm plan [flags]
Scan ECS/Lambda resources and find unused ECR images to delete safety.
Flags:
-o, --output="-" File name of the output. The default is STDOUT ($ECRM_OUTPUT).
--format="table" Output format of plan(table, json) ($ECRM_FORMAT)
--[no-]scan Scan ECS/Lambda resources that in use ($ECRM_SCAN).
-r, --repository=STRING Manage images in the repository only ($ECRM_REPOSITORY).$ ecrm plan
REPOSITORY | TOTAL | EXPIRED | KEEP
-----------------------+--------------+---------------+--------------
dev/app | 732 (594 GB) | -707 (574 GB) | 25 (21 GB)
dev/nginx | 720 (28 GB) | -697 (27 GB) | 23 (875 MB)
prod/app | 97 (80 GB) | -87 (72 GB) | 10 (8.4 GB)
prod/nginx | 95 (3.7 GB) | -85 (3.3 GB) | 10 (381 MB) The delete command first runs ecrm scan, then creates a plan to delete images, and finally deletes them.
By default, ecrm delete shows a prompt before deleting images. You can use --force option to delete images without confirmation.
Usage: ecrm delete [flags]
Scan ECS/Lambda resources and delete unused ECR images.
Flags:
-o, --output="-" File name of the output. The default is STDOUT ($ECRM_OUTPUT).
--format="table" Output format of plan(table, json) ($ECRM_FORMAT)
--[no-]scan Scan ECS/Lambda resources that in use ($ECRM_SCAN).
-r, --repository=STRING Manage images in the repository only ($ECRM_REPOSITORY).
--scanned-files=SCANNED-FILES,... Files of the scan result. ecrm does not delete images in these
files ($ECRM_SCANNED_FILES).
--force force delete images without confirmation ($ECRM_FORCE)ecrm supports image indexes and soci (Seekable OCI) indexes. ecrm deletes these images that are related to expired images safely.
- Scans ECR repositories.
- Detect image type (Image, Image index, Soci index).
- Find expired images.
- Find expired image indexes related to expired images by the image tag (sha256-{digest of image}).
- Find soci indexes related to expired image indexes using ECR BatchGetImage API for expired images.
An example output is here.
REPOSITORY | TYPE | TOTAL | EXPIRED | KEEP
-------------+-------------+------------+-------------+-------------
xxx/app | Image | 30 (40 GB) | -27 (36 GB) | 3 (3.8 GB)
xxx/app | Image index | 5 (163 MB) | -3 (98 MB) | 2 (65 MB)
xxx/app | Soci index | 5 (163 MB) | -3 (98 MB) | 2 (65 MB)
See also
- Under the hood: Lazy Loading Container Images with Seekable OCI and AWS Fargate
- AWS Fargate Enables Faster Container Startup using Seekable OCI
ecrm supports a single AWS account and region for each run.
If your workloads are deployed in multiple regions or accounts, you should run ecrm scan for each region or account to collect all image URIs in use.
Then, you can run ecrm delete with the --scanned-files option to delete unused images in all regions or accounts.
For example, your ECR in the account-a, and your ECS clusters are deployed in account-a and account-b.
At first, you run ecrm scan for each account.
$ AWS_PROFILE=account-a ecrm scan --output scan-account-a.json
$ AWS_PROFILE=account-b ecrm scan --output scan-account-b.jsonNow, you can run ecrm delete with the --scanned-files option to safely delete unused images in all accounts.
$ AWS_PROFILE=account-a ecrm delete --scanned-files scan-account-a.json,scan-account-b.jsonCopyright (c) 2021 FUJIWARA Shunichiro
MIT