🏬 धडा 09 — Registries: गोठलेल्या डब्यांचे गोदाम

📍 तुम्ही इथे आहात: 12 पैकी धडा 09 — भाग 2 सुरू! · मागे: lesson-08-image-hygiene · पुढे: lesson-10-ecr-setup

📦 या ब्रँचमध्ये काय आहे

धडे 01–08, आणि त्याशिवाय: laptop पासून cloud पर्यंतचा पूल — registry म्हणजे काय, आणि भाग 2 ज्यावर चालतो तो pull/push/tag/digest चा शब्दसंग्रह.

🧒 5 वर्षांच्या मुलाला समजावल्यासारखे

तुमचा डबा अगदी परिपूर्ण आहे — पण तो तुमच्या fridge मध्ये आहे. शाळेचे कॅन्टीन (एक server), तुमची सहकारी, भुकेल्या मशीनचा संपूर्ण cluster… यापैकी कोणीही तुमच्या fridge पर्यंत पोहोचू शकत नाही. 🧊🚫

आता येते गोठलेल्या डब्यांचे गोदाम 🏬 (एक registry):

तुम्ही तुमचा डबा एकदा पोहोचवता (docker push).
परवानगी असलेले कोणीही त्याची प्रत घेऊ शकते (docker pull) — कुठूनही.
गोदामात कप्पे (repositories) असतात — प्रत्येक ॲपसाठी एक कप्पा: hello-school कप्प्यात त्या एका ॲपची सगळी versions असतात.
कप्प्यावरच्या प्रत्येक डब्यावर एक लेबल (tag: v1, abc123) आणि एक ठसा (digest: sha256:…) असतो. लेबल माणसे हलवू शकतात; ठसा खोटे बोलू शकत नाही — ठशाने pull करा आणि तुम्हाला byte-for-byte तोच नेमका डबा मिळतो, कायमचा.

तुम्ही आतापर्यंत गोदामच वापरत होता! FROM node:20-alpine हे Docker Hub वरून pull करते — प्रचंड मोठे सार्वजनिक गोदाम. भाग 2 तुमचे स्वतःचे खाजगी गोदाम (ECR) मिळवण्याबद्दल आहे, कारण तुमच्या कंपनीचे जेवण अनोळखी लोकांसाठी नाही. 🔐

🗺️ आकृती

flowchart LR
    lap["🧑‍💻 your laptop<br/>image built locally"]
    subgraph reg["🏬 registry - the warehouse"]
        shelf["📚 repository: hello-school<br/>one shelf, all versions"]
        tags["🏷️ tags: v1, v2, abc123<br/>🔢 digests: sha256:… fingerprints"]
        shelf --- tags
    end
    eks["☸️ cluster<br/>pulls at deploy"]
    mate["💻 teammate<br/>docker pull"]
    lap -->|"1 docker push - once"| reg
    reg -->|"2 pull - anywhere, many times"| eks
    reg --> mate

❓ काय

Registry (गोदाम: Docker Hub, ECR, GHCR…) → repository (एका ॲपचा कप्पा) → tags/digests (डबे).
Image चे पूर्ण नाव म्हणजे खरे तर एक पत्ता आहे: REGISTRY/REPOSITORY:TAG — उदा. docker.io/library/node:20-alpine. Registry चा भाग नसेल = Docker Hub गृहीत धरला जातो. एवढीच सगळी जादू.
Push/pull थरांबाबत हुशार असतात (धडा 02 चे फळ मिळते): पलीकडच्या बाजूकडे आधीच नसलेले थरच wire वरून जातात. लहान थर = जलद पाठवणी.
Tag विरुद्ध digest: tags हलवता येणारे स्टिकर (mutable); digests म्हणजे content चे ठसे (immutable). CI systems आणि काळजीपूर्वक केलेले deploys digests pin करतात; माणसे tags वाचतात.

🧠 उतरंड — registry ≠ repository

Registry        (the warehouse — one host)
   ↓
Repository      (one shelf — one application)
   ↓
Image           (one box — one build)
   ↓
Tag / Digest    (the sticker / the fingerprint)

123456789012.dkr.ecr.ap-south-1.amazonaws.com/    ← registry
    my-app                                         ← repository
       ├── v1.0.0                                  ← tags
       ├── v1.1.0
       └── latest    (a sticker — it moves)

Registry ही service आहे; repository म्हणजे तिच्या आतला एका ॲपचा कप्पा. ECR मध्ये "repository बनवा" म्हणजे तुमच्याकडे आधीच असलेल्या गोदामात एक कप्पा जोडणे.

🤔 का

Registry हा संपूर्ण trilogy चा हस्तांतरणाचा बिंदू आहे: हा कोर्स त्यावर push करतो, k8s कोर्सचे Deployments त्यावरून pull करतात, ArgoCD कोर्स त्याचे पत्ते git मध्ये commit करतो. ती नैसर्गिक security सीमा ही आहे (कोण push करू शकते? कोण pull करू शकते?) आणि असा cache ही, ज्यामुळे 50 मशीनचा cluster तुमच्या laptop वरून download करत नाही.

🧪 करून पाहा

# you already speak registry — see today's pulls:
docker pull node:20-alpine                 # from Docker Hub, layer by layer
docker pull node:20-alpine                 # again: "Already exists" — layer cache!

# read image ADDRESSES like a pro:
docker image inspect node:20-alpine --format '{{index .RepoDigests 0}}'
# → docker.io/library/node@sha256:…  ← warehouse/shelf@fingerprint

# a real private-warehouse dry run — run a registry IN a container (how meta):
docker run -d -p 5000:5000 --name warehouse registry:2
docker tag hello-school:v1 localhost:5000/hello-school:v1     # readdress the box
docker push localhost:5000/hello-school:v1                    # deliver
docker rmi localhost:5000/hello-school:v1
docker pull localhost:5000/hello-school:v1                    # collect — full circle 🎉
docker rm -f warehouse

⚠️ नेहमीच्या चुका

repository ला "registry" म्हणणे (आणि उलट) — एक कप्पा विरुद्ध संपूर्ण गोदाम
चुकून Docker Hub च्या सार्वजनिक namespace मध्ये push करणे — image चे पूर्ण नाव तपासा
pull फुकट असतो असे गृहीत धरणे — cross-region आणि cross-cloud pulls वर egress चे बिल लागते

⏭️ पुढे

आता खरी गोष्ट: AWS बँकेतला तुमचा स्वतःचा locker — ECR repository बनवणे आणि त्याच्या पुढच्या दारातून आत जाणे.

git checkout lesson-10-ecr-setup

🏬 Lesson 09 — Registries: the frozen-lunchbox warehouse

📍 You are here: Lesson 09 of 12 — Part 2 begins! · Previous: lesson-08-image-hygiene · Next: lesson-10-ecr-setup

📦 What's in this branch

Lessons 01–08, plus: the bridge from laptop to cloud — what a registry is, and the pull/push/tag/digest vocabulary Part 2 lives on.

🧒 Explain like I'm 5

Your lunchbox is perfect — but it's in YOUR fridge. The school cafeteria (a server), your teammate, a whole cluster of hungry machines… none of them can reach your fridge. 🧊🚫

Enter the frozen-lunchbox warehouse 🏬 (a registry):

You deliver your box once (docker push).
Anyone allowed can collect a copy (docker pull) — from anywhere.
The warehouse has shelves (repositories) — one shelf per app: the hello-school shelf holds ALL versions of that one app.
Every box on the shelf has a label (tag: v1, abc123) and a fingerprint (digest: sha256:…). Labels can be moved by humans; fingerprints can't lie — pull by fingerprint and you get byte-for-byte that exact box, forever.

You've been using a warehouse all along! FROM node:20-alpine pulls from Docker Hub — the giant public warehouse. Part 2 is about getting your own private one (ECR), because your company's lunches aren't for strangers. 🔐

🗺️ Diagram

flowchart LR
    lap["🧑‍💻 your laptop<br/>image built locally"]
    subgraph reg["🏬 registry - the warehouse"]
        shelf["📚 repository: hello-school<br/>one shelf, all versions"]
        tags["🏷️ tags: v1, v2, abc123<br/>🔢 digests: sha256:… fingerprints"]
        shelf --- tags
    end
    eks["☸️ cluster<br/>pulls at deploy"]
    mate["💻 teammate<br/>docker pull"]
    lap -->|"1 docker push - once"| reg
    reg -->|"2 pull - anywhere, many times"| eks
    reg --> mate

❓ What

Registry (the warehouse: Docker Hub, ECR, GHCR…) → repository (one app's shelf) → tags/digests (the boxes).
A full image name is really an address: REGISTRY/REPOSITORY:TAG — e.g. docker.io/library/node:20-alpine. No registry part = Docker Hub is assumed. That's the whole magic.
Push/pull are layer-smart (lesson 02 pays off): only layers the other side doesn't already have travel the wire. Small layers = fast ships.
Tag vs digest: tags are movable stickers (mutable); digests are content fingerprints (immutable). CI systems and careful deploys pin digests; humans read tags.

🧠 The hierarchy — registry ≠ repository

Registry        (the warehouse — one host)
   ↓
Repository      (one shelf — one application)
   ↓
Image           (one box — one build)
   ↓
Tag / Digest    (the sticker / the fingerprint)

123456789012.dkr.ecr.ap-south-1.amazonaws.com/    ← registry
    my-app                                         ← repository
       ├── v1.0.0                                  ← tags
       ├── v1.1.0
       └── latest    (a sticker — it moves)

A registry is the service; a repository is one app's shelf inside it. "Create a repository" in ECR means adding a shelf to the warehouse you already have.

🤔 Why

The registry is the handoff point of the entire trilogy: this course pushes to it, the k8s course's Deployments pull from it, the ArgoCD course commits its addresses into git. It's also the natural security boundary (who may push? who may pull?) and the cache that makes a 50-machine cluster not download from your laptop.

🧪 Try it

# you already speak registry — see today's pulls:
docker pull node:20-alpine                 # from Docker Hub, layer by layer
docker pull node:20-alpine                 # again: "Already exists" — layer cache!

# read image ADDRESSES like a pro:
docker image inspect node:20-alpine --format '{{index .RepoDigests 0}}'
# → docker.io/library/node@sha256:…  ← warehouse/shelf@fingerprint

# a real private-warehouse dry run — run a registry IN a container (how meta):
docker run -d -p 5000:5000 --name warehouse registry:2
docker tag hello-school:v1 localhost:5000/hello-school:v1     # readdress the box
docker push localhost:5000/hello-school:v1                    # deliver
docker rmi localhost:5000/hello-school:v1
docker pull localhost:5000/hello-school:v1                    # collect — full circle 🎉
docker rm -f warehouse

⚠️ Common mistakes

calling the repository "the registry" (and vice versa) — one shelf vs the whole warehouse
pushing to Docker Hub's public namespace by accident — check the full image name
assuming a pull is free — cross-region and cross-cloud pulls bill egress

⏭️ Next

Now the real thing: your own locker at the AWS bank — creating an ECR repository and getting through its front door.

git checkout lesson-10-ecr-setup

← Previousimage hygiene Next →ecr setup

This page is the lesson's README from the lesson-09-registries branch, shown here so the whole School stays on one site. Code files open on GitHub at the same branch.