brandon/oam
1
0
Fork 0
mirror of https://gitea.com/mcereda/oam.git synced 2026-02-09 05:44:23 +00:00
Code Issues Packages Projects Releases Wiki Activity

chore: aws ecr commands examples

Browse Source
This commit is contained in:
Michele Cereda
2024-02-10 18:02:29 +01:00
parent 419b009a23
commit 1a6f8f39f9
1 changed files with 49 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

49
knowledge base/cloud computing/aws/ecr.md
View File

@@ -1,11 +1,58 @@
# Elastic Container Registry
1. [TL;DR](#tldr)
1. [Pull through cache feature](#pull-through-cache-feature)
1. [Further readings](#further-readings)
1. [Sources](#sources)
## TL;DR
```sh
# List and get information about the repositories in ECRs.
aws ecr describe-repositories
# List images in ECRs.
aws ecr list-images --repository-name 'repository'
aws ecr list-images --registry-id '123456789012' --repository-name 'my-image'
# Use ECRs as Docker registries.
aws ecr get-login-password \
| docker login --username 'AWS' --password-stdin 'aws_account_id.dkr.ecr.region.amazonaws.com' \
# Pull images from ECRs.
docker 'pull aws_account_id.dkr.ecr.region.amazonaws.com/repository_name/image_name:tag'
# List and show pull through cache rules.
aws ecr describe-pull-through-cache-rules
aws ecr describe-pull-through-cache-rules \
--registry-id '123456789012' --ecr-repository-prefixes 'ecr-public' 'quay'
# Create pull through cache rules.
aws ecr create-pull-through-cache-rule \
--registry-id '123456789012' --ecr-repository-prefix 'prefix' \
--upstream-registry 'docker-hub' --upstream-registry-url 'registry-1.docker.io' \
--credential-arn "$( \
aws secretsmanager describe-secret --secret-id 'ecr-pullthroughcache/docker-hub' \
--query 'ARN' --output 'text' \
)"
# Validate pull through cache rules.
aws ecr validate-pull-through-cache-rule \
--registry-id '123456789012' --ecr-repository-prefix 'prefix'
# Pull images from cache repositories.
docker pull 'aws_account_id.dkr.ecr.region.amazonaws.com/prefix/repository_name/image_name:tag'
docker pull '123456789012.dkr.ecr.us-east-2.amazonaws.com/ecr-public/repository_name/image_name:tag'
docker pull '123456789012.dkr.ecr.eu-west-1.amazonaws.com/quay/argoproj/argocd:v2.10.0'
```
## Pull through cache feature
> **Note:** when requesting an image for the first time using the pull through cache, the ECR creates a new repository for that image.<br>
> This might™ introduce a small latency and be cause of pull failures. Pulling that (not-yet)cached image from an interactive shell session worked flawlessly.
## Further readings
- AWS' [CLI]
@@ -14,6 +61,7 @@
- [Using pull through cache rules]
- [Creating a lifecycle policy preview]
- [CLI subcommand reference]
<!--
References
@@ -25,6 +73,7 @@
<!-- Files -->
<!-- Upstream -->
[cli subcommand reference]: https://docs.aws.amazon.com/cli/latest/reference/ecr/
[creating a lifecycle policy preview]: https://docs.aws.amazon.com/AmazonECR/latest/userguide/lpp_creation.html
[using pull through cache rules]: https://docs.aws.amazon.com/AmazonECR/latest/userguide/pull-through-cache.html