Skip to content

Commit

Permalink
Update documentation and changelog
Browse files Browse the repository at this point in the history
  • Loading branch information
nabsul committed Apr 17, 2021
1 parent e9f377e commit 1a7f530
Show file tree
Hide file tree
Showing 2 changed files with 32 additions and 10 deletions.
26 changes: 21 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,23 @@ will always be able to pull Docker images from ECR.

The tool is build for standard 64-bit Linux and ARM (Raspberry Pi). The latest images are:

- `nabsul/k8s-ecr-login-renew:v1.4`
- `nabsul/k8s-ecr-login-renew:arm32v7-v1.4`
- `nabsul/k8s-ecr-login-renew:v1.5`
- `nabsul/k8s-ecr-login-renew:arm32v7-v1.5`

## Environment Variables

The tool is mainly configured through environment variables. These are:

- AWS_ACCESS_KEY_ID (required): AWS access key used to create the Docker credentials.
- AWS_SECRET_ACCESS_KEY (required): AWS secret needed to fetch Docker credentials from AWS.
- AWS_REGION (required): The AWS region where your ECR instance is created.
- DOCKER_SECRET_NAME (required): The name of the Kubernetes secret where the Docker credentials are stored.
- TARGET_NAMESPACE (optional): Comma-separated list of namespaces.
A Docker secret is created in each of these.
If this environment variable is not set, a value of `default` is assumed.
- DOCKER_REGISTRIES (optional): Comma-separated list of registry URL.
If none is provided, the default URL returned from AWS is used.
- Example: `DOCKER_REGISTRIES=https://321321.dkr.ecr.us-west-2.amazonaws.com,https://123123.dkr.ecr.us-east-2.amazonaws.com`

## Running the Example

Expand All @@ -24,14 +39,15 @@ but you'll need to fill in you registry's URL before using `example/pod.yml`.
### Create an ECR Instance

I'm not going to describe this in too much details because
there is [plenty of documentation](https://docs.aws.amazon.com/AmazonECR/latest/userguide/what-is-ecr.html)
there is
[plenty of documentation](https://docs.aws.amazon.com/AmazonECR/latest/userguide/what-is-ecr.html)
that describes how to do this.
But here are a few pointers:
Here are a few pointers:

- Create an AWS ECR instance
- Create a repository inside that instance

### Push a Test Image to
### Push a Test Image to ECR

To complete the final steps of these instructions, you'll need to create and upload an image to ECR.
As with the previous section, there's plenty of good documentation out there.
Expand Down
16 changes: 11 additions & 5 deletions changelog.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,26 +2,32 @@

## v1.5 (2021-04-03)

- Handle the case of multiple registries in AWS (contributed by [Veraticus](https://github.com/Veraticus) in [pull request 18](https://github.com/nabsul/k8s-ecr-login-renew/pull/18))
- Allow custom/multiple registry URLs with a new environment variable: `DOCKER_REGISTRIES`
- Contributed by [Veraticus](https://github.com/Veraticus) with feedback from [PawelLipski](https://github.com/PawelLipski) in [pull request 18](https://github.com/nabsul/k8s-ecr-login-renew/pull/18)
- Implemented in [pull request 19](https://github.com/nabsul/k8s-ecr-login-renew/pull/19)

## v1.4 (2021-02-13)

- Update Docker secrets instead of delete+create (suggested by [xavidop](https://github.com/xavidop) in [issue 15](https://github.com/nabsul/k8s-ecr-login-renew/issues/15))
- Update Docker secrets instead of delete+create
- Suggested by [xavidop](https://github.com/xavidop) in [issue 15](https://github.com/nabsul/k8s-ecr-login-renew/issues/15)
- Fall back to old delete+create if update fails to avoid breaking old users

## v1.3 (2020-06-07)

- Added support for ARM (tested by [kuskoman](https://github.com/kuskoman) on Raspberry Pi)
- Added support for ARM
- Tested by [kuskoman](https://github.com/kuskoman) on Raspberry Pi

## v1.2 (2020-06-07)

- `TARGET_NAMESPACE` now supports multiple namespaces and wildcards (Suggested by [Q-Nimbus](https://github.com/Q-Nimbus))
- `TARGET_NAMESPACE` now supports multiple namespaces and wildcards
- Suggested by [Q-Nimbus](https://github.com/Q-Nimbus) in [issue 5](https://github.com/nabsul/k8s-ecr-login-renew/issues/5)
- Added automated tests
- Various refactoring and code restructuring

## v1.1 (2020-04-25)

- Added environment variable to specify a namespace (Contribution from [YoSmudge](https://github.com/YoSmudge))
- Added environment variable to specify a namespace
- Contribution from [YoSmudge](https://github.com/YoSmudge) in [pull request 1](https://github.com/nabsul/k8s-ecr-login-renew/pull/1)
- Add a changelog
- Add a contributor list

Expand Down

0 comments on commit 1a7f530

Please sign in to comment.