Harbor 2.9.0-ARM64离线安装与服务升级全指南

引言

随着容器化技术的普及，Harbor作为企业级私有镜像仓库，因其安全、高效、可扩展的特性，成为众多企业构建CI/CD流水线的首选。然而，在ARM64架构服务器上部署Harbor，尤其是离线环境下的安装与升级，常面临资源获取困难、依赖冲突等问题。本文将围绕Harbor 2.9.0版本，详细阐述在ARM64架构下的离线安装包制作、服务部署及升级流程，旨在为开发者及运维人员提供一套可复制的解决方案。

一、环境准备与依赖分析

1.1 硬件与操作系统要求

• 硬件：ARM64架构服务器，建议配置不低于4核CPU、8GB内存、100GB存储空间。
• 操作系统：推荐使用CentOS 7/8或Ubuntu 20.04 LTS，确保系统为最新稳定版，并已安装基本开发工具（如gcc、make、wget等）。

1.2 依赖分析

Harbor 2.9.0依赖Docker、Docker Compose、Notary、Clair等组件。在离线环境下，需提前下载这些组件的ARM64版本及其所有依赖库。可通过以下步骤获取：

• Docker：从Docker官方仓库下载ARM64版本的.deb或.rpm包。
• Docker Compose：直接下载二进制文件，或通过源码编译（需确保编译环境包含所有依赖）。
• Notary & Clair：从GitHub发布页下载对应版本的ARM64二进制包。

二、离线安装包制作

2.1 依赖收集与打包

1. 创建依赖目录：mkdir -p /opt/harbor-offline/deps
2. 下载依赖：
   • 使用wget或curl从官方源下载所有依赖包至/opt/harbor-offline/deps。
   • 对于无法直接下载的依赖，可通过构建临时容器在线下载后提取。
3. 打包依赖：
   • 使用tar -czvf harbor-deps-arm64.tar.gz /opt/harbor-offline/deps将依赖打包。

2.2 Harbor安装包定制

1. 下载Harbor源码：从GitHub克隆Harbor 2.9.0分支。
2. 修改配置：
   • 编辑make/photon/Makefile，调整Dockerfile中的基础镜像为ARM64兼容版本。
   • 修改harbor.yml.tmpl，确保所有服务配置（如数据库、Redis）均指向本地或内网资源。
3. 编译打包：
   • 执行make package_offline，生成包含所有依赖的离线安装包harbor-offline-installer-v2.9.0.tgz。

三、离线安装与配置

3.1 安装前准备

• 将离线安装包harbor-offline-installer-v2.9.0.tgz及依赖包harbor-deps-arm64.tar.gz上传至目标服务器。
• 解压依赖包：tar -xzvf harbor-deps-arm64.tar.gz -C /opt/
• 安装Docker与Docker Compose：

  cd /opt/harbor-offline/deps/docker
  rpm -ivh *.rpm  # 或dpkg -i *.deb
  systemctl enable docker
  systemctl start docker
  cp docker-compose /usr/local/bin/

3.2 Harbor安装

1. 解压安装包：tar -xzvf harbor-offline-installer-v2.9.0.tgz -C /opt/
2. 配置Harbor：
   • 编辑/opt/harbor/harbor.yml，设置hostname、admin密码、数据存储路径等。
   • 确保https配置正确，若使用自签名证书，需将证书文件放置于指定目录。
3. 执行安装：

   cd /opt/harbor
   ./install.sh --offline

四、服务验证与使用

4.1 服务验证

• 访问Harbor Web界面，确认能正常登录并浏览项目。
• 使用Docker命令行推送/拉取镜像，验证基本功能：

  docker login <harbor_hostname>
  docker tag myimage <harbor_hostname>/myproject/myimage:latest
  docker push <harbor_hostname>/myproject/myimage:latest

4.2 高级功能配置

• 机器人账号：用于自动化流程，减少人工干预。
• 复制策略：配置镜像复制规则，实现多数据中心同步。
• 漏洞扫描：集成Clair进行镜像安全扫描。

五、升级部署策略

5.1 升级前准备

• 备份数据：使用pg_dump备份PostgreSQL数据库，redis-cli备份Redis数据。
• 停止服务：docker-compose down停止Harbor服务。

5.2 升级步骤

1. 下载新版本离线包：重复离线安装包制作流程，生成Harbor新版本的离线包。
2. 解压并替换：
   • 解压新版本包至/opt/harbor-new。
   • 复制/opt/harbor/common/config下的配置文件至/opt/harbor-new/common/config，保持原有配置。
3. 执行升级：

   cd /opt/harbor-new
   ./upgrade.sh --offline

4. 启动服务：docker-compose up -d启动Harbor服务。

5.3 升级后验证

• 检查服务日志：docker-compose logs -f，确认无错误。
• 重新执行镜像推送/拉取操作，验证功能正常。

六、常见问题与解决方案

6.1 依赖冲突

• 问题：离线环境下，某些依赖版本不兼容。
• 解决方案：使用容器化方式在线构建依赖，再提取至离线环境。

6.2 数据库迁移失败

• 问题：升级时数据库结构变更导致迁移失败。
• 解决方案：手动执行SQL脚本调整数据库结构，或回滚至旧版本后重新尝试升级。

七、总结与展望

本文详细介绍了Harbor 2.9.0在ARM64架构下的离线安装包制作、服务部署及升级流程。通过合理的规划与准备，可以高效完成Harbor的离线部署与升级，满足企业对于私有镜像仓库的安全、高效需求。未来，随着容器技术的不断发展，Harbor将持续优化其功能与性能，为企业提供更加稳定、可靠的镜像管理服务。