一、harbor简介

Harbor是一个用于存储和分发Docker镜像的企业级Registry服务器，通过添加一些企业必需的功能特性，例如安全、标识和管理等，扩展了开源Docker Distribution。作为一个企业级私有Registry服务器，Harbor提供了更好的性能和安全。提升用户使用Registry构建和运行环境传输镜像的效率。Harbor支持安装在多个Registry节点的镜像资源复制，镜像全部保存在私有Registry中， 确保数据和知识产权在公司内部网络中管控。另外，Harbor也提供了高级的安全特性，诸如用户管理，访问控制和活动审计等。

特征：

1 云本机注册表：Harbour 支持容器映像和Helm图表，可用作云本机环境（如容器运行时和业务流程平台）的注册表。 2 基于角色的访问控制：用户和存储库通过“项目”进行组织，用户可以对项目下的图像拥有不同的权限。 3 基于策略的映像复制：可以基于具有多个过滤器（存储库，标记和标签）的策略在多个注册表实例之间复制（同步）映像。如果遇到任何错误，Harbor将自动重试进行复制。非常适合负载平衡，高可用性，多数据中心，混合和多云场景。 4 漏洞扫描：Harbor定期扫描图像并警告用户漏洞。 5 LDAP / AD支持：Harbor与现有企业LDAP / AD集成以进行用户身份验证和管理，并支持将LDAP组导入Harbor并为其分配适当的项目角色。 6 图像删除和垃圾收集：可以删除图像，并可以回收它们的空间。 7 公证：可以确保图像的真实性。 8 图形用户门户：用户可以轻松浏览，搜索存储库和管理项目。 9 审计：跟踪存储库的所有操作。10 RESTful API：适用于大多数管理操作的RESTful API，易于与外部系统集成。11 易于部署：提供在线和离线安装程序。　

官方文档：

github用户手册：

二、当前安装Harbor主机环境及安装要求

主机环境：

OS: CentOS Linux release 7.3.1611 (Core)mem: 2GBpython:2.7.5Base&EPEL:aliyun

硬件要求

资源	容量	描述
CPU	最小2 CPU	4 CPU是首选
内存	最小4GB	8GB是首选
磁盘	最小40GB	160GB是首选

软件要求

软件	版	描述
Python	2.7或更高版本	请注意，您可能必须在Linux发行版（Gentoo，Arch）上安装Python，默认情况下不安装Python解释器
Docker引擎	版本1.10或更高版本	有关安装说明，请参阅：：
Docker Compose	版本1.6.0或更高版本	有关安装说明，请参阅：：
OpenSSL	建议最新的	为Harbor生成证书和密钥

网络端口要求

端口	协议	描述
443	HTTPS	Harbor门户和核心API将接受此端口上的https协议请求
4443	HTTPS	只有在连接到Dock的Docker Content Trust服务启用认证时才需要
80	HTTP	Harbor端口和核心API将接受此端口上的http协议请求

根据版本的不同，可能环境要求各不相同，具体可以参官方文档：

 三、安装Harbor

1.安装docker

[root@localhost ~]#  wget https://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo -P /etc/yum.repos.d/[root@localhost ~]# yum clean all  && yum makecache fast[root@localhost ~]# yum install docker-ce -y [root@localhost ~]#systemctl enable docker && systemctl restart docker

2.安装Docker-compose

Docker-compose有两种安装方式，分别为下载源码和pip安装

下载源码安装(可以指定版本)：

1、下载指定版本的docker-compose　　[root@localhost ~]# curl -L https://github.com/docker/compose/releases/download/1.23.2/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose2、对二进制文件赋可执行权限　　[root@localhost ~]# chmod +x /usr/local/bin/docker-compose3、测试下docker-compose是否安装成功　　[root@localhost ~]#docker-compose --version

pip安装：

[root@localhost ~]# yum install python-pip -y[root@localhost ~]# pip install --upgrade pip[root@localhost ~]# pip install docker-compose #默认最新版本，可以使用 docker-compose==version指定安装版本 [root@localhost ~]# docker-compose -version docker-compose version 1.23.2, build 1110ad0

3.安装Harbor

harbor有两个版本，分别为offline(离线)和online(在线)，离线的安装包比较大，后续安装会相对快一点，在线的安装包比较下，但是后续安装会比较慢，这里我们选择离线安装

下载地址：

在指定版本的Download Binary处现在对应的安装包，复制链接

[root@localhost ~]# wget https://storage.googleapis.com/harbor-releases/release-1.7.0/harbor-offline-installer-v1.7.0.tgz #如果无法下***，可以从我的网盘中下载(链接: https://pan.baidu.com/s/1RnULNRY6ExulTI8hzejZQw 提取码: b81p)[root@localhost ~]# tar xf harbor-offline-installer-v1.7.0.tgz [root@localhost ~]# cd harbor

4.配置Harbor

解压缩之后，目录下回生成harbor.conf文件，该文件就是Harbor的配置文件。

1 ## Configuration file of Harbor 2  3 # hostname设置访问地址，可以使用ip、域名，不可以设置为127.0.0.1或localhost 4 hostname = 172.33.16.1   #需要根据实际情况手动修改 5  6 # 访问协议，默认是http，也可以设置https，如果设置https，则nginx ssl需要设置on 7 ui_url_protocol = http 8  9 # mysql数据库root用户默认密码root123，实际使用时修改下10 db_password = root12311 12 max_job_workers = 3 13 customize_crt = on14 ssl_cert = /data/cert/server.crt15 ssl_cert_key = /data/cert/server.key16 secretkey_path = /data17 admiral_url = NA18 19 # 邮件设置，发送重置密码邮件时使用20 email_identity = 21 email_server = smtp.mydomain.com22 email_server_port = 2523 email_username = sample_admin@mydomain.com24 email_password = abc25 email_from = admin 
     
      26 email_ssl = false27 28 # 启动Harbor后，管理员UI登录的密码，默认是Harbor1234529 harbor_admin_password = Harbor1234530 31 # 认证方式，这里支持多种认证方式，如LADP、本次存储、数据库认证。默认是db_auth，mysql数据库认证32 auth_mode = db_auth33 34 # LDAP认证时配置项35 #ldap_url = ldaps://ldap.mydomain.com36 #ldap_searchdn = uid=searchuser,ou=people,dc=mydomain,dc=com37 #ldap_search_pwd = password38 #ldap_basedn = ou=people,dc=mydomain,dc=com39 #ldap_filter = (objectClass=person)40 #ldap_uid = uid 41 #ldap_scope = 3 42 #ldap_timeout = 543 44 # 是否开启自注册45 self_registration = on46 47 # Token有效时间，默认30分钟48 token_expiration = 3049 50 # 用户创建项目权限控制，默认是everyone（所有人），也可以设置为adminonly（只能管理员）51 project_creation_restriction = everyone52 53 verify_remote_cert = on
     

5.启动harbor

修改完配置文件后，在的当前目录执行./install.sh，Harbor服务就会根据当期目录下的docker-compose.yml开始下载依赖的镜像，检测并按照顺序依次启动各个服务

[root@localhost harbor]# ./install.sh ......[Step 4]: starting Harbor ...Creating network "harbor_harbor" with the default driverCreating harbor-log ... doneCreating registry           ... doneCreating registryctl        ... doneCreating harbor-adminserver ... doneCreating harbor-db          ... doneCreating redis              ... doneCreating harbor-core        ... doneCreating harbor-portal      ... doneCreating harbor-jobservice  ... doneCreating nginx              ... done✔ ----Harbor has been installed and started successfully.----Now you should be able to visit the admin portal at http://172.33.16.1. For more details, please visit https://github.com/goharbor/harbor .

#后续可以使用docker-compose [start|stop] 命令在docker-compose.yml文件所在目录下来关闭和启动harbor

访问harbor，地址为我们设置的hostname，端口默认为80

点击登录

默认安装后会自动创建一个名称为library的项目，且访问级别为公开(表示任何人可读，即任何人都可以下载该项目中的镜像)

 6.命令行登录

harbor也可以在命令行下进行登录，登录后可以将本地的镜像上传到harbor，也可以下载用户拥有权限项目下的镜像，需要注意的是上传镜像的格式(docker tag  image:tag harbor-address/project name/image:tag),例如docker tag nginx:alpine 172.33.16.1/library/nginx:latest

[root@localhost harbor]# docker login 172.33.16.1  Username: adminPassword: Error response from daemon: Get https://172.33.16.1/v2/: dial tcp 172.33.16.1:443: connect: connection refused

第一次登录报错了，报这个错误可能有如下2个原因：

1、是端口错了！2、未在docker启动文件中添加--insecure-registry信任关系！大多数这个错误是第2个原因，因为你没有添加信任关系的话，docker默认使用的是https协议，所以端口不对(443)，会报连接拒绝这个错误；或者提示你 "服务器给HTTPS端的是HTTP响应" 这个错误，因为你没添加端口信任，服务器认为这是默认的https访问，返回的却是http数据！

解决方法：

正确的添加信任关系包括端口号：注：记住，这是harbor镜像仓库，而不是单纯的registry容器仓库！如果你用的是默认的80端口，则不需要加，或者加上80也行，而不是5000这个端口！[root@localhost harbor]# tee /etc/docker/daemon.json <<-'EOF'> {>   "insecure-registries": [>     "172.33.16.1"    #harbor服务主机ip，如果不是80端口，一定要把端口同时添加进去>   ]> }> EOF

再次登录

[root@localhost harbor]# systemctl daemon-reload[root@localhost harbor]# systemctl restart docker [root@localhost harbor]# docker login 172.33.16.1Username: adminPassword: WARNING! Your password will be stored unencrypted in /root/.docker/config.json.Configure a credential helper to remove this warning. Seehttps://docs.docker.com/engine/reference/commandline/login/#credentials-storeLogin Succeeded

好了，harbor安装完成，关于harbor的使用，由于篇幅有限，请参考harbor用户指南，链接如下：