GitLab DotNet项目Pipeline验证失败：cobertura未知密钥错误

我的DotNet项目GitLab流水线无法通过验证，报错信息为jobs:build:artifacts:reports config contains unknown keys: cobertura，导致流水线无法触发。尝试移除代码覆盖相关配置但操作不当引发其他错误，参考相关方案后仍未解决。

问题原因 #

• GitLab版本不兼容：cobertura报告关键字在GitLab 13.0及以上版本才正式支持，若你的GitLab实例版本低于该版本，会将其识别为未知配置项。
• 报告格式不匹配：当前测试命令生成的是opencover格式的覆盖率文件，但cobertura报告要求文件为Cobertura XML格式，格式不匹配会触发配置验证失败。

解决方案 #

方案1：升级GitLab实例（若有权限） #

如果可以升级GitLab到13.0及以上版本，升级后cobertura关键字会被正常识别，无需修改现有配置格式。

方案2：转换覆盖率报告格式（无需升级） #

修改dotnet test命令的输出格式为Cobertura，并调整对应文件路径：

1. 将测试命令中的-p:CoverletOutputFormat=\"opencover\"改为-p:CoverletOutputFormat=\"cobertura\"
2. 更新工件配置中覆盖率文件的路径为**/*coverage.cobertura.xml

方案3：降级配置（放弃原生覆盖率展示） #

若暂时无法升级或转换格式，可移除cobertura报告配置，改用GitLab的正则提取覆盖率数值，同时保留覆盖率文件作为普通工件：

• 删除artifacts.reports下的cobertura节点
• 保留artifacts.paths中的覆盖率文件配置，确保文件能被正常保存

修改后的流水线配置（方案2示例） #

variables:
  OBJECTS_DIRECTORY: "obj"
  NUGET_PACKAGES_DIRECTORY: ".nuget"
  SOURCE_CODE_PATH: "$CI_PROJECT_DIR"
  SELF_CONTAINED: "false"
  BUILD_TARGET: "Release"
  DOTNET_IMAGE: mcr.microsoft.com/dotnet/core/sdk:3.1
  SKIP_TESTS: "false"

# Coverage: TBD https://gitlab.com/gitlab-org/gitlab/-/issues/217664
.dotnet.build:
  image: $DOTNET_IMAGE
  script:
    - dotnet nuget add source "$NUGET_REPO" --name gitlab --username ???? --password ???? --store-password-in-clear-text
    - dotnet restore "$SOURCE_CODE_PATH" --packages "$NUGET_PACKAGES_DIRECTORY"
    - dotnet build "$SOURCE_CODE_PATH" -c "$BUILD_TARGET" --no-restore
    - if [ "$SKIP_TESTS" = "false" ]; then dotnet test "$SOURCE_CODE_PATH" -c "$BUILD_TARGET" -p:CollectCoverage=true -p:CoverletOutputFormat="cobertura" --no-build --test-adapter-path:. --logger:"junit;LogFilePath=.\artifacts\test-result.xml;MethodFormat=Class;FailureBodyFormat=Verbose"; fi
    - dotnet publish "$SOURCE_CODE_PATH" -c "$BUILD_TARGET" --no-build --self-contained "$SELF_CONTAINED"
  cache:
    key: "${CI_JOB_STAGE}-${CI_COMMIT_REF_SLUG}-dotnet"
    paths:
      - "$SOURCE_CODE_PATH/$OBJECTS_DIRECTORY/project.assets.json"
      - "$SOURCE_CODE_PATH/$OBJECTS_DIRECTORY/*.csproj.nuget.*"
      - "$NUGET_PACKAGES_DIRECTORY"
    policy: pull-push
  coverage: /Total\s*\|\s*(\d+(?:\.\d+)?)/
  artifacts:
    paths:
      - '**/*test-result.xml'
      - '**/bin/'
      - '**/*coverage.cobertura.xml'
      - "$SOURCE_CODE_PATH/$OBJECTS_DIRECTORY/project.assets.json"
      - "$NUGET_PACKAGES_DIRECTORY"
    reports:
      junit:
        - '**/*test-result.xml'
      cobertura:
        - '**/*coverage.cobertura.xml'


.dotnet.pack:
  image: $DOTNET_IMAGE
  artifacts:
    paths:
      - '**/bin/$BUILD_TARGET/*.nupkg'
  script:
    - PACKAGE_VERSION="$VERSION"
    - if [ -n "$CI_MERGE_REQUEST_ID" ]; then PACKAGE_VERSION="${VERSION}-dev"; fi;
    - dotnet pack -p:PackageVersion="$PACKAGE_VERSION" "$SOURCE_CODE_PATH" -c "$BUILD_TARGET" --no-build --packages "$NUGET_PACKAGES_DIRECTORY"

.dotnet.push:
  image: $DOTNET_IMAGE
  script:
    - dotnet nuget add source "$NUGET_REPO" --name gitlab --username ???? --password ???? --store-password-in-clear-text
    - dotnet nuget push "**/bin/$BUILD_TARGET/*.nupkg" --source gitlab

内容的提问来源于stack exchange，提问作者Bilel-NEJI