建站
咨詢
售后
建站咨詢
新聞中心
1.1 為什么要使用Git參數(shù)?
如何解決固定分支問題?起初我們的流水線項目配置分支可能是采用的選項參數(shù)。創(chuàng)建一個選項參數(shù)然后把項目經(jīng)常用到的分支給更新上去，最后開發(fā)人員在發(fā)布的時候來選擇對應(yīng)的分支?？此平鉀Q了固定分支問題，但是后期維護起來非常困難，需要不斷的更改參數(shù)值。
創(chuàng)建一個字符參數(shù)設(shè)置一個默認值，然后 交給開發(fā)人員自己填寫。這樣的確方便了配置管理人員，給開發(fā)人員增加了負擔(dān)，手動輸入避免不了帶來了錯誤發(fā)生的可能。
我們來通過下面的內(nèi)容，掌握如何使用 git參數(shù)實現(xiàn)動態(tài)分支構(gòu)建呢?
1.2 在freestyle項目中使用
當你的項目還沒有使用pipeline，可以參考以下的配置來使用git參數(shù)。當然如果你在調(diào)試pipeline項目的時候使用git參數(shù)經(jīng)常出現(xiàn)問題的話，也可以看下在freestyle項目中如何使用，了解git參數(shù)的工作原理。
我們在項目的配置中，勾選參數(shù)化構(gòu)建。然后添加git參數(shù)。選擇變量名稱和參數(shù)類型。
然后鼠標滾動到下面，填寫項目代碼庫的信息
最后保存配置，回到作業(yè)首頁，我們點擊項目的參數(shù)化構(gòu)建。此時你會看到項目代碼庫對應(yīng)的所有分支已經(jīng)出現(xiàn)了，我們可以選擇分支并構(gòu)建了。
1.3 在Pipeline項目中使用
1.3.1 普通的Pipeline項目
這里把普通的pipeline項目定義為 未將Jenkinsfile內(nèi)容保存在版本控制系統(tǒng)中，而是存儲在該JOB中。
首先我們添加一個srcUrl參數(shù)定義項目代碼庫的地址，便于后期在pipeline中調(diào)用。
然后添加git參數(shù)branchName，定義為分支類型。
編寫Jenkinsfile
//pipeline
pipeline{
agent { node { label "build"}}
stages{
stage("CheckOut"){
steps{
script{
println("${branchName}")
checkout([$class: 'GitSCM', branches: [[name: "${branchName}"]],
doGenerateSubmoduleConfigurations: false,
extensions: [],
submoduleCfg: [],
userRemoteConfigs: [[credentialsId: 'gitlab-admin-user',
url: "${srcUrl}"]]])
}
}
}
}
}
然后保存配置，回到作業(yè)首頁。構(gòu)建一次，然后就能夠獲取到項目代碼庫的分支了。
對于將jenkinsfile保存在作業(yè)中，這種方式有利有弊，好處是可以方便我們進行代碼調(diào)試，壞處是不利于統(tǒng)一管理。大家酌情使用。
1.3.2 流行的Pipeline項目
這里流行的Pipeline項目我們理解為 此job使用的jenkinsfile文件存儲在git版本控制系統(tǒng)中。
首先我們創(chuàng)建一個測試jenkinsfile,保存在git項目中，命名為git.jenkinsfile。此文件內(nèi)容與上面那種方式是一樣的，只不過將jenkinsfile納入了版本控制。
//pipeline
pipeline{
agent { node { label "build"}}
stages{
stage("CheckOut"){
steps{
script{
println("${branchName}")
checkout([$class: 'GitSCM', branches: [[name: "${branchName}"]],
doGenerateSubmoduleConfigurations: false,
extensions: [],
submoduleCfg: [],
userRemoteConfigs: [[credentialsId: 'gitlab-admin-user',
url: "${srcUrl}"]]])
}
}
}
}
}
然后我們來創(chuàng)建一個新的流水線項目。注意情況我們 現(xiàn)在用到了兩個倉庫，一個是Jenkinsfile倉庫，另一個是 項目代碼倉庫。創(chuàng)建一個參數(shù)srcUrl用于存儲項目 代碼倉庫的URL。
默認git參數(shù)會識別到Jenkinsfile的倉庫，所以我們需要在git參數(shù)的高級設(shè)置中指定我們要使用的倉庫地址。80%錯誤因為沒有指定倉庫導(dǎo)致獲取分支錯誤等問題。
填寫Jenkinsfile倉庫信息。
最后我們來構(gòu)建一次就能夠獲取到項目代碼倉庫的分支信息了。這里經(jīng)常出現(xiàn)獲取 分支的問題，請仔細參考上面的步驟一定要在git參數(shù)中指定好我們要用的倉庫，否則會出現(xiàn)分支獲取失敗等問題。
1.3.3 使用Pipeline as Code
我們將參數(shù)信息全部放到Jenkinsfile中存儲。此時生成的代碼就不區(qū)分在作業(yè)中保存還是在版本控制系統(tǒng)中保存了。不過還是建議大家把jenkinsfile納入版本控制系統(tǒng)中保存。
我們?nèi)绾紊蒍enkinsfile代碼?很方便的工具，我們導(dǎo)航到 流水線語法-> Declarative Directive Generator 。
最后完整的Jenkinsfile如下所示：
//pipeline
pipeline{
agent { node { label "build"}}
parameters {
string defaultValue: 'http://192.168.1.200:30088/idevops/idevops-maven-service.git',
description: '',
name: 'srcUrl',
trim: false
gitParameter branch: '',
branchFilter: '.*',
defaultValue: 'origin/master',
description: '',
name: 'branchName',
quickFilterEnabled: false,
selectedValue: 'NONE',
sortMode: 'NONE',
tagFilter: '*',
type: 'PT_BRANCH',
useRepository: 'http://192.168.1.200:30088/idevops/idevops-maven-service.git'
}
stages{
stage("CheckOut"){
steps{
script{
println("${branchName}")
checkout([$class: 'GitSCM', branches: [[name: "${branchName}"]],
doGenerateSubmoduleConfigurations: false,
extensions: [],
submoduleCfg: [],
userRemoteConfigs: [[credentialsId: 'gitlab-admin-user',
url: "${srcUrl}"]]])
}
}
}
}
}
同樣的配置過程，我們構(gòu)建 一次之后就能夠 正常獲取到項目代碼庫的分支信息了。
1.4 總結(jié)
你是不是在使用git參數(shù)時也遇到了相同的問題呢?此文章能夠 幫助到大家避免問題的出現(xiàn)。這個git參數(shù)還是有些不方便的。隨著內(nèi)部devops平臺的功能擴展，目前發(fā)布都是通過 devops平臺中來完成參數(shù)的選擇，最后生成一個Jenkins作業(yè)來運行。這種情況下選擇分支和標簽就放在了外圍的devops平臺中了，這樣jenkins的參數(shù)使用什么類型都無所謂了。
網(wǎng)站名稱：使用JenkinsGit參數(shù)實現(xiàn)分支標簽動態(tài)選擇
網(wǎng)頁鏈接：http://m.fisionsoft.com.cn/article/copogig.html
