实现 GitLab CI/CD 自动化发布网站至本地IIS服务器-526互联

下面列出我本次使用的环境：

操作系统：Windows 11 项目版本：.NET Core 6.0 脚本执行环境：PowerShell 5.1.22621.963 Web服务器：IIS 10.0 Gitlab：git.local

基本步骤

配置GitLab CI/CD Runner
首先，在本地或公司内网的机器上设置一个GitLab CI/CD Runner，该Runner将用于执行CI/CD任务。确保该Runner已经正确配置和注册到GitLab服务器。

注册流程
1. 下载 Gitlab Runner
下载地址：https://docs.gitlab.com/runner/install/

本次下载的版本为Windows amd64

下载好后将文件改名为 gitlab-runner.exe，使用cmd管理员模式进入到该文件目录
1. 注册 Gitlab Runner
  
      命令行输入 .\gitlab-runner register
  
      出现提示 Enter the GitLab instance URL (for example, https://gitlab.com/):
  
      此时需要输入协调器的地址，这个地址是在你 gitlab 项目的 左侧导航栏 ，设置 下的 CI/CD 中，找到 Runner 点击展开，就会看到 指定Runner 和 共享Runner ,这里我们使用 指定Runner 做演示说明。
  
  
  
      复制URL至刚才的命令中回车。
  
      出现提示：Enter the registration token: ，此时输入CI/CD下的注册令牌，然后需要输入描述，根据需求填。
  
      之后提示：Enter tags for the runner (comma-separated):，需要我们输入 Runner 的标签，这里我使用 deploy。输入后回车提示Enter optional maintenance note for the runner:也根据需求填。
  
      回车后正常提示：（如报错请见注册Gitlab Runner时报错）
  
  
  
      最后一个提示：Enter an executor: parallels, virtualbox, docker+machine, instance, kubernetes, docker-windows, docker-ssh, shell, ssh, docker-autoscaler, docker-ssh+machine, custom, docker:
  
      ，需要我们填入脚本的执行环境，这里先填 shell，这时你的 gitlab-runner.exe 下会生成一个 config.toml 文件，里面保存着我们刚刚输入的信息。
  
  
  
      完整命令
  
  
  
      也可尝试用参数一次性输入
```
./gitlab-runner.exe register --non-interactive --tls-ca-file=/etc/gitlab/ssl/git.local.crt --url "https://git.local/"  --registration-token "你的Runner注册令牌" --executor "shell"  --description "runner"   --tag-list "deploy"  --run-untagged  --locked="false"
```
2. 将 Shell 改成 PowerShell
  
  上面选择脚本执行环境的时候我们选了 shell，但是本次我是在 Windows 环境下运行，所以需要将它改为 PowerShell，打开 config.toml 文件，在 [[runners]] 下改成 shell = "powershell" ，然后保存文件即可。

创建CI/CD配置文件
在你的项目中创建一个名为.gitlab-ci.yml的文件，该文件定义了CI/CD的工作流程。在该文件中，需要定义一系列的阶段和任务，以完成自动化发布网站至本地IIS的过程。以下为示例代码：
```
before_script:
  - cd src
stages:
  - build

# job
test:
  stage: build
  # 将会执行的脚本
  script:
    - dotnet restore
    - dotnet build
  # 哪个分支会执行
  only:
    - main
    #runner 注册时的 tag，这里指会触发的 runner
  tags:
    - deploy
```
  以上代码在使用runner运行时会出现以下错误：



  原因可能为项目未restore完成就开始build，所以还是需要在脚本上对每个步骤进行细分，以下为修改后的脚本：
```
before_script:
  #解决powershell中文乱码问题
  - chcp 65001
  #进入项目工作目录
  - cd src

# 执行的 job 
stages:
  - restore
  - build
  - deploy

# 校验代码
restore:
  stage: restore
  # 将会执行的脚本
  script:
    - dotnet restore
  # 哪个分支会执行
  only:
    - main
    #runner 注册时的 tag，这里指会触发的 runner
  tags:
    - deploy

build:
  stage: build
  # 将会执行的脚本
  script:
    - dotnet build
  # 哪个分支会执行
  only:
    - main
    #runner 注册时的 tag，这里指会触发的 runner
  tags:
    - deploy
```
  before_script 在整个项目 clone 到 Runner 所处的服务器时会先执行这个里面的脚本，这里我是进入到了 src 目录，你还可以在这里面做一些包还原的操作。

  stages 里放的是将会执行的 job。

  build 是做作业（job），这个命名你可以根据自己的情况来。build 就是上面 stages 会执行的 job 的真正配置处。
1. stage 对应 stages 中的项，如果一个 job 没有指定 stage，那么这个任务会分配到test stage。
2. script 就是执行的脚本，构建自动化的核心也就是在此处。作为简单的演示，我就还原了包和生成项目。
3. only 是值该 job 会在被哪些分支 push 触发。
4. tags 上面在我们注册时有提到过，这个 tags 对应的是我们注册 gitlab runner 时所填的 tags，表示的是该 job 会触发哪些 Runner。
OK，我们此时已经将一个最简单的 .gitlab-ci.yml 构建好了，将配置好的文件 push（推送）到远端。回到 gitlab 中，我们点击 CI/CD 可以看到有一个流水线在运行。

检出代码

在CI/CD配置文件中的第一个阶段，使用Git命令或GitLab提供的CI/CD变量来检出代码库。这将确保在CI/CD Runner上获取最新的代码。

会从gitlab库中将最新代码拉至本地

构建和打包网站

根据项目需求，执行一些构建和打包的操作，例如编译源代码、安装依赖项等。这些步骤可以在CI/CD配置文件中定义为任务。

自动化部署网站至本地IIS

编写脚本或命令来将打包好的网站部署至本地IIS。包括将文件复制到IIS的网站目录、配置IIS站点和应用程序池等。可以使用PowerShell脚本或其他适合的工具来执行这些操作。

在进行编写剩下的脚本之前需要定义几个变量：

WebsiteName：站点名称，用户关闭 IIS 站点和 IIS 对应进程池的，如果你的进程池和站点的名称不一致请再声明一个变量。

WebsitePath：站点的路径，用于备份、删除原有站点、新的项目复制到该路径下。

before_script:
  #中文乱码问题
  - chcp 65001
  - cd src

# 执行的 job 
stages:
  - restore
  - build
  - deploy

# 校验代码
restore:
  stage: restore
  # 将会执行的脚本
  script:
    # 使用NuGet还原project.json文件中被指定的依赖项，以及特定于项目的工具。
    - dotnet restore
  # 哪个分支会执行
  only:
    - main
    #runner 注册时的 tag，这里指会触发的 runner
  tags:
    - deploy

build:
  stage: build
  # 将会执行的脚本
  script:
    # 生成项目及其所有依赖项
    - dotnet build
  # 哪个分支会执行
  only:
   - main
    #runner 注册时的 tag，这里指会触发的 runner
  tags:
    - deploy

deploy:
  stage: deploy
  script:
      # 声明一个变量保存当前时间，用作备份数据文件夹名称
    - $datetime=Get-Date -Format 'yyyy-MM-dd-HH-mm'

    - |#当站点未停止时才执行停止站点指令
      if ((C:\Windows\System32\inetsrv\appcmd.exe list site $env:WebsiteName | Select-String -Pattern 'STOPPED') -eq $null) {
        C:\Windows\System32\inetsrv\appcmd.exe stop site $env:WebsiteName  
      }
    - | # 当进程池未停止时才执行停止进程池指令
      if ((C:\Windows\System32\inetsrv\appcmd.exe list apppool /apppool.name:$env:WebsiteName | Select-String -Pattern 'STOPPED') -eq $null) {
        C:\Windows\System32\inetsrv\appcmd.exe stop apppool /apppool.name:$env:WebsiteName 
      }
    - |
      
      if (Test-Path $env:WebsitePath) { # 检查原有项目文件是否存在
        # 备份原有项目文件
        cp $env:WebsitePath "$env:WebsitePath$datetime" -Recurse
      }

    # 编译打包项目至iis目录
    - dotnet publish -c debug --no-self-contained -o E:\IIS_Server\AlgoDisplay\publish
    # 启动进程池
    - C:\Windows\System32\inetsrv\appcmd.exe start apppool /apppool.name:"$env:WebsiteName"
    # 启动 IIS 站点
    - C:\Windows\System32\inetsrv\appcmd.exe start site $env:WebsiteName

  only:
    - main
  tags:
    - deploy

到这一步整个自动化发布已经完成了，我们只要 push 代码到远端就会自动部署我们的项目到 IIS 中，但是需要注意必须确保你的 IIS 中已经配置好这个站点了。

回到 gitlab 中查看 CI/CD 可以看到这次我们的阶段有三个，因为我配置了三个作业（job），一个 restore一个 build和一个 deploy。

IIS路径下文件已备份完毕，网站也可以正常访问了。

清理和收尾

最后，在部署完成后，可以添加一些任务来清理临时文件、关闭连接等，以确保CI/CD环境保持干净和可靠。

遇到的坑

注册Gitlab Runner时报错

ERROR: Registering runner... failed runner=GR1348941ZNHLJa9w status=couldn't execute POST against https://git.local/api/v4/runners: Post "https://git.local/api/v4/runners": x509: certificate signed by unknown authority PANIC: Failed to register the runner.