Harbor企业级私服Docker镜像仓库搭建

Harbor 简介

什么是Harbor

  • Harbor 是 VMware 公司开源的企业级 Docker Registry 项目,其目标是帮助用户迅速搭建一个企业级的 Docker Registry (私有仓库)服务。
  • Harbor以 Docker 公司开源的 Registry 为基础,提供了图形管理 UI 、基于角色的访问控制(Role Based AccessControl) 、AD/LDAP 集成、以及审计日志(Auditlogging) 等企业用户需求的功能,同时还原生支持中文。
  • Harbor 的每个组件都是以 Docker 容器的形式构建的,使用 docker-compose 来对它进行部署。用于部署 Harbor 的 docker-compose 模板位于 harbor/docker-compose.yml。

Harbor的特性

  • 基于角色控制:用户和仓库都是基于项目进行组织的,而用户在项目中可以拥有不同的权限。
  • 基于镜像的复制策略:镜像可以在多个Harbor实例之间进行复制(同步)。
  • 支持 LDAP/AD:Harbor 可以集成企业内部已有的 AD/LDAP(类似数据库的一张表),用于对已经存在的用户认证和管理。
  • 镜像删除和垃圾回收:镜像可以被删除,也可以回收镜像占用的空间。
  • 图形化用户界面:用户可以通过浏览器来浏览,搜索镜像仓库以及对项目进行管理。
  • 审计管理:所有针对镜像仓库的操作都可以被记录追溯,用于审计管理。
  • 支持 RESTful API:RESTful API 提供给管理员对于 Harbor 更多的操控, 使得与其它管理软件集成变得更容易。
  • Harbor和docker registry的关系:Harbor实质上是对docker registry做了封装,扩展了自己的业务模板。

Harbor的构成

  Harbor 在架构上主要有 Proxy、Registry、Core services、Database(Harbor-db)、Log collector(Harbor-log)、Job services 六个组件。

  • Proxy: 是一个 nginx 的前端代理,Harbor 的 Registry、UI、Token 服务等组件,都处在 nginx 反向代理后边。 该代理将来自浏览器、docker clients 的请求转发到后端不同的服务上。
  • Registry: 负责储存 Docker 镜像,并处理 Docker push/pull 命令。由于要对用户进行访问控制,即不同用户对 Docker 镜像 有不同的读写权限,Registry 会指向一个 Token 服务,强制用户的每次 Docker pull/push 请求都要携带一个合法的 Token, Registry 会通过公钥对 Token 进行解密验证。
  • Core services: Harbor的核心功能,主要提供以下3个服务:
    • UI(harbor-ui): 提供图形化界面,帮助用户管理 Registry 上的镜像(image), 并对用户进行授权。
    • WebHook:为了及时获取Registry 上image 状态变化的情况,在Registry 上配置 Webhook,把状态变化传递给 UI 模块。
    • Token 服务:负责根据用户权限给每个 Docker push/pull 命令签发 Token。Docker 客户端向 Registry 服务发起的请求, 如果不包含 Token,会被重定向到 Token 服务,获得 Token 后再重新向 Registry 进行请求。
  • Database(harbor-db):为core services提供数据库服务,负责储存用户权限、审计日志、Docker 镜像分组信息等数据。
  • Job services: 主要用于镜像复制,本地镜像可以被同步到远程 Harbor 实例上。
  • Log collector(harbor-log): 负责收集其他组件的日志到一个地方。

  Harbor 的每个组件都是以 Docker 容器的形式构建的,因此,使用 Docker Compose 来对它进行部署。
  总共分为7个容器运行,通过在docker-compose.yml所在目录中执行 docker-compose ps 命令来查看, 名称分别为:nginx、harbor-jobservice、harbor-ui、harbor-db、harbor-adminserver、registry、harbor-log。
  其中 harbor-adminserver 主要是作为一个后端的配置数据管理,并没有太多的其他功能。harbor-ui 所要操作的所有数据都通过 harbor-adminserver 这样一个数据配置管理中心来完成。

Harbor 部署

安装docker

#安装需要的安装包
yum install -y yum-utils
#设置镜像仓库为阿里云的
yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo
#更新yum索引安装包
yum makecache fast
#安装docker
yum install docker-ce docker-ce-cli containerd.io 
#启动docker,设置docker开机启动
systemctl start docker && systemctl enable docker

安装docker-compose

curl -L https://get.daocloud.io/docker/compose/releases/download/2.11.2/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

部署 Harbor 服务

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

下载或上传 Harbor 安装程序
# Harbor的压缩包下载地址:https://github.com/goharbor/harbor/releases
wget https://github.com/goharbor/harbor/releases/download/v2.6.1/harbor-offline-installer-v2.6.1.tgz
tar -zxvf harbor-offline-installer-v2.6.1.tgz -C /usr/local/
修改harbor安装的配置文件
cd /usr/local/harbor

cp harbor.yml.tmpl harbor.yml
vi /usr/local/harbor/harbor.yml

--5行--修改,设置为Harbor服务器的IP地址或者域名
hostname = 192.168.3.202
--10行--修改-端口
port = 82
--13行--https的注释掉,局域网下不需要
#https:
   # https port for harbor, default is 443
  # port: 443
   # The path of cert and key files for nginx
  # certificate: /your/certificate/path
  # private_key: /your/private/key/path
--59行--指定管理员的初始密码,默认的用户名/密码是admin/Harbor12345
harbor_admin_password = Harbor12345

# mkdir /var/harbor   chmod -R 750 /var/harbor
data_volume: /var/harbor

:wq!
安装 Harbor
./install.sh 
#以 pull (获取)镜像并启动容器

  安装之后生成docker-compose.yml

bash脚本一键安装(可选)
#!/bin/bash

# 常量设置
harbor_version="2.9.0" # harbor版本
install_path="/usr/local" # 安装、操作目录
server_ip="192.168.0.88" # 服务ip
server_port="8888" # 服务端口
data_path="/var/harbor" # 数据保存目录
data_path2="\/var\/harbor" # 数据保存目录


# 下载harbor源码包,如果下载过慢,注释下面几行代码
echo "......正在下载源码包......"
wget -P ${install_path} wget https://github.com/goharbor/harbor/releases/download/v${harbor_version}/harbor-offline-installer-v${harbor_version}.tgz
echo "......源码包下载完成......"

# 解压缩
echo "......正在解压缩源码包......"
cd ${install_path}
tar -zxf ${install_path}/harbor-offline-installer-v${harbor_version}.tgz
echo "......源码包解压缩完成......"

# 创建数据目录
mkdir ${data_path}
chmod -R 750 ${data_path}

# 配置文件
echo "......正在修改配置文件......"
## 复制配置文件
cp ${install_path}/harbor/harbor.yml.tmpl ${install_path}/harbor/harbor.yml
## 调整配置文件
sed -i 's/data_volume: \/data/data_volume: '"$data_path2"'/g' ${install_path}/harbor/harbor.yml
sed -i 's/hostname: reg.mydomain.com/hostname: '"$server_ip"'/g' ${install_path}/harbor/harbor.yml
sed -i 's/https:/# https:/g' ${install_path}/harbor/harbor.yml
sed -i 's/certificate:/# certificate:/g' ${install_path}/harbor/harbor.yml
sed -i 's/private_key:/# private_key:/g' ${install_path}/harbor/harbor.yml
sed -i 's/port: 443/# port: 443/g' ${install_path}/harbor/harbor.yml
echo "......修改配置文件完成......"
## 启动
/usr/local/harbor/install.sh

echo "......!!!脚本运行完成!!!......"
查看 Harbor 启动镜像
cd /usr/local/harbor

docker compose ps
镜像控制
docker-compose up -d      #后台启动
docker-compose stop       #停止
docker-compose restart    #重新启动

登录 Harbor WEB UI 界面

  安装完成,输入地址http://192.168.3.202:82

  到这里harbor镜像仓库就搭好了,下面演示怎么用镜像仓库。

开机启动

  vi /etc/systemd/system/harbor.service

[Unit]
Description=Harbor service
Requires=docker.service
After=docker.service

[Service]
Type=simple
Restart=always
WorkingDirectory=/harbor //改成你的harbor路径
ExecStart=/usr/local/bin/docker-compose up //改成你的docker-compost路径

[Install]
WantedBy=multi-user.target

  设置开机启动和启动

sudo systemctl enable harbor.service
sudo systemctl start harbor.service

  重启服务器测试

Harbor 镜像仓库使用

新建项目

配置Docker私有镜像仓库

  项目建好了,如何推送呢,首先推送的服务器要修改本机的配置文件并重启docker,注意重启docker前先重新加载配置文件。

vi /etc/docker/daemon.json

  添加 "insecure-registries":[harbor地址:端口]

{
        "insecure-registries":["192.168.3.202:82"]
}

  重启docker

[root@localhost docker]# systemctl daemon-reload
[root@localhost docker]# systemctl restart docker

登录 Harbor 私有镜像仓库

  登陆docker仓库 ,docker login<harbor所在服务器ip>:<端口>

docker login http://192.168.3.202:82
docker login -u admin -p Harbor12345 http://192.168.3.202:82 

下载镜像进行推送测试

docker pull nginx

docker tag nginx:latest 192.168.3.202:82/xiaosige/nginx:gb

docker push 192.168.3.202:82/xiaosige/nginx:gb

docker pull 192.168.3.202:82/xiaosige/nginx:gb

docker logout 192.168.3.202

PS

harbor部署(docker hub)+bash一键安装