流水線參數(shù)使用
參數(shù)介紹
流水線參數(shù)可以傳遞給各個任務使用(通過“${參數(shù)名}”方式引用),實現(xiàn)任務間數(shù)據(jù)流動的統(tǒng)一,用戶只需要配置好流水線參數(shù),即可完成構(gòu)建、部署、接口測試等任務的數(shù)據(jù)拉通。流水線參數(shù)包括以下兩種。
1、自定義參數(shù):根據(jù)需要自定義添加,參數(shù)類型包括:字符串類型、枚舉類型、自增長類型和主機組類型。
2、系統(tǒng)預定義參數(shù):系統(tǒng)默認提供的參數(shù),無需定義,不能刪除,不能修改。包括:PROJECT_ID、PIPELINE_ID、PIPELINE_NUMBER、COMMIT_ID、TIMESTAMP。
參數(shù)使用
以通過流水線統(tǒng)一配置releaseversion參數(shù)并傳遞到構(gòu)建任務為例,介紹流水線參數(shù)使用方法,其他任務操作方法相同。
一、新建構(gòu)建任務。
二、在“參數(shù)設置”頁面添加releaseversion參數(shù)并設置好默認值,將“運行時設置”打開。
三、在“構(gòu)建步驟”頁面,選擇“上傳軟件包到軟件發(fā)布庫”,將“發(fā)布版本號”配置成引用參數(shù)形式。在參數(shù)輸入框輸入“$”符號后會自動出現(xiàn)參數(shù)列表,選擇上一步已經(jīng)新建好的releaseversion參數(shù)。
四、配置完成后,保存構(gòu)建任務。
五、新建空白模板流水線,在流水線階段添加一個新的任務,然后在該任務中添加“CodeArtsBuild構(gòu)建”插件并調(diào)用剛創(chuàng)建的構(gòu)建任務,即可看到剛新建好的構(gòu)建任務參數(shù)releaseversion。
六、將鼠標移動到releaseversion參數(shù)上,可以一鍵將該參數(shù)設置為流水線參數(shù)?;蛑苯訂螕簟按_定”,然后切換到流水線“參數(shù)設置”頁面,新建流水線參數(shù)releaseversion,類型可以根據(jù)需求選擇自增長或字符串等,設置默認值并打開運行時設置。
七、再切回到流水線“任務編排”頁面,編輯剛添加的構(gòu)建任務,將流水線的releaseversion參數(shù)通過“$”符號引用到構(gòu)建任務的releaseversion參數(shù)內(nèi)。
說明:
- 該處只顯示任務中已開啟“運行時設置”的文本類型參數(shù)。
- 參數(shù)引用形式為“${ParameterName}”,其中“ParameterName”為流水線參數(shù)名,在參數(shù)輸入框輸入“$”符號后會自動出現(xiàn)參數(shù)列表。
- 鼠標移至參數(shù)名稱,可以快速將該參數(shù)設置為流水線參數(shù)并能直接引用該參數(shù)。
八、完成參數(shù)引用后,保存信息,然后單擊“保存并運行”,彈出“運行配置”側(cè)滑框,可查看“運行參數(shù)配置”。
運行時參數(shù)值默認為添加參數(shù)時為參數(shù)設置的默認值,可根據(jù)需要進行修改。流水線運行時在構(gòu)建任務內(nèi)使用的就是此時輸入的參數(shù)值。
九、設置完參數(shù),單擊“保存”,然后單擊“執(zhí)行”,開始使用配置的參數(shù)執(zhí)行流水線。