Docker 之部署 Harbor

﹏ヽ暗。殇╰゛Y 2024-04-17 17:13 69阅读 0赞

## 前言 ##

本小节我们学习一下Docker部署Harbor。

*  Harbor简介  
    Harbor是一个用于存储和分发Docker镜像的企业级Registry服务器，通过添加一些企业必需的功能特性，例如安全、标识和管理等，扩展了开源Docker Distribution。作为一个企业级私有Registry服务器，Harbor提供了更好的性能和安全。提升用户使用Registry构建和运行环境传输镜像的效率。Harbor支持安装在多个Registry节点的镜像资源复制，镜像全部保存在私有Registry中， 确保数据和知识产权在公司内部网络中管控。另外，Harbor也提供了高级的安全特性，诸如用户管理，访问控制和活动审计等。
 *  Harbor特性
    
     *  基于角色的访问控制 ：用户与Docker镜像仓库通过“项目”进行组织管理，一个用户可以对多个镜像仓库在同一命名空间（project）里有不同的权限。
     *  镜像复制 ： 镜像可以在多个Registry实例中复制（同步）。尤其适合于负载均衡，高可用，混合云和多云的场景。  
        图形化用户界面 ： 用户可以通过浏览器来浏览，检索当前Docker镜像仓库，管理项目和命名空间。
     *  AD/LDAP 支持 ： Harbor可以集成企业内部已有的AD/LDAP，用于鉴权认证管理。
     *  审计管理 ： 所有针对镜像仓库的操作都可以被记录追溯，用于审计管理。
     *  国际化 ： 已拥有英文、中文、德文、日文和俄文的本地化版本。更多的语言将会添加进来。
     *  RESTful API ： RESTful API 提供给管理员对于Harbor更多的操控, 使得与其它管理软件集成变得更容易。
     *  部署简单 ： 提供在线和离线两种安装工具， 也可以安装到vSphere平台(OVA方式)虚拟设备。
 *  Harbor组件，Harbor在架构上主要由6个组件构成：
    
     *  Proxy：Harbor的registry, UI, token等服务，通过一个前置的反向代理统一接收浏览器、Docker客户端的请求，并将请求转发给后端不同的服务。
     *  Registry： 负责储存Docker镜像，并处理docker push/pull 命令。由于我们要对用户进行访问控制，即不同用户对Docker image有不同的读写权限，Registry会指向一个token服务，强制用户的每次docker pull/push请求都要携带一个合法的token, Registry会通过公钥对token 进行解密验证。
     *  Core services： 这是Harbor的核心功能，主要提供以下服务：
     *  UI：提供图形化界面，帮助用户管理registry上的镜像（image）, 并对用户进行授权。
     *  webhook：为了及时获取registry 上image状态变化的情况， 在Registry上配置webhook，把状态变化传递给UI模块。
     *  token 服务：负责根据用户权限给每个docker push/pull命令签发token. Docker 客户端向Regiøstry服务发起的请求,如果不包含token，会被重定向到这里，获得token后再重新向Registry进行请求。
     *  Database：为core services提供数据库服务，负责储存用户权限、审计日志、Docker image分组信息等数据。
     *  Job Services：提供镜像远程复制功能，可以把本地镜像同步到其他Harbor实例中。
     *  Log collector：为了帮助监控Harbor运行，负责收集其他组件的log，供日后进行分析。
    
    各个组件之间的关系如下图所示：![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTI0Mzc3ODE_size_16_color_FFFFFF_t_70]
 *  Harbor实现  
    Harbor的每个组件都是以Docker容器的形式构建的，官方也是使用Docker Compose来对它进行部署。用于部署Harbor的Docker Compose模板位于 harbor/docker-compose.yml,打开这个模板文件，发现Harbor是由7个容器组成的；
    
        [root@iZwz92qakfc7zvdr9h0gipZ harbor]# docker-compose ps  
               Name                     Command                  State                                    Ports                              
        -------------------------------------------------------------------------------------------------------------------------------------
        harbor-adminserver   /harbor/harbor_adminserver       Up                                                                             
        harbor-db            docker-entrypoint.sh mysqld      Up             3306/tcp                                                        
        harbor-jobservice    /harbor/harbor_jobservice        Up                                                                             
        harbor-log           /bin/sh -c crond && rm -f  ...   Up             127.0.0.1:1514->514/tcp                                         
        harbor-ui            /harbor/harbor_ui                Up                                                                             
        nginx                nginx -g daemon off;             Up             0.0.0.0:443->443/tcp, 0.0.0.0:4443->4443/tcp, 0.0.0.0:80->80/tcp
        registry             /entrypoint.sh serve /etc/ ...   Up (healthy)   5000/tcp                                                        
        [root@iZwz92qakfc7zvdr9h0gipZ harbor]#
    
     *  nginx：nginx负责流量转发和安全验证，对外提供的流量都是从nginx中转，所以开放https的443端口，它将流量分发到后端的ui和正在docker镜像存储的docker registry。
     *  harbor-jobservice：harbor-jobservice 是harbor的job管理模块，job在harbor里面主要是为了镜像仓库之前同步使用的;
     *  harbor-ui：harbor-ui是web管理页面，主要是前端的页面和后端CURD的接口;
     *  registry：registry就是docker原生的仓库，负责保存镜像。
     *  harbor-adminserver：harbor-adminserver是harbor系统管理接口，可以修改系统配置以及获取系统信息。  
        这几个容器通过Docker link的形式连接在一起，在容器之间通过容器名字互相访问。对终端用户而言，只需要暴露proxy （即Nginx）的服务端口。
     *  harbor-db：harbor-db是harbor的数据库，这里保存了系统的job以及项目、人员权限管理。由于本harbor的认证也是通过数据，在生产环节大多对接到企业的ldap中；
     *  harbor-log：harbor-log是harbor的日志服务，统一管理harbor的日志。通过inspect可以看出容器统一将日志输出的syslog。
    
    这几个容器通过Docker link的形式连接在一起，这样，在容器之间可以通过容器名字互相访问。对终端用户而言，只需要暴露proxy （即Nginx）的服务端口。

## 安装Docker和Docker-compose ##

![在这里插入图片描述][20190829102920226.png]  
安装Harbor需要先安装docker和docker-compose

*  安装docker
    
        # yum install -y yum-utils \
          device-mapper-persistent-data \
          lvm2
        配置repository：
        # yum-config-manager \
            --add-repo \
        https://download.docker.com/linux/centos/docker-ce.repo
        
        安装最新版本docker-ce   Docker version 1.13.1
        # yum install docker-ce
 *  启动Docker
    
        # systemctl start docker
    
    > 如果需要卸载docker-ce，操作如下：yum remove docker-ce  
    > 卸载后images，containers，volumes，configuration files 是不能自动删除的，为了删除all images，containers，and volumes，请执行如下命令：rm -rf /var/lib/docker
 *  安装docker-compose
    
     *  二进制安装
        
         *  下载二进制文件
            
                # curl -L https://github.com/docker/compose/releases/download/1.16.1/docker-compose-`uname -s`-`uname -m` -o /workspace/harbor/bin/docker-compose
            
            > 如果需要安装其他版本的话，请修改上面命令中的版本号。
         *  赋予二进制文件可执行权限
            
                # chmod +x  /workspace/harbor/bin/docker-compose
         *  根据自己的情况决定是否安装命令补全功能
            
                # yum install bash-completion 
                # curl -L https://raw.githubusercontent.com/docker/compose/1.16.1/contrib/completion/bash/docker-compose -o /etc/bash_completion.d/docker-compose
            
            > 重新登陆后就生效了  
            > docker-compose  
            > build config down exec images logs port pull restart run start top up  
            > bundle create events help kill pause ps push rm scale stop unpause version
         *  测试是否安装成功
            
                # docker-compose --version
                docker-compose version 1.16.1, build 6d1ac21
     *  二进制卸载docker-compose
        
            # rm   /workspace/harbor/bin/docker-compose
     *  pip
        
            # yum install python-pip
            # pip install  docker-compose
     *  .测试是否安装成功
        
            [root@iZwz92qakfc7zvdr9h0gipZ harbor]# docker-compose --version
            docker-compose version 1.24.1, build 4667896
            [root@iZwz92qakfc7zvdr9h0gipZ harbor]#
     *  pip卸载docker-compose
        
            # pip uninstall  docker-compose

## 安装Harbor ##

安装方式分为在线安装和离线安装两种方式，我这里选择的是在线安装。

*  在线安装
    
        wget -P /workspace/harbor/     https://github.com/vmware/harbor/releases/download/v1.2.0/harbor-online-installer-v1.2.0.tgz
    
        # cd /workspace/harbor/
        # tar zxf harbor-online-installer-v1.2.0.tgz
        # cd /harbor/
 *  离线安装
    
        https://github.com/vmware/harbor/releases/download/v1.2.0/harbor-offline-installer-v1.2.0.tgz
 *  修改配置文件  
    配置文件为：/workspace/harbor/harbor/harbor.cfg，做了修改的配置项大致如下：
    
    > hostname = 你的域名或IP \#harbor域名或IP  
    > ui\_url\_protocol = http \#默认使用的protocol  
    > db\_password = bai5331359 \#harbor数据库ROOT用户链接的密码  
    > max\_job\_workers = 3  
    > self\_registration = off \#不允许注册用户  
    > customize\_crt = on  
    > project\_creation\_restriction = adminonly \#设置只有管理员可以创建项目  
    > harbor\_admin\_password = bai5331359 \#admin用户登录密码
 *  执行安装脚本
    
        /workspace/harbor/harbor/install.sh
    
        [root@iZwz92qakfc7zvdr9h0gipZ harbor]# ./install.sh 
        
        [Step 0]: checking installation environment ...
        
        Note: docker version: 1.13.1
        
        Note: docker-compose version: 1.24.1
        
        
        [Step 1]: preparing environment ...
        Clearing the configuration file: ./common/config/db/env
        Clearing the configuration file: ./common/config/ui/app.conf
        Clearing the configuration file: ./common/config/ui/private_key.pem
        Clearing the configuration file: ./common/config/ui/env
        Clearing the configuration file: ./common/config/jobservice/app.conf
        Clearing the configuration file: ./common/config/jobservice/env
        Clearing the configuration file: ./common/config/nginx/nginx.conf
        Clearing the configuration file: ./common/config/adminserver/env
        Clearing the configuration file: ./common/config/registry/config.yml
        Clearing the configuration file: ./common/config/registry/root.crt
        loaded secret from file: /data/secretkey
        Generated configuration file: ./common/config/nginx/nginx.conf
        Generated configuration file: ./common/config/adminserver/env
        Generated configuration file: ./common/config/ui/env
        Generated configuration file: ./common/config/registry/config.yml
        Generated configuration file: ./common/config/db/env
        Generated configuration file: ./common/config/jobservice/env
        Generated configuration file: ./common/config/jobservice/app.conf
        Generated configuration file: ./common/config/ui/app.conf
        Generated certificate, key file: ./common/config/ui/private_key.pem, cert file: ./common/config/registry/root.crt
        The configuration files are ready, please use docker-compose to start the service.
        
        
        [Step 2]: checking existing instance of Harbor ...
        
        Note: stopping existing Harbor instance ...
        Removing nginx              ... done
        Removing harbor-jobservice  ... done
        Removing harbor-ui          ... done
        Removing harbor-adminserver ... done
        Removing registry           ... done
        Removing harbor-db          ... done
        Removing harbor-log         ... done
        Removing network harbor_harbor
        
        
        [Step 3]: starting Harbor ...
        Creating network "harbor_harbor" with the default driver
        Creating harbor-log ... done
        Creating harbor-db          ... done
        Creating harbor-adminserver ... done
        Creating registry           ... done
        Creating harbor-ui          ... done
        Creating harbor-jobservice  ... done
        Creating nginx              ... done
        
        ✔ ----Harbor has been installed and started successfully.----
        
        Now you should be able to visit the admin portal at http://dustyone.club . 
        For more details, please visit https://github.com/vmware/harbor .
        
        [root@iZwz92qakfc7zvdr9h0gipZ harbor]#
 *  Harbor启动和停止  
    Harbor 的日常运维管理是通过docker-compose来完成的，Harbor本身有多个服务进程，都放在docker容器之中运行，我们可以通过docker ps命令查看。
    
        [root@iZwz92qakfc7zvdr9h0gipZ harbor]# docker ps
        CONTAINER ID        IMAGE                              COMMAND                  CREATED              STATUS                        PORTS                                                              NAMES
        70f2a12d4cb9        vmware/nginx-photon:1.11.13        "nginx -g 'daemon ..."   About a minute ago   Up About a minute             0.0.0.0:80->80/tcp, 0.0.0.0:443->443/tcp, 0.0.0.0:4443->4443/tcp   nginx
        c538b882b9d3        vmware/harbor-jobservice:v1.2.0    "/harbor/harbor_jo..."   About a minute ago   Up About a minute                                                                                harbor-jobservice
        d6a926fef9ef        vmware/harbor-ui:v1.2.0            "/harbor/harbor_ui"      About a minute ago   Up About a minute                                                                                harbor-ui
        6e96ca08ea4a        vmware/registry:2.6.2-photon       "/entrypoint.sh se..."   About a minute ago   Up About a minute (healthy)   5000/tcp                                                           registry
        89299fdc69cb        vmware/harbor-adminserver:v1.2.0   "/harbor/harbor_ad..."   About a minute ago   Up About a minute                                                                                harbor-adminserver
        b97594be84ef        vmware/harbor-db:v1.2.0            "docker-entrypoint..."   About a minute ago   Up About a minute             3306/tcp                                                           harbor-db
        ec6f359ad827        vmware/harbor-log:v1.2.0           "/bin/sh -c 'crond..."   About a minute ago   Up About a minute             127.0.0.1:1514->514/tcp                                            harbor-log
        cd5e58772856        cc7aef62c0b1                       "entrypoint.sh php..."   17 hours ago         Up 17 hours                   0.0.0.0:8088->80/tcp                                               kodexplorer
        d2eef3c35fdc        mysql:5.7                          "docker-entrypoint..."   17 hours ago         Up 17 hours                   0.0.0.0:3306->3306/tcp, 33060/tcp                                  mysql
        1bdbaeae0333        gitlab/gitlab-ce:latest            "/assets/wrapper"        25 hours ago         Up 23 hours (healthy)         22/tcp, 0.0.0.0:11110->80/tcp, 0.0.0.0:1443->443/tcp               gitlab
        [root@iZwz92qakfc7zvdr9h0gipZ harbor]#
    
    或者docker-compose 来查看
    
        cd /workspace/harbor/harbor/
    
        [root@iZwz92qakfc7zvdr9h0gipZ harbor]# docker-compose ps
               Name                     Command                  State                                    Ports                              
        -------------------------------------------------------------------------------------------------------------------------------------
        harbor-adminserver   /harbor/harbor_adminserver       Up                                                                             
        harbor-db            docker-entrypoint.sh mysqld      Up             3306/tcp                                                        
        harbor-jobservice    /harbor/harbor_jobservice        Up                                                                             
        harbor-log           /bin/sh -c crond && rm -f  ...   Up             127.0.0.1:1514->514/tcp                                         
        harbor-ui            /harbor/harbor_ui                Up                                                                             
        nginx                nginx -g daemon off;             Up             0.0.0.0:443->443/tcp, 0.0.0.0:4443->4443/tcp, 0.0.0.0:80->80/tcp
        registry             /entrypoint.sh serve /etc/ ...   Up (healthy)   5000/tcp                                                        
        [root@iZwz92qakfc7zvdr9h0gipZ harbor]#
 *  Harbor的启动和停止
    
        启动Harbor
        # docker-compose start
        停止Harbor
        # docker-comose stop
        重启Harbor
        # docker-compose restart
 *  访问测试  
    使用你的域名或者IP直接访问Harbor，Harbor默认使用的是80端口  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTI0Mzc3ODE_size_16_color_FFFFFF_t_70 1]

## 小结 ##

*  一篇非常好的介绍Harbor的文章：[Docker私有仓库Harbor介绍和部署记录][Docker_Harbor]

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTI0Mzc3ODE_size_16_color_FFFFFF_t_70]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/17/3b7b568afc2d4b2ab58a6bf51819aadc.png
[20190829102920226.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/17/e7e30e501d734bd988d60353ea9ed518.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTI0Mzc3ODE_size_16_color_FFFFFF_t_70 1]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/17/a702a7ba23134945b6c136d4f72bd400.png
[Docker_Harbor]: https://www.cnblogs.com/adjk/p/11043856.html