Jenkins如何与服务器集成

Jenkins与服务器集成的实用方案

一 集成方式总览

• SSH/SCP/SFTP 直连：在目标服务器开启 SSH(22)，Jenkins 通过凭据（密码或私钥）执行远程命令或传输文件，适合传统虚拟机、物理机部署。
• Publish Over SSH 插件：在 Jenkins 中集中管理远程主机，支持“上传产物 + 远程执行命令”，常用于构建后自动部署到 Tomcat/Nginx 等目录。
• 代理节点 Agent：把目标服务器作为 Jenkins Agent，在目标机上直接执行构建与部署，适合异构环境、需要本地工具链的场景。
• Docker 集成：在服务器上启用 Docker，Jenkins 通过 Docker 插件或管道在目标主机/集群上构建与运行容器，适合云原生交付。
• FTP 等协议：在受控网络或遗留系统中，可用 FTP 上传构建产物（安全性较低，优先 SSH）。

二 快速上手步骤 SSH 或 Publish Over SSH

• 准备目标服务器
  • 安装基础工具（如 Git、Maven），创建用于 Jenkins 的 远程工作目录，并确保 SSH 服务运行（端口 22）。
• 方式 A Publish Over SSH（推荐）
  • 安装插件：进入 系统管理 → 管理插件 → 可选插件，安装 Publish Over SSH。
  • 配置主机：进入 系统管理 → 系统设置 → Publish over SSH，新增远程服务器，填写 Hostname、Username、Port，选择凭据（密码或 SSH 私钥），点击 Test Configuration 验证连通性。
  • 在任务中使用：在构建后操作选择 Send build artifacts over SSH，配置 Source files、Remove prefix、Remote directory、Exec command（如解压、备份、重启服务）。
• 方式 B 直接在构建步骤执行 SSH
  • 在 Execute shell 中使用 scp/sftp/ssh 命令上传并部署，例如：
    • scp target/app.jar user@host:/opt/app/
    • ssh user@host “cd /opt/app && ./restart.sh”
• 适用场景
  • 将 WAR/JAR 推送到 Tomcat/webapps 或应用目录，远程解压并重启服务，实现一键发布。

三 代理节点 Agent 集成

• 在目标服务器准备 Java 与运行环境，创建 Jenkins 工作目录，并开启 SSH。
• 在 Jenkins 中 新建节点：进入 系统管理 → 新建节点，命名并配置 远程工作目录、标签、执行器数量 等；在 Credentials 中添加可登录该服务器的凭据。
• 保存后启动代理，并在任务配置中通过 标签选择器 指定在该节点上运行，适合需要本地编译工具链（如 Maven/Gradle/Node.js）的项目。

四 在 CentOS 上的落地示例

• 安装与启动
  • 安装 Java 11：sudo yum install java-11-openjdk-devel -y
  • 添加仓库并安装 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 jenkins -y
  • 启动并设置开机自启：sudo systemctl start jenkins && sudo systemctl enable jenkins
  • 开放端口：sudo firewall-cmd --permanent --zone=public --add-port=8080/tcp && sudo firewall-cmd --reload
• 基本任务配置
  • 安装插件：Git、Maven Integration、Pipeline 等。
  • 新建 Freestyle 或 Pipeline 任务，配置 Git 源码管理、构建触发器（轮询 SCM 或 Webhook）、构建步骤（如 mvn clean package），构建后通过 SSH 或 Publish Over SSH 部署产物。
• 可选 Docker 集成
  • 安装 Docker，在 Jenkins 中安装 Docker 插件，在 系统设置 → Docker 配置 Docker URL（如 unix:///var/run/docker.sock） 并测试连接，实现在目标主机上构建与运行容器。

五 常见问题与最佳实践

• 连通性测试：优先用 Test Configuration 或命令行 ssh user@host 验证凭据与网络；确保 SSH 端口 22 放行。
• 凭据安全：优先使用 SSH 私钥，配合 Jenkins 凭据存储 管理；避免明文密码。
• 传输与回滚：使用 rsync + SSH 做增量同步，保留历史版本目录，部署脚本实现 备份 → 部署 → 健康检查 → 回滚。
• 触发策略：生产环境建议 Webhook + 参数化构建（选择分支/环境），开发环境可用 轮询 SCM。
• 日志与审计：通过 Console Output 定位问题，关键步骤加日志打印与退出码判断，必要时接入 企业微信/钉钉 通知。