jbuncle/nexus-repository-composer

Nexus Repository Composer Format 镜像文档

镜像概述和主要用途

Nexus Repository Composer Format是集成了Composer插件的Nexus Repository Manager 3 Docker镜像，专为PHP项目设计，用于管理Composer包的存储、检索和分发。该镜像提供完整的Composer仓库功能，支持私有Composer包管理，可作为PHP开发团队的依赖管理解决方案，适用于从测试到生产的全流程环境。

核心功能和特性

• Composer仓库管理：支持Composer包的存储、版本控制和分发，满足PHP项目依赖管理需求
• 多安装模式：提供临时（Karaf控制台）、较永久（deploy目录）和最永久（配置文件集成）三种插件安装方式，适应不同使用场景
• Docker化部署：支持通过Docker快速构建和运行，简化部署流程
• 持久化支持：可通过Docker卷挂载实现数据持久化，确保仓库数据不丢失
• Nexus核心集成：继承Nexus Repository Manager 3的用户认证、权限管理和仓库配置等核心功能

使用场景和适用范围

• PHP开发团队：需要私有Composer仓库管理内部或第三方依赖包
• 测试环境：快速部署插件进行功能验证和兼容性测试
• 生产环境：通过最永久安装方式构建稳定的Composer仓库服务
• 开发环境：集成到本地开发流程，管理项目依赖

使用方法和配置说明

构建Docker镜像

使用以下命令从源码构建镜像：

bash
docker build -t nexus-repository-composer:0.0.2 .

运行Docker容器

通过以下命令启动容器，默认暴露8081端口：

bash
docker run -d -p 8081:8081 --name nexus nexus-repository-composer:0.0.2

容器启动后，可通过浏览器访问 http://localhost:8081 打开Nexus Repository Manager界面。

如需持久化数据，参考https://github.com/sonatype/docker-nexus3%E9%85%8D%E7%BD%AE%E5%8D%B7%E6%8C%82%E8%BD%BD%EF%BC%8C%E5%A6%82%EF%BC%9A

bash
docker run -d -p 8081:8081 -v nexus-data:/nexus-data --name nexus nexus-repository-composer:0.0.2

安装Composer插件

安装前需先构建插件包（nexus-repository-composer-0.0.2.jar），然后选择以下安装方式：

临时安装（适合测试/开发）

通过Karaf控制台安装，重启Nexus后失效：

1. 启用Nexus控制台：编辑 <nexus_dir>/bin/nexus.vmoptions，将 karaf.startLocalConsole 修改为 true
2. 启动Nexus控制台：

   bash
   sudo su - nexus
   cd <nexus_dir>/bin
   ./nexus run
   

3. 在控制台中执行命令：

   bash
   # 安装插件（替换JAR路径为实际位置）
   > bundle:install file:///tmp/nexus-repository-composer-0.0.2.jar
   # 列出所有bundle，找到"org.sonatype.nexus.plugins:nexus-repository-composer"的ID
   > bundle:list
   # 启动插件（替换<ID>为实际ID）
   > bundle:start <ID>
   

较永久安装

将插件包复制到Nexus的 deploy 目录，重启后自动加载：

bash
# 将插件包复制到deploy目录
cp nexus-repository-composer-0.0.2.jar <nexus_dir>/deploy

Nexus会监控 deploy 目录，运行中会在60秒内加载，未运行则在重启后加载。

最永久安装

通过修改Nexus核心配置文件实现插件随启动自动加载：

1. 复制插件包到指定目录：

   bash
   cp nexus-repository-composer-0.0.2.jar <nexus_dir>/system/org/sonatype/nexus/plugins/nexus-repository-composer/0.0.2/
   

2. 编辑 <nexus_dir>/system/org/sonatype/nexus/assemblies/nexus-core-feature/3.x.y/nexus-core-feature-3.x.y-features.xml：
   • 在现有feature列表中添加：

     xml
     <feature prerequisite="false" dependency="false">nexus-repository-composer</feature>
     

   • 在文件末尾添加feature定义：

     xml
     <feature name="nexus-repository-composer" description="org.sonatype.nexus.plugins:nexus-repository-composer" version="0.0.2">
         <details>org.sonatype.nexus.plugins:nexus-repository-composer</details>
         <bundle>mvn:org.sonatype.nexus.plugins/nexus-repository-composer/0.0.2</bundle>
     </feature>
     

使用Composer与Nexus Repository Manager 3

关于Composer与Nexus的具体使用方法，参见详细用户文档。

获取帮助

• Gitter社区：sonatype/nexus-developers
• Stack Overflow：使用Nexus3标签提问
• 用户邮件列表：Nexus Repository User List

第三方Composer插件

推荐使用 elendev/nexus-composer-push 插件（https://github.com/Elendev/nexus-composer-push%EF%BC%89%EF%BC%8C%E6%8F%90%E4%BE%9BComposer%E5%91%BD%E4%BB%A4%E5%B0%86%E5%8C%85%E6%8E%A8%E9%80%81%E5%88%B0%E5%9F%BA%E4%BA%8E%E6%9C%AC%E9%95%9C%E5%83%8F%E7%9A%84Nexus%E4%BB%93%E5%BA%93%E3%80%82