一、引言

随着容器技术的普及，Harbor作为企业级私有镜像仓库，在ARM64架构服务器上的部署需求日益增加。特别是在国产化替代和边缘计算场景下，ARM64架构因其低功耗、高性能的特点，成为许多企业的首选。然而，由于网络限制或安全考虑，许多企业需要离线安装Harbor服务。本文将详细介绍如何在ARM64架构服务器上制作Harbor 2.9.0版本的离线安装包，并进行部署和升级。

二、环境准备

1. 硬件要求

• 服务器：支持ARM64架构的服务器，如华为鲲鹏、飞腾等。
• 内存：建议至少8GB RAM，根据实际使用情况调整。
• 磁盘空间：至少100GB可用空间，用于存储镜像和日志。

2. 软件要求

• 操作系统：CentOS 7/8或Ubuntu 20.04 LTS等支持ARM64架构的Linux发行版。
• Docker：已安装并运行，版本建议为19.03及以上。
• Docker Compose：已安装，版本建议为1.25及以上。

三、制作离线安装包

1. 下载Harbor源码

访问Harbor官方GitHub仓库，下载2.9.0版本的源码包。由于直接下载可能受限，建议使用国内镜像源或提前下载好源码包并上传至内网服务器。

# 示例命令（需替换为实际下载链接）
wget https://github.com/goharbor/harbor/releases/download/v2.9.0/harbor-offline-installer-v2.9.0.tgz

2. 准备依赖项

Harbor依赖多个外部组件，如Notary、Clair等。对于离线安装，需要提前下载这些组件的ARM64版本。

• Notary：用于镜像签名。
• Clair：用于镜像漏洞扫描。
• 其他依赖：如Redis、PostgreSQL等，可根据Harbor配置选择是否使用外部服务。

3. 制作离线包

将下载的Harbor源码包和所有依赖项打包成一个离线安装包。可以使用tar命令进行打包。

# 创建目录并解压源码包
mkdir harbor-offline
tar -zxvf harbor-offline-installer-v2.9.0.tgz -C harbor-offline/
# 将依赖项复制到离线包目录（示例）
cp /path/to/notary-server-arm64.tar.gz harbor-offline/
cp /path/to/clair-arm64.tar.gz harbor-offline/
# ... 其他依赖项
# 打包离线包
tar -czvf harbor-offline-arm64-v2.9.0.tar.gz harbor-offline/

四、离线安装Harbor

1. 上传离线包至目标服务器

将制作好的离线包上传至ARM64架构的目标服务器。

2. 解压离线包

tar -zxvf harbor-offline-arm64-v2.9.0.tar.gz -C /opt/

3. 配置Harbor

编辑/opt/harbor-offline/harbor.yml文件，根据实际需求修改配置，如主机名、HTTPS证书、数据存储路径等。

# 示例配置片段
hostname: registry.example.com
http:
  port: 80
https:
  port: 443
  certificate: /path/to/cert.pem
  private_key: /path/to/key.pem
# ... 其他配置

4. 安装Harbor

运行安装脚本，Harbor将使用离线包中的组件进行安装。

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

五、服务验证与使用

1. 验证服务状态

docker-compose ps

确保所有容器均处于Up状态。

2. 登录Harbor

使用docker login命令登录Harbor仓库。

docker login registry.example.com

3. 推送与拉取镜像

测试推送和拉取镜像功能，确保Harbor服务正常运行。

# 示例：推送镜像
docker tag nginx:latest registry.example.com/library/nginx:latest
docker push registry.example.com/library/nginx:latest
# 示例：拉取镜像
docker pull registry.example.com/library/nginx:latest

六、升级Harbor

1. 备份数据

在升级前，务必备份Harbor的数据库和配置文件。

# 备份数据库（示例，根据实际数据库类型调整）
docker exec -it harbor-db pg_dump -U postgres -h 127.0.0.1 harbor > harbor_backup.sql
# 备份配置文件
cp /opt/harbor-offline/harbor.yml /path/to/backup/

2. 下载新版离线包

重复“制作离线安装包”步骤，下载并制作新版本的Harbor离线包。

3. 停止Harbor服务

cd /opt/harbor-offline/
docker-compose down

4. 替换旧版文件

将新版离线包中的文件替换至安装目录。

# 解压新版离线包至临时目录
mkdir /tmp/harbor-new
tar -zxvf harbor-offline-arm64-vX.X.X.tar.gz -C /tmp/harbor-new/
# 替换文件（示例）
cp -r /tmp/harbor-new/harbor-offline/* /opt/harbor-offline/

5. 更新配置并启动

根据新版Harbor的变更，更新harbor.yml配置文件，然后重新启动服务。

# 编辑配置文件（如有需要）
vi /opt/harbor-offline/harbor.yml
# 启动服务
cd /opt/harbor-offline/
./install.sh --offline

6. 验证升级

重复“服务验证与使用”步骤，确保Harbor服务在新版本下正常运行。

七、总结与展望

本文详细介绍了Harbor 2.9.0版本在ARM64架构下的离线安装包制作、服务部署及升级方法。通过离线安装，企业可以在无外网访问的环境下高效部署Harbor服务，满足容器镜像管理的需求。未来，随着容器技术的不断发展，Harbor将持续优化性能、增强安全性，为企业提供更加稳定、高效的镜像仓库解决方案。