Jenkins Setup Document

Jenkins Setup Document

BrainBox Network. Copyright@2015. All rights reserved

The document provides steps to integrate Android Application with Jenkins.
The integration process requires following steps ‐
1. System Requirements
2. Download Jenkins
3. Starting Jenkins
4. How to Install Tomcat in Windows
5. Configure Apache with Jenkins
6. Jenkins First Look
7. Configuration
8. JDK Setup
9. PlugIn Installation
10. List of Necessary Plugins
11. Jenkins New Project Setup
12. Get Project from Repository
13. Build Android Project
14. Email Notification
15. Advanced Setting
16. Set Success Trigger
17. Setup Notification Detail
18. Set Failure Trigger
19. Setup Notification Detail
20. Project Build Error
21. Build the Project

SYSTEM REQUIREMENTS

➔ JDK :JDK 1.5 or above
➔ Memory:2GB RAM (recommended)
➔ Disk Space:No minimum requirement. Note that since all builds will be stored on the Jenkins
machines, it has to be ensured that sufficient disk space is available for build storage.
➔ Operating System Version:Jenkins can be installed on Windows, Ubuntu/Debian, Red
Hat/Fedora/CentOS, Mac OS X, openSUSE, FReeBSD, OpenBSD, Gentoo.
➔ Java Container:The WAR file can be run in any container that supports Servlet 2.4/JSP 2.0 or
later.(An example is TOMCAT/APACHE).

DOWNLOAD JENKINS

➔ Open Given Link :https://jenkins‐ci.org/
➔ Download Jenkins for system

STARTING JENKINS
➔ Open the command prompt,
➔ Browse to the directory where the “Jenkins.war” file is present.
➔ Run the following command:
Mostly Jenkins installation directory location is:C:Program Files (x86)Jenkins
Command:Java –jar Jenkins.war
➔ Accessing Jenkins: Once Jenkins is up and running,
You can access Jenkins from the link − http://localhost:8080


HOW TO INSTALL TOMCAT IN WINDOWS MACHINE

➔ Link https://tomcat.apache.org/download‐70.cgiuse for download the tomcat.
➔ Then unzip the contents of the downloaded zip file and install.

CONFIGURE APACHE WITH JENKINS

➔ Copy the Jenkis.warfile and PASTE it to the webapps folder in the tomcat folder.
➔ Now open thecommand prompt
➔ Browse to the bin directory in this folder and run the start.bat file
E:Appstomcat7bin>startup.bat
➔ Then open http://localhost/jenkins

JENKINS FIRST LOOK

CONFIGURATION

➔ Click on “Manage Jenkins” link, showing in left side bar of the screen.
➔ Click on “Configuration Setting”, showing in the container part of the screen.


JDK SETUP

➔ Click on “JDK Installations” button
➔ Set JDK path, where you want the install JDK in your machine.
➔ Then click “Save”

➔ Then click on “Available” button
➔ Then put the “Go to next Slide” in your “Filter” showing in right top corner.
➔ Check and select Plugin,
➔ Then Click “Download now and install after restart” button

INSTALL PLUGIN
➔ Click on “Manage Plugin” icon, it is located in container part of the screen.


LIST FOR NECESSARY PLUGINS

1. Credentials Plugin
2. Email Extension Plugin
3. Google Authenticated Source plugin
4. Google Login Plugin
5. Google OAuth Credentials plugin
6. Gradle plugin
7. Subversion Plug‐in
8. OAuth Credentials plugin
9. SSH Credentials Plugin
➔ Go to “Configure System”
➔ Go to extended email notification
➔ Click “Advanced”
➔ Fill in blank:
1. SMTP server ‐> smtp.gmail.com (Mandatory)
2. Use SMTP Authentication ‐> CHECK TRUE (Mandatory)
3. USER NAME ‐> <YOUR_EMAIL_ID> (Mandatory)
4. PASSWORD ‐> <YOUR_EMAIL_ID_PASSWORD> (Mandatory)
5. USE SSL ‐> CHECK TRUE (Mandatory)
6. SMTP PORT ‐> 465 (Mandatory)
7. Default Recipients ‐> <ANY EMAIL ID> (Mandatory)
➔ Save and Restart.

JENKINS NEW PROJECT SETUP
➔ OPEN http://localhost:8080/
➔ Create new Job:Click on “New Item”
➔ Enter your project name in “Item Name” text box
➔ Check true “Freestyle project”
➔ Press “OK”

GET PROJECT FROM REPOSITORY

➔ Go to “Source Code Management” block
➔ Select “Subversion”
➔ Enter Repository Url”
➔ Insert “Use Svn update as much as possible” in the “Check‐out Strategy” field
➔ Press “Apply”
➔ In first time Svn setup you also configure Svn credential
➔ Click “Enter Credentials”, and enter your Svn credentials

BUILD ANDROID PROJECT

➔ Go To “Build Tag”
➔ Click on “Add Build Setup”
➔
➔ Select “Execute windows batch command”
➔ Paste below code in Command Prompt:
gradlew.bat assembleDebug
➔ ADD ONE MORE COMMAND BOX by clicking on “Add build step” and paste below code
➔ if exist temp rmdir temp /S /Q
➔ if not exist temp mkdir temp
copy /Y "%WORKSPACE%appbuildoutputsapk<YOUR_APK_NAME>.apk"
"temp<YOUR_APK_NAME>_%BUILD_NUMBER%.apk"
move /Y "%WORKSPACE%appbuildoutputsapk<YOUR_APK_NAME>.apk"
"c:Program Files (x86)JenkinsuserContent"
➔ As shown below :‐

➔ Press “Apply”.
EMAIL NOTIFICATION

➔ NOTIFICATION ON SUCCESS BUILD (SEND APK WITH NOTIFICATION)
1. Go To post build action tag
2. Select “Add Post build action”
3. Select “Editable Email Notification”

ADVANCED SETTING

➔ Click on “Advanced Setting”

SET SUCCESS TRIGGER

➔ Go To “Trigger” tag
➔ Press “Add Trigger”
➔ Select “success”
➔ Screen looks like below screen
➔ Select “Advanced”.

SETUP NOTIFICATION DETAIL

➔ Add “Recipient List” (Ex: mohit.mobifly@gmail.com)
➔ Set “Subject” (Ex: $PROJECT_NAME ‐ $BUILD_NUMBER ‐ $BUILD_STATUS)
➔ Set “Content” :
<html>
<body>
<h4>Build # $BUILD_NUMBER ‐ $BUILD_STATUS</h4>
<h4>APK Name: <YOUR_APK_NAME>_$BUILD_TYPE_ $BUILD_NUMBER .apk</h4>
</body>
</html>
➔ Add “Attachments”
Copy & Paste given code:(temp/*.apk)
➔ Set “Attach Build Log”: If you want to attach any bulid log, then you have to select “Attach
Build Log” otherwise select “Do Not Attach Build Log”

SET FAILURE TRIGGER

➔ Go To “Trigger Tag”
➔ Press “Add Trigger”
➔ Select “Failure”
➔ Your screen will looks like below shown screen

SETUP NOTIFICATION DETAIL

➔ ADD Recipient List(Ex: mohit.mobifly@gmail.com)
➔ Set Subject (Ex: $PROJECT_NAME ‐ $BUILD_NUMBER ‐ $BUILD_STATUS)
➔ Set Content (<ANY INFORMATION>)
➔ Set “Attach Build Log” (Select “Attach Build Log”)
➔ Save and Build now.

PROJECT BUILD ERROR
➔ If during build a Project on jenkin , An exception occurs with message “The SDK directory
does not exist.”
As shown below :‐
➔ Then go through the jenkins directory of your system :
1. Open workspace folder under your project folder in jenkins directory
2. Update “local.properties” file with your local SDK path and save it.


NOW BUILD THE PROJECT

➔ On successful build of project.
➔ Find generated APK on your specified locations.
➔ Check your specified emails also.

Thank You So Very Much
For queries please write on ashish@mobifly.in
Developed By
Mohit Saini
Android Developer ‐ Mobifly
mobifly.in

Jenkins Setup Document

More Related Content

What's hot (18)

Viewers also liked (14)

Similar to Jenkins Setup Document (20)

More from mobi fly (6)

Recently uploaded (20)

Jenkins Setup Document