简介
Harbor是VMware公司开源的企业级DockerRegistry项目,其目标是帮助用户迅速搭建一个企业级的Dockerregistry服务。 它以Docker公司开源的registry为基础,提供了管理UI,基于角色的访问控制(Role Based Access Control),AD/LDAP集成、以及审计日志(Auditlogging) 等企业用户需求的功能,同时还原生支持中文。
简单说来,Harbor封装了Docker的registry v2,帮用户提供了许多便捷管理的特性,方便用户操作。
环境准备:
- Docker
- Docker-compose
- Harbor
注意:Harbor的所有服务组件都是在Docker中部署的,所以官方安装使用Docker-compose快速部署,所以我们需要安装Docker、Docker-compose。由于Harbor是基于Docker Registry V2版本,所以就要求Docker版本不小于1.10.0,Docker-compose版本不小于1.6.0。
Docker-compose是一个定义和运行多个Docker应用的工具,你可以使用YMAL文件来配置你的服务,然后使用docker-compose命令,创建和启动所有你配置的的服务。
安装docker
1. sudo apt-get update
#安装CA证书,支持Https:
2. sudo apt-get install apt-transport-https ca-certificates curl software-properties-common
#添加一个官方的GPG密钥
3. curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
#验证密钥指纹:
4. sudo apt-key fingerprint 0EBFCD88
输出的是:9DC8 5822 9FC7 DD38 854A E2D8 8D81 803C 0EBF CD88 即正确。
5.
1. sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
6. sudo apt-get update
7. sudo apt-get install docker-ce
创建一个docker组,防止每次都要用sudo命令执行docker命令:
8. sudo groupadd docker
将该用户加入到组内:
9. sudo gpasswd -a ${USER} docker
重启docker
10. sudo service docker restart
下载并解压安装包
下载地址:https://github.com/goharbor/harbor/releases
解压:tar -zxvf harbor-offline-installer-v1.6.1.tgz
安装docker-compose
#apt install docker-compose
两种安装方式:
1.从github上下载docker-compose二进制文件安装
下载最新版的docker-compose文件
$ sudo curl -L https://github.com/docker/compose/releases/download/1.16.1/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose
添加可执行权限
$ sudo chmod +x /usr/local/bin/docker-compose
测试安装结果
$ docker-compose --version
docker-compose version 1.16.1, build 1719ceb
2.pip安装
$ sudo pip install docker-compose
查看版本:docker-compose --version
修改配置
解压缩之后,进入目录下会看到 harbor.cfg 文件,该文件就是 Harbor 的配置文件。
## Configuration file of Harbor
# hostname设置访问地址,可以使用ip、域名,不可以设置为127.0.0.1或localhost
hostname = 192.168.1.131
# 访问协议,默认是http,也可以设置https,如果设置https,则nginx ssl需要设置on
ui_url_protocol = http
# mysql数据库root用户默认密码root123,实际使用时修改下
db_password = root123
max_job_workers = 3
customize_crt = on
ssl_cert = /data/cert/server.crt
ssl_cert_key = /data/cert/server.key
secretkey_path = /data
admiral_url = NA
# 邮件设置,发送重置密码邮件时使用
email_identity =
email_server = smtp.mydomain.com
email_server_port = 25
email_username = sample_admin@mydomain.com
email_password = abc
email_from = admin
email_ssl = false
# 启动Harbor后,管理员UI登录的密码,默认是Harbor12345
harbor_admin_password = Harbor12345
# 认证方式,这里支持多种认证方式,如LADP、本次存储、数据库认证。默认是db_auth,mysql数据库认证
auth_mode = db_auth
# LDAP认证时配置项
#ldap_url = ldaps://ldap.mydomain.com
#ldap_searchdn = uid=searchuser,ou=people,dc=mydomain,dc=com
#ldap_search_pwd = password
#ldap_basedn = ou=people,dc=mydomain,dc=com
#ldap_filter = (objectClass=person)
#ldap_uid = uid
#ldap_scope = 3
#ldap_timeout = 5
# 是否开启自注册
self_registration = on
# Token有效时间,默认30分钟
token_expiration = 30
# 用户创建项目权限控制,默认是everyone(所有人),也可以设置为adminonly(只能管理员)
project_creation_restriction = everyone
verify_remote_cert = on
- harbor_admin_password: 用于设置Harbor admin用户的初始密码,只在Harbor第一次启动时有效。在Harbor第一次启动之后,修改本字段是无效的。如果第一次启动后,要修改Harbor admin密码,请通过WebUI来进行修改。
- 邮箱设置公司邮箱会报504 网关超时
修改完配置文件以后 运行./prepare脚本更新配置, 出现如下信息表示 更新完毕.
启动 Harbor
修改完配置文件后,在的当前目录执行./install.sh,Harbor服务就会根据当期目录下的docker-compose.yml开始下载依赖的镜像,检测并按照顺序依次启动各个服务。Harbor依赖的镜像及启动服务如下:
启动完成后,我们访问刚设置的hostname即可 http://192.168.1.131,默认是80端口,如果端口占用,我们可以去修改docker-compose.yml文件中,对应服务的端口映射。
用户名:admin 密码:Csizg12345
我们可以看到系统各个模块如下:
项目:新增/删除项目,查看镜像仓库,给项目添加成员、查看操作日志、复制项目等
日志:仓库各个镜像create、push、pull等操作日志
系统管理
用户管理:新增/删除用户、设置管理员等
复制管理:新增/删除从库目标、新建/删除/启停复制规则等
配置管理:认证模式、复制、邮箱设置、系统设置等
其他设置
用户设置:修改用户名、邮箱、名称信息
修改密码:修改用户密码
注意:非系统管理员用户登录,只能看到有权限的项目和日志,其他模块不可见。
新建项目
我们新建一个名称为csizg_iot的项目,设置不公开。注意:当项目设为公开后,任何人都有此项目下镜像的读权限。命令行用户不需要“docker login”就可以拉取此项目下的镜像。
新建项目完毕后,我们就可以用admin账户提交本地镜像到Harbor仓库了。例如我们提交本地nginx镜像:
1)admin登录
docker login 192.168.1.131 输入用户名admin、密码Harbor12345
或者:docker login -u admin -p Harbor12345 192.168.1.131
报错:Error response from daemon: Get https://192.168.1.131/v2/: dial tcp 192.168.1.131:443: connect: connection refused
这是因为docker1.3.2版本开始默认docker registry使用的是https,我们设置Harbor默认http方式,所以当执行用docker login、pull、push等命令操作非https的docker regsitry的时就会报错
解决方式:
1.修改docker配置文件
nano /etc/docker/daemon.json
"insecure-registries": [], #这个私库的服务地址
"registry-mirrors": [], #私库加速器
修改为
{
"insecure-registries": ["192.168.1.131"]
}
重启Docker
sudo service docker restart
2.sudo nano /etc/default/docker
增加以下一行:
DOCKER_OPTS="$DOCKER_OPTS --insecure-registry=192.168.1.131"
重启Docker
sudo service docker restart
3.修改配置文件/lib/systemd/system/docker.service,修改[Service]下ExecStart参数,增加–insecure-registry 192.168.1.131
2)上传镜像
从docker hub拉取镜像:docker pull nginx
然后为该镜像打上新的标签,标签格式为:Harbor地址/项目名/镜像名称:镜像标签,如:
docker tag nginx 192.168.1.131/csizg_iot/nginx:latest
push我们的镜像到Harbor仓库中:docker push 192.168.1.131/csizg_iot/nginx:latest