ecr-cleaner


Nameecr-cleaner JSON
Version 0.1.3 PyPI version JSON
download
home_pageNone
SummaryECR Image Cleanup Tool
upload_time2024-10-21 12:47:14
maintainerNone
docs_urlNone
authorNone
requires_python>=3.9
licenseNone
keywords aws cleanup ecr package python
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            ## ECR Image Cleanup Tool

## Table of Contents
- [Overview](#overview)
- [Features](#features)
- [Installation](#installation)
- [Usage](#usage)


## Overview

The ECR Image Cleanup Tool addresses limitations in Amazon ECR's built-in lifecycle policies, particularly for multi-architecture images. It helps prevent repositories from hitting the 10,000 image hard limit imposed by ECR by providing more flexible and architecture-aware cleanup options.

## Features

1. Supports multi-architecture image cleanup
2. Allows fine-grained control over image retention
3. Can keep a specified number of recent images for each tag
4. Manages untagged images separately
5. Provides a dry-run option to preview actions before execution


### Installation

```shell
pip install ecr-cleaner
```

### Usage

Support following CLI argument

```shell
usage: ecr_cleaner [-h] [--config-file CONFIG_FILE] [--repositories REPOSITORIES [REPOSITORIES ...]] [--region REGION] [--batch-size BATCH_SIZE] [--dry-run] [--debug]

ECR Cleaner CLI

options:
  -h, --help            show this help message and exit
  --config-file CONFIG_FILE
                        Path to configuration file in YAML format. See example in README.md
  --repositories REPOSITORIES [REPOSITORIES ...]
                        List of repository names and policies(keep-most-recent). (e.g. my-repo:latest=3,tag-prefix=2,untagged=10)
  --region REGION       ECR region
  --batch-size BATCH_SIZE
                        Max number of images that can be deleted in one call
  --dry-run             Check result without deleting images
  --debug               Enable debug logging
```

Clean-up will keep most recent number of images based on inputs and it will delete remaining matching tagPrefix

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "ecr-cleaner",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.9",
    "maintainer_email": null,
    "keywords": "aws, cleanup, ecr, package, python",
    "author": null,
    "author_email": "Rahul Patil <4476687+rahulinux@users.noreply.github.com>",
    "download_url": "https://files.pythonhosted.org/packages/55/03/315ee724900ea5f92128e8a39a33f2b64053c9192c10c644d0af9f7a8002/ecr_cleaner-0.1.3.tar.gz",
    "platform": null,
    "description": "## ECR Image Cleanup Tool\n\n## Table of Contents\n- [Overview](#overview)\n- [Features](#features)\n- [Installation](#installation)\n- [Usage](#usage)\n\n\n## Overview\n\nThe ECR Image Cleanup Tool addresses limitations in Amazon ECR's built-in lifecycle policies, particularly for multi-architecture images. It helps prevent repositories from hitting the 10,000 image hard limit imposed by ECR by providing more flexible and architecture-aware cleanup options.\n\n## Features\n\n1. Supports multi-architecture image cleanup\n2. Allows fine-grained control over image retention\n3. Can keep a specified number of recent images for each tag\n4. Manages untagged images separately\n5. Provides a dry-run option to preview actions before execution\n\n\n### Installation\n\n```shell\npip install ecr-cleaner\n```\n\n### Usage\n\nSupport following CLI argument\n\n```shell\nusage: ecr_cleaner [-h] [--config-file CONFIG_FILE] [--repositories REPOSITORIES [REPOSITORIES ...]] [--region REGION] [--batch-size BATCH_SIZE] [--dry-run] [--debug]\n\nECR Cleaner CLI\n\noptions:\n  -h, --help            show this help message and exit\n  --config-file CONFIG_FILE\n                        Path to configuration file in YAML format. See example in README.md\n  --repositories REPOSITORIES [REPOSITORIES ...]\n                        List of repository names and policies(keep-most-recent). (e.g. my-repo:latest=3,tag-prefix=2,untagged=10)\n  --region REGION       ECR region\n  --batch-size BATCH_SIZE\n                        Max number of images that can be deleted in one call\n  --dry-run             Check result without deleting images\n  --debug               Enable debug logging\n```\n\nClean-up will keep most recent number of images based on inputs and it will delete remaining matching tagPrefix\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "ECR Image Cleanup Tool",
    "version": "0.1.3",
    "project_urls": {
        "Bug reports": "https://github.com/rahulinux/ecr-cleaner/issues/new",
        "Documentation": "https://github.com/rahulinux/ecr-cleaner/blob/main/python/README.md",
        "Source": "https://github.com/rahulinux/ecr-cleaner"
    },
    "split_keywords": [
        "aws",
        " cleanup",
        " ecr",
        " package",
        " python"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "b1f783fb843d07c8cb22e8c802f5afb1d8359e000d5ce84c97952a67cbcac6a2",
                "md5": "28d2094ef27c878dca69ee605534a59d",
                "sha256": "0bb095ec0e246169147fe5037fce400bc8f0f43788898f431ee3f28b1b11dd3d"
            },
            "downloads": -1,
            "filename": "ecr_cleaner-0.1.3-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "28d2094ef27c878dca69ee605534a59d",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.9",
            "size": 11726,
            "upload_time": "2024-10-21T12:47:13",
            "upload_time_iso_8601": "2024-10-21T12:47:13.087793Z",
            "url": "https://files.pythonhosted.org/packages/b1/f7/83fb843d07c8cb22e8c802f5afb1d8359e000d5ce84c97952a67cbcac6a2/ecr_cleaner-0.1.3-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "5503315ee724900ea5f92128e8a39a33f2b64053c9192c10c644d0af9f7a8002",
                "md5": "12325199c2f37e9b2eeb8f91e0a418e4",
                "sha256": "da8f26e2c5351d71376f10ac0e52c100d35ed16e67f5a10d252bda8b71c3ecd7"
            },
            "downloads": -1,
            "filename": "ecr_cleaner-0.1.3.tar.gz",
            "has_sig": false,
            "md5_digest": "12325199c2f37e9b2eeb8f91e0a418e4",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.9",
            "size": 14120,
            "upload_time": "2024-10-21T12:47:14",
            "upload_time_iso_8601": "2024-10-21T12:47:14.176194Z",
            "url": "https://files.pythonhosted.org/packages/55/03/315ee724900ea5f92128e8a39a33f2b64053c9192c10c644d0af9f7a8002/ecr_cleaner-0.1.3.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-10-21 12:47:14",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "rahulinux",
    "github_project": "ecr-cleaner",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "requirements": [],
    "lcname": "ecr-cleaner"
}
        
Elapsed time: 0.75339s