Repository Management with Nexus


14.1. Introduction

Nexus supports the OSGi Bundle Repository format. The OSGi Bundle format is defined by the OSGi RFC 112 "Bundle Repository." It is a format for the distribution of OSGi bundles which includes any components that are described by the OSGi standards set forth in RFC 112. An OBR repository has a single XML file that completely describes the contents of the entire repository. Nexus Pro can read this OBR repository XML and create proxy repositories that can download OSGi bundles from remote OBR repositories. Nexus Pro can also act as a hosting platform for OSGi bundles. You can configure your builds to publish OSGi bundles to Nexus Pro, and then expose these bundle repositories to internal or external developers using Nexus Pro as a publishing and distribution platform.

Nexus Pro can also act as a bridge between Maven repositories and OSGi bundle repositories. When you configure a virtual OBR repository that uses a Maven 2 repository as a source repository, Nexus Pro will expose components with the appropriate metadata from the Maven repository as OSGi bundles. In this way, you can unify your OSGi and non-OSGi development efforts and publish components with the appropriate OSGi metadata to Nexus Pro. Non-OSGi clients can retrieve software components from a Maven repository, and OSGi-aware clients can retrieve OSGi bundles from a virtual OBR repository.

The following sections detail the procedures for creating and managing OBR repositories.

Nexus Pro has OBR support installed by default. Prior to any usage in Nexus OSS the Nexus OBR Plugin needs to be installed. You can download the file for your specific Nexus version from the Central Repository:

Extract the file into sonatype-work/nexus/plugin-repository and restart Nexus. Ensure to repeat the step for any Nexus upgrades.