OpenShift Deployer Plugin enables Jenkins job to create containers(gears) on OpenShift and deploy applications to it. This plugin currently supports OpenShift v2.
This plugin is available in the Jenkins plugin manager. To install in Jenkins, go to Manage Jenkins | Manage Plugins | Available | OpenShift Deployer Plugin | Install.
You must restart Jenkins to complete the installation.
SSH keys are essential when working with OpenShift. SSH keys must be uploaded to the OpenShift server in order for this Jenkins plugin to be able to deploy to OpenShift.
If no SSH keys exist on the Jenkins server, follow these instructions to generate a pair:
ssh-keygen -t rsa -f /var/lib/jenkins/.ssh/id_rsa
chmod 755 /var/lib/jenkins/.ssh/
chmod 644 /var/lib/jenkins/.ssh/authorized_keys
In order to configure the OpenShift Deployer plugin, go to Manage Jenkins | Configure System | OpenShift. Enter the path to the public key (defaults to /var/lib/jenkins/.ssh/id_rsa.pub
).
Add an OpenShift Server block for each OpenShift server you want to deploy to by specifying an arbitrary name, broker address, username and password. Click on "Check Login" to test the authentication. If successful, you can upload your SSH Public Key to the OpenShift server by clicking on "Upload SSH Keys". The broker address is by default openshift.redhat.com which is the address of broker for http:https://www.openshift.com.
The Deploy Application
build-step creates a container on OpenShift and deploys the WAR, EAR or TAR archive package to the created container. It also supports giving a URL (e.g. to Nexus or Artifactory) for the deployment which will be fetched and deployed to OpenShift. This buildstep supports both git and binary deployments.
When building the WAR/EAR file by Maven, make sure your build is successful creating a deployable file. The mvn package
command creates the WAR/EAR file into its target
directory. Otherwise create the WAR/EAR in whatever way that is appropriate for you project. Check out this blog post for further details on creating TAR archives for binary deployment.
After the WAR/EAR/TAR is created, add a Deploy to OpenShift
build-step in your Jenkins job configuration and specify the OpenShift server from the list of added servers, application name, domain and cartridges for the OpenShift gear. It is also possible to choose the gear profile and the path to the WAR/EAR/TAR directory (defaults to target
) or alternatively the URL to the WAR/EAR/TAR file.
The Delete Application
build-step deletes an existing application from OpenShift.
-
Follow instructions on setting up your environment from Jenkins
-
Build the plugin:
git clone https://github.com/jenkinsci/openshift-deployer-plugin.git mvn clean package
-
This will create a
*.hpi
file in thetarget
directory. -
On your Jenkins instance, go to Manage Jenkins | Manage Plugins | Advanced | Upload Plugin.
-
Choose the generated
*.hpi
file and click upload. -
Restart Jenkins.
Moved to JIRA