温馨提示×

Debian Jenkins配置步骤有哪些

小樊
41
2025-09-21 13:22:49
栏目: 智能运维

1. 安装Java环境
Jenkins依赖Java运行时环境(JRE),需先安装OpenJDK 11(或更高版本)。执行以下命令:

sudo apt update && sudo apt install -y openjdk-11-jdk

验证安装:java -version,输出应包含Java版本信息。

2. 添加Jenkins官方软件源
为获取最新稳定版Jenkins,需添加其官方Debian仓库:

wget -q -O - https://pkg.jenkins.io/debian/jenkins.io.key | sudo apt-key add -
echo "deb http://pkg.jenkins.io/debian-stable binary/" | sudo tee /etc/apt/sources.list.d/jenkins.list

更新软件包索引:sudo apt update

3. 安装Jenkins
通过APT安装Jenkins:

sudo apt install -y jenkins

安装完成后,Jenkins服务会自动启动。

4. 启动Jenkins服务并设置开机自启

sudo systemctl enable jenkins  # 设置开机自启动
sudo systemctl start jenkins   # 启动服务

检查服务状态:sudo systemctl status jenkins,确认状态为“active (running)”。

5. 访问Jenkins控制面板
在浏览器中输入http://<服务器IP>:8080(默认端口8080),首次访问需解锁Jenkins。

6. 解锁Jenkins
获取初始管理员密码:

sudo cat /var/lib/jenkins/secrets/initialAdminPassword

将输出的密码粘贴到Web界面的“Unlock Jenkins”输入框中。

7. 安装必要插件
进入“Manage Jenkins > Plugin Manager”,选择“Recommended plugins”(推荐插件)安装,或手动选择以下核心插件:

  • Pipeline:支持流水线构建;
  • Git Integration:集成Git版本控制;
  • Docker:支持Docker容器操作(可选);
  • Credentials Binding:安全管理凭据(如SSH密钥、Git账号)。

8. 配置全局工具与环境变量
进入“Manage Jenkins > Configure System”,设置以下内容:

  • JDK路径:若系统有多个JDK版本,指定Jenkins使用的JDK路径(如/usr/lib/jvm/java-11-openjdk-amd64);
  • Git路径:若Git未在系统PATH中,指定Git可执行文件路径;
  • 环境变量:添加项目所需的环境变量(如MAVEN_HOMEPYTHONPATH),点击“Save”保存。

9. 配置凭据管理
进入“Manage Jenkins > Credentials”,添加代码托管平台(如GitHub、GitLab)的访问凭据:

  • 选择“SSH Username with private key”类型,输入用户名和私钥(或通过“Enter directly”粘贴私钥);
  • 或添加Git账号的“Username and password”类型凭据,用于代码拉取。

10. 创建自动化构建任务

  • 点击“New Item”,输入任务名称(如my-python-app),选择“Pipeline”类型,点击“OK”;
  • 在“Pipeline”配置页,选择“Pipeline script from SCM”(从SCM获取流水线脚本);
  • 配置SCM类型(如“Git”),输入代码仓库URL(如https://github.com/your-repo/my-python-app.git),选择对应的凭据;
  • 在“Script Path”中指定流水线脚本路径(如Jenkinsfile,需存放在代码仓库根目录)。

11. 配置自动化触发器(可选)
为实现代码提交后自动触发构建,可配置Git钩子:

  • 进入代码仓库的.git/hooks目录,创建post-commit文件:
    cd /path/to/your/repo/.git/hooks
    echo '#!/bin/sh' > post-commit
    echo "curl http://<Jenkins服务器IP>:8080/job/my-python-app/build" >> post-commit
    chmod +x post-commit
    
    此脚本会在每次提交后向Jenkins发送构建请求。

12. 配置防火墙(可选但推荐)
若系统启用了ufw防火墙,需开放Jenkins相关端口:

sudo ufw allow 8080/tcp   # Jenkins Web界面端口
sudo ufw allow 50000/tcp  # Jenkins Agent通信端口(若使用分布式构建)
sudo ufw reload

0