如何在GitLab中使用pwsh替代PowerShell执行任务？

问题背景 #

使用GitLab Windows Docker Runner（配置中shell = "powershell"），当使用预装完整PowerShell的mcr.microsoft.com/windows/servercore:ltsc2022镜像时，测试任务可正常运行；但切换到仅包含PowerShell 7（pwsh）的mcr.microsoft.com/dotnet/sdk:7.0镜像时，任务执行失败，错误提示系统找不到powershell命令（错误码0x2）。由于使用GitLab SaaS无法修改现有Runner配置，需通过自定义Docker镜像让pwsh替代powershell执行任务。

解决方案：构建自定义镜像，创建powershell到pwsh的符号链接 #

通过在基础镜像中创建符号链接，将系统对powershell命令的调用重定向到pwsh，无需修改Runner配置即可兼容原有任务脚本。

步骤1：编写Dockerfile #

创建名为Dockerfile的文件，内容如下：

FROM mcr.microsoft.com/dotnet/sdk:7.0

# 创建powershell.exe到pwsh.exe的符号链接，让Runner调用powershell时实际执行pwsh
RUN New-Item -ItemType SymbolicLink -Path "C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe" -Target "C:\Program Files\PowerShell\7\pwsh.exe"

步骤2：构建自定义镜像 #

在Dockerfile所在目录执行构建命令：

docker build -t custom-dotnet-sdk-7:pwsh-proxy .

步骤3：在GitLab CI配置中使用自定义镜像 #

修改.gitlab-ci.yml，使用刚构建的自定义镜像：

pwsh sdk 7:
  stage: test
  image: custom-dotnet-sdk-7:pwsh-proxy
  script:
    - echo "Hello World!"

验证 #

构建完成后，可通过以下命令验证符号链接是否生效：

docker run custom-dotnet-sdk-7:pwsh-proxy powershell --version

执行后应输出PowerShell 7的版本信息（如PowerShell 7.3.11），说明powershell命令已成功映射到pwsh。

内容的提问来源于stack exchange，提问作者malat