Introduce Jenkins file. Add Jenkinsfile example on Repository.

1. JENKINS
Written by Samuel Jiang

2. AGENDA
Jenkins Introduction
Jenkins 2.0
Jenkins Build a Job
Jenkins Slave
Jenkins Role

3. JENKINS INTRODUCTION
最早持續整合的服務代表
⼯工具
多項社群開發之插件，故
能隨專案不同發展出多樣
性流程

4. JENKINS 2.0
Pipeline
有別於以往需要在眾多選項
設定做調整，現改以DSL語
法撰寫整個流程步驟
Blue Ocean
改善舊有UI , 更更貼近⼯工作流
程表現⽅方式

5. DEMO 範例例
https://github.com/jyangchisyan/workshop_demo_repository.git
範例例分別在各不同分⽀支
請各位分別試試不同分⽀支執⾏行行結果以及相關操作

6. JENKINS BUILD A JOB
Sudo apt-get install Jenkins
go to Jenkins web page and follow steps
Create a pipeline job
Choose pipeline script and choose Hello World
Save & Run it !

7. JENKINSFILE
//Declarative Pipeline正規陳述寫法，
須明確定義宣告相關敘述
Pipeline{
agent any
stages{
stage(‘Build’){
steps{
echo ‘Build’
}
}
}
}
//Script Pipeline 簡明寫法當執⾏行行的
動作只執⾏行行在Jenkins Master 上，
可採⽤用此類寫法
Node{
checkout scm
}

8. JENKINSFILE STAGE & STEPS
Example:
Branch- stage_and_steps
Pipeline{
agent any
stages{
stage('這是Stage, 描述這⼀一階段要做什什麼'){
steps{
echo '這是steps, 執⾏行行這階段所要執⾏行行的動作'
}
}
}
}

9. JENKINFILE PARAMETER
Example:
Branch- parameter_echo
parameters{//參參數放置位置
string(name: 'PERSON', defaultValue: 'Jenkins 先⽣生', description:
'Who should I say hello to?’)//依參參數類型定義填入所需資訊
}
steps{
echo "您好 ${params.PERSON}”//以參參數名讀取參參數
}

10. JENKINSFILE SCRIPT & WHEN
When, stage 判斷是否要
執⾏行行的條件
stage(‘’){
when{
expression{}
}
steps{//上述的when需成立，
steps才會執⾏行行動作
}
}
Scripts, steps執⾏行行步驟中所添
加判斷或function等動作
stage(‘’){
steps{
script{//執⾏行行script內的function
if(){
}else if(){
}
}
}
}

11. JENKINSFILE FUNCTION
Example:
Branch- def_library
//以pipeline外部來來額外定義臨臨時的function 做共⽤用
def callFunction(){ //定義function
echo ‘call function’
}
.
.
.
steps{ //pipeline 內部的steps 直接呼叫
callFunction()
}

12. JENKINSFILE POST
Example:
Branch- post
//所有steps 結束後會依結果判斷來來執⾏行行post內動作
post{
always{
echo ‘after stage always execute it’
}
success{
echo 'if job execute success, execute it'
}
}

13. JENKINS SLAVE
安裝 SSH Agent Plugin
進入管理理Jenkins,管理理節點
新增⼀一Node
設定SSH登入Node的系統⽬目錄
設定SSH ip 和 username/password
執⾏行行，Jenkins⾃自動下載agent ⾄至
Slave 端

14. JENKINS PARALLEL
stage(‘’){
parallel{//宣告平⾏行行處理理，帶全部執⾏行行完才會做下⼀一個stage
stage(‘test1’){
agent{
label ‘’//指定執⾏行行的節點
}
steps{
}
}
stage(‘test2’){
agent{
label ‘’
}
steps{
}
}
}
}
有時動作會希望做平⾏行行處理理，
減少執⾏行行時間
利利⽤用parallel 和Slave 來來做多
台分⼯工

15. JENKINS SECURITY ROLE
Jenkins 本⾝身即是⼀一套系統，
同時給多⼈人操作，必定需
有安全考量量和設定。
利利⽤用 Role Strategy Plugin 針
對每個⼈人和相關Project 作
群組化管理理

16. REFERENCE
Jenkins Handbook
https://jenkins.io/doc/book/