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 Professional can read this OBR repository XML and create proxy repositories that can download OSGi bundles from remote OBR repositories. Nexus Professional can also act as a hosting platform for OSGi bundles. You can configure your builds to publish OSGi bundles to Nexus Professional, and then expose these bundle repositories to internal or external developers using Nexus Professional as a publishing and distribution platform.

Nexus Professional 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 Professional will expose artifacts 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 artifacts with the appropriate OSGi metadata to Nexus Professional. Non-OSGi clients can retrieve software artifacts 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 Professional 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.