JarCastingRancher API Maven plugin
A Maven plugin for interacting with rancher. Basing on the sources from: https://github.com/RedFroggy/rancher-maven-plugin
Goal
There is only one goal: stack-deploy which purpose is to delete and/or create a new rancher stack thanks to a docker-compose file
Usage
pom.xml file
<plugin>
<groupId>io.crowdcode.maven.plugins</groupId>
<artifactId>rancher-maven-plugin</artifactId>
<version>1.1.0</version>
<configuration>
<dockerComposeFile>src/main/resources/docker-compose.yml</dockerComposeFile>
<accessKey>${ACCESS_KEY}</accessKey>
<password>${PASSWORD}</password>
<skip>false</skip>
<url>http://${HOST}/v2-beta</url>
<environment>Default</environment>
<stack>
<dockerComposeFile>src/main/resources/docker-compose.yml</dockerComposeFile>
<name>Stackname</name>
<description>Stackdiscriptions</description>
<actions>remove,wait:millis,create,verify[:timeout[:attempts]]</actions>
</stack>
</configuration>
</plugin>
Command line
All optons can be overidden by using line arguments:
- rancher.accessKey # rancher login
- rancher.password # rancher password
- rancher.url #rancher url (should be http://HOST)(v2-beta will be used)
- rancher.environment # environment
- rancher.skip # enable or disable plugin. Default enable
- rancher.stack.name # Name of the stack to delete/create
- rancher.stack.description # Stack description
- rancher.stack.startOnCreate
- rancher.stack.dockerComposeFile # docker-compose file
- rancher.stack.rancherComposeFile # rancher-compose file
- rancher.stack.actions # actions witch has to do (remove/create/wait:time/verify[:timeout[:attempts]])
Examples:
mvn rancher:stack-deploy -Drancher.accessKey=XXXX -Drancher.password=YYYYY -D.....
skip:
If set to true disables creating a Stack. This config option is best used together with a maven property
Tests
mvn clean test
Nice to have
- Convert current unit tests into integration tests because it needs infrastructure (Rancher).
- Check maven parameter provided by user.
- More Debug-Logging.
- Better exception handling.
- Update stacks.
- Update single services in a stack.
