Linux下Jenkins與GitHub自動構建NetCore與部署

今天咱們來談談NetCore在Linux底下的持續集成與部署。NetCore我就很少介紹了，持續集成用的是Jenkins，源代碼管理器用的是GitHub。咱們就跟着博文往下走吧。

• • • • 1.Linux環境
      • 2.Jenkins自動構建
        • 定時構建
        • 觸發構建
      • 3.NetCore部署
      • 4.總結一下

1.Linux環境

在進行自動構建以前，咱們須要一個能夠運行的Linux環境，並保證環境安裝了NetCoreSDK,Git,Jenkins等環境，那在這邊就很少說環境的安裝，提供相對應的安裝教程，你們按照安裝就能夠，不過對Jenkins的安裝，我會多囉嗦一句。

環境	地址
NetCore	https://dotnet.microsoft.com/download/linux-package-manager/centos/sdk-current
Git	http://www.javashuo.com/article/p-hwuqrehw-cr.html
Jenkins	http://www.javashuo.com/article/p-vngllrnh-ee.html
Supervisor	http://www.javashuo.com/article/p-fbitwfwd-bk.html

囉嗦的那一句：
我在安裝Jenkins成功的時候進入網頁，網頁會一直保持在下面圖這個狀態，沒辦法進入到開始頁面，那解決辦法是：

Jenkins等待

1. 進入到Jenkins的工做目錄/var/lib/jenkins/修改hudson.model.UpdateCenter.xml文件
2. 將http://updates.jenkins-ci.org/update-center.json修改成http://mirror.xmission.com/jenkins/updates/update-center.json
3. 重啓下Jenkins

2.Jenkins自動構建

• 定時構建

  1. 建立Jenkins項目
     

  2. 配置好自定義工做目錄
     

  3. 填寫源代碼路徑
     

  4. 配置定時任務
     

     字段	*	*	*	*	*
     含義	分鐘	小時	日期	月份	星期
     取值範圍	0-59	0-23	1-31	1-12	0-7
     示例
     每隔15分鐘執行一次	H/15	*	*	*	*
     每隔2個小時執行一次	H	H/2	*	*	*
     每隔3天執行一次	H	H	H/3	*	*
     每隔3天執行一次(每個月的1-15號)	H	H	1-15/3	*	*
     每週1,3,5執行一次	H	H	*	*	1,3,5
     規則
     指定時間範圍	a-b
     指定時間間隔	/
     指定變量取值	a,b,c

  5. 配置構建命令
     

     1. dotnet restore 
        

        ---

     2. dotnet build 
        

        ---

     3. dotnet publish 
        

        ---

  6. 查看構建，並運行NetCore
     注意:
     由於你創建的自定義工做目錄，對於"jenkins"沒有讀寫權限，因此可能就會致使構建失敗，執行下面命令，給Jenkins賦予讀寫權限。

     1. chown jenkins /ftpfile -R  
        

        ---

     2. chmod 777 /ftpfile -R 
        

        ---

     
     
     
     
     

• 觸發構建

  1. 配置GitHub
     針對咱們的項目，咱們要在本身的項目內添加webhook，並配置好webhook的地址。

     1. 在項目設置中找到webhook
        

     2. 設置Jenkins的hook地址到剛纔添加的webhook中，

        Jenkins的hook地址爲：http://你的地址（端口）/github-webhook，固然這個地址應該是外網能夠訪問的

  2. Personal access tokens
     對於任何第三方訪問GitHub的項目，是須要受權的，Jenkins也是同樣的，因此咱們須要先獲取一個accessToken

     1. 進入Settings頁面，找到左邊列表的Developer settings,點擊進入，能夠看到以下：
        
     2. 點擊生成，而後勾選,，保存便可，就能夠得到token，順便說下，token要記下來，否則關閉頁面就看不到了。
        

  3. Jenkins配置
     上面的配置完成以後，咱們須要返回Jenkins，進行再次設置。爲Jenkins添加GitHub服務器。

     1. 添加GitHub服務器
        
        2.添加GitHub的憑據，也就咱們剛纔拿到得accessToken
        
        
        

  4. Jenkins任務配置
     由於咱們已經將觸發構建的前置步驟都作完了，那接着咱們就要去修改以前的定時構建的配置了

     1. 切換成觸發構建
        
     2. 使用密文模式，並添加綁定，選擇剛纔添加的憑據
        

  5. 修改代碼，上傳GitHub
     終於咱們將以前的定時構建改爲了觸發構建，也就是咱們每次Push代碼都會觸發構建，接下來咱們試下。

     1. 提交代碼
        
     2. 查看Jenkins
        

3.NetCore部署

終於的終於，咱們把構建這個步驟作好了，那麼接下來固然就是要部署咱們網站咯。

• 運行NetCore
  運行NetCore最簡單了，咱們只須要在發佈後的目錄運行dotnet ***.dll就能夠了，固然，前提，你要裝CoreSDK。
  

• nginx託管
  雖說上面那樣已經運行起來，可是因爲咱們的環境在騰旭雲上，要訪問能夠用nginx進行方向代理下，下面就簡單貼下配置就能夠了。

  1. server { 
     

     ---

  2. listen 80; 
     

     ---

  3. location / { 
     

     ---

  4. proxy_pass http://localhost:5000; 
     

     ---

  5. proxy_http_version 1.1; 
     

     ---

  6. proxy_set_header Upgrade $http_upgrade; 
     

     ---

  7. proxy_set_header Connection keep-alive; 
     

     ---

  8. proxy_set_header Host $host; 
     

     ---

  9. proxy_cache_bypass $http_upgrade; 
     

     ---

  10. } 
      

      ---

  11. } 
      

      ---

• 守護進程
  咱們已經知道要運行Core，須要使用命令在控制檯運行，可是一旦退出了，Core天然就退出了，因此咱們在Linux底下須要一個相似IIS的，來託管咱們運行Core的進程，守護進程，讓其在後臺運行，自動重啓等等功能，這個就是supervisor

  supervisors是C/S架構的進程控制系統，可以使用戶在類UNIX系統中監控、管理進程。經常使用於管理與某個用戶或項目相關的進程。

  安裝教程能夠參考開始表格supervisor的連接，一樣怎麼對於怎麼對Core進行守護進程，文章內也有講，一步一步按照教程來就能夠了。不過我這邊仍是會講下我在使用supervisor中遇到的坑。

  1. 一開始，我百度了挺多的，發現百度中的文章，對於supervisor的日誌文件，不少都說在/etc/log/supervisor/supervisord.log這個文件內，但其實我去找的時候，發現並無，查看配置文檔，發現默認是在tmp中，我不知道是centeros 的版本問題，仍是supervisor版本問題。

  2. 還有一個就是，在根據教程走完，配置後，要進行啓動時，可能會出現Unlinking stale socket /tmp/supervisor.sock 這個錯誤，咱們只須要解鎖下就能夠了unlink /tmp/supervisor.sock

4.總結一下

該篇文章簡單介紹了下Linux下Jenkins與GitHub自動構建NetCore與部署，不少細點我可能沒講出來，我把大大的教程貼出來，按照教程走起，就能夠了，這也是我實踐過了的，確定能夠用的，很是感謝大大們，而後呢，我也想拋磚引玉下，在我Jenkins構建時有兩個問題，不知道誰能夠幫我解答下。

1. 好比咱們的解決方案文件.sln並無在git項目的根目錄下，咱們要指定須要構建的解決方案呢？

2. 還有一個就是，在命令dotnet publish咱們怎麼指定發佈到另外一個文件夾內呢，我知道有個參數-o|--output <OUTPUT_DIRECTORY>,我試了下，發現不行 dotnet publish -o /ftpfile/netCore/netCoreJenkins/JenkinsNetCore,會有如下的錯誤。

最後的最後，個人下一篇文章是《Linux下Jenkins與GitHub自動構建Node項目(Vue)》，期待0.5下吧。