CodeBlanks Logo Icon CodeBlanks
Login Register

Private registry

Learn to run your own private registry.

A private registry

To run your own registry, the official registry:2 image is enough. Images are tagged with the registry address at the start of the name and pushed:

docker run -d --name registry -p 5000:5000 -v registry-veri:/var/lib/registry registry:2
docker tag api:1.0 localhost:5000/api:1.0
docker push localhost:5000/api:1.0
curl http://localhost:5000/v2/_catalog
# {"repositories":["api"]}

TLS and managed registries

Docker talks to registries other than localhost only over HTTPS. In production a registry is protected with a TLS certificate and authentication; or a managed service is used: GitHub (ghcr.io), GitLab, AWS ECR, Google Artifact Registry, Azure ACR. They all use the same login/tag/push flow.

docker tag api:1.0 registry.sirket.com/ekip/api:1.0
docker login registry.sirket.com
docker push registry.sirket.com/ekip/api:1.0

Practice A local registry

Write three commands: start a container named registry from registry:2 in the background publishing port 5000 with the same number; tag api:1.0 as localhost:5000/api:1.0; push it.

Starter code

terminal
# buraya yaz

Sample solution

terminal
docker run -d --name registry -p 5000:5000 registry:2
docker tag api:1.0 localhost:5000/api:1.0
docker push localhost:5000/api:1.0

Expected output

d6e7f8091a2b
The push refers to repository [localhost:5000/api]
1.0: digest: sha256:4a5b… size: 1789

Questions and answers

Review the lesson questions together with their answers. To test yourself, solve the lesson interactively.

1 What must the image name be to push it to the registry at localhost:5000?

  • localhost:5000/api:1.0 Correct answer
  • api:1.0@localhost
  • 5000/api:1.0
  • api:localhost:5000

Explanation: If the first part of the name contains a dot or colon, it counts as a registry address.

2 List the repositories in the registry.

Question 
curl http://localhost:5000/v2/____
Answer 
curl http://localhost:5000/v2/_catalog

Explanation: The catalog endpoint of the Registry HTTP API.

3 Match.

Term Meaning
registry:2 Your own registry
localhost:5000/ Target registry prefix
/v2/_catalog Repository list
ECR, ACR Managed registry

All lessons in Beginner

1 What is Docker?

  1. What is Docker?
  2. Containers and virtual machines
  3. Images and containers
  4. Docker architecture
  5. Use cases
  6. Summary - What is Docker

2 Installation and first commands

  1. Installing Docker
  2. docker version
  3. docker info
  4. The hello-world container
  5. Docker Desktop
  6. Summary - Installation

3 First container

  1. docker run basics
  2. Running in the background
  3. docker ps
  4. docker stop and rm
  5. docker logs
  6. Summary - First container

4 Dockerfile basics

  1. What is a Dockerfile?
  2. The FROM instruction
  3. The RUN instruction
  4. COPY and ADD
  5. CMD and ENTRYPOINT
  6. Summary - Dockerfile

5 Build and images

  1. docker build
  2. Tagging images
  3. Build context
  4. Layers and cache
  5. .dockerignore
  6. Summary - Build

6 docker run options

  1. Interactive mode
  2. Naming containers
  3. Restart policy
  4. Working directory
  5. Switching users
  6. Summary - docker run

7 Image management

  1. docker images
  2. docker rmi
  3. docker pull
  4. docker push
  5. docker tag
  6. Summary - Image management

8 Port mapping

  1. The port concept
  2. The -p flag
  3. Multiple ports
  4. Random ports
  5. IP binding
  6. Summary - Port mapping

9 Volumes and data

  1. Data persistence
  2. Named volumes
  3. The -v flag
  4. Bind mounts
  5. Volume management
  6. Summary - Volumes

10 Environment variables

  1. The -e flag
  2. The ENV instruction
  3. The ARG instruction
  4. env-file
  5. The WORKDIR instruction
  6. Summary - Environment

11 Project: docker-compose

  1. Compose design
  2. Service definition
  3. Database service
  4. Volume and network
  5. Putting it together - compose

12 Docker Hub and registry

  1. What is Docker Hub?
  2. docker login
  3. Searching images
  4. Official images
  5. Private registry
  6. Summary - Registry

13 Network basics

  1. Network drivers
  2. docker network ls
  3. Bridge network
  4. Container connectivity
  5. Publishing ports
  6. Summary - Network

14 Beginner final

  1. Challenge - Dockerfile
  2. Challenge - Build and run
  3. Challenge - Volume
  4. Challenge - Compose
  5. Challenge - Beginner project