{"id":24956200,"url":"https://github.com/jenkinsci/amazon-ecr-plugin","last_synced_at":"2026-03-11T19:31:40.021Z","repository":{"id":3094367,"uuid":"48419922","full_name":"jenkinsci/amazon-ecr-plugin","owner":"jenkinsci","description":"Amazon EC2 Container Registry plugin for Jenkins","archived":false,"fork":false,"pushed_at":"2025-10-26T12:18:36.000Z","size":226,"stargazers_count":33,"open_issues_count":4,"forks_count":22,"subscribers_count":99,"default_branch":"main","last_synced_at":"2025-10-26T14:26:42.886Z","etag":null,"topics":["adopt-this-plugin","aws","aws-ecr","jenkins"],"latest_commit_sha":null,"homepage":"https://plugins.jenkins.io/amazon-ecr/","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jenkinsci.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.old.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2015-12-22T08:28:44.000Z","updated_at":"2025-10-26T12:18:40.000Z","dependencies_parsed_at":"2024-06-28T01:03:07.970Z","dependency_job_id":"7a8bdd0d-74bb-46f0-a692-97a27760cfc5","html_url":"https://github.com/jenkinsci/amazon-ecr-plugin","commit_stats":null,"previous_names":[],"tags_count":16,"template":false,"template_full_name":null,"purl":"pkg:github/jenkinsci/amazon-ecr-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jenkinsci%2Famazon-ecr-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jenkinsci%2Famazon-ecr-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jenkinsci%2Famazon-ecr-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jenkinsci%2Famazon-ecr-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jenkinsci","download_url":"https://codeload.github.com/jenkinsci/amazon-ecr-plugin/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jenkinsci%2Famazon-ecr-plugin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30395597,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-11T18:46:22.935Z","status":"ssl_error","status_checked_at":"2026-03-11T18:46:17.045Z","response_time":84,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["adopt-this-plugin","aws","aws-ecr","jenkins"],"created_at":"2025-02-03T06:28:08.612Z","updated_at":"2026-03-11T19:31:40.010Z","avatar_url":"https://github.com/jenkinsci.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Amazon ECR Plugin\n\n[![Jenkins Plugin](https://img.shields.io/jenkins/plugin/v/amazon-ecr.svg)](https://plugins.jenkins.io/amazon-ecr)\n[![GitHub release](https://img.shields.io/github/release/jenkinsci/amazon-ecr-plugin.svg?label=release)](https://github.com/jenkinsci/amazon-ecr-plugin/releases/latest)\n[![Jenkins Plugin Installs](https://img.shields.io/jenkins/plugin/i/amazon-ecr.svg?color=blue)](https://plugins.jenkins.io/amazon-ecr)\n[![Build Status](https://ci.jenkins.io/buildStatus/icon?job=Plugins%2Famazon-ecr-plugin%2Fmain)](https://ci.jenkins.io/job/Plugins/job/amazon-ecr-plugin/job/main/)\n[![GitHub license](https://img.shields.io/github/license/jenkinsci/amazon-ecr-plugin.svg)](https://github.com/jenkinsci/amazon-ecr-plugin/blob/main/LICENSE.txt)\n![GitHub last commit](https://img.shields.io/github/last-commit/jenkinsci/amazon-ecr-plugin)\n\nThis plugin offers integration with [Amazon Container Registry\n(ECR)](https://aws.amazon.com/ecr/) as a [DockerRegistryToken] source to convert\nAmazon Credentials into a Docker CLI Authentication Token.\n\n[DockerRegistryToken]: https://github.com/jenkinsci/docker-commons-plugin/blob/master/src/main/java/org/jenkinsci/plugins/docker/commons/credentials/DockerRegistryToken.java\n\n## About\n\nAmazon ECR plugin implements a Docker Token producer to convert Amazon\ncredentials to Jenkins’ API used by (mostly) all Docker-related plugins.\n\nThanks to this producer, you can select your existing registered Amazon\ncredentials for various Docker operations in Jenkins, for example using the\nDocker Build and Publish plugin:\n\n![](.github/build-and-publish.png)\n\n## Installation\n\nNavigate to the \"Plugin Manager\" screen, install the \"Amazon ECR\" plugin and\nrestart Jenkins.\n\nThe plugin will use the proxy configured on Jenkins if it is set.\n\nRecommended logger for troubleshooting, you have to take care where you publish\nthese logs could contain sensitive information\n\n- com.cloudbees.jenkins.plugins.amazonecr\n- com.amazonaws\n- org.apache.http.wire\n- org.jenkinsci.plugins.docker.workflow\n\n## Docker Pipeline Usage\n\nWhen using the [Docker Pipeline\nPlugin](https://plugins.jenkins.io/docker-workflow/), in order to obtain an ECR\nlogin credential, you must use the ecr provider prefix.\n\n```groovy\ndocker.withRegistry(\"https://your.ecr.domain.amazonws.com\", \"ecr:us-east-1:credential-id\") {\n  docker.image(\"your-image-name\").push()\n}\n```\n\nIf you experience authentication issues, you would try to remove user\ndocker configuration files on the agents before to run the docker\ncommands, something like this pipeline script.\n\n```groovy\nnode {\n  // cleanup current user docker credentials\n  sh 'rm -f ~/.dockercfg ~/.docker/config.json || true'\n\n  // configure registry\n  docker.withRegistry('https://ID.ecr.eu-west-1.amazonaws.com', 'ecr:eu-west-1:86c8f5ec-1ce1-4e94-80c2-18e23bbd724a') {\n\n    // build image\n    def customImage = docker.build(\"my-image:${env.BUILD_ID}\")\n\n    // push image\n    customImage.push()\n  }\n}\n```\n\n## Development\n\n### Testing\n\nUnfortunately, testing against AWS isn't very straightforward, since you always\nneed an AWS account with correct setup, which might incur some costs. Current\ntests try to make this as easy as possible. You need a user with read\npermission to ECR (AWS IAM policy `AmazonEC2ContainerRegistryReadOnly` should\nsuffice) and an (empty) container registry. The test expect these details in\nthe following environment variables:\n\n```shell\nexport AWS_ACCESS_KEY_ID=\u003cyour-key-id-here\u003e\nexport AWS_SECRET_ACCESS_KEY=\u003cyour-secret-access-key-here\u003e\nexport AWS_REGISTRY_HOST=\u003csome-number\u003e.dkr.ecr.us-east-1.amazonaws.com\n```\n\nWhen those are set correctly, `mvn test` should run those tests successfully.\n\n### Code Style\n\nThis plugin uses [Google Java Code Style], which is enforced by the [spotless]\nplugin. If the build fails because you were using the \"wrong\" style, you can\nfix it by running:\n\n    $ mvn spotless:apply\n\nto reformat code in the proper style.\n\n[Google Java Code Style]: https://google.github.io/styleguide/javaguide.html\n[spotless]: https://github.com/diffplug/spotless\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjenkinsci%2Famazon-ecr-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjenkinsci%2Famazon-ecr-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjenkinsci%2Famazon-ecr-plugin/lists"}