GitHub与SonarQube集成时无法查看Secrets标签的问题求助

问题背景 #

我正在进行GitHub与SonarQube的集成，已完成以下步骤：

• 创建了GitHub App
• 在组织中安装了GitHub App

但在执行第三步创建GitHub Secrets时，尽管拥有仓库的完整管理员权限，却无法在Settings中看到Secrets标签（截图：Settings页面无Secrets标签）。当前使用GitHub Enterprise Server 3.12.5版本，已完成以下排查：

• 确认自身拥有仓库完整管理员权限
• 查阅多份官方文档，添加Secrets的步骤均指向Settings中的Secrets标签
• Jenkins与SonarQube的集成已正常运行

需要解决两个问题：

1. 是否存在特定配置遗漏导致Secrets标签无法显示？
2. 有无无需使用Secrets标签即可完成集成的替代方法？

一、Secrets标签不显示的可能原因及解决 #

1. GitHub Actions功能未启用 #

GitHub仓库的Secrets标签（针对Actions）依赖GitHub Actions功能的启用状态：

• 组织层级检查：联系组织管理员进入「组织Settings → Actions → General」，确认已启用GitHub Actions，且当前仓库在允许使用Actions的列表中
• 仓库层级检查：进入「仓库Settings → Actions → General」，确认Actions功能处于启用状态

2. 组织权限策略限制 #

即使你拥有仓库管理员权限，组织可能对Secrets操作做了额外限制：

• 联系组织管理员进入「组织Settings → Permissions → Secrets and variables → Actions」，确认管理员组拥有管理Secrets的权限，且未对仓库做权限限制

3. 特殊仓库类型限制 #

如果是GitHub Pages仓库或其他特殊类型仓库，可能会隐藏Secrets标签，但这种情况极少发生，可确认仓库类型是否为普通代码仓库。

二、无需Secrets标签的集成替代方案 #

1. 直接在Workflow中注入SonarQube令牌（私有仓库可用） #

在SonarQube项目中生成分析令牌，直接写入GitHub Actions workflow文件（仅建议在私有仓库使用，避免令牌泄露）：

jobs:
  sonarqube-scan:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0 # 完整克隆仓库以支持SonarQube分析
      - name: Run SonarQube Scan
        uses: SonarSource/sonarqube-scan-action@v2
        env:
          SONAR_TOKEN: "你的SonarQube项目分析令牌"
          SONAR_HOST_URL: "你的SonarQube实例地址"

2. 利用已创建的GitHub App直接认证 #

由于已创建并安装GitHub App，可跳过Secrets存储，直接通过GitHub App完成SonarQube与GitHub的认证：

1. 进入SonarQube的GitHub集成设置页面，选择「GitHub App认证」模式
2. 填入GitHub App的ID、私钥（从GitHub App的Settings页面获取）等信息，SonarQube会直接通过GitHub App完成身份验证，无需在GitHub仓库存储额外Secrets

3. 使用组织级Secrets #

如果仓库级Secrets不可用，但能访问组织级Secrets：

1. 联系组织管理员进入「组织Settings → Secrets and variables → Actions」，添加SonarQube所需的SONAR_TOKEN和SONAR_HOST_URL
2. 在仓库的Workflow中直接引用组织级Secrets：

jobs:
  sonarqube-scan:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - name: Run SonarQube Scan
        uses: SonarSource/sonarqube-scan-action@v2
        env:
          SONAR_TOKEN: ${{ secrets.ORG_SONAR_TOKEN }}
          SONAR_HOST_URL: ${{ secrets.ORG_SONAR_HOST_URL }}

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