Harbor镜像仓库教程(单节点)

1.前置内容

1.1 harbor概述

众所周知，docker镜像仓库被墙了，所以部署我们私有环境内的Registry也是非常必要的。

Harbor是由VMware公司开源的企业级的Docker Registry管理项目，相比docker官方拥有更丰富的权限权利和完善的架构设计，适用大规模docker集群部署提供仓库服务。

它主要提供 Dcoker Registry 管理界面UI，可基于角色访问控制,镜像复制， AD/LDAP 集成，日志审核等功能，完全的支持中文。

1.2 harbor主要功能

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

● 基于镜像的复制策略
	镜像可以在多个Registry实例中复制（可以将仓库中的镜像同步到远程的Harbor，类似于MySQL主从同步功能），尤其适合于负载均 衡，高可用，混合云和多云的场景。

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

● 支持 AD/LDAP
	Harbor可以集成企业内部已有的AD/LDAP，用于鉴权认证管理。

● 镜像删除和垃圾回收
	Harbor支持在Web删除镜像，回收无用的镜像，释放磁盘空间。image可以被删除并且回收image占用的空间。

● 审计管理
	所有针对镜像仓库的操作都可以被记录追溯，用于审计管理。

● RESTful API
	RESTful API 提供给管理员对于Harbor更多的操控, 使得与其它管理软件集成变得更容易。

● 部署简单
	提供在线和离线两种安装工具， 也可以安装到vSphere平台(OVA方式)虚拟设备。

架构组件图：

如上图所描述，Harbor由6个大的模块所组成：

        1、Proxy: Harbor的registry、UI、token services等组件，都处在一个反向代理后边。该代理将来自浏览器、docker clients的请求转发到后端服务上。

        2、Registry: 负责存储Docker镜像，以及处理Docker push/pull请求。因为Harbor强制要求对镜像的访问做权限控制， 在每一次push/pull请求时，Registry会强制要求客户端从token service那里获得一个有效的token。

        3、Core services: Harbor的核心功能，主要包括如下3个服务:

                UI：图形界面
                WebHook：及时获取registry上image状态变化情况，在registry上配置 webhook，把状态变化传递给UI模块。
                Token服务：负责根据用户权限给每个docker push/pull命令签发token。Docker 客户端向Registry服务发起的请求,如果不包含token，会被重定向到这里，获得token后再重新向Registry进行请求。

        4、**Database：**为core services提供数据库服务，负责储存用户权限、审计日志、Docker image分组信息等数据。

        5、Job services: 主要用于镜像复制，本地镜像可以被同步到远程Harbor实例上。

        6、Log collector: 负责收集其他组件的日志到一个地方

2.docker

#卸载旧版本Docker
sudo yum remove docker \
                  docker-client \
                  docker-client-latest \
                  docker-common \
                  docker-latest \
                  docker-latest-logrotate \
                  docker-logrotate \
                  docker-engine

#yum 安装 gcc 相关：
yum -y install gcc
yum -y install gcc-c++

#安装所需要的软件包：
yum -y install yum-utils

#设置 stable 镜像仓库：
yum-config-manager --add-repo https://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo

#更新 yum 软件包索引：
yum makecache fast

#安装指定版本的 Docker（v20.10） ：
yum -y install docker-ce-3:20.10.8-3.el7.x86_64 docker-ce-cli-1:20.10.8-3.el7.x86_64 containerd.io

# 启动 Docker 
systemctl start docker

# 开启自动启动
systemctl enable docker

#配置阿里云镜像加速：
sudo mkdir -p /etc/docker

tee /etc/docker/daemon.json <<-'EOF'
{
  "exec-opts": ["native.cgroupdriver=systemd"],	
  "registry-mirrors": [
    "https://du3ia00u.mirror.aliyuncs.com",
    "https://hub-mirror.c.163.com",
    "https://mirror.baidubce.com",
    "https://registry.docker-cn.com",
    "https://docker.mirrors.sjtug.sjtu.edu.cn"
  ],
  "live-restore": true,
  "log-driver":"json-file",
  "log-opts": {"max-size":"500m", "max-file":"3"},
  "max-concurrent-downloads": 10,
  "max-concurrent-uploads": 5,
  "storage-driver": "overlay2"
}
EOF

sudo systemctl daemon-reload

sudo systemctl restart docker

3.docker-compose

3.1 安装docker-compose

//安装docker-compose工具
[root@120 docker-compose]# curl -L "https://get.daocloud.io/docker/compose/releases/download/v1.25.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

[root@120 docker-compose]# chmod +x /usr/local/bin/docker-compose

[root@120 docker-compose]# docker --version
Docker version 20.10.8, build 3967b7d

[root@120 docker-compose]# docker-compose version
Docker Compose version v2.28.0
[root@120 docker-compose]# 

如果拉不下来，可以先科学上网，下载下来放到服务器上，然后软连接过去。

3.2 docker-compose基础命令

docker-compose up	//启动所有服务，默认读取名为docker-compose.yml文件

docker-compose up -d	//在后台启动所有服务

docker-compose build 	//在运行项目前先构建项目所需镜像

docker-compose ps	//列出本地docker-compose.yml文件里定义的正在运行的所有服务

docker-compose stop	//停止所有服务，如果服务没有停止，可以使用docker-compose kill强制杀死服务

docker-compose start	//开启所有服务

docker-compose rm	//删除所有服务

4.harbor

4.1 下载离线安装包

//下载地址
https://github.com/goharbor/harbor/tags
 
//我下载的是
https://github.com/goharbor/harbor/releases/download/v2.10.3/harbor-offline-installer-v2.10.3.tgz

//解压缩
tar -zxvf harbor-offline-installer-v2.10.3.tgz

4.2 修改配置文件

//拷贝模板文件
cp harbor.yml.tmpl harbor.yml

//修改配置文件
vim harbor.yml

      5 hostname: 101.43.4.210           //仓库地址改为自己的IP
      6 
      8 http:
     
     10   port: 80                    //对外暴露端口
     
     11 
     12 # https related config
     13 #https:                         //https我们这里不用全都注释掉
     14   # https port for harbor, default is 443
     15 #  port: 443
     16   # The path of cert and key files for nginx
     17 #  certificate: /your/certificate/path
     18 #  private_key: /your/private/key/path
     
     
     
     47 data_volume: /data           //仓库数据存储目录，根据自己需求修改
                                     //仓库大多情况下都是独立的一台或多台主从服务器

4.3 安装

sh install.sh

4.4 访问harbor页面

http://192.168.255.120:80
 
//默认登陆
admin
Harbor12345

4.5 配置node节点镜像私有仓库地址

vim /etc/docker/daemon.json

修改后
{
   "registry-mirrors": ["https://yxzrazem.mirror.aliyuncs.com"],
   "insecure-registries": ["http://192.168.255.120:80"] # 新增 insecure-registries
}

重载服务

systemctl daemon-reload
systemctl restart docker

如果node主机和harbor仓库是同一台主机，重启docker后harbor仓库就登不上了，需要重启下harbor

//切换到harbor目录
cd harbor

//重启harbor
docker-compose down -v && docker-compose up -d

4.6 部署harbor开机自启

[root@120 ~]# vim /etc/rc.local
#!/bin/bash
cd /usr/local/harbor		//添加这行与下面一行
docker-compose start
[root@120 ~]# ll /etc/rc.local
lrwxrwxrwx. 1 root root 13 Oct  5  2024 /etc/rc.local -> rc.d/rc.local

[root@120 ~]# ll /etc/rc.d/rc.local
-rw-r--r--. 1 root root 516 Aug 11 21:17 /etc/rc.d/rc.local		//默认该文件无执行权限，需添加执行权限

//添加执行权限，否则该文件无法生效
[root@120 ~]# chmod +x /etc/rc.d/rc.local

//重启主机验证配置的开机自启harbor的效果
[root@120 ~]# reboot

4.7 harbor使用教程

//修改harbor.cfg配置文件需要重新生成容器，重新执行
./install.sh

//重新启动
docker-compose down -v && docker-compose up -d

//harbor日志存储目录 (Harbor核心服务不可用时，先查看日志：core.log)
cd /var/log/harbor 

//登入harbor
docker login -u admin -p Harbor12345  192.168.255.120:80
    
//打包已有镜像为新的镜像   
docker tag prom/prometheus  192.168.255.120:80/demo/prometheus:v1.0

//上传镜像  
docker push  192.168.255.120:80/demo/prometheus:v1.0

//其他节点可拉取
docker pull  192.168.255.120:80/demo/prometheus:v1.0