引言

随着容器化技术的普及，Harbor作为企业级私有镜像仓库的重要性日益凸显。针对ARM64架构的服务器环境，如何在无互联网访问的离线场景下完成Harbor 2.9.0的安装与升级，成为许多开发者与运维人员关注的焦点。本文将从离线安装包制作、安装部署到升级流程，提供一套完整的解决方案。

一、Harbor 2.9.0 ARM64离线安装包制作

1.1 环境准备

• 服务器要求：ARM64架构服务器，建议配置4核CPU、8GB内存及以上，以支持Harbor运行及后续镜像存储。
• 操作系统：推荐使用CentOS 7/8或Ubuntu 20.04 LTS，确保系统兼容性。
• 依赖安装：

  # CentOS示例
  yum install -y docker-ce docker-ce-cli containerd.io make go git

  # Ubuntu示例
  apt-get update && apt-get install -y docker.io make golang git

1.2 下载Harbor源码与依赖

• 源码获取：从Harbor官方GitHub仓库克隆2.9.0版本源码。

  git clone -b v2.9.0 https://github.com/goharbor/harbor.git
  cd harbor

• 依赖下载：Harbor依赖的Docker镜像、二进制文件等需提前下载并打包。利用docker save与tar命令将所需镜像打包为.tar文件，如：

  docker pull goharbor/harbor-core:v2.9.0
  docker save goharbor/harbor-core:v2.9.0 > harbor-core-v2.9.0.tar

  类似地，下载并打包harbor-db、harbor-jobservice、harbor-portal等组件镜像。

1.3 制作离线安装包

• 创建安装脚本：编写install.sh脚本，包含环境检查、依赖安装、镜像导入、配置文件生成等步骤。示例片段：

  #!/bin/bash
  # 检查Docker服务状态
  if ! systemctl is-active --quiet docker; then
    echo "Docker服务未运行，正在启动..."
    systemctl start docker
  fi
  # 导入Docker镜像
  for img in *.tar; do
    docker load -i $img
  done
  # 生成Harbor配置文件（需根据实际环境调整）
  cp harbor.yml.tmpl harbor.yml
  sed -i 's/hostname: reg.mydomain.com/hostname: your-server-ip/' harbor.yml
  # 执行安装
  ./install.sh --with-clair --with-trivy  # 根据需求选择插件

• 打包：将源码目录、离线镜像、安装脚本打包为harbor-offline-2.9.0-arm64.tar.gz，便于传输与部署。

二、Harbor 2.9.0 ARM64离线安装部署

2.1 服务器环境准备

• 上传安装包：将harbor-offline-2.9.0-arm64.tar.gz上传至目标服务器。
• 解压与安装：

  tar -zxvf harbor-offline-2.9.0-arm64.tar.gz
  cd harbor
  chmod +x install.sh
  ./install.sh

2.2 配置调整

• harbor.yml配置：根据实际环境修改harbor.yml，包括hostname、http/https端口、data_volume存储路径等。
• 证书配置（如需HTTPS）：生成或准备SSL证书，配置至harbor.yml的https部分。

2.3 启动与验证

• 启动Harbor：

  docker-compose up -d

• 验证服务：

  curl -I https://your-server-ip:9443  # 替换为实际IP与端口

  或通过浏览器访问Harbor Web界面，确认登录与项目创建功能正常。

三、Harbor 2.9.0 ARM64升级部署

3.1 升级前准备

• 备份数据：使用docker-compose down停止服务，备份/data目录（含数据库、镜像等）。
• 下载新版本离线包：重复1.2-1.3步骤，制作新版本离线安装包。

3.2 升级流程

• 导入新镜像：解压新版本离线包，导入Docker镜像。
• 更新配置：对比新旧harbor.yml，合并配置变更。
• 执行升级：

  cd harbor
  ./prepare  # 生成新配置
  docker-compose down
  docker-compose up -d

• 验证升级：检查Harbor版本信息，确认服务运行状态。

四、常见问题与解决方案

• 镜像导入失败：检查镜像名称与标签是否匹配，确保Docker服务正常运行。
• 配置文件错误：使用yq或jq工具辅助修改YAML/JSON配置，避免格式错误。
• 升级后服务异常：查看docker-compose logs定位问题组件，必要时回滚至备份数据。

五、总结

Harbor 2.9.0在ARM64架构下的离线安装与升级，关键在于提前准备依赖、制作离线包，并严格遵循安装与升级流程。通过本文的指导，开发者与运维人员可高效完成Harbor的部署与维护，为企业容器化环境提供稳定可靠的镜像管理服务。