从Nexus迁移至JFrog Artifactory：OSGi-bundle依赖解析困境

背景与现状 #

我们原本基于Nexus+Maven+Tycho完成自研OSGi-bundle的开发、构建与部署：

• OSGi-bundle以ZIP/JAR格式部署到Nexus仓库，同时通过Tycho/Nexus Unzip Plugin镜像并解压bundle，生成虚拟仓库供Tycho解析依赖
• Nexus快照仓库结构示例：

+- Snapshots
 +--- A0
  +--- A1
   +--- A2
    +--- 1.*.*-SNAPSHOT
    |+-- A2-1.*.*.zip
    |+-- A2-1.*.*.pom
    |+-- A2-1.*.*-p2artifacts.xml
    |+-- A2-1.*.*-p2metadata.xml

• 插件生成的解压后虚拟仓库结构：

+- Snapshots-Unzip for P2
 +--- A0
  +--- A1
   +--- A2
    +--- 1.*.*-SNAPSHOT
     +--- A2-1.*.*-SNAPSHOT.zip-unzip
     |+-- features
     |+-- plugins
     |+-- artifacts.jar
     |+-- artifacts.xml.xz
     |+-- content.jar
     |+-- content.xml.xz
     |+-- p2.index

• 依赖通过target文件指向解压后的仓库路径：http://*****:****/nexus/service/local/repositories/Snapshot-Unzip/content/A0/A1/A2/1.*.*-SNAPSHOT/A2-1.*.*-SNAPSHOT.zip-unzip

遇到的问题 #

迁移至JFrog Artifactory后，无法复刻Nexus搭配Tycho/Nexus Unzip Plugin的核心行为：

• 官方文档明确支持P2仓库，但创建虚拟P2仓库时，无法直接包含整个存放OSGi-bundle的仓库，必须指向具体元数据文件
• 尝试按文档要求以!结尾指向ZIP内元数据，依赖解析仍失败
• 现有应用的依赖解析逻辑无法修改，必须完全复刻原有路径与解析方式

方法1：利用Artifactory P2仓库的自动归档展开与索引 #

1. 创建专用P2本地仓库：在Artifactory中创建类型为P2的本地仓库，而非通用Maven仓库
2. 配置归档展开规则：
   • 进入仓库配置的Advanced标签页，找到Archive Unpacking设置
   • 添加规则：*.zip（匹配你的OSGi-bundle包格式），勾选Unpack，设置展开路径保持与原包一致的层级结构
   • 确保Index P2 Repository选项已启用，Artifactory会自动解析p2元数据并生成p2.index等索引文件
3. 重新部署bundle：将Nexus中的OSGi-bundle重新部署到该P2仓库，Artifactory会自动解压ZIP包并生成对应p2仓库结构
4. 调整target路径：将依赖路径替换为Artifactory中P2仓库的对应展开路径，格式类似：http://<artifactory-url>/artifactory/<p2-repo-key>/A0/A1/A2/1.*.*-SNAPSHOT/A2-1.*.*-SNAPSHOT.zip-unzip

方法2：虚拟P2仓库+自定义路由规则适配原有路径 #

如果必须沿用现有Maven仓库存储bundle，可通过虚拟仓库路由规则实现：

1. 创建虚拟P2仓库：将存放OSGi-bundle的Maven仓库添加为虚拟仓库的成员
2. 配置路由规则：
   • 进入虚拟仓库的Routing标签页，添加路由规则，将原有zip-unzip结尾的路径映射到对应ZIP包的归档内内容
   • 示例规则：^/(.*)/([^/]+).zip-unzip$ → /artifactory/<maven-repo-key>/$1/$2.zip!
   • 注：Artifactory支持通过!符号直接访问归档内的目录与文件，需确保规则完全匹配原有Nexus的路径格式
3. 验证路径可用性：访问调整后的target路径，确认能正常获取到解压后的content.jar、artifacts.jar等p2元数据

方法3：编写Artifactory用户插件模拟Nexus Unzip行为 #

若上述方法无法满足需求，可通过自定义用户插件实现自动解压逻辑：

1. 编写Groovy插件，监听bundle的部署或下载事件
2. 当检测到请求路径以.zip-unzip结尾时，自动映射到对应ZIP包的归档内容，或在部署时主动解压包到指定路径
3. 插件核心逻辑示例：

   downloads {
       afterDownloadRequest { request, response ->
           def repoKey = request.repoKey
           def path = request.path
           if (path.endsWith('.zip-unzip')) {
               def zipPath = path.replace('.zip-unzip', '.zip')
               def zipExists = repositories.exists(repoKey, zipPath)
               if (zipExists) {
                   response.redirectTo("/artifactory/${repoKey}/${zipPath}!")
               }
           }
       }
   }
   

4. 将插件部署到Artifactory的$ARTIFACTORY_HOME/etc/plugins目录，重启Artifactory生效

关键注意事项 #

• 确保Artifactory的P2索引功能正常启用，Tycho依赖p2.index文件完成依赖解析
• 针对SNAPSHOT版本，需在P2仓库配置中开启Handle Snapshots选项，自动处理快照版本的更新与索引
• 测试时先验证单个bundle的路径访问与依赖解析，再批量迁移所有资源

内容的提问来源于stack exchange，提问作者CPPC