docker 私有仓库

发布于 更新于 评论

私有仓库

有时候使用 Docker Hub 这样的公共仓库可能不方便，用户可以创建一个本地仓库供私人使用。

docker-registry 是官方提供的工具，可以用于构建私有的镜像仓库。本文内容基于 docker-registry v2.x 版本。你可以通过获取官方 registry 镜像来运行。

1
docker run --name registry -p 5000:5000 -d registry

这将使用官方的 registry 镜像来启动私有仓库。默认情况下，仓库会被创建在容器的 /var/lib/registry 目录下。

在私有仓库上传、搜索、下载镜像

创建好私有仓库之后，就可以使用 docker tag 来标记一个镜像，然后推送它到仓库。例如私有仓库地址为 127.0.0.1:5000。先在本机查看已有的镜像。

1
2
3
$ docker images
REPOSITORY                TAG              IMAGE ID       CREATED         SIZE
xueyongshan/python-demo   latest           97b87f915673   2 days ago      60.3MB

使用 docker tag 将 xueyongshan/python-demo 这个镜像标记为 127.0.0.1:5000/python:v1。
格式为 docker tag IMAGE[:TAG] [REGISTRY_HOST[:REGISTRY_PORT]/]REPOSITORY[:TAG]

1
2
3
4
5
$ docker tag xueyongshan/python-demo:latest 127.0.0.1:5000/python:v1
$ docker images
REPOSITORY                TAG              IMAGE ID       CREATED         SIZE
127.0.0.1:5000/python     v1               97b87f915673   2 days ago      60.3MB
xueyongshan/python-demo   latest           97b87f915673   2 days ago      60.3MB

使用 docker push 上传标记的镜像.

1
2
3
4
5
6
7
8
9
10
$ docker push 127.0.0.1:5000/python:v1
The push refers to repository [127.0.0.1:5000/python]
8c84e798e095: Pushed
a4206afdb0ad: Pushed
be6b216728ff: Pushed
b9a7a7381abe: Pushed
2306fb7a5a47: Pushed
6666686122fd: Pushed
994393dc58e7: Pushed
v1: digest: sha256:165e3ef140f7ac367897345d058d3bab24455b19ec7afb0a1ca72a206b43e3f6 size: 1786

用 curl 查看仓库中的镜像。

1
2
$ curl 127.0.0.1:5000/v2/_catalog
{"repositories":["python"]}

这里可以看到 {"repositories":["python"]}，表明镜像已经被成功上传了。

先删除已有镜像，再尝试从私有仓库中下载这个镜像。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
# root @ james in /mnt/e/phpStudy/PHPTutorial/WWW/larelastic/docker-python [11:12:47]
$ docker rmi 127.0.0.1:5000/python:v1
Untagged: 127.0.0.1:5000/python:v1
Untagged: 127.0.0.1:5000/python@sha256:165e3ef140f7ac367897345d058d3bab24455b19ec7afb0a1ca72a206b43e3f6

# root @ james in /mnt/e/phpStudy/PHPTutorial/WWW/larelastic/docker-python [11:12:53]
$ docker pull 127.0.0.1:5000/python:v1
v1: Pulling from python
Digest: sha256:165e3ef140f7ac367897345d058d3bab24455b19ec7afb0a1ca72a206b43e3f6
Status: Downloaded newer image for 127.0.0.1:5000/python:v1
127.0.0.1:5000/python:v1

# root @ james in /mnt/e/phpStudy/PHPTutorial/WWW/larelastic/docker-python [11:13:02]
$ docker images
REPOSITORY                TAG              IMAGE ID       CREATED         SIZE
127.0.0.1:5000/python     v1               97b87f915673   2 days ago      60.3MB
xueyongshan/python-demo   latest           97b87f915673   2 days ago      60.3MB

注意事项

如果你不想使用 127.0.0.1:5000 作为仓库地址，比如想让本网段的其他主机也能把镜像推送到私有仓库。你就得把例如 192.168.199.100:5000 这样的内网地址作为私有仓库地址，这时你会发现无法成功推送镜像。

这是因为 Docker 默认不允许非 HTTPS 方式推送镜像。我们可以通过 Docker 的配置选项来取消这个限制。

对于使用 systemd 的系统，请在 /etc/docker/daemon.json 中写入如下内容（如果文件不存在请新建该文件）

1
2
3
4
5
{
  "insecure-registries": [
    "192.168.199.100:5000"
  ]
}

注意：该文件必须符合json规范，否则 Docker 将不能启动。

镜像持久化

删除正再执行的容器 registry，然后重新运行 registry

1
2
3
4
5
6
docker rm -f registry

docker run --name registry -d -p 5000:5000 registry

docker ps -a
CONTAINER ID   IMAGE     COMMAND   CREATED   STATUS    PORTS     NAMES

查询仓库中的镜像。发现是没有之前提交的 python 镜像。

1
2
$ curl 127.0.0.1:5000/v2/_catalog
{"repositories":[]}

因为默认情况下，仓库会被创建在容器的 /var/lib/registry 目录下。当删除容器 registry 时会把 /var/lib/registry 一起删除。
因此我们可以通过 -v 参数来将镜像文件存放在本地的指定路径。例如下面的例子将上传的镜像放到本地的 /registry 目录。

1
docker run -d -p 5000:5000 -v $(pwd)/registry:/var/lib/registry registry

持久化 Demo

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
# 1、删除镜像
docker ps -a
CONTAINER ID   IMAGE      COMMAND                  CREATED         STATUS         PORTS                                       NAMES
479bdf321954   registry   "/entrypoint.sh /etc…"   7 minutes ago   Up 7 minutes   0.0.0.0:5000->5000/tcp, :::5000->5000/tcp   registry

# root @ james in /mnt/e/phpStudy/PHPTutorial/WWW/larelastic/docker-python [12:02:42]
$ docker rm -f registry
registry

# root @ james in /mnt/e/phpStudy/PHPTutorial/WWW/larelastic/docker-python [12:02:57]
$ docker ps -a
CONTAINER ID   IMAGE     COMMAND   CREATED   STATUS    PORTS     NAMES

# 2、启动容器并挂载本地目录
# root @ james in /mnt/e/phpStudy/PHPTutorial/WWW/larelastic/docker-python [12:02:59]
$ docker run -d -p 5000:5000 -v $(pwd)/registry:/var/lib/registry registry
2a175bf9e3c7de68d19541ab845c0c1be87acf5b2a11253f4dfddb6e8a73f317

# root @ james in /mnt/e/phpStudy/PHPTutorial/WWW/larelastic/docker-python [12:03:15]
$ docker ps -a
CONTAINER ID   IMAGE      COMMAND                  CREATED         STATUS         PORTS                                       NAMES
2a175bf9e3c7   registry   "/entrypoint.sh /etc…"   8 seconds ago   Up 3 seconds   0.0.0.0:5000->5000/tcp, :::5000->5000/tcp   clever_lamarr

# 3、提交镜像
# root @ james in /mnt/e/phpStudy/PHPTutorial/WWW/larelastic/docker-python [12:03:19]
$ docker push 127.0.0.1:5000/python:v1
The push refers to repository [127.0.0.1:5000/python]
8c84e798e095: Pushed
a4206afdb0ad: Pushed
be6b216728ff: Pushed
b9a7a7381abe: Pushed
2306fb7a5a47: Pushed
6666686122fd: Pushed
994393dc58e7: Pushed
v1: digest: sha256:165e3ef140f7ac367897345d058d3bab24455b19ec7afb0a1ca72a206b43e3f6 size: 1786

# root @ james in /mnt/e/phpStudy/PHPTutorial/WWW/larelastic/docker-python [12:03:56]
$ ls
Dockerfile  main.py  registry  # 这里会出现容器中存放镜像的文件夹

# 4、删除容器和镜像
# root @ james in /mnt/e/phpStudy/PHPTutorial/WWW/larelastic/docker-python [12:07:13]
$ docker ps -a
CONTAINER ID   IMAGE      COMMAND                  CREATED         STATUS         PORTS                                       NAMES
2a175bf9e3c7   registry   "/entrypoint.sh /etc…"   4 minutes ago   Up 4 minutes   0.0.0.0:5000->5000/tcp, :::5000->5000/tcp   clever_lamarr

# root @ james in /mnt/e/phpStudy/PHPTutorial/WWW/larelastic/docker-python [12:07:19]
$ docker rm -f 2a17
2a17

# root @ james in /mnt/e/phpStudy/PHPTutorial/WWW/larelastic/docker-python [12:07:42]
$ docker images
REPOSITORY                TAG              IMAGE ID       CREATED         SIZE
127.0.0.1:5000/python     v1               97b87f915673   2 days ago      60.3MB
xueyongshan/python-demo   latest           97b87f915673   2 days ago      60.3MB

# root @ james in /mnt/e/phpStudy/PHPTutorial/WWW/larelastic/docker-python [12:07:44]
$ docker rmi 127.0.0.1:5000/python:v1
Untagged: 127.0.0.1:5000/python:v1
Untagged: 127.0.0.1:5000/python@sha256:165e3ef140f7ac367897345d058d3bab24455b19ec7afb0a1ca72a206b43e3f6

# 5、重新启动容器并拉取镜像
# root @ james in /mnt/e/phpStudy/PHPTutorial/WWW/larelastic/docker-python [12:07:50]
$ docker run -d -p 5000:5000 -v $(pwd)/registry:/var/lib/registry registry
ff808f4369c83860bdadeb419539d714449817703f170ffb287e34a79edb1e53

# root @ james in /mnt/e/phpStudy/PHPTutorial/WWW/larelastic/docker-python [12:08:55]
$ docker pull 127.0.0.1:5000/python:v1
v1: Pulling from python
Digest: sha256:165e3ef140f7ac367897345d058d3bab24455b19ec7afb0a1ca72a206b43e3f6
Status: Downloaded newer image for 127.0.0.1:5000/python:v1
127.0.0.1:5000/python:v1

# 6、查看镜像
# root @ james in /mnt/e/phpStudy/PHPTutorial/WWW/larelastic/docker-python [12:09:03] C:1
$ docker images
REPOSITORY                TAG              IMAGE ID       CREATED         SIZE
127.0.0.1:5000/python     v1               97b87f915673   2 days ago      60.3MB
xueyongshan/python-demo   latest           97b87f915673   2 days ago      60.3MB

# root @ james in /mnt/e/phpStudy/PHPTutorial/WWW/larelastic/docker-python [12:09:05]
$ docker ps -a
CONTAINER ID   IMAGE      COMMAND                  CREATED          STATUS          PORTS                                       NAMES
ff808f4369c8   registry   "/entrypoint.sh /etc…"   16 seconds ago   Up 13 seconds   0.0.0.0:5000->5000/tcp, :::5000->5000/tcp   loving_moore