From 1a6f8f39f943b7c4712976ba4c1bd0f3f12d648b Mon Sep 17 00:00:00 2001
From: Michele Cereda <cereda.michele@gmail.com>
Date: Sat, 10 Feb 2024 18:02:29 +0100
Subject: [PATCH] chore: aws ecr commands examples

---
 knowledge base/cloud computing/aws/ecr.md | 49 +++++++++++++++++++++++
 1 file changed, 49 insertions(+)

diff --git a/knowledge base/cloud computing/aws/ecr.md b/knowledge base/cloud computing/aws/ecr.md
index 114c85f..507e36b 100644
--- a/knowledge base/cloud computing/aws/ecr.md	
+++ b/knowledge base/cloud computing/aws/ecr.md	
@@ -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