GitLab自建CI环境中.NET 6项目遇dotnet命令未找到错误

针对你遇到的.NET 6应用GitLab CI执行时提示dotnet command not found的问题，以下是几个排查和解决方向：

• 检查Runner执行器类型
  如果你的GitLab Runner使用的是shell执行器，CI会直接在Runner所在主机环境运行命令，不会拉取配置的mcr.microsoft.com/dotnet/sdk:6.0镜像。这种情况下主机未安装.NET SDK就会报错。需要将Runner切换为docker或docker+machine执行器，确保CI在指定的Docker镜像环境内运行。

• 验证镜像完整性
  本地拉取指定镜像测试是否包含dotnet命令：

  docker run --rm mcr.microsoft.com/dotnet/sdk:6.0 dotnet --version
  

  如果无法正常输出.NET版本，说明镜像拉取不完整或存在损坏，尝试重新拉取镜像。

• 调整脚本引号格式
  脚本中的单引号可能在部分shell环境下导致命令解析异常，去掉单引号后重试：

  image: mcr.microsoft.com/dotnet/sdk:6.0
  
  before_script:
    - dotnet restore --packages $NUGET_PACKAGES_DIRECTORY
  build:
    stage: build
    script:
      - dotnet build --no-restore
  

• 排查Runner配置覆盖问题
  自定义Runner可能存在全局image配置，覆盖了CI脚本中指定的镜像。检查Runner的配置文件（通常是config.toml），确认没有全局镜像设置，或者确保CI脚本中的镜像优先级更高。

• 使用dotnet绝对路径
  .NET SDK镜像中dotnet的默认路径通常是/usr/share/dotnet/dotnet，可以尝试用绝对路径执行命令：

  before_script:
    - /usr/share/dotnet/dotnet restore --packages $NUGET_PACKAGES_DIRECTORY
  build:
    stage: build
    script:
      - /usr/share/dotnet/dotnet build --no-restore
  

内容的提问来源于stack exchange，提问作者Imran Qadir Baksh - Baloch