如何在GitLab CI/CD流水线设置全局环境变量？Gradle项目配置求助

核心原因 #

GitLab CI/CD变量默认是环境变量，而Gradle的setting.gradle在初始化阶段（早于项目build.gradle）默认不会自动将环境变量映射为Gradle属性，因此直接配置的变量无法被识别。

可行解决方案 #

方案1：CI脚本中注入临时gradle.properties #

在.gitlab-ci.yml中，执行Gradle命令前将GitLab变量写入临时gradle.properties，让setting.gradle能读取到这些属性：

stages:
  - build

build_job:
  stage: build
  script:
    # 注入Artifactory凭证到gradle.properties
    - echo "artifactory.username=$ARTIFACTORY_USERNAME" >> gradle.properties
    - echo "artifactory.password=$ARTIFACTORY_PASSWORD" >> gradle.properties
    # 执行构建
    - ./gradlew build
  after_script:
    # 可选：清理临时写入的敏感信息
    - sed -i '/artifactory.username/d' gradle.properties
    - sed -i '/artifactory.password/d' gradle.properties

若项目无gradle.properties，可先执行touch gradle.properties创建空文件再写入。

方案2：setting.gradle直接读取环境变量 #

修改setting.gradle，同时兼容本地gradle.properties和CI环境变量：

// setting.gradle 配置片段
def artifactoryUsername = System.getenv("ARTIFACTORY_USERNAME") ?: project.findProperty("artifactory.username")
def artifactoryPassword = System.getenv("ARTIFACTORY_PASSWORD") ?: project.findProperty("artifactory.password")

dependencyResolutionManagement {
    repositories {
        maven {
            url "https://your-artifactory-url/repo"
            credentials {
                username = artifactoryUsername
                password = artifactoryPassword
            }
        }
    }
}

方案3：用Gradle专属前缀配置CI变量 #

GitLab CI中给变量添加ORG_GRADLE_PROJECT_前缀，Gradle会自动将其识别为项目属性，无需修改代码或CI脚本：

• 在GitLab CI变量中，用户名设为ORG_GRADLE_PROJECT_artifactory.username，密码设为ORG_GRADLE_PROJECT_artifactory.password
• 此时setting.gradle可直接使用artifactory.username和artifactory.password，与本地gradle.properties配置完全一致。

常见操作误区排查 #

• 确认GitLab CI变量类型为「变量」而非「文件」，若分支非保护分支，不要勾选「保护变量」
• 检查变量名大小写匹配：CI环境变量默认大写（如ARTIFACTORY_USERNAME），Gradle属性通常为小写带点格式
• 确保setting.gradle中引用的属性名与CI变量映射关系正确（比如CI变量是ARTIFACTORY_USER，代码里却读artifactory.username会导致匹配失败）

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