GitLab 的 C++ CI/CD 腳本：使用 PowerShell

理論上，Windows 上如果用最新版的 GitLab Runner 來設定一台新的 GitLab Runner，在選擇 shell 模式的情況下，預設就會是使用 PowerShell 來執行了。

而針對既有的 GitLab Runner 呢，則就需要手動去修改設定了。

修改的方法，基本上就是以純文字檔編輯器去開啟「config.toml」（在 Windows 環境應該會跟 gitlab-runner.exe 在一起），然後找到「runners」的區段，加入「shell」的設定了。

在官方文件中，也有提供對應的範例：

...
[[runners]]
  name = "shell executor runner"
  executor = "shell"
  shell = "powershell"
...

在修改完後，只要再讓 GitLab Runner 重新執行，就可以讓修改生效了。

要重新執行 gitlab-runner.exe 的話，只要用系統管理者權限，執行

.gitlab-runner.exe restart

就可以了。

在 yaml 腳本的部分，由於流程沒有變，所以大致上都可以沿用之前的腳本。

但是，有兩個地方必須要針對更換 shell 做對應的修改：

• 切換字碼
• 設定 Visual C++ 的環境

切換字碼

首先，在切換字碼的部分，在使用 cmd 作為 shell 的時候，只要執行「CHCP 65001」就可以了。但是這個指令在 PowerShell 下，似乎不能解決問題。

後來查了一下資料，最後是採用下面的指令：

[System.Console]::OutputEncoding = [System.Console]::InputEncoding =
[System.Text.Encoding]::UTF8

透過這個指令，可以把 console 輸入、輸出的編碼都設定成 UTF-8；如此一來 GitLab 抓到的紀錄就能正常顯示中文了。

（這個指令哪抄來的已經忘了 ^^"）

Visual C++ 環境變數

'call "c:progra~2MICROS~12017BuildToolsVCAuxiliaryBuildvcvars64.bat"'

if ($env:APPVEYOR_BUILD_WORKER_IMAGE -eq "Visual Studio 2015") {
  cmd.exe /c "call `"C:Program FilesMicrosoft SDKsWindowsv7.1BinSetEnv.cmd`" /x64 && call `"C:Program Files (x86)Microsoft Visual Studio 14.0VCvcvarsall.bat`" x86_amd64 && set > %temp%vcvars.txt"
} else {
  cmd.exe /c "call `"C:Program Files (x86)Microsoft Visual Studio2017CommunityVCAuxiliaryBuildvcvars64.bat`" && set > %temp%vcvars.txt"
}
Get-Content "$env:tempvcvars.txt" | Foreach-Object {
  if ($_ -match "^(.*?)=(.*)$") {
    Set-Content "env:$($matches[1])" $matches[2]
  }
}

最後，如果只看「build-windows」 這個工作的話，他的腳本就變成：

.powershell_encoding:
  before_script:
  - "[System.Console]::OutputEncoding = [System.Console]::InputEncoding = [System.Text.Encoding]::UTF8" # Set as UTF-8
build-windows:
  stage: build
  extends: .powershell_encoding
  variables:
    GIT_SUBMODULE_STRATEGY: none
  script:
  - git submodule sync --recursive
  - git submodule update --recursive --init --remote external
  - cmd.exe /c "call `"C:Program Files (x86)Microsoft Visual Studio2017BuildToolsVCAuxiliaryBuildvcvars64.bat`" && set > vcvars.txt" # Generate VC env-settings
  - Get-Content "vcvars.txt" | Foreach-Object { if ($_ -match "^(.*?)=(.*)$") { Set-Content "env:$($matches[1])" $matches[2] } } # Apply VC env settings
  - msbuild.exe /m /property:Configuration=Release
  tags:
  - msvc