如何在Jenkins Linux节点启动时自动执行配置命令？

问题描述 #

我希望实现类似Linux用户登录时.bashrc文件的效果，让Jenkins Linux节点/代理在启动时执行配置命令（不限于Git配置），比如执行Git相关配置：

git config --global http.extraHeader "Authorization: Basic ${B64_PAT}"

或者：

git config --global credential.helper manager
git config --global credential.https://dev.azure.com.usehttppath true

想从Jenkins主节点配置Linux节点，实现启动时自动执行这些预先配置的命令，避免新增节点时手动登录虚拟机重复操作。有没有办法在Jenkins节点配置中实现这个自动化？

解决方案 #

方法1：通过Jenkins节点配置的预启动命令/初始化脚本

这是最直接的从主节点管控的方式，根据代理启动方式不同操作略有区别：

• SSH启动代理：在节点配置页面展开「高级」选项，找到**「启动前执行的命令」**（Pre-launch command），把需要执行的命令填进去，多命令用分号分隔：

  git config --global credential.helper manager; git config --global credential.https://dev.azure.com.usehttppath true
  

  每次代理通过SSH启动时，都会先执行这些命令。
• JNLP/Web启动代理：在节点配置的「节点属性」中添加**「初始化脚本」**（Init Script），用Groovy脚本调用shell命令：

  def gitConfigCmd = """
  git config --global http.extraHeader "Authorization: Basic ${B64_PAT}"
  git config --global credential.helper manager
  git config --global credential.https://dev.azure.com.usehttppath true
  """.execute()
  gitConfigCmd.waitFor()
  // 可选：输出执行日志
  println "初始化命令执行结果：\n${gitConfigCmd.in.text}"
  

  节点启动时会自动执行这段脚本。

方法2：自动配置Jenkins代理用户的shell配置文件

如果Jenkins代理使用固定系统用户（比如jenkins）运行，可以通过预启动命令自动修改该用户的.bashrc或.bash_profile，实现类似登录执行的效果：

# 将配置命令追加到用户的bashrc文件
echo 'git config --global credential.helper manager' >> ~/.bashrc
echo 'git config --global credential.https://dev.azure.com.usehttppath true' >> ~/.bashrc

只需在节点第一次启动时执行一次，后续该用户启动shell时都会自动加载这些配置。如果需要批量管理，也可以结合自动化工具批量推送配置文件。

方法3：流水线任务级别的预初始化（补充方案）

如果你的配置是针对特定流水线任务的，可以在流水线的初始化阶段执行命令，虽然不是节点启动时执行，但能确保任务运行前环境配置正确：

pipeline {
    agent { label 'linux-node' }
    stages {
        stage('环境初始化') {
            steps {
                sh '''
                    git config --global http.extraHeader "Authorization: Basic ${B64_PAT}"
                    git config --global credential.helper manager
                '''
            }
        }
        // 后续业务阶段...
    }
}

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