centos jenkins部署教程

CentOS 部署 Jenkins 教程

一 环境准备与安装

• 更新系统并安装 Java（推荐 OpenJDK 11，也可使用 OpenJDK 8）：
  • sudo yum update -y
  • sudo yum install -y java-11-openjdk-devel
  • java -version
• 添加 Jenkins 官方仓库并安装：
  • 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 -y jenkins
• 说明：Jenkins 2.357+ 要求 Java 11 或更高版本；如使用 CentOS 7/8/Stream 9，上述仓库与安装方式均适用。

二 启动与防火墙配置

• 启动服务并设置开机自启：
  • sudo systemctl daemon-reload
  • sudo systemctl start jenkins
  • sudo systemctl enable jenkins
  • sudo systemctl status jenkins
• 开放访问端口（默认 8080；如启用 JNLP 代理还需开放 50000/tcp）：
  • sudo firewall-cmd --permanent --add-port=8080/tcp
  • sudo firewall-cmd --permanent --add-port=50000/tcp
  • sudo firewall-cmd --reload
• 访问地址：http://<服务器IP>:8080。

三 初始化与插件安装

• 获取初始管理员密码并解锁：
  • sudo cat /var/lib/jenkins/secrets/initialAdminPassword
  • 将密码粘贴到 Web 页面完成解锁。
• 安装插件与创建管理员：
  • 选择 Install suggested plugins 安装推荐插件，或按需选择；随后创建管理员账户并完成向导。
• 可选优化（国内环境加速插件下载）：
  • 进入 Manage Jenkins → Plugin Manager → Advanced，将 Update Site URL 替换为：https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json，然后重新检查更新并安装。

四 常用配置与CI/CD示例

• 修改默认端口（如需要）：
  • 编辑 /etc/sysconfig/jenkins，修改 JENKINS_PORT=“8081”，保存后重启：sudo systemctl restart jenkins
• 全局安全与凭据：
  • 进入 Manage Jenkins → Security，启用安全并禁用匿名访问；在 Manage Jenkins → Credentials 中添加 SSH 私钥/用户名+密码 等凭据，用于拉取代码与部署。
• 示例流水线（Java + Maven，托管于 GitHub）：
  • 生成 SSH 密钥：ssh-keygen -t rsa -b 4096 -f ~/.ssh/jenkins_github
  • 将公钥（~/.ssh/jenkins_github.pub）添加为 GitHub 仓库的 Deploy Key
  • Jenkins 中创建 Pipeline 项目，选择 Pipeline script from SCM，配置 Git 仓库与凭据
  • 示例 Jenkinsfile： pipeline { agent any stages { stage(‘Build’) { steps { sh ‘mvn clean package’ } } stage(‘Test’) { steps { sh ‘mvn test’ } } stage(‘Deploy’) { when { branch ‘master’ } steps { sh ‘mvn deploy’ } } } }
• 触发方式：可配置 Webhook（GitHub → Settings → Webhooks → Payload URL: http:///github-webhook/）或 轮询 SCM。

五 常见问题与运维建议

• 端口冲突排查：
  • ss -tulpen | grep 8080 或 netstat -tuln | grep 8080
  • 修改 /etc/sysconfig/jenkins 的 JENKINS_PORT 后重启服务
• 查看日志定位故障：
  • sudo journalctl -u jenkins -xe
• 权限与目录：
  • 确保 /var/lib/jenkins、/var/cache/jenkins、/var/log/jenkins 目录属主为 jenkins:jenkins，避免因权限导致启动失败
• 性能与稳定性：
  • 调整 JVM 堆大小（如 -Xms/-Xmx）、限制并发构建数、定期清理旧构建与工作空间
  • 插件按需安装与及时更新，避免不兼容
  • 生产建议：分离 Controller/Agent、使用反向代理（Nginx）+ HTTPS、定期备份 $JENKINS_HOME。