|
|
|
| Line 97: | |||
| =Source= | =Source= | ||
| + | ==Jenkins== | ||
| + | ===Installing the Jenkins Plugin=== | ||
| + | #In your Jenkins interface, navigate to Manage Jenkins>Manage Plugins>Advanced. | ||
| + | #Click "choose file" and navigate to the urbandeploypublisher.hpi provided to you by Urbancode or drag the file from your file system browser to the "choose file' button, and click upload. | ||
| + | #Shutdown and restart Jenkins. | ||
| + | #From the Jenkins dashboard, navigate to Manage Jenkins>Configure System, and scroll to the UrbanDeploy Server section. | ||
| + | #Fill in the fields and click save. | ||
| + | :*Profile Name = The name you would like the Profile to have | ||
| + | :*UrbanDeploy URL = the web url for your uDeploy server. Don't forget the port | ||
| + | :*User Name = The username that Jenkins will use to access uDeploy | ||
| + | :*Password = The password for said user | ||
| + | !!!Note!!!! Jenkins often uses an older log4j file then our plugin needs. You may need to replace it. See below for instructions: | ||
| + | #Unpackage the jenkins.war | ||
| + | #Open /web-inf/lib in the unpacked .war's directory to determine the name of Jenkin's log4j.jar | ||
| + | #Navigate to your uDeploy server's %serverLocation%/lib directory and copy our log4j.jar to Jenkin's /web-inf/lib/ directory, overwriting the existing log4j with uDeploy's (rename it to match Jenkin's) | ||
| + | ===Configure Your Jenkins Build to Push Artifacts to uDeploy=== | ||
| + | #[http://wiki.urbancode.com/uDeploy/Components#Creating_a_New_Component Create a component] in uDeploy with the Jenkins Source Config Type. | ||
| + | #From the Jenkins dashboard, click on the build that you would like to use to import artifacts | ||
| + | #Click Configure | ||
| + | #In the Post-build Action drop down menu, choose to publish artifacts to UrbanDeploy | ||
| + | #Fill in the fields and click save | ||
| + | :*UrbanDeploy Server = the profile for the uDeploy server you'd like to push artifacts to | ||
| + | :*Component = the name of the component that you created earlier that will be receiving the artifacts | ||
| + | :*Base Artifact Directory = the location Jenkins is storing the artifacts (${WORKSPACE} will take you to the base directory of the workspace) | ||
| + | :*Directory Offset = the sub-directory in the workspace where it should search for artifacts | ||
| + | :*Version = the name of the version to be created | ||
| + | :*Include = what files to include | ||
| + | :*Exclude = what files to exclude | ||
| + | :*Skip Publishing = click this if you want to disable publishing to uDeploy without deleting your configuration | ||
| + | :*Deploy = click this if you would like to initiate a deployment after the build and publication | ||
| + | :*Deploy Application = the application to use to deploy | ||
| + | :*Deploy Environment = the environment to deploy to | ||
| + | :*Deploy Process = the application process to use to deploy | ||
| ==PVCS Checkout== | ==PVCS Checkout== | ||