GitHub - gbloquel/nexus-rundeck-plugin: Nexus plugin that provides a new REST API meant to be used by RunDeck as an "Option provider".

gbloquel / nexus-rundeck-plugin Public

forked from vbehar/nexus-rundeck-plugin

Notifications You must be signed in to change notification settings
Fork 0
Star 1

Nexus plugin that provides a new REST API meant to be used by RunDeck as an "Option provider".

github.com/vbehar/nexus-rundeck-plugin

Apache-2.0 license

1 star 23 forks Branches Tags Activity

Star

Notifications

Branches Tags

Name		Name	Last commit message	Last commit date
Latest commit History 13 Commits
src/main/java/org/sonatype/nexus/plugins/rundeck		src/main/java/org/sonatype/nexus/plugins/rundeck
.gitignore		.gitignore
LICENSE		LICENSE
README		README
pom.xml		pom.xml

Repository files navigation

Nexus RunDeck plugin
https://github.com/vbehar/nexus-rundeck-plugin

This is a Nexus plugin that provides an "Option provider" for RunDeck.
See http://rundeck.org/docs/RunDeck-Guide.html#option-model-provider

Usage
The plugin provides the following new HTTP resources :
- http://NEXUS_HOST/service/local/rundeck/options/version : return a json array with the version of the matching artifacts.
  Parameters (all optional) :
  - r : repository ID to search in (null for searching in all indexed repositories)
  - g : groupId of the artifacts to match
  - a : artifactId of the artifacts to match
  - p : packaging of the artifacts to match ('jar', 'war', etc)
  - c : classifier of the artifacts to match ('sources', 'javadoc', etc)
  - l : limit - max number of results to return
  - includeLatest : if "true", will include the special "LATEST" version before all versions
  - includeRelease : if "true", will include the special "RELEASE" version before all versions
- http://NEXUS_HOST/service/local/rundeck/options/artifactId : return a json array with the artifactId of the matching artifacts.
  Parameters (all optional) :
  - r : repository ID to search in (null for searching in all indexed repositories)
  - g : groupId of the artifacts to match
  - v : version of the artifacts to match
  - p : packaging of the artifacts to match ('jar', 'war', etc)
  - c : classifier of the artifacts to match ('sources', 'javadoc', etc)
Note that if you want to retrieve the artifact from your RunDeck script, you should use Nexus REST API : https://docs.sonatype.com/display/SPRTNXOSS/Nexus+FAQ#NexusFAQ-Q.HowcanIretrieveasnapshotifIdon%27tknowtheexactfilename%3F 

Change Log
- Version 1.2.2.2 : re-release 1.2, but with a dependence on Nexus 1.9.2.2 (instead of Nexus 1.9)
- Version 1.2 : the option provider for version now includes the date of the version (release)
- Version 1.1 : add option provider for artifactId
- Version 1.0 : option provider for version. compatible with Nexus 1.9 and RunDeck 1.1

How to install
- Download from https://github.com/downloads/vbehar/nexus-rundeck-plugin/nexus-rundeck-plugin-1.2.2.2-bundle.zip
- Unzip the "nexus-rundeck-plugin-VERSION-bundle.zip" file into the "plugin-repository" directory (located in "$NEXUS_HOME/sonatype-work/nexus/plugin-repository")
  You should have a "nexus-rundeck-plugin-VERSION" directory with a "nexus-rundeck-plugin-VERSION.jar" file inside it
- Then, you just need to restart Nexus.

How to build
- prerequisites : Apache Maven 2.2.1 or 3.x http://maven.apache.org/
- run "mvn package"
- use the "bundle" file in target/nexus-rundeck-plugin-VERSION-bundle.zip

FAQ
- If you get an error while installing the plugin, check this how-to : http://kb.dtosolutions.com/wiki/Nexus-rundeck-plugin_options_service

Resources
- Nexus : http://nexus.sonatype.org
- RunDeck : http://www.rundeck.org
- RunDeck "Option Model Provider" : http://rundeck.org/docs/RunDeck-Guide.html#option-model-provider
- RunDeck mailing-list (for questions/feedback/etc) : http://groups.google.com/group/rundeck-discuss

LICENSE : The Apache Software License, Version 2.0
See the LICENSE file, or http://www.apache.org/licenses/LICENSE-2.0