Docker私有仓库搭建

下载离线镜像

检查Docker环境

docker version

Docker Hub 中registry 最新版本为 2.8.3，详见 registry . https://hub.docker.com/_/registry/tags

下载镜像

docker pull registry:2.8.3

离线导出，方便在无法联网的设备上安装

docker image save registry:2.8.3 -o registry.2.8.3.tar

离线安装

讲registry.2.8.3.tar 复制到目标设备上，运行下面命令导入镜像。

docker load -i registry.2.8.3.tar

查询导入镜像

docker images

启动

创建镜像存储路径

mkdir -p /data/docker-registry/

启动仓库

docker run -p 5000:5000 \
           --name registry \
           --restart=always \
           -v /data/docker-registry/:/var/lib/registry \
           -d registry:2.8.3

• 服务端口为 5000，注意开放防护墙。
• 镜像存储目录为 /var/lib/registry 需要映射主机存储目录防止容器删除后镜像丢失。

查看运行状态

docker ps | grep registry 

检查服务是否可以访问：

curl 127.0.0.1:5000/v2/_catalog

仓库为空。

私有仓库设置

在需要访问该私有仓库的设备上，调整Docker配置文件/etc/docker/daemon.json加入下面内容

{
  "insecure-registries": [ "192.168.0.222:5000" ]
}

例如：

重启Docker

systemctl restart docker 

Docker构建镜像上传

准备构建镜像内容

cd ~
mkdir -p hello_world
cd hello_world/
touch file.txt

cat > Dockerfile <<EOF
FROM scratch 
COPY ./file.txt file.txt
EOF

构建镜像，并打上仓库标签， 注意仓库地址替换为实际IP或域名！

docker build -t 192.168.0.222:5000/myhello:1.0.0 .

推送镜像到私有仓库

docker push 192.168.0.222:5000/myhello:1.0.0

推送成功

查询一下仓库中是否存在

curl 127.0.0.1:5000/v2/_catalog

从另外一台设备上从私有仓库拉取镜像

docker pull 192.168.0.222:5000/myhello:1.0.0

Containerd构建镜像上传

使用Containerd构建镜像需要先安装 nerdctl [6]

检查命令是否可用

nerdctl -v

请确保已经将私有仓库添加至containerd目录，详见 [5]

准备构建镜像内容

cd ~
mkdir -p hello_world
cd hello_world/
touch file.txt

cat > Dockerfile <<EOF
FROM scratch 
COPY ./file.txt file.txt
EOF

构建镜像，并打上仓库标签， 注意仓库地址替换为实际IP或域名！

nerdctl build -t 192.168.0.221:5000/myhello:1.0.1 .

推送至私有仓库

nerdctl push 192.168.0.221:5000/myhello:1.0.1

查看仓库上的镜像

curl http://192.168.0.221:5000/v2/myhello/tags/list

参考文献

[1]. CNCF . Distribution Registry . 2024 . https://distribution.github.io/distribution/
[2]. yeasy . docker——入门到实践 . https://yeasy.gitbook.io/docker_practice/repository/registry
[3]. 博客园 . 持久化docker的镜像或容器的方法 . 飞天小子 . 2018.12 . https://www.cnblogs.com/zhuochong/p/10064350.html
[4]. containerd . nerdctl . 2024 .https://github.com/containerd/nerdctl
[5]. 小灰灰的碎碎念 . containerd 配置私有仓库 . 2023.11 . https://h2c.tech/p/containerd-%E9%85%8D%E7%BD%AE%E7%A7%81%E6%9C%89%E4%BB%93%E5%BA%93/
[6]. 博客园 . nerdctl安装 . 小吉猫 2022.10 . https://www.cnblogs.com/wangguishe/p/16779282.html