kubeasz/docs/guide/harbor.md

6.8 KiB
Raw Blame History

harbor

Habor是由VMWare中国团队开源的容器镜像仓库。事实上Habor是在Docker Registry上进行了相应的企业级扩展从而获得了更加广泛的应用这些新的企业级特性包括管理用户界面基于角色的访问控制 水平扩展同步AD/LDAP集成以及审计日志等。本文档仅说明部署单个基础harbor服务的步骤。

安装步骤

  1. 在deploy节点下载最新的 docker-compose 二进制文件,改名后把它放到项目 /etc/ansible/bin目录下(百度云的二进制文件中已包含)
wget https://github.com/docker/compose/releases/download/1.18.0/docker-compose-Linux-x86_64
mv docker-compose-Linux-x86_64 /etc/ansible/bin/docker-compose
  1. 在deploy节点下载最新的 harbor 离线安装包,把它放到项目 /etc/ansible/down 目录下,也可以从分享的百度云盘下载

  2. 由于ansible解压的一些问题需要将官方的tgz包重新打包为zip包

  3. 在deploy节点编辑/etc/ansible/hosts文件可以参考 example目录下的模板,修改部分举例如下

# 参数 NEW_INSTALL=(yes/no)yes表示新建 harbor并配置k8s节点的docker可以使用harbor仓库
# no 表示仅配置k8s节点的docker使用已有的harbor仓库
[harbor]
#192.168.1.8 HARBOR_DOMAIN="harbor.yourdomain.com" NEW_INSTALL=no
  1. 在deploy节点执行 ansible-playbook /etc/ansible/11.harbor.yml完成harbor安装和docker 客户端配置

安装讲解

根据 11.harbor.yml文件harbor节点需要以下步骤

  1. role prepare 基础系统环境准备
  2. role docker 安装docker
  3. role harbor 安装harbor

kube-node节点在harbor部署完之后需要配置harbor的证书并可以在hosts里面添加harbor的域名解析如果你的环境中有dns服务器可以跳过hosts文件设置

请在另外窗口打开 roles/harbor/tasks/main.yml,对照以下讲解

  1. 下载docker-compose可执行文件到$PATH目录
  2. 自注册变量result判断是否已经安装harbor避免重复安装问题
  3. 解压harbor离线安装包到指定目录
  4. 导入harbor所需 docker images
  5. 创建harbor证书和私钥(复用集群的CA证书)
  6. 修改harbor.cfg配置文件
  7. 启动harbor安装脚本

验证harbor

  1. 在harbor节点使用docker ps -a 查看harbor容器组件运行情况
  2. 浏览器访问harbor节点的IP地址 https://$NodeIP,使用账号 admin 和 密码 Harbor12345 (harbor.cfg 配置文件中的默认)登陆系统

在k8s集群使用harbor

admin用户web登陆后可以方便的创建项目并指定项目属性(公开或者私有);然后创建用户,并在项目成员选项中选择用户和权限;

镜像上传

在node上使用harbor私有镜像仓库首先需要在指定目录配置harbor的CA证书详见 11.harbor.yml文件。

使用docker客户端登陆harbor.test.com然后把镜像tag成 harbor.test.com/$项目名/$镜像名:$TAG 之后即可使用docker push 上传

docker login harbor.test.com
Username: 
Password:
Login Succeeded
docker tag busybox:latest harbor.test.com/library/busybox:latest
docker push harbor.test.com/library/busybox:latest
The push refers to a repository [harbor.test.com/library/busybox]
0271b8eebde3: Pushed 
latest: digest: sha256:91ef6c1c52b166be02645b8efee30d1ee65362024f7da41c404681561734c465 size: 527

k8s中使用harbor

  1. 如果镜像保存在harbor中的公开项目中那么只需要在yaml文件中简单指定harbor私有镜像即可例如
apiVersion: v1
kind: Pod
metadata:
  name: test-busybox
spec:
  containers:
  - name: test-busybox
    image: harbor.test.com/xxx/busybox:latest
    imagePullPolicy: Always
  1. 如果镜像保存在harbor中的私有项目中那么yaml文件中使用该私有项目的镜像需要指定imagePullSecrets,例如
apiVersion: v1
kind: Pod
metadata:
  name: test-busybox
spec:
  containers:
  - name: test-busybox
    image: harbor.test.com/xxx/busybox:latest
    imagePullPolicy: Always
  imagePullSecrets:
  - name: harborkey1

其中 harborKey1可以用以下两种方式生成:

  • 1.使用 kubectl create secret docker-registry harborkey1 --docker-server=harbor.test.com --docker-username=admin --docker-password=Harbor12345 --docker-email=team@test.com
  • 2.使用yaml配置文件生成
//harborkey1.yaml
apiVersion: v1
kind: Secret
metadata:
  name: harborkey1
  namespace: default
data:
    .dockerconfigjson: {base64 -w 0 ~/.docker/config.json}
type: kubernetes.io/dockerconfigjson

前面docker login会在~/.docker下面创建一个config.json文件保存鉴权串这里secret yaml的.dockerconfigjson后面的数据就是那个json文件的base64编码输出-w 0让base64输出在单行上避免折行

管理harbor

  • 日志目录 /var/log/harbor
  • 数据目录 /data ,其中最主要是 /data/database/data/registry 目录如果你要彻底重新安装harbor删除这两个目录即可

先进入harbor安装目录 cd /data/harbor,常规操作如下:

  1. 暂停harbor docker-compose stop : docker容器stop并不删除容器
  2. 恢复harbor docker-compose start : 恢复docker容器运行
  3. 停止harbor docker-compose down -v : 停止并删除docker容器
  4. 启动harbor docker-compose up -d : 启动所有docker容器

修改harbor的运行配置需要如下步骤

# 停止 harbor
 docker-compose down -v
# 修改配置
 vim harbor.cfg
# 执行./prepare已更新配置到docker-compose.yml文件
 ./prepare
# 启动 harbor
 docker-compose up -d

harbor 升级

以下步骤基于harbor 1.1.2 版本升级到 1.2.2版本

# 进入harbor解压缩后的目录停止harbor
cd /data/harbor
docker-compose down

# 备份这个目录
cd ..
mkdir -p /backup && mv harbor /backup/harbor

# 下载更新的离线安装包,并解压
tar zxvf harbor-offline-installer-v1.2.2.tgz  -C /data

# 使用官方数据库迁移工具,备份数据库,修改数据库连接用户和密码,创建数据库备份目录
# 迁移工具使用docker镜像镜像tag由待升级到目标harbor版本决定这里由 1.1.2升级到1.2.2,所以使用 tag 1.2
docker pull vmware/harbor-db-migrator:1.2
mkdir -p /backup/db-1.1.2
docker run -it --rm -e DB_USR=root -e DB_PWD=xxxx -v /data/database:/var/lib/mysql -v /backup/db-1.1.2:/harbor-migration/backup vmware/harbor-db-migrator:1.2 backup

# 因为新老版本数据库结构不一样需要数据库migration
docker run -it --rm -e DB_USR=root -e DB_PWD=xxxx -v /data/database:/var/lib/mysql vmware/harbor-db-migrator:1.2 up head

# 修改新版本 harbor.cfg配置需要保持与老版本相关配置项保持一致然后执行安装即可
cd /data/harbor
vi harbor.cfg
./install.sh