超簡單！asp.net core前後端分離項目使用gitlab-ci持續集成到IIS

現在好多使用gitlab-ci的持續集成的教程，大部分都是發佈到linux系統上的，但是目前還是有很大一部分企業使用的都是windows系統使用IIS在部署.NET應用程式。這裡寫一下如何使用gitlab-ci配合gitlab-runner持續集成到IIS吧。

安裝gitlab

網上有很多安裝gitlab的方法，這裡推薦使用docker安裝，真的超級超級方便。
這裡有一篇文章
docker安裝配置gitlab詳細過程
https://www.cnblogs.com/zuxing/articles/9329152.html
這裡就不細說了。畢竟重點不是說怎麼安裝gitlab哈哈哈。

配置windows伺服器環境

1. windows配置IIS環境
2. 需要在伺服器安裝Node，yarn，git，dotnet2.2-sdk，dotnet-hosting。所需安裝包如下圖所示（自己去找下載鏈接哈哈哈）：
   

第一次需要手動使用git配置用戶密碼，否則無法拉取gitlab上的代碼。
單獨使用git clone命令，將代碼拉取下來。成功驗證完用戶許可權信息後可刪除文件。

在windows伺服器上安裝gitlab-runner

這裡說一下為什麼選gitlab-runner，不使用jenkins。（兩種方式我都嘗試過）
jenkins很強大很好，不需要自己安裝編譯環境，直接可以集成各種編譯環境。但是需要額外部署一個jenkins服務，和gitlab服務分開，需要gitlab的webhooks觸發事件。（沒有運維團隊一個人用的話覺得比較麻煩）
而gitlab-runner在windows環境把編譯環境安裝完，直接啟動一個服務，把gitlab-runner註冊到gitlab上即可。

在伺服器上安裝gitlab-runner
下載地址
https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-windows-amd64.exe

在伺服器中創建gitlab-runner目錄，將下載好的gitlab-runner.exe放入，打開CMD。執行安裝命令，gitlab-runner.exe install

其他操作系統安裝方式查看 https://docs.gitlab.com/runner/install/

註冊gitlab-runner到私有gitlab，執行命令gitlab-runner.exe register

打開http://gitlabserver/admin/runners 查看gitlab-runner註冊時所需的url以及註冊token。
./gitlab-runner.exe register

• 第一步填入URL

Please enter the gitlab-ci coordinator URL (e.g. https://gitlab.com )
http://gitlabserver/

• 第二步填入token

Please enter the gitlab-ci token for this runner
xxx

• 第三步填入runner描述

Please enter the gitlab-ci description for this runner
[hostname] my-runner

• 第四步填入runner標簽

Please enter the gitlab-ci tags for this runner (comma separated):
my-tag,another-tag

• 第五步選擇runner執行環境

Please enter the executor: ssh, docker+machine, docker-ssh+machine, kubernetes, docker, parallels, virtualbox, docker-ssh, shell:
Shell

因為是直接部署到IIS，所以沒有選擇docker容器的方式。
這裡是windows伺服器所以使用powershell作為預設shell執行環境
啟動gitlab-runner
執行命令gitlab-runner.exe start即可啟動。

配置gitlab-ci.yml

使用gitlab-ci需要在項目跟路徑添加.gitlab-ci.yml文件，在文件中添加CI所需要的命令。
詳細的命令參數在此頁面可查看http://gitlabserver/help/ci/yaml/README
每一個最高級的名字分別表示一個任務。
before_script和after_script中的指令是在管道執行前後所運行的指令。
gitlab-ci中預設有三個管道，執行順序分別是build，test，deploy，同一個stage的任務是並行執行的。
這裡我們只需要配置執行的編譯發佈腳本即可，一步到位哈哈哈，當然也可以分幾個步驟，這裡我偷懶了哈哈哈
Script下表示需要執行的命令。Only表示限定哪個分支可以觸發。

超簡單！只要會寫powershell腳本即可

這裡配合IIS的話我們直接將編譯完的發佈文件拷貝到IIS的站點目錄下即可。
為了方便，將powershell腳本單獨編寫到build.ps1文件中，下麵針對52ABP前後端分離項目編寫如下powershell腳本。

# COMMON PATHS
$buildFolder = (Get-Item -Path "./" -Verbose).FullName
$slnFolder = Join-Path $buildFolder "src/aspnet-core"
$webHostFolder = Join-Path $slnFolder "src/Web.Host"
$ngFolder = Join-Path $buildFolder "src/angular"
Set-Location /
$rootFolder = (Get-Item -Path "./" -Verbose).FullName
$outputFolder = Join-Path $rootFolder "publish"
$endOutputFolder = Join-Path $outputFolder "Host"
$fontOutputFolder = (Join-Path $outputFolder "ng")

## RESTORE NUGET PACKAGES #####################################################
echo "開始還原後臺"
Set-Location $slnFolder
dotnet restore
echo "還原後臺結束"
## PUBLISH WEB HOST PROJECT ###################################################
echo "開始發佈後臺，發佈目錄為："$endOutputFolder
Set-Location $webHostFolder
dotnet publish --output $endOutputFolder
echo "發佈後臺結束"
## PUBLISH ANGULAR UI PROJECT #################################################
echo "開始發佈前端，發佈目錄為："$fontOutputFolder
Set-Location $ngFolder
& yarn
& yarn build
Remove-Item $fontOutputFolder -Force -Recurse -ErrorAction Ignore
Copy-Item (Join-Path $ngFolder "dist") $fontOutputFolder -Recurse
echo "發佈前端結束"

將.gitlab-ci.yml和build.ps1文件放入項目根目錄，提交文件。
Gitlab-CI識別到.gitlab.yml文件後會自動執行CI腳本。

大佬說這裡腳本寫的有點弱，菜雞水平沒辦法，powershell寫的牛逼的可以直接操作IIS的API哈哈哈，這裡我就不會了哈哈哈

配置IIS環境

Asp.net core發佈到IIS需要安裝Hosting Bundle，安裝後，在IIS上添加網站，配置好基本目錄信息後，修改應用程式池，選擇無托管代碼。

將asp.net core網站目錄指向發佈目錄即可自動運行。

IIS配置angular前端環境。
由於angular是單頁面前端項目，所以需要配置URL重寫，否則頁面刷新會出現404。
在IIS中安裝URL重寫功能，若沒有，可以通過Web平臺安裝程式安裝功能。

在angular項目的src目錄下添加web.config文件，添加如下內容。

然後在前端項目根路徑的angular.json文件中添加如下配置，將web.config配置成在發佈時複製過去。

在IIS添加網站配置好後，將發佈後的靜態文件複製到網站目錄即可。
這些複製的步驟直接可以通過powershell腳本自動化執行。

結果截圖

下圖就是我折騰過程中執行的截圖

That's all

看完是不是覺得好簡單的樣子哈哈哈，只需要安裝好相應的編譯環境，然後寫一下powershell腳本就行了，所以只要會寫powershell腳本，那其他都不是問題了是吧~~
覺得寫的不好的話，大佬們有意見歡迎評論吐槽~~~