Linux下Jenkins怎样配置环境

Linux下Jenkins环境配置全流程

一 准备与安装

• 安装 Java：Jenkins 需要 Java 11 或 17（LTS）。例如在 Ubuntu/Debian 上执行：sudo apt update && sudo apt install openjdk-11-jdk -y；在 CentOS/RHEL 上执行：sudo yum install java-11-openjdk-devel -y。完成后用 java -version 验证。
• 安装 Jenkins（Debian/Ubuntu 系）：导入密钥并添加仓库（推荐新版签名方式）
  curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key | sudo tee /usr/share/keyrings/jenkins-keyring.asc > /dev/null
  echo “deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc] https://pkg.jenkins.io/debian-stable binary/” | sudo tee /etc/apt/sources.list.d/jenkins.list > /dev/null
  sudo apt update && sudo apt install jenkins -y
  启动与开机自启：sudo systemctl enable --now jenkins；查看状态：sudo systemctl status jenkins。
• 安装 Jenkins（RHEL/CentOS 系）：sudo wget -O /etc/yum.repos.d/jenkins.repo https://pkg.jenkins.io/redhat-stable/jenkins.repo
  sudo rpm --import https://pkg.jenkins.io/redhat-stable/jenkins.io.key
  sudo yum install jenkins -y；sudo systemctl enable --now jenkins。
• 访问与解锁：浏览器打开 http://<服务器IP>:8080，首次解锁密码在 /var/lib/jenkins/secrets/initialAdminPassword。
• 可选 Docker 部署：docker run -d --name jenkins -p 8080:8080 -p 50000:50000 -v jenkins_home:/var/jenkins_home jenkins/jenkins:lts。

二 防火墙与端口

• 开放 8080 端口：
  Ubuntu/Debian（ufw）：sudo ufw allow 8080
  CentOS/RHEL（firewalld）：sudo firewall-cmd --permanent --add-port=8080/tcp && sudo firewall-cmd --reload
• 如与 Tomcat 等冲突，可修改端口：编辑 /etc/default/jenkins（或 /etc/sysconfig/jenkins），将 JENKINS_PORT=8080 改为其他端口（如 10896），然后重启服务。

三 全局工具与构建环境

• 安装构建工具（系统层面）：提前安装 JDK 11/17、Maven、Git，确保命令行可直接执行 java、mvn、git。
• Jenkins 全局工具配置：进入 Manage Jenkins → Global Tool Configuration
  • JDK：取消“自动安装”，填写已安装 JAVA_HOME 路径。
  • Maven：配置 Maven 安装目录 与 settings.xml 路径。
  • Git：可直接填写 git（PATH 可达即可）。
• 常用环境变量（系统级，建议设置）：
  • 在 /etc/profile 或相应 profile 中导出：export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64；export MAVEN_HOME=/opt/maven；export PATH=$PATH:$JAVA_HOME/bin:$MAVEN_HOME/bin；执行 source /etc/profile 生效。
• 可选优化：在 Manage Jenkins → Configure System → Global properties → Environment variables 增加
  • JAVA_TOOL_OPTIONS=-Dfile.encoding=UTF-8
  • LANG=zh_CN.UTF-8
    以避免构建过程出现编码与本地化问题。

四 环境变量配置方式

• 管理界面全局变量：Manage Jenkins → System → Global properties → Environment variables，添加键值对，对所有任务生效。
• 任务级变量：在具体任务 配置 → 构建环境，勾选“使用特定的环境变量”，仅对当前任务生效。
• Pipeline 中定义：
  pipeline {
  agent any
  environment {
  MY_VAR = ‘my_value’
  }
  stages {
  stage(‘Example’) {
  steps {
  echo “The value of MY_VAR is ${env.MY_VAR}”
  }
  }
  }
  }
• 构建步骤脚本中导出：在“执行 shell”中 export MY_VAR=xxx，仅对当前构建步骤及其子进程有效。
• 系统服务层注入：编辑 /etc/default/jenkins（或 /usr/lib/systemd/system/jenkins.service），在 JAVA_ARGS 或 Environment 中追加变量，然后 sudo systemctl restart jenkins 使配置生效。

五 常见问题与快速排查

• 端口占用：修改 /etc/default/jenkins（或 /etc/sysconfig/jenkins）中的 JENKINS_PORT，重启服务；或停用占用 8080 的进程。
• 权限问题：Jenkins 默认以 jenkins 用户运行，确保该用户对 JENKINS_HOME、工作空间、工具目录具备读写权限；必要时在配置中调整运行用户（不推荐直接使用 root）。
• 工具不可用：在 Global Tool Configuration 明确指定 JDK/Maven/Git 路径；命令行执行 which java/mvn/git 确认在 PATH 中。
• 构建乱码：在系统或 Jenkins 全局属性中设置 LANG=zh_CN.UTF-8 与 JAVA_TOOL_OPTIONS=-Dfile.encoding=UTF-8。
• 插件安装慢：在 Manage Plugins → Advanced 将更新站点改为国内镜像（如清华源）以加速。