在运维工作中，jenkins 获取不到服务器上的环境变量如何排查？

在运维工作中，Jenkins 获取不到服务器上的环境变量是一个常见的问题。这可能涉及 Jenkins 的配置、环境变量的加载方式，以及脚本的执行方式等多个方面。以下是详细的排查步骤和解决方案：

1. 确认环境变量是否在服务器上正确设置

1.1 检查服务器上的环境变量

首先，登录到目标服务器，确认环境变量是否正确设置。可以通过以下命令检查：

echo $VARIABLE_NAME
env | grep VARIABLE_NAME

如果环境变量未设置，需要在服务器的配置文件中添加。常见的配置文件包括：

• .bashrc
• .bash_profile
• /etc/profile
• /etc/environment

1.2 确认变量的作用域

环境变量的作用域分为：

• 全局变量：对所有用户生效，通常设置在 /etc/profile 或 /etc/environment 中。
• 用户变量：仅对当前用户生效，通常设置在 .bashrc 或 .bash_profile 中。

如果变量是用户变量，确保 Jenkins 使用的用户（如 jenkins 用户）有权访问该变量。

2. 检查 Jenkins 是否加载了环境变量

2.1 检查 Jenkins 的环境变量

在 Jenkins 中，可以通过以下方式查看可用的环境变量：

1. 访问 Jenkins 的 系统信息页面：

   http://<Jenkins_URL>/systemInfo

   在该页面中搜索 env，查看加载的环境变量。

2. 在 Jenkins Pipeline 或自由风格项目中，打印环境变量：

   pipeline {
       agent any
       stages {
           stage("Print Env Variables") {
               steps {
                   script {
                       sh 'env'
                   }
               }
           }
       }
   }

   或者在自由风格项目的构建步骤中添加：

   env

2.2 检查 Jenkins 是否加载了服务器的环境变量

如果 Jenkins 是通过 SSH 连接到远程服务器执行命令的，需要确保远程服务器的环境变量被正确加载。可以通过以下方式测试：

ssh user@remote_host "env"

如果远程服务器的环境变量未加载，可能是因为 SSH 默认以非交互式方式执行命令，不会加载 .bashrc 或 .bash_profile。

3. 确保环境变量在 Jenkins 中生效

3.1 在 Jenkins 中显式加载环境变量

如果环境变量未自动加载，可以通过以下方式显式加载：

• 在 SSH 命令中加载环境变量：

  ssh user@remote_host "source ~/.bashrc && echo $VARIABLE_NAME"

• 在 Jenkins Pipeline 中加载环境变量：

  pipeline {
      agent any
      stages {
          stage("Load Env Variables") {
              steps {
                  script {
                      sh 'source ~/.bashrc'
                      sh 'echo $VARIABLE_NAME'
                  }
              }
          }
      }
  }

3.2 配置 Jenkins 全局环境变量

如果需要在 Jenkins 中全局使用某个环境变量，可以在 Jenkins 的 系统设置 中配置：

1. 进入 Jenkins 管理页面，选择 “系统设置”。
2. 在 “全局属性” 部分，勾选 “环境变量”。
3. 点击 “添加”，输入变量的名称和值。

4. 检查脚本的执行方式

4.1 确认脚本的执行环境

如果 Jenkins 是通过 SSH 远程执行脚本，需要确保脚本的执行环境与登录用户的环境一致。可以通过以下方式测试：

ssh user@remote_host "source ~/.bashrc && /path/to/your/script.sh"

或者在脚本中显式加载环境变量：

#!/bin/bash
source ~/.bashrc
# Your script logic here

4.2 检查脚本的 Shebang

确保脚本的 Shebang 指向正确的解释器路径。例如：

#!/usr/bin/env bash

或者：

#!/bin/bash

5. 验证环境变量是否生效

5.1 在 Jenkins 中验证

在 Jenkins Pipeline 或自由风格项目中，添加以下步骤验证环境变量是否生效：

pipeline {
    agent any
    stages {
        stage("Verify Env Variables") {
            steps {
                script {
                    sh 'echo $VARIABLE_NAME'
                }
            }
        }
    }
}

或者在自由风格项目的构建步骤中添加：

echo $VARIABLE_NAME

5.2 在远程服务器上验证

如果 Jenkins 是通过 SSH 远程执行命令的，可以通过以下方式验证：

ssh user@remote_host "source ~/.bashrc && echo $VARIABLE_NAME"

6. 常见问题及解决方案

6.1 SSH 不加载用户配置文件

SSH 默认以非交互式方式执行命令，不会加载 .bashrc 或 .bash_profile。可以通过以下方式解决：

• 在命令中显式加载配置文件：

  ssh user@remote_host "source ~/.bashrc && your_command"

• 修改远程服务器的 SSH 配置，允许加载用户配置文件（不推荐，可能有安全风险）。

6.2 Jenkins 使用的用户权限不足

如果 Jenkins 使用的用户（如 jenkins 用户）权限不足，无法访问某些环境变量，可以尝试以下方法：

• 确保环境变量对所有用户生效（设置在 /etc/profile 或 /etc/environment 中）。
• 修改 Jenkins 的运行用户，使用具有足够权限的用户。

6.3 环境变量在 Jenkins Pipeline 中未生效

如果环境变量在 Jenkins Pipeline 中未生效，可以尝试以下方法：

• 在 Pipeline 中显式加载环境变量：

  sh 'source ~/.bashrc'

• 使用 withEnv 包裹脚本：

  withEnv(["VARIABLE_NAME=value"]) {
      sh 'echo $VARIABLE_NAME'
  }

7. 我的总结

Jenkins 获取不到服务器上的环境变量，通常是由于环境变量未正确加载或 Jenkins 的执行方式导致的。通过以下步骤可以逐步排查和解决问题：

1. 确认环境变量在服务器上正确设置。
2. 检查 Jenkins 是否加载了环境变量。
3. 在 Jenkins 中显式加载环境变量。
4. 确保脚本的执行环境与登录用户一致。
5. 验证环境变量是否生效。