Hello World from OSS Silicon Valley


HowToUse/Jenkins/1.594


_ Prerequisite

_ Install&Setup

Step.1
Import public key.
# wget -O /etc/yum.repos.d/jenkins.repo http://pkg.jenkins-ci.org/redhat/jenkins.repo
# rpm --import http://pkg.jenkins-ci.org/redhat/jenkins-ci.org.key
Step.2
Install Jenkins
# yum install jenkins

_ Launch Jenkins

Step.1
Login from GUI with root.
Step.2
Select System -> Administration -> Firewall
Launch_fig1.png
Step.3
Select "Other Ports" and click "Add" button and set 8080 port.
Launch_fig2.png
Step.4
Click "Apply" button on the "Firewall Configuration" window.
Step.5
Execute the following command and access http://<host name>:8080/.
# /etc/rc.d/init.d/jenkins start
Launch_fig3.png

_ HowToUse

_ Mail Server Configuration

Step.1
Click "Manage Jenkins".
ServerConfig_fig1.png
Step.2
Click "Configure System".
ServerConfig_fig2.png
Step.3
Setup mail notification configuration.
ServerConfig_fig3.png
ItemDescriptionExample
SMTP serverSMTP server"smtp.gmail.com"
Default user e-mail suffixIf you specify this as "@gmail.com", user e-mail address will be automatically obtained as <user name><suffix>@gmail.com (for gmail)
Step.4
Click "Advances..." button. Setup the configuration.
ServerConfig_fig4.png
ItemDescriptionExample
Use SMTP AuthenticationIf you expect SMTP authorization, check thisTRUE (for gmail)
User Namee-mail user name for SMTP authentification"syatsuzuka"
Passwordpassword for SMTP Authentification"xxxx"
SSLif SMTP server require SSL, check thisTRUE (for gmail)
SMTP PortPort used in SMTP server"465" (for gmail)
CharsetCharacter used in e-mail"UTF-8"

_ Install JDK for Jenkins

Step.1
Click "Manage Jenkins" link.
Step.2
Click "Configure System" link.
Step.3
Click "Add JDK" button.
Step.4
InstallJDK_fig1.png
ItemDescriptionExample
NameJDK name"jdk8u25"
Install automaticallyIf you want to install JDK automatically, keep this checkedTRUE (default)
VersionJDK Version"Java SE Development Kit License Agreement
I agree to the Java SE Development Kit License AgreementTRUE
Step.5
Click "Please enter your username/password" link.
Step.6
Enter Oracle account and click "OK" button.
InstallJDK_fig1.png

_ Install Maven for Jenkins

Step.1
Click "Add Maven" button and set Name.
Step.2
Click "Save" button.

_ Create Items

Step.1
Click "New Item" link.
CreateItem_fig1.png
Step.2
Set "Item name", check "Freestyle project" and click "OK" button.
ItemDescriptionExample
Item nameItem name"TestJOB"
CreateItem_fig2.png

Now, you have new directory named "TestJOB" in JENKINS_HOME, namely, /var/lib/jenkins. Resources which are necessary for build will be stored in workspace under

Step.3
Click Subversion for "Source Code Management" and set "Repository URL".
ItemDescriptionExample
Repository URLRepository URL"http://localhost/svn"
CreateItem_fig3.png
Step.4
Click "enter credential" link.
CreateItem_fig4.png
Step.5
You can choose build trigger according to your situation.
  • "Build after other projects are built"
  • "Build periodically"
  • "Poll SCM"

Here, I choose "Poll SCM". Check "Poll SCM". If you want to check every 5min, set as follows. The order of parameters are same as cron.

min hour day month wday

*/5 * * * *
CreateItem_fig5.png
Step.6
Select "Invoke top-level Maven targets" from "Add build step".
Step.7
Set the following.
ItemDescriptionExample
Maven Versioninstalled maven version"maven3.2.2"
goalmaven goal"compile test"
CreateItem_fig7.png
Step.8
Choose "Publish JUnit Test Result" from "Add post-build action".
ItemDescriptionExample
Test report XMLsSpecify the location of JUnit result report file"trunk/sample/target/surefire-reports/*.xml"

#ref(): File not found: "CreateItem_fig9.png" at page "HowToUse/Jenkins/1.594"

Step.9
Choose "E-mail Notification" from "Add post-build action" and set "Recipients".
ItemDescriptionExample
Recipientsrecipients of error notification"syatsuzuka@xxx.org"

#ref(): File not found: "CreateItem_fig10.png" at page "HowToUse/Jenkins/1.594"

Step.10
Click "Save" button. Now, you can see New Item in the main window.
CreateItem_fig6.png

_ Run Build

Step.1
Click newly created "Schedule Build" link.
Step.2
Click "TestJOB" link and you can see the status of build and test. When you encounter error during job, e-mail will be sent to the specified recipients address.
Step.3
For your first job, Jenkins will download and install maven and related libraries, so it takes time. After the build job finished, you can check test result.

#ref(): File not found: "RunBuild_fig2.png" at page "HowToUse/Jenkins/1.594"

#ref(): File not found: "RunBuild_fig3.png" at page "HowToUse/Jenkins/1.594"

Also, you can see the detail information from terminal log, Jenkins -> sample -> #<job number> -> "Console Output Windows".

RunBuild_fig1.png

_ Author

S.Yatsuzuka