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镜像

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

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

运行Docker容器

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

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

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

如需持久化数据，参考Nexus***Docker镜像文档配置卷挂载，如：

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控制台：

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

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

   # 安装插件（替换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 目录，重启后自动加载：

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

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

最永久安装

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

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

   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列表中添加：

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

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

     <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 插件（GitHub地址），提供Composer命令将包推送到基于本镜像的Nexus仓库。