Docker安装harbor

此文档需要在docker安装完成之后操作

安装docker-compose

curl方式

    curl -L https://github.com/docker/compose/releases/		download/1.22.0/docker-compose-`uname -s`-`uname -		m` -o /usr/local/bin/docker-compose
	chmod +x /usr/local/bin/docker-compose
	docker-compose -v

python-pip安装

安装附加包
```
 yum -y install epel-release
```
安装pip
```
  yum -y install python-pip
```
更新pip
```
  pip install --upgrade pip
```
安装docker-compose
```
  pip  install docker-compose
```
执行pip install docker-compose时可能会报一下错误导致安装失败

报错：Cannot uninstall ‘requests’. It is a distutils installed project and thus we cannot accurately determine which files belong to it which would lead to only a partial uninstall.

解决办法：

  pip  install docker-compose --ignore-install requests

查看版本信息
```
  docker-compose --version
```

安装Harbor

官网下载地址：https://github.com/goharbor/harbor/releases

下载Harbor安装文件

在线安装：

  $ wget https://github.com/vmware/harbor/releases/download/v1.1.2/harbor-online-installer-v1.1.2.tgz
  $ tar xvf harbor-online-installer-v1.1.2.tgz

离线安装:

  $ wget https://github.com/vmware/harbor/releases/download/v1.1.2/harbor-offline-installer-v1.1.2.tgz
  $ tar xvf harbor-offline-installer-v1.1.2.tgz

配置Harbor

解压缩后，目录下会生成harbor.cfg文件

    ## Configuration file of Harbor

	# hostname设置访问地址，可以使用ip、域名，不可以设置为127.0.0.1或localhost
	hostname = 172.16.77.71

	# 访问协议，默认是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 <sample_admin@mydomain.com>
	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

修改完配置文件后，在当前目录执行./install.sh，Harbor服务就会根据当前目录下的docker-compose.yml开始下载依赖的镜像，检测并按照顺序启动各个服务。
启动完成后，我们访问刚才设置的hostname即可：http://172.16.77.71/，默认端口是80，如果端口占用，我们可以去修改docker-compose.yml文件中，对应服务的端口映射。

登录web Harbor

输入用户名admin 默认密码(Harbor12345)或已修改密码登录系统

其他主机客户端登录连接Harbor

       docker login  -u username -p userpasswd 172.16.77.71

会报以下错误：

 Error response from daemon: Get https://172.16.77.71/v2/: dial tcp 172.16.77.71:443: connect: connection refused

解决办法：

   vim /etc/docker/daemon.json
  {
  "insecure-registries": ["172.16.77.71:5000","172.16.77.71" ]
  }
  systemctl daemon-reload
  systemctl restart docker.service

再次登录就可以了

上传镜像：

  docker tag ubuntu:latest 172.16.77.71/ubuntu
  docker push 172.16.77.71/test/ubuntu:latest

Harbor的默认镜像存储路径在/data/registry目录下，映射到docker容器里面的/storage目录下。这个参数是在docker-compose.yml中指定的，在docker-compose up -d运行之前修改。如果希望将Docker镜像存储到其他的磁盘路径，可以修改这个参数。

Harbor的服务管理

可以使用docker-compose来管理harbor的启动、停止和销毁。但注意必须切换到docker-compose.ym同级目录下运行一下命令

停止Harbor
```
 docker-compose stop
```
启动harbor
```
    docker-compose start
```

修改配置后启动

先停止harbor，再修改配置文件harbor.cfg，然后运行prepare脚本应用配置，最后重新创建harbor并运行它
  
	docker-compose down -v
  vi harbor.cfg
  prepare
  docker-compose up -d

清理harbor容器，保留镜像和容器
```
  docker-compose down -v
```
删除harbor数据库和镜像（常用于干净的重新安装）
```
  rm -rf /data/database
  rm -rf /data/registry
```
镜像删除和空间回收

Docker命令没有提供Registry镜像删除功能，日积月累，将会产生许多无用的镜像，占用大量存储空间。若要删除镜像并回收空间，需要调用docker registry API来完成，比较麻烦。Harbor提供了可视化的镜像删除界面，可以逻辑删除镜像。在维护状态下可以回收垃圾镜像的空间。在harbor web端界面对镜像进行删除。这只是逻辑删除，实际上宿主机上存放镜像的目录大小没有改变。

彻底删除无用的镜像

1、首先去界面删除该镜像

2、在Harbor宿主机上执行如下命令

  docker images vmware/registry #先找到当前registry的版本
   	       
       
 列出要删除的镜像：
      
  docker run -it --name gc --rm --volumes-from registry vmware/registry:2.6.1-photon garbage-collect --dry-run /etc/registry/config.yml
       
 注：选项--dry-run只是在最后打印出界面删除了的但是实际上并未删除的镜像层，但是这条命令不会删除这下镜像层
      
 运行下面的命令删除镜像：
      
  docker run -it --name gc --rm --volumes-from registry vmware/registry:2.6.1-photon garbage-collect  /etc/registry/config.yml
      	
 再次查看存放镜像的目录大小：
      
  du -sh /data/registry/docker/registry/v2/

Contents

安装docker-compose

安装Harbor

Harbor的服务管理