1. 需求背景

公司有后臺(tái)項(xiàng)目和前端項(xiàng)目黔宛，后臺(tái)和前端是分開(kāi)部署的姜性，后臺(tái)是用svn進(jìn)行代碼管理捺典，并且通過(guò)jenkins進(jìn)行持續(xù)集成和構(gòu)建压恒，但是前端還是用著最原始的方式通過(guò)上傳js，html文件到web服務(wù)器進(jìn)行發(fā)布括改，主要是造成了以下的問(wèn)題：

• 部署麻煩腻豌，需要知道本地文件所在目錄和線上文件所在目錄，然后進(jìn)行上傳
• 容易遺漏嘱能，在文件多的時(shí)候上傳會(huì)有遺漏情況發(fā)生吝梅，導(dǎo)致線上出問(wèn)題
• 發(fā)布流程不易管理，無(wú)法追蹤發(fā)布時(shí)間惹骂，發(fā)布目的苏携，發(fā)布內(nèi)容

綜上幾點(diǎn)，再加上前端的代碼是通過(guò)碼云的git進(jìn)行托管的析苫，所以jenkins配置碼云的代碼來(lái)實(shí)現(xiàn)自動(dòng)部署迫在眉睫兜叨。

2. 過(guò)程

2.1 目標(biāo)

jenkins配置碼云自動(dòng)部署的目標(biāo)是在指定分支上進(jìn)行push到遠(yuǎn)程庫(kù)的時(shí)候能夠觸發(fā)jenkins的構(gòu)建，然后實(shí)現(xiàn)自動(dòng)化部署上線衩侥。

2.1 尋找解決方案

在網(wǎng)上能看到很多部署方案国旷，但是大都大同小異，描述得很不詳細(xì)茫死，沒(méi)有從碼云這個(gè)托管平臺(tái)的實(shí)際出發(fā)來(lái)講如何部署跪但，后面通過(guò)翻閱碼云的幫助文檔，再加上自己的一些經(jīng)驗(yàn)峦萎，終于實(shí)現(xiàn)了通過(guò)jenkins自動(dòng)配置碼云

2.2 部署過(guò)程

2.2.1 jenkins安裝碼云Gitee插件

系統(tǒng)管理 --> 插件管理 --> 搜索插件（安裝）屡久，重啟即可（下圖是我在安裝好的插件中查詢出來(lái)的，我是已經(jīng)安裝好的了）

在這里插入圖片描述

2.2.2 插件配置

jenkins --> 系統(tǒng)管理 --> 系統(tǒng)設(shè)置 爱榔，找到Gitee 配置選項(xiàng)

• 鏈接名：輸入你想要的名字被环，這個(gè)名字無(wú)所謂，后面只是做顯示作用
• Gitee 域名 URL：輸入碼云完整URL地址详幽，https://gitee.com（碼云私有化客戶輸入部署的域名）筛欢，一般填https://gitee.com即可
• 證書令牌：右邊選項(xiàng)點(diǎn)擊add,選擇jenkins浸锨，
  1. Domain：選擇全局憑據(jù)（Global credentials）
  2. 類型（Kind）：選擇Gitee API 令牌（Gitee API Token）
  3. 范圍（Scope）:根據(jù)你個(gè)人想要這個(gè)憑據(jù)在哪個(gè)范圍可使用，我選的是全局
  4. Gitee APIV5 私人令牌（Gitee API Token）：輸入你的碼云私人令牌版姑，獲取地址https://gitee.com/profile/personal_access_tokens
  5. ID和描述：自己隨便填柱搜，也是作為顯示使用而已
     添加完成后，選擇剛自己添加的這個(gè)令牌
• Advanced:可配置是否忽略 SSL 錯(cuò)誤（適您的Jenkins環(huán)境是否支持）剥险，并可設(shè)置鏈接測(cè)超時(shí)時(shí)間（適您的網(wǎng)絡(luò)環(huán)境而定）,我是忽略掉的了聪蘸。

• 測(cè)試連接：點(diǎn)擊可以確定自己的配置是否正確，如果不正確表制，則根據(jù)插件配置重新再走一遍健爬。

  
  
  在這里插入圖片描述

2.2.3 新建構(gòu)建任務(wù)

選擇自由風(fēng)格的構(gòu)建項(xiàng)目，然后開(kāi)始配置：

• 選擇gitee地址

  
  
  在這里插入圖片描述
• 源碼管理配置
  1. 點(diǎn)擊Git,Repository URL輸入git地址夫凸，Credentials選擇無(wú)即可（前提是我們已經(jīng)把jenkins所在服務(wù)器的公鑰配置在碼云上了浑劳，該服務(wù)器可以直接使用git命令clone或pull碼云的代碼）
  2. 點(diǎn)擊Advanced阱持，Name中輸入origin,Refspec輸入+refs/heads/*:refs/remotes/origin/* +refs/pull/*/MERGE:refs/pull/*/MERGE （這個(gè)的配置其實(shí)我并不是很懂）
  3. Branch Specifier (blank for 'any')輸入origin/${giteeSourceBranch}

  4. 源碼管理配置的其他都默認(rèn)選項(xiàng)即可

     
     
     在這里插入圖片描述
• 觸發(fā)器配置
  1. 選擇Gitee webhook 觸發(fā)構(gòu)建
  2. 根據(jù)自己需要選擇Gitee 觸發(fā)構(gòu)建策略
  3. 其他默認(rèn)即可

  4. 選擇自己需要過(guò)濾的分支夭拌，比如我這個(gè)job是構(gòu)建測(cè)試環(huán)境的，那么我只希望在push到dev分支上我才要構(gòu)建衷咽，所謂我只有dev分支接口

     
     
     在這里插入圖片描述
• 新建Gitee WebHook

這是整個(gè)配置的核心工作鸽扁，通過(guò)配置WebHook，把我們jenkins相關(guān)的地址設(shè)置進(jìn)去镶骗，在碼云檢測(cè)到有push動(dòng)作或其他指定動(dòng)作的時(shí)候桶现，就會(huì)調(diào)用我們配置的jenkins的地址，然后引發(fā)jenkins的構(gòu)建鼎姊。

進(jìn)入源碼管理配置中設(shè)置的碼云倉(cāng)庫(kù)中骡和，進(jìn)入 管理 -> WebHooks
1. 填寫URL，該URL在配置jenkins的觸發(fā)器的時(shí)候相寇，會(huì)顯示
2. 密碼填寫慰于，在jenkins的配置中生成密碼，復(fù)制黏貼過(guò)去
3. 勾選push唤衫，即自己想要觸發(fā)構(gòu)建的一些動(dòng)作
4. 點(diǎn)擊測(cè)試婆赠，在正常的情況下可以發(fā)現(xiàn)jenkins已經(jīng)自動(dòng)構(gòu)建了

在這里插入圖片描述

• 構(gòu)建過(guò)程

接下來(lái)就是在build中根據(jù)自己業(yè)務(wù)需求執(zhí)行相關(guān)的構(gòu)建步驟了，這個(gè)和碼云部署無(wú)關(guān)佳励，所以不再贅述休里。

3. 總結(jié)

至此，jenkins配置碼云自動(dòng)部署已經(jīng)全部設(shè)置完畢赃承，當(dāng)有開(kāi)發(fā)在本地的push代碼大遠(yuǎn)程的dev分支時(shí)妙黍，就會(huì)觸發(fā)jenkins構(gòu)建。從此瞧剖，前端也走向了自動(dòng)化部署的道路拭嫁。

參考鏈接:
碼云的jenkins插件
Linux安裝Git