咨询如何让Jenkins Pipeline正确将环境变量写入~/.bash_profile

• 第一种sh命令的方案失效通常是三个问题叠在一起导致的：
  • Jenkins服务默认以独立的jenkins系统账号运行，命令里的~会自动解析成Jenkins账号自己的家目录（一般是/var/lib/jenkins/），根本不是你手动登录服务器用的那个普通用户的家目录，写进去的内容其他用户手动登录时完全读不到
  • 非交互式shell执行时没有加载用户的全局配置，~的解析结果经常和预期偏差，偶尔还会直接把文件写到Jenkins项目的工作区根目录，根本不是系统层面的配置文件
  • Jenkins账号默认没有普通用户家目录的写权限，没有提前配置权限的话执行写入命令会直接报Permission denied错误
• 第二种writeFile方案的失效原因更直接：
  • Jenkins的writeFile步骤根本不解析~这种shell占位符，会直接在当前项目的工作区里创建一个名叫~的文件夹，在里面生成.bash_profile文件，完全找错了写入目标
  • writeFile默认是覆盖写入模式，就算路径找对了，也会把原来.bash_profile里的所有原有配置全部冲掉
  • 写入的文本内容少了export前缀，就算真的写进了正确路径，bash加载文件时也不会把这行识别为环境变量，只是个无效的普通文本行

• 第一步：彻底抛弃~占位符，所有写入路径全部用绝对路径。比如要给deploy用户写配置就直接填/home/deploy/.bash_profile，给root写就填/root/.bash_profile，从根源上避免路径解析错配。
• 第二步：提前对齐文件权限。如果要写入的文件不属于Jenkins服务账号，提前在目标服务器给Jenkins账号配置目标文件的读写权限，比如用ACL授权：setfacl -m u:jenkins:rw /home/deploy/.bash_profile，不要在流水线里临时用sudo提权，避免触发Jenkins的权限拦截规则。
• 第三步：根据自己选的步骤调整对应代码逻辑：
  • 选sh步骤实现的正确写法，用追加重定向保留原有内容，加全export前缀：

    stage("Def environment variable") {
        steps {
            sh 'echo "export VARIABLE_NAME=variable_value" >> /home/deploy/.bash_profile'
        }
    }
    

  • 选writeFile步骤实现的话，绝对不能直接覆盖写，要先读原有文件内容，把环境变量行拼到内容末尾再整体回写，对应代码：

    stage("Def environment variable") {
        steps {
            script {
                // 读取目标文件的原有内容
                originProfile = sh(script: 'cat /home/deploy/.bash_profile', returnStdout: true).trim()
                // 拼接新的环境变量配置，保证格式和手动操作一致
                finalProfileContent = originProfile + "\nexport VARIABLE_NAME=variable_value\n"
                // 写入绝对路径的目标文件
                writeFile file: '/home/deploy/.bash_profile', text: finalProfileContent
            }
        }
    }
    

• 额外校验点：写之前先确认目标用户手动登录时实际加载的shell配置文件是哪个，比如用zsh的用户加载的是~/.zshrc而不是.bash_profile，路径写错了就算写入成功，手动操作时也读不到对应的环境变量。

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