現在好多使用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指令碼，那其他都不是問題了是吧~~
覺得寫的不好的話，大佬們有意見歡迎評論吐槽~~~