Nexus Repository Conan Format
Table Of Contents
- Using Conan with Nexus Repository Manager 3
- Installing the plugin
- The Fine Print
- Getting Help
Go read our contribution guidelines to get a bit more familiar with how we would like things to flow.
- Apache Maven 3.3.3+
- Java 8+
- Network access to https://repository.sonatype.org/content/groups/sonatype-public-grid
Also, there is a good amount of information available at Bundle Development
NOTE: Version 0.0.2+ of Conan is only compatible with Nexus Repo 3.11.0 or greater due to adding Tree View Filtering. If you need to use this plugin with an older version, please use 0.0.1
To build the project and generate the bundle use Maven
mvn clean package -PbuildKar
If everything checks out, the bundle for Conan should be available in the
Build with Docker
docker build -t nexus-repository-conan:0.0.6 .
Run as a Docker container
docker run -d -p 8081:8081 --name nexus nexus-repository-conan:0.0.6
For further information like how to persist volumes check out the GitHub repo for our official image.
The application will now be available from your browser at http://localhost:8081
Using Conan With Nexus Repository Manager 3
Installing the plugin
There are a range of options for installing the Conan plugin. You'll need to build it first, and then install the plugin with the options shown below:
Thanks to some upstream work in Nexus Repository (versions newer than 3.15), it's become a LOT easier to install a plugin. To install the
conan plugin, follow these steps:
- Build the plugin with
mvn clean package -PbuildKar
- Copy the
nexus-repository-conan-0.0.6-bundle.karfile from your
targetfolder to the
deployfolder for your Nexus Repository installation.
Once you've done this, go ahead and either restart Nexus Repo, or go ahead and start it if it wasn't running to begin with.
You should see
conan (hosted) and
conan (proxy) in the available Repository Recipes to use, if all has gone according to plan :)
Installations done via the Karaf console will be wiped out with every restart of Nexus Repository. This is a good installation path if you are just testing or doing development on the plugin.
Enable Nexus console: edit
Run Nexus' console:
# sudo su - nexus $ cd <nexus_dir>/bin $ ./nexus run > bundle:install file:///tmp/nexus-repository-conan-0.0.6.jar > bundle:list
(look for org.sonatype.nexus.plugins:nexus-repository-conan ID, should be the last one)
> bundle:start <org.sonatype.nexus.plugins:nexus-repository-conan ID>
(more) Permanent Install
For more permanent installs of the nexus-repository-conan plugin, follow these instructions:
- Copy the bundle (nexus-repository-conan-0.0.6.jar) into <nexus_dir>/deploy
This will cause the plugin to be loaded with each restart of Nexus Repository. As well, this folder is monitored by Nexus Repository and the plugin should load within 60 seconds of being copied there if Nexus Repository is running. You will still need to start the bundle using the karaf commands mentioned in the temporary install.
(most) Permanent Install
If you are trying to use the Conan plugin permanently, it likely makes more sense to do the following:
- Copy the bundle into
- If you are using OSS edition, make these mods in:
- If you are using PRO edition, make these mods in:
<feature version="3.x.y.xy" prerequisite="false" dependency="false">nexus-repository-rubygems</feature> <feature version="0.0.6" prerequisite="false" dependency="false">nexus-repository-conan</feature> <feature version="3.x.y.xy" prerequisite="false" dependency="false">nexus-repository-yum</feature> </features>
<feature name="nexus-repository-conan" description="org.sonatype.nexus.plugins:nexus-repository-conan" version="0.0.6"> <details>org.sonatype.nexus.plugins:nexus-repository-conan</details> <bundle>mvn:org.sonatype.nexus.plugins/nexus-repository-conan/0.0.6</bundle> </feature> </features>
This will cause the plugin to be loaded and started with each startup of Nexus Repository.
The Fine Print
It is worth noting that this is NOT SUPPORTED by Sonatype, and is a contribution of ours to the open source community (read: you!)
- Use this contribution at the risk tolerance that you have
- Do NOT file Sonatype support tickets related to Conan support
- DO file issues here on GitHub, so that the community can pitch in
Phew, that was easier than I thought. Last but not least of all:
Have fun creating and using this plugin and the Nexus platform, we are glad to have you here!
Looking to contribute to our code but need some help? There's a few ways to get information: