C.7 docker registry

介绍

什么是注册服务？什么是仓库？

注册注册服务（docker registry）是提供存放仓库（REPOSITORY）的服务器，docker 官方提供了一个默认的公共服务（docker hub），个人或者企业可以将自己制作的镜像上传到docker hub，也可以上传到自己搭建的私服。类似于 maven 的官方服务和私服。

仓库（REPOSITORY）是存放镜像的命名空间，仓库里面有多个不同标签（TAG）的镜像。类似于 maven 的 artifactId 和 version。

仓库（REPOSITORY）的名字由两部分组成：比如 rancher/server，前半部分是多用户环境下的用户名，后半部分是软件名。如果不需要用户环境，前半部分可以丢弃，如果是用私服的话，还需要在仓库名前面加上地址名（域名），例如：registry.mateng.pers:5000/mateng/kafka 或者 registry.mateng.pers:5000/kafka

镜像的命名为：:。仓库加标签即为一个唯一的镜像。

命名规则：

一般在私服中大多不会使用多用户环境，所以不考虑用户名
仓库名为软件名
标签为版本号

registry 分类

公开服务
- docker hub
- 阿里云镜像库
- 网易云镜像库
私有registry

私有 registry 的搭建

介绍

docker私服是为每个docker主机提供镜像服务，每个docker主机即为我们的部署程序软件的机器。

每个docker主机可以上传镜像到仓库
每个docker主机可以从仓库中下载镜像安装运行到本地

准备

准备两台机器，分别都安装好docker，并启动成功

192.168.137.103 作为 docker 主机
192.168.137.104 作为 docker 私服
在 192.168.137.103 机器上配置 hosts

192.168.137.104 registry.mateng.pers

下载并安装

在 docker 私服机器上安装 docker registry

#下载registry镜像
docker pull registry
#镜像启动一个容器
docker run -d \
    -p 5000:5000 \
    --name registry \
    --restart=always \
    -v /opt/docker-software/registry:/var/lib/registry \
registry

此时私服已经搭建完毕

docker 主机配置

1、在所有的 docker 主机上配置/etc/hosts，其中 x.x.x.x为docker仓库的地址，通过域名来映射 docker 私服的ip。如：

x.x.x.x registry.mateng.pers

2、在docker主机上配置仓库的地址

# centos7的配置方法
vim /lib/systemd/system/docker.service

# 修改配置文件的ExecStart参数
ExecStart=/usr/bin/dockerd \
        --insecure-registry=registry.mateng.pers:5000 
        
# 重启Docker
systemctl daemon-reload
systemctl restart docker.service

测试上传下载

在 docker 主机上测试镜像的上传下载

# 从docker hub 下载测试镜像
docker pull hello-world

# 给本地的hello-world镜像新打标签，形成新镜像
# 域名为仓库地址
docker tag hello-world registry.mateng.pers:5000/hello-world

# 将新镜像上传到本地私服
docker push registry.mateng.pers:5000/hello-world

通过 http 查看私服中的镜像

curl registry.mateng.pers:5000/v2/_catalog

经验分享

由于docker仓库的地址可能会变，所以建议一般在 docker 主机上配置hosts来映射docker-registry的ip

registry UI管理界面

由于我们通过浏览器输入http://私服的ip:5000/v2/_catalog，访问可以查看到仓库中有哪些镜像，但是界面比较粗糙，查看不方便。
为此我们要重新安装一个仓库的UI管理界面来更好的使用仓库。例如hyper/docker-registry-web，konradkleine/docker-registry-frontend。以下只说明hyper/docker-registry-web的安装。

registry-web 安装

docker run -d \
    -p 5002:8080 \
    --name registry-web \
    --link registry \
    -v /opt/docker-software/registry/web:/data \
    -e REGISTRY_URL=http://registry:5000/v2 \
    -e REGISTRY_TRUST_ANY_SSL=true \
    -e REGISTRY_NAME=registry.mateng.pers:5000 \
    hyper/docker-registry-web

命令解释：

-p 5002:8080 端口映射，使用宿主机的5002端口映射容器的8080端口
--name 容器名称
--link 连接到私服，registry为docker私服容器的名字，
必须加
-e REGISTRY_TRUST_ANY_SSL=true，环境变量，相信所有的ssl，取消ssl验证
-e REGISTRY_NAME, docker仓库中每个镜像的前缀，会在docker-registry-web的页面上显示（这个域名是私服的域名，端口是私服的端口）
-e REGISTRY_URL 链接私服的url。和 REGISTRY_NAME 类似，这两个最好写一致

通过编排方式启动

vim stack.yml

version: '3'
services:
  registry:
    image: registry:latest
    ports:
      - 5000:5000
    volumes:
      - /opt/docker-software/registry:/var/lib/registry
    networks:
      - net
    deploy:
      replicas: 1
      restart_policy:
        condition: on-failure
      placement:
        constraints:
        - node.role == manager
              
  web:
    image: hyper/docker-registry-web:latest
    ports:
      - 5002:8080
    volumes:
      - /opt/docker-software/registry/web:/data
    depends_on:
      - registry
    networks:
      - net
    environment:
      REGISTRY_HOST: registry
      REGISTRY_URL: http://registry:5000/v2
      REGISTRY_NAME: registry.mateng.pers:5000
    deploy:
      replicas: 1
      restart_policy:
        condition: on-failure
      placement:
        constraints:
        - node.role == manager
        
networks:
  net:

參考文件

https://docs.docker.com/registry/deploying/