forked from vbehar/nexus-rundeck-plugin
-
Notifications
You must be signed in to change notification settings - Fork 2
/
Copy pathREADME
57 lines (47 loc) · 3.11 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
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