Alauda Build of Nexus
  • 简体中文

    • Nexus 迁移指南：3.69.0 到 3.76.0（Alauda Build of Nexus Operator 版本 v3.76.z）

    目录

    OverviewPrerequisitesMigration Process1. 数据备份1.1 服务关闭1.2 备份 Blob 存储1.3 数据库备份2. 数据库迁移2.1 OrientDB 到 H2 转换3. 新实例部署3.1 配置选项3.2 数据导入4. 验证步骤

    Overview

    本文档提供了从 Nexus Repository Manager 版本 3.69.0 升级到 3.76.0 的详细迁移步骤。由于 Nexus 在 3.70 版本后停止支持 OrientDB，需进行手动数据迁移。

    Prerequisites

    Migration Process

    1. 数据备份

    创建备份目录（确保本地磁盘空间充足）：

    mkdir -p nexus-backup

    设置环境变量：

    export INSTANCE_NAME=<nexus 实例名称> 
export INSTANCE_NAMESPACE=<nexus 实例命名空间>
export POD_NAME=$(kubectl -n ${INSTANCE_NAMESPACE} get pod -l release=${INSTANCE_NAME} | grep ${INSTANCE_NAME} | awk '{print $1}')

    1.1 服务关闭

    删除前需先卸载旧版本 operator，否则删除后服务会被自动重建。

    kubectl -n ${INSTANCE_NAMESPACE} delete service -l release=${INSTANCE_NAME}

    1.2 备份 Blob 存储

    mkdir -p nexus-backup/blobs
kubectl -n ${INSTANCE_NAMESPACE} cp ${POD_NAME}:/nexus-data/blobs nexus-backup/blobs

    1.3 数据库备份

    1. 进入：Admin Dashboard > System > Tasks
    2. 创建新任务：
      • 类型：Admin - Export databases for backup
      • 任务名称：[自定义]
      • 备份位置：[指定路径] - 目录路径必须在 Nexus 数据卷目录内
      • 频率：手动
    3. 执行任务并确认完成状态

    2. 数据库迁移

    2.1 OrientDB 到 H2 转换

    设置环境变量：

    export INSTANCE_NAME=<旧 nexus 实例名称> 
export INSTANCE_NAMESPACE=<旧 nexus 实例命名空间>
export POD_NAME=$(kubectl -n ${INSTANCE_NAMESPACE} get pod -l release=${INSTANCE_NAME} | grep ${INSTANCE_NAME} | awk '{print $1}')

    进入容器并下载迁移工具：

    kubectl -n ${INSTANCE_NAMESPACE} exec -it ${POD_NAME} -- bash
cd /nexus-data/backup
wget https://download.sonatype.com/nexus/nxrm3-migrator/nexus-db-migrator-3.70.3-01.jar -O nexus-db-migrator.jar

    若无法直接网络下载，可先本地下载后复制至容器：

    kubectl -n ${INSTANCE_NAMESPACE} cp nexus-db-migrator.jar ${POD_NAME}:/nexus-data/backup

    执行迁移：

    # 迁移完成后，backup 目录下会生成 nexus.mv.db 文件
java -Xmx16G -Xms16G -XX:+UseG1GC -XX:MaxDirectMemorySize=28672M -jar nexus-db-migrator.jar --migration_type=h2

    备份转换后的数据库：

    kubectl -n ${INSTANCE_NAMESPACE} cp ${POD_NAME}:/nexus-data/backup/nexus.mv.db nexus-backup/nexus.mv.db

    3. 新实例部署

    由于数据和存储均从原实例导入，部署新实例时只需保持与原实例相同的访问方式。

    注意： 使用与旧版本相同的 NodePort 和 Ingress 配置会导致冲突，无法创建。请配置新的值，迁移成功后删除旧实例，再修改对外暴露配置。

    3.1 配置选项

    NodePort 访问示例：

    helmValues:
   service:
     nexus:
       enabled: true
       nodePort: <端口>

    HTTP ingress 示例：

    service:
  nexus:
    enabled: true
    type: ClusterIP

ingress:
  enabled: true
  host: <域名>
  defaultRule: true

    HTTPS ingress 示例：

    helmValues:
   service:
     nexus:
       enabled: true
       type: ClusterIP
   
   ingress:
     enabled: true
     host: <域名>
     defaultRule: true
     tls:
       - secretName: <tls-secret>
         hosts:
         - <域名>

    3.2 数据导入

    设置新实例变量：

    export INSTANCE_NAME=<新 nexus 实例名称> 
export INSTANCE_NAMESPACE=<新 nexus 实例命名空间>
export POD_NAME=$(kubectl -n ${INSTANCE_NAMESPACE} get pod -l app.kubernetes.io/instance=${INSTANCE_NAME} | grep ${INSTANCE_NAME} | awk '{print $1}')

    清理现有数据（新数据卷为空时可跳过）：

    kubectl -n ${INSTANCE_NAMESPACE} exec -it ${POD_NAME} -- rm -rf /nexus-data/blobs /nexus-data/db/nexus.mv.db

    导入备份数据：

    kubectl -n ${INSTANCE_NAMESPACE} cp nexus-backup/blobs ${POD_NAME}:/nexus-data
kubectl -n ${INSTANCE_NAMESPACE} cp nexus-backup/nexus.mv.db ${POD_NAME}:/nexus-data/db

    然后重启 Nexus Pod。

    4. 验证步骤

    1. 检查 Pod 状态：

      kubectl -n ${INSTANCE_NAMESPACE} get pods -l app.kubernetes.io/instance=${INSTANCE_NAME}

    2. 验证清单：

      • Web UI 可访问
      • 仓库可见
      • 构件上传功能
      • 构件下载功能
      • 用户认证
      • 仓库权限

    3. 迁移后清理：

      • 验证成功后删除旧实例（需重新安装旧版本 operator 以完成旧实例资源清理）
      • 按保留策略归档备份数据