基于Harbor搭建Docker私有镜像仓库

曾经终败给现在 2022-01-20 06:07 442阅读 0赞

### 文章目录 ###

*   *   *   *  准备工作
             *  Harbor安装
             *   *  资源下载
                 *  Https证书配置
                 *  Harbor的配置文件修改
                 *  安装Harbor
                 *  Harbor管理平台
             *  Docker上传本地镜像仓库(HTTPS)
             *  Docker本地镜像下载(HTTPS)
             *  Docker上传本地镜像仓库(HTTP)
             *  Docker本地镜像下载(HTTP)

#### 准备工作 ####

*  安装docker  
    [Linux下安装Docker及基础操作][Linux_Docker]
 *  安装docker-compose  
    [官网教程][Link 1]
    
     *  下载
        
            sudo curl -L "https://github.com/docker/compose/releases/download/1.24.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
        
        ![在这里插入图片描述][20190611085244837.png]
     *  更改权限
        
            sudo chmod +x /usr/local/bin/docker-compose

#### Harbor安装 ####

##### 资源下载 #####

*  下载  
    [Harbor Github上的下载页面][Harbor Github]，这里下载了目前最新的1.8.0的版本；将其拷贝至linux服务器的/usr/local/src/目录下并解压；

##### Https证书配置 #####

*  **前言**  
    由于Docker上传默认使用的Https，为了不影响客户端的使用，这里使用[自签泛域名证书][Link 2]的方式进行测试；这一步也可以不做配置，那么就只支持http的上传，客户端就需要指定授权，具体的方式下面会介绍；如果不想配置https证书或者不想配，可以直接跳过本节直接看下一节；
 *  **域名说明**  
    为了便于访问，这里使用了hub.lpf.com作为了测试域名；声明lpf.com非本人域名，这里仅仅使用hub.lpf.com映射到内网下的一个做测试用，不做任何其他用处。个人测试的话，也可以使用其他的任意域名，该域名仅仅作为解析到内网ip使用，不会做公网映射；  
    如果需要做私服的外网访问，这里也可以使用真实的域名，相关的域名证书可以上阿里云、腾讯云等平台申请付费或者免费的证书；关于免费证书申请，可参考该博客：[免费SSL证书实现https请求][SSL_https]
 *  **添加hosts记录**  
    本地内网下使用:192.168.1.21的一台机器作为镜像服务器，在192.168.1.21的hosts文件下加一条域名映射关系，用于将hub.lpf.com映射到192.168.1.21的机器上；如果域名是真实的且与本机做了映射，就不用做此配置；
    
        vi /etc/hosts
    
    添加以下配置
    
        192.168.1.21 hub.lpf.com
    
    使用：ping [hub.lpf.com][] 测试是否已经生效  
    ![20190611104050859.png][]
 *  **自签证书生成**
    
     *  下载正式生成工具  
        [下载自签泛域名证书的工具][Link 2]，放到linux服务器上，也可以在linux服务器上安装git，使用git clone指令进行下载；如果是压缩包，请自行解压好。
     *  生成正式  
        **进入以上工具的解压目录**，使用以下指令  
        cd /usr/local/src/ssl-master
        
            ./gen.cert.sh hub.lpf.com
        
        ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2x1cGVuZ2ZlaTEwMDk_size_16_color_FFFFFF_t_70][]  
        可以看出，out目录下为生成的证书信息；为了方便我们后续的配置，我们将证书拷贝到另外一个目录:
        
            mkdir -p /home/data/keys/harbor/
            cp /usr/local/src/ssl-master/out/hub.lpf.com/hub.lpf.com.key.pem /home/data/keys/harbor/cert.key.pem
            cp /usr/local/src/ssl-master/out/hub.lpf.com/hub.lpf.com.crt /home/data/keys/harbor/hub.lpf.com.crt
        
        ![20190611102727436.png][]
     *  root.crt说明  
        》注意，警告《 该证书文件需要放到各个客户端，才能正常的通过https访问，这里做说明，后面会详细的讲解怎么使用

##### Harbor的配置文件修改 #####

*  进入harbor的解压目录，找到以下文件  
    ![20190611110239791.png][]  
    vim harbor.yml
 *  添加修改以下配置:
    
        #主机地址，前面配置的域名
        	hostname: hub.lpf.com
        	
        	# http 相关的配置
        	http:
        	  # 由于80端口被其他的服务给占用了，这里使用8099代替
        	  port: 8099
        	
        	# https 相关配置
        	# 默认情况下，https的配置都没有开启，由于我们已经生成了自签的正式，这里就做https的ssl证书配置
        	# 如果不需要https证书，可以将以下配置注释掉
        	https:
        	  # https 的端口，443地址
        	  port: 443
        	  # 签名生成的证书的相关路径
        	  # 以下的路径请根据个人的具体情况配置
        	  certificate: /home/data/keys/harbor/hub.lpf.com.crt
        	  private_key: /home/data/keys/harbor/cert.key.pem
    
    目前我们只修改以上的配置，如果需要更多的配置，可以根据描述进行修改调整；

##### 安装Harbor #####

*  进入harbor的解压目录，找到并执行以下shell脚本  
    ![2019061111391041.png][]  
    出现以下日志，说明harbor安装成功  
    ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2x1cGVuZ2ZlaTEwMDk_size_16_color_FFFFFF_t_70 1][]

##### Harbor管理平台 #####

*  进入管理平台  
    [https://hub.lpf.com][https_hub.lpf.com]
    
     *  注意  
        由于hub.lpf.com只是做内网下的映射，这里如果使用window访问管理平台，也需要在window的hosts文件下添加一条映射记录，window的hosts的路径为：C:\\Windows\\System32\\drivers\\etc下  
        ![20190611115757949.png][]  
        ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2x1cGVuZ2ZlaTEwMDk_size_16_color_FFFFFF_t_70 2][]
     *  说明  
        **由于使用的是自签的证书，同时又使用了hosts进行了重定向，这里使用浏览器访问的时候，会出现安全提示，但是不会影响https的正常使用，这里将就一下；如果使用正规渠道下发的证书，就不会出现安全提示。**
     *  使用默认账户密码登录  
        用户名：admin  
        密 码：Harbor12345  
        以上用户名密码可以在harbor.yml配置中修改
     *  新建项目  
        ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2x1cGVuZ2ZlaTEwMDk_size_16_color_FFFFFF_t_70 3][]

#### Docker上传本地镜像仓库(HTTPS) ####

*  准备工作  
    准备另外一台服务器，作为docker的客户端，这里使用:192.168.1.208；安装好Docker，具体安装步骤上面有介绍;
 *  下载一个mysql:5.6.36版本的镜像作为测试；
    
        docker pull centos:7
    
    ![20190611130346279.png][]
 *  配置hosts文件  
    同上所述，在host加上docker服务端的ip映射；如果是真实的域名且映射了对应机器，可不做配置。
 *  添加HTTPS证书  
    创建目录
    
        mkdir -p /etc/docker/certs.d/hub.lpf.com
    
    以上hub.lpf.com为域名，可以根据个人的配置自行调整  
    将上面生成的证书root.crt拷贝只该目录  
    ![20190611134049171.png][]
 *  镜像打标签  
    给镜像打上本地服务的标签
    
        docker tag centos:7 hub.lpf.com/test/centos:7
    
    ![20190611130503982.png][]
 *  登录本地镜像仓库
    
        docker login hub.lpf.com
    
    输入Harbor管理平台的用户密码，这里使用的admin的账户  
    ![20190611130939993.png][]
 *  推送本地镜像
    
        docker push hub.lpf.com/test/centos:7
    
    ![20190611131142347.png][]  
    ![2019061113121363.png][]  
    管理中心已经可以正常看见对应的镜像文件![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2x1cGVuZ2ZlaTEwMDk_size_16_color_FFFFFF_t_70 4][]

#### Docker本地镜像下载(HTTPS) ####

*  前言  
    这里使用另外一台服务器（192.168.1.22）作为Docker客户端进行下载测试;
 *  Hosts配置  
    同上所述
 *  添加root.crt证书  
    同上面的上传服务器的添加方式宜阳
 *  登录  
    ![20190611134356307.png][]
 *  下载镜像
    
        docker pull hub.lpf.com/test/centos:7
        docker images|grep centos
    
    ![20190611134553807.png][]

#### Docker上传本地镜像仓库(HTTP) ####

*  harbor配置  
    如果没有https证书或者不想弄https，使用http的也是可以做到上传下载；由于上面安装harbor的时候已经开放了8099端口作为http的服务，这里就使用8099端口作为演示；
 *  打本地镜像标签
    
        docker tag centos:7 hub.lpf.com:8099/test/centos:7
    
    ![20190611140012688.png][]
 *  上传
    
        docker push hub.lpf.com:8099/test/centos:7
    
     *  问题  
        由于docker上传默认使用的是https，因此直接推送回报以下错误  
        ![20190611140424982.png][]
     *  解决方式  
        在/etc/docker/daemon.json的配置文件下添加授权
        
            {
              "insecure-registries":["hub.lpf.com:8099"]
            }
     *  重启docker服务
        
            systemctl restart docker
     *  测试  
        再次推送即可将镜像推送上去  
        ![20190611140903468.png][]

#### Docker本地镜像下载(HTTP) ####

*  问题描述  
    客户端使用http下载的时候，面临的问题和上传是一样的，因此，我们需要/etc/docker/daemon.json的配置文件下添加相同的配置，并重启!  
    ![20190611141245327.png][]
 *  配置后测试  
    ![20190611141416291.png][]

到此，基于Harbor的本地镜像仓库已经搭建完成，同时实现了http及https的镜像上传和下载！

[Linux_Docker]: https://blog.csdn.net/lupengfei1009/article/details/91392687
[Link 1]: https://docs.docker.com/compose/install/
[20190611085244837.png]: /images/20220120/4c8ab562577e4ba1b006408b1414d0b8.png
[Harbor Github]: https://github.com/goharbor/harbor/releases
[Link 2]: https://github.com/Fishdrowned/ssl
[SSL_https]: https://blog.csdn.net/lupengfei1009/article/details/76828190
[hub.lpf.com]: http://hub.lpf.com
[20190611104050859.png]: /images/20220120/3577bb8d4e1c4893b1af587b95e78ecd.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2x1cGVuZ2ZlaTEwMDk_size_16_color_FFFFFF_t_70]: /images/20220120/8842b242a3a144cc8895eb5b9c5cde46.png
[20190611102727436.png]: /images/20220120/de2d2f02c15b456d9df2acef5d7c2946.png
[20190611110239791.png]: /images/20220120/df8e7d91ebfa4ed594bbc37386d0c64b.png
[2019061111391041.png]: /images/20220120/62420a61fbf84ad1adf5573fc5dd95a1.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2x1cGVuZ2ZlaTEwMDk_size_16_color_FFFFFF_t_70 1]: /images/20220120/81e8e581d20d431cb0c031dfdc8c8859.png
[https_hub.lpf.com]: https://hub.lpf.com
[20190611115757949.png]: /images/20220120/4c1ab07125dc4912b258d64b1a902081.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2x1cGVuZ2ZlaTEwMDk_size_16_color_FFFFFF_t_70 2]: /images/20220120/69565f858c15413a83c870e15a032a80.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2x1cGVuZ2ZlaTEwMDk_size_16_color_FFFFFF_t_70 3]: /images/20220120/b735165aa15c4134a7a2ad387244d4f1.png
[20190611130346279.png]: /images/20220120/6c3b7288d2f44e02b978793fe893be2e.png
[20190611134049171.png]: /images/20220120/239fb6bef0734fc7b13352e0f572cf54.png
[20190611130503982.png]: /images/20220120/501e2e2ef8fa4259b9c7da2dd4a70525.png
[20190611130939993.png]: /images/20220120/cf5286045254484489ff63cd1d9fce6c.png
[20190611131142347.png]: /images/20220120/f7594ba0601d4cf5810d5416ac84e1c1.png
[2019061113121363.png]: /images/20220120/7925f8dbf0fc42ee8db45dde154d28e8.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2x1cGVuZ2ZlaTEwMDk_size_16_color_FFFFFF_t_70 4]: /images/20220120/abb30b2d5d564c8aae09e61556e62db4.png
[20190611134356307.png]: /images/20220120/f33bfab0b96b416c8f394f43406cbed8.png
[20190611134553807.png]: /images/20220120/258a1c84dddd427a9bb43abc8e0d4dc4.png
[20190611140012688.png]: /images/20220120/6ea2854a44a24211b1d506dfd529d9c0.png
[20190611140424982.png]: /images/20220120/1d039823c9524c6489ac529ca1f9d2c0.png
[20190611140903468.png]: /images/20220120/1de128ef25cc4a7fabf177aab5210121.png
[20190611141245327.png]: /images/20220120/9065275460cb4c64a7f01755913621b4.png
[20190611141416291.png]: /images/20220120/d10ea9b2a17d405b9f2f4c881d613107.png