Jenkins多分支流水线添加环境变量：Django项目注入问题求助

我之前在做Django+Jenkins多分支流水线的时候，也踩过这个环境变量注入的坑！明明装了Environment Injector插件却死活不生效，后来折腾出几个靠谱的解决办法，分享给你：

方案1：在分支源配置中直接注入（最直接） #

多分支流水线的环境变量注入逻辑和普通流水线不太一样，直接在分支源里配置的变量优先级最高，而且会应用到所有分支：

• 打开你的Multibranch Pipeline项目，点击「配置」
• 找到「分支源」（比如你用的GitHub/GitLab源），展开「高级」选项
• 找到「环境变量」区域，点击「添加」，输入DB_PASSWORD作为变量名，填入对应的密码值
• 保存配置后，重新扫描分支，新的构建就会自动带上这个环境变量了

方案2：在Jenkinsfile中结合凭据管理定义（最安全） #

敏感信息比如DB密码绝对不能明文暴露，推荐用Jenkins的凭据管理来注入，同时在Jenkinsfile里明确声明环境变量：

pipeline {
    agent any
    environment {
        // 从Jenkins凭据库中拉取密码，这里假设你已创建了ID为`db_prod_password`的Secret Text凭据
        DB_PASSWORD = credentials('db_prod_password')
        // 非敏感变量可以直接定义
        DB_HOST = 'your-db-host'
    }
    stages {
        stage('Test Env Var') {
            steps {
                // 测试变量是否生效，生产环境建议删掉这一步
                sh 'echo $DB_PASSWORD'
                // Django项目执行迁移，settings.py要从环境变量读配置
                sh 'python manage.py migrate'
            }
        }
    }
}

同时确保你的Django settings.py里是从环境变量读取配置：

import os

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': 'your_db_name',
        'USER': 'your_db_user',
        'PASSWORD': os.environ.get('DB_PASSWORD', ''),
        'HOST': os.environ.get('DB_HOST', 'localhost'),
    }
}

方案3：正确配置Environment Injector插件（针对插件党） #

如果一定要用Environment Injector插件，得注意多分支流水线的特殊配置方式：

• 进入Multibranch Pipeline的「配置」页面，找到「流水线」部分
• 点击「添加构建步骤」，选择「Inject environment variables」
• 在弹出的配置框里，你可以选择从文件注入，或者直接输入键值对
• 注意：如果你的流水线是用Jenkinsfile定义的，插件注入的变量会被Jenkinsfile里的environment块覆盖，所以要调整两者的优先级，或者在Jenkinsfile里用withEnv来引用插件注入的变量

另外，建议把Environment Injector插件更新到最新版本，旧版本对多分支流水线的支持存在一些兼容性bug。

方案4：全局环境变量（不推荐，仅作备选） #

如果是所有项目都需要的公共变量，可以用Jenkins全局环境变量，但敏感信息绝对不能这么做：

• 进入Jenkins「系统管理」→「系统配置」
• 找到「全局属性」，勾选「环境变量」
• 添加DB_PASSWORD和对应的值，保存后所有项目都能访问这个变量

测试变量是否生效的小技巧 #

不管用哪种方案，都可以在Jenkinsfile里加一步sh 'printenv'，构建后查看控制台输出，确认DB_PASSWORD是否存在。

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