此文档需要在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/