docker 仓库-Harbor

docker 仓库之分布式 Harbor：

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

https://github.com/vmware/harbor

 

Harbor 功能介绍：

基于角色的访问控制：用户与docker镜像仓库通过"项目" 进行组织管理，一个用户可以对多个镜像仓库在同一命名空间（project）里有不通的权限。

镜像复制：镜像可以在多个Registry实例中复制（同步）。尤其适合于负载均衡，高可用，混合云和多云的场景。

图形化用户界面：用户可以通过浏览器来流量，检索当前docker镜像仓库，管理项目和命名空间。

AD/LDAP 支：Harbor 可以集成企业内部已有的AD/LDAP，用于鉴权认证管理。审计管理：所有针对镜像仓库的操作都可以被记录追溯，用于审计管理。国际化：已拥有英文、中文、德文、日文和俄文的本机化版本。更多的语言将会添加进来。

RESTful API - RESTful API ：提供给管理员对于 Harbor 更多的操控, 使得与其它管 理软件集成变得更容易。 部署简单：提供在线和离线两种安装工具， 也可以安装到 vSphere 平台(OVA 方 式)虚拟设备。

 

安装Harbor ：

首先安装docker服务：

yum install -y yum-utils device-mapper-persistent-data lvm2
yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo
选择版本进行安装，不选择版本默认安装最新版本的docker 19.03
yum install -y docker-ce-18.06.2.ce

// 启动docker（启动后会自动生成/etc/docker目录，否则需要手动创建）
systemctl start docker && systemctl enable docker
yum makecache

下载 Harbor安装包：

cd /usr/local/src
wget https://github.com/vmware/harbor/releases/download/v1.2.2/harbor-offlineinstaller-v1.2.2.tgz 

解压及安装全过程：

 tar xf harbor-offline-installer-v1.6.3.tgz
 #ln -sv /usr/local/src/harbor /usr/local/harbor
 mv harbor /usr/local/
 cd harbor

将harbor文件中的hostname段改写为自己的本机IP（也就是harbor服务IP）

安装docker-compose:

yum install epel-release -y
yum install python-pip -y
yum install docker-compose -y
rpm -qa|grep docker-compose
docker-compose version

#docker 默认是https加密方式访问，所有加上以下内容：
cat > /etc/docker/daemon.json <<EOF
{
"insecure-registries":["192.168.1.25"]
}
EOF

创建https证书以及配置相关目录权限（可选做）

mkdir /data/cert
#生成密钥key
openssl genrsa -des3 -out server.key 2048
#创建证书请求，server.csr
openssl req -new -key server.key -out server.csr
#备份以下密钥
cp server.key server.key.org
#转换成证书，退出密码
openssl rsa -in server.key.org -out server.key
#证书请求签名
openssl x509 -req -days 365 -in server.csr -signkey server.key -out server.crt

chmod -R 777 /data/cert

安装：
./install
启动：
docker-compose start

到这里已经安装完成了harbor, 登录测试: 192.168.1.x默认端口80访问，用户：admin 密码：Harbor12345 默认harbor配置文件中设置的密码，可以自己改写：

harbor.cfg配置文件详解：

原来没注释的参数不要注释掉，否则下边一步不通过。留默认即可
hostname：配置主机名称，不可以设置127.0.0.1，localhost这样的主机名，可以是IP或者域名
ui_url_protocol：指定使用HTTP协议还是HTTPS协议
Email settings：邮箱设置，option配置，只在首次启动生效，可以登陆UI后修改
harbor_admin_password：设置管理员的初始密码，只在第一次登录时使用
auth_mode：用户认证模式，默认是db_auth,也可以使用ldap_auth验证。
db_password：使用db需要指定连接数据库的密码
self_registration：是否允许自行注册用户，默认是on,新版本可以在图形界面中修改。
max_job_workers：最大工作数，默认是10个
customize_crt：是否为token生成证书，默认为on
ssl_cert：nginx cert与key文件的路径, 只有采用https协议是才有意义
ssl_cert：nginx cert与key文件的路径, 只有采用https协议是才有意义
secretkey_path：The path of secretkey storage
admiral_url：Admiral's url, comment this attribute, or set its value to NA when Harbor is standalone
clair_db_password：未启用calir服务，但解压目录下的"./prepare"文件中要检查以下相关参数配置，不能注释，否则环境准备检查不能通过，报"ConfigParser.NoOptionError: No option u'clair_db_password' in section: u'configuration' "相关错误；或者在"./prepare"中注释相关检查与定义，但需要注意，文件中的关联太多，推荐修改"harbor.cfg"文件即可
ldap_url：ladp相关设置，如未采用ldap认证，但解压目录下的"./prepare"文件中要检查以下相关参数配置，不能注释，否则环境准备检查不能通过，报"ConfigParser.NoOptionError: No option u'ldap_timeout' in section: u'configuration' "相关错误；或者在"./prepare"中注释相关检查与定义，但需要注意，文件中的关联太多，推荐修改"harbor.cfg"文件即可
ldap_scope：
self_registration：默认开启自注册，off为关闭
token_expiration：token有效时间，默认30minutes
project_creation_restriction：创建项目权限控制，默认是"everyone"(所有人)，可设置为"adminonly"(管理员)
verify_remote_cert：与远程registry通信时是否采用验证ssl
其他使用默认值

安装Harbor 时报错解决 ：

上传下载镜像：

cat > /etc/docker/daemon.json <<EOF
{
"insecure-registries":["192.168.1.25"]
}
EOF

尝试登录：
[root@8s-etcd harbor]# docker login 192.168.1.25
Username: admin
Password:
Login Succeeded
注意每次push前需docker login 192.168.1.79确认是否已经登录了私有仓库，
push后需登出私有仓库。
如果push到公共项目必须登录admin账号才可以

上传镜像：
docker tag  6e30b06a90d3  192.168.1.25/xxx/tomcat-bbs
docker push 192.168.1.25/xxx/tomcat-bbs
下载镜像：
docker pull 192.168.1.25/xxx/tomcat-bbs

xxx是harbor种创建的项目