Public | Automated Build

Last pushed: 2 years ago
Short Description
Temporary fork to fix a bug
Full Description

Dockercfg Generation Service for AWS ECR

This container allows you to generate a temporary dockercfg using your AWS credentials
and writes it to a specified filename. Typical usage of this image would be to run it
with a volume attached, and write the dockercfg to that volume.

In order to export a dockercfg, the container needs access to a docker instance, so
you must mount a docker socket, or provide access to a docker host in some way.

$ cat aws_creds.env
$ docker run -it -v /home/myuser/data:/opt/data --env-file=aws_creds.env -v /var/run/docker.sock:/var/run/docker.sock codeship/aws-ecr-dockercfg-generator /opt/data/aws.dockercfg
Logging into AWS ECR
WARNING: login credentials saved in /root/.docker/config.json
Login Succeeded
Writing Docker creds to /opt/data/aws.dockerccfg
$ cat /home/myuser/data/aws.dockercfg # file is available locally

As per AWS documentation, this dockercfg should be valid for 48 hours.

Using with Codeship

Codeship supports using custom images to generate dockercfg files during the build process. To use this image to integrate with AWS ECR, simply define a entry in your services file for this image, and reference it from any steps or services which need to interact with ECR repositories with the dockercfg_service field. You'll also need to provide the following environment variables using an encrypted env file:

  • AWS_REGION - Your selected AWS Region, ensure this is a region suppoing AWS ECR
  • AWS_ACCESS_KEY_ID - Your AWS Access Key
  • AWS_SECRET_ACCESS_KEY - Your AWS Access Secret

Optionally, you can also set the following variables to assume a role across accounts before generating the dockercfg:

  • AWS_STS_ROLE - The AWS role to assume
  • AWS_STS_ACCOUNT - The AWS account the role exists in

Here is an example of using and ECR Dockercfg generator to authenticate pushing an image.

# codeship-services.yml
    dockerfile_path: ./Dockerfile
  image: codeship/aws-ecr-dockercfg-generator
  add_docker: true
  encrypted_env_file: aws.env.encrypted
# codeship-steps.yml
- service: app
  type: push
  tag: master
  dockercfg_service: aws_dockercfg

You can also use this authentication to pull images, or use with caching, by defining the dockercfg_service field on groups of steps, or each individual step that pulls or pushes an image, or by adding the field to specific services.


"No basic auth credentials" error on push

Make sure the registry entry in your steps does not contain a trailing slash.

Docker Pull Command