第一章：认识你的自动化媒人——Jenkins
在现代软件开发中，我们经常会遇到这种场景：代码在本地运行得好好的，但一提交到团队仓库就开始各种“闹脾气”。难道我们注定要浪费时间在手动测试和部署上吗？当然不！
Jenkins是一个用Java编写的开源持续集成工具，但它对Ruby和PHP这类脚本语言项目同样情有独钟。想象一下，有一个不知疲倦的助手，每次你推送代码到仓库，它都会自动运行测试、检查代码质量，甚至帮你部署到服务器。
持续集成这个术语由Martin Fowler于2000年提出，它鼓励团队在一天之中多次集成代码，避免集成冲突，并以同样的频率部署功能和修正缺陷。而Jenkins正是实现这一理念的完美工具。
设想一个场景：你刚完成了一个令人兴奋的Ruby on Rails功能，本地测试全部通过，但当你合并到主分支后，却发现与其他团队成员的代码冲突，导致应用崩溃。有了Jenkins，这个问题在代码合并前就会被发现，大大减少了调试时间和团队摩擦。
对于PHP项目也是如此。想象一个团队开发的大型PHP应用，每个人负责不同模块，如果没有自动化流程，每次集成都可能是一场噩梦。Jenkins就像是团队中的超级协调员，确保所有代码和谐共处。
第二章：Jenkins相亲准备——安装与基础配置
2.1 如何迎娶Jenkins回家
在Ubuntu上安装Jenkins其实非常简单，只需要几条命令就能搞定：
wget -q -O - https://pkg.jenkins.io/debian/jenkins-ci.org.key | sudo apt-key add -
sudo sh -c 'echo deb http://pkg.jenkins.io/debian-stable binary/ > /etc/apt/sources.list.d/jenkins.list'
sudo apt-get update
sudo apt-get install jenkins
安装完成后，Jenkins会自动创建一个名为jenkins的用户，并在8080端口启动服务。你可以通过浏览器访问http://your_server_ip:8080来打开Jenkins界面。
注意：对于内存小于1GB的服务器，Jenkins在构建时可能会因为内存不足而崩溃，建议使用至少1GB内存的服务器。
另一种推荐的安装方式是使用Docker，这种方式更加轻量且易于管理：
docker run -d --name jenkins -p 8080:8080 -p 50000:50000 jenkins/jenkins:lts
2.2 初次见面设置
首次访问Jenkins时，你需要输入初始密码。这个密码存储在服务器的文件中：
cat /var/lib/jenkins/secrets/initialAdminPassword
输入密码后，按照提示创建管理员账户，并安装推荐的插件。这些插件包括Git集成、Pipeline支持等，为后续的项目构建奠定基础。
2.3 为Ruby和PHP准备闺房
对于Ruby on Rails项目，我们需要为Jenkins用户配置Ruby环境。推荐使用RVM管理Ruby版本：
# 切换到jenkins用户
sudo su - jenkins
# 安装RVM
gpg --keyserver hkp://keys.gnupg.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3
\curl -sSL https://get.rvm.io | bash
# 将RVM加入shell环境
echo '[[ -s "$HOME/.rvm/scripts/rvm" ]] && source "$HOME/.rvm/scripts/rvm"' >> ~/.bashrc
source ~/.bashrc
# 安装项目所需的Ruby版本
rvm install 2.6.5
rvm use 2.6.5
# 安装Bundler
gem install bundler
不要忘记安装Rails应用可能需要的系统依赖：
sudo apt-get install autoconf bison build-essential libssl-dev libyaml-dev libreadline6 libreadline6-dev zlib1g zlib1g-dev libcurl3-dev libpq-dev nodejs
是的，Rails需要JavaScript运行时环境，所以Node.js是必须的。
对于PHP项目，配置相对简单，但同样需要确保安装正确的PHP版本和Composer：
# 安装PHP和Composer
sudo apt-get install php php-xml php-mbstring php-curl composer
第三章：与Ruby on Rails的浪漫邂逅——完整自动化示例
3.1 前期准备——见家长前的打扮
让我们来看一个真实的Rails项目Jenkins配置示例。假设我们有一个名为"blog_app"的Rails项目，托管在GitHub上。
首先，我们需要进行数据库配置。在Jenkins服务器上创建数据库配置文件~/ci_database.yml：
default: &default
host: localhost
adapter: postgresql
encoding: unicode
pool: 5
test:
<<: *default
database: blog_app_test
username: postgres
password: password
接着是SSH密钥配置。为Jenkins用户生成SSH密钥，并添加到GitHub账户：
sudo su - jenkins
ssh-keygen -t rsa
cat ~/.ssh/id_rsa.pub
将公钥内容添加到GitHub账户的SSH密钥设置中。
3.2 Freestyle项目配置——简单直接的相亲方式
对于初学者，Freestyle项目更易于上手。新建一个Freestyle项目后，我们需要配置几个关键部分：
- 源代码管理：在"Source Code Management"部分选择Git，填写你的仓库URL。
- 构建触发器：设置何时触发构建。你可以选择轮询SCM（定期检查代码变更）、GitHub钩子（代码推送时自动触发）或其他触发器。
- 构建环境：在"Build Environment"中，选择"Run the build in a RVM-managed environment"，并指定你的Ruby版本。这确保了构建环境与你的开发环境一致。
- 构建步骤：添加构建步骤"Execute shell"，并编写构建脚本：
#!/bin/bash -xl
source ~/.bashrc
# 复制数据库配置
cp ~/ci_database.yml config/database.yml
# 安装gem依赖
bundle install --without production --path vendor/bundle
# 设置测试数据库
RAILS_ENV=test bundle exec rake db:drop db:create db:migrate
# 运行测试
RAILS_ENV=test bundle exec rake test
# 生成测试报告
RAILS_ENV=test bundle exec rake test:coverage
3.3 Pipeline高级配置——浪漫的长期恋爱关系
对于更复杂的项目，推荐使用Pipeline。Pipeline使用Groovy语法编写构建脚本，但别担心，即使你不熟悉Groovy，也能掌握基本用法。
在你的Rails项目根目录创建Jenkinsfile：
pipeline {
agent any
tools {
rvm 'ruby-2.6.5'
}
stages {
stage('Checkout') {
steps {
checkout scm
}
}
stage('Dependencies') {
steps {
sh 'bundle install --without production --path vendor/bundle'
}
}
stage('Setup DB') {
steps {
sh 'cp $HOME/ci_database.yml config/database.yml'
sh 'RAILS_ENV=test bundle exec rake db:drop db:create db:migrate'
}
}
stage('Test') {
steps {
sh 'RAILS_ENV=test bundle exec rake test'
}
post {
always {
junit 'test/reports/*.xml'
publishHTML(target: [
allowMissing: false,
alwaysLinkToLastBuild: true,
keepAll: true,
reportDir: 'coverage',
reportFiles: 'index.html',
reportName: 'Test Coverage'
])
}
}
}
stage('Deploy to Staging') {
steps {
sh '''
# 添加你的部署脚本 here
echo "Deploying to staging environment..."
'''
}
}
}
post {
failure {
emailext (
subject: "构建失败: ${currentBuild.fullDisplayName}",
body: "项目 ${env.JOB_NAME} 构建失败，请及时处理。",
to: "team@example.com"
)
}
success {
emailext (
subject: "构建成功: ${currentBuild.fullDisplayName}",
body: "项目 ${env.JOB_NAME} 构建成功。",
to: "team@example.com"
)
}
}
}
这个Pipeline定义了多个明确的阶段：代码检出、依赖安装、数据库设置、测试和部署。构建完成后，无论结果如何都会发送邮件通知。
Pipeline的优势在于你可以将构建脚本（Jenkinsfile）保存在项目仓库中，实现构建流程的版本控制。
第四章：与PHP项目的稳定婚姻——自动化部署实战
4.1 插件安装——为婚姻生活准备家具
要在Jenkins中实现PHP项目的持续交付，你需要先安装必要的插件：
- Git plugin：用于从Git仓库拉取代码
- Pipeline plugin：用于定义和执行管道
- PHP plugin：用于在Jenkins中配置PHP环境
- PHPUnit plugin（可选）：用于运行PHP单元测试
4.2 PHP项目的Pipeline配置——共建爱巢
在你的PHP项目根目录中创建一个名为Jenkinsfile的文件，用于定义持续交付的流程。以下是一个简单的示例：
pipeline {
agent any
stages {
stage('Checkout') {
steps {
git 'https://github.com/your-username/your-php-project.git'
}
}
stage('Composer Install') {
steps {
sh 'composer install'
}
}
stage('Run Tests') {
steps {
sh 'vendor/bin/phpunit'
}
}
stage('Deploy') {
steps {
// 根据你的服务器配置，使用SCP、FTP或其他方法将代码部署到服务器上
sh 'scp -r ./build user@your-server:/path/to/your/deployment/directory'
}
}
}
}
这个示例中的管道包含了四个阶段：Checkout（拉取代码）、Composer Install（安装依赖）、Run Tests（运行测试）和Deploy（部署代码）。
4.3 高级PHP流水线——婚姻的保鲜秘诀
对于更复杂的PHP项目，你可能需要添加代码质量检查、安全扫描等步骤。以下是一个更完整的示例：
pipeline {
agent any
environment {
APP_ENV = 'production'
}
stages {
stage('Checkout') {
steps {
checkout scm
}
}
stage('Composer Install') {
steps {
sh 'composer install --no-dev --optimize-autoloader'
}
}
stage('Code Quality') {
parallel {
stage('PHP Syntax Check') {
steps {
sh 'find . -name "*.php" -exec php -l {} \\;'
}
}
stage('PHP Code Sniffer') {
steps {
sh './vendor/bin/phpcs --standard=PSR2 src/'
}
}
}
}
stage('Test') {
steps {
sh './vendor/bin/phpunit --coverage-html coverage/'
}
post {
always {
junit 'build/logs/junit.xml'
publishHTML(target: [
allowMissing: false,
alwaysLinkToLastBuild: true,
keepAll: true,
reportDir: 'coverage',
reportFiles: 'index.html',
reportName: 'PHPUnit Test Coverage'
])
}
}
}
stage('Security Scan') {
steps {
sh './vendor/bin/security-checker security:check'
}
}
stage('Deploy') {
steps {
sh '''
# 使用rsync部署到生产服务器
rsync -avz --delete ./ user@production-server:/var/www/html/
# 清理OPcache
curl -s http://production-server/clear_cache.php
'''
}
}
}
post {
always {
emailext (
subject: "构建完成: ${currentBuild.fullDisplayName}",
body: "项目 ${env.JOB_NAME} 构建完成，状态: ${currentBuild.result}",
to: "dev-team@example.com"
)
}
}
}
这个高级Pipeline包含了并行执行的代码质量检查阶段，可以大大加快构建速度。同时，它还添加了安全扫描和OPcache清理等生产环境部署后的必要步骤。
第五章：婚姻辅导课——高级部署策略与优化
5.1 蓝绿部署——准备备胎，永不宕机
通过Jenkins，可以实现蓝绿部署，确保新版本的稳定性。蓝绿部署的原理是在两组生产环境中分别部署旧版本和新版本，通过流量切换实现无缝切换。
stage('Blue-Green Deployment') {
steps {
script {
// 确定当前部署的颜色（蓝色或绿色）
def currentColor = getCurrentDeploymentColor()
def newColor = currentColor == 'blue' ? 'green' : 'blue'
// 部署到非活动环境
sh "docker-compose -f docker-compose-${newColor}.yml up -d"
// 运行健康检查
sh "sleep 30" // 等待应用启动
def healthStatus = sh(script: "curl -s -o /dev/null -w '%{http_code}' http://your-app-${newColor}:8080/health", returnStdout: true).trim()
if (healthStatus == '200') {
// 切换流量
sh "docker exec nginx sed -i 's/your-app-${currentColor}/your-app-${newColor}/g' /etc/nginx/nginx.conf"
sh "docker exec nginx nginx -s reload"
// 停止旧环境
sh "docker-compose -f docker-compose-${currentColor}.yml down"
} else {
// 健康检查失败，回滚
sh "docker-compose -f docker-compose-${newColor}.yml down"
error "Health check failed for ${newColor} environment"
}
}
}
}
5.2 金丝雀发布——小心试探，降低风险
金丝雀发布是逐步增加新版本的流量比例，通过实时监控评估新版本的性能和稳定性。
stage('Canary Release') {
steps {
script {
// 部署新版本，但最初不接收流量
sh 'docker-compose -f docker-compose-canary.yml up -d'
// 将少量流量（例如5%）路由到新版本
sh 'docker exec nginx sed -i \'s/#canary/canary/g\' /etc/nginx/nginx.conf'
sh 'docker exec nginx nginx -s reload'
// 监控关键指标
sh 'sleep 300' // 监控5分钟
// 检查错误率
def errorRate = getErrorRateFromMonitoring()
if (errorRate < 0.01) { // 错误率低于1%
// 逐步增加流量到50%
sh 'docker exec nginx sed -i \'s/weight=5/weight=50/g\' /etc/nginx/nginx.conf'
sh 'docker exec nginx nginx -s reload'
sh 'sleep 300' // 再监控5分钟
errorRate = getErrorRateFromMonitoring()
if (errorRate < 0.01) {
// 将全部流量切换到新版本
sh 'docker exec nginx sed -i \'s/your-app-production/your-app-canary/g\' /etc/nginx/nginx.conf'
sh 'docker exec nginx nginx -s reload'
}
}
// 如果任何阶段错误率过高，回滚
if (errorRate >= 0.01) {
sh 'docker exec nginx sed -i \'s/canary/#canary/g\' /etc/nginx/nginx.conf'
sh 'docker exec nginx nginx -s reload'
sh 'docker-compose -f docker-compose-canary.yml down'
error 'Canary release failed due to high error rate'
}
}
}
}
5.3 回滚机制——吵架后的和好策略
在CI/CD流程中，必须设计回滚机制，确保在新版本出现问题时，能够快速回滚到之前的稳定版本。
stage('Rollback') {
steps {
script {
try {
// 尝试部署新版本
sh 'docker-compose -f docker-compose-new.yml up -d'
// 健康检查
def healthCheck = sh(
script: "curl -s -f http://your-app-new:8080/health || echo \"failed\"",
returnStdout: true
).trim()
if (healthCheck == 'failed') {
// 健康检查失败，触发回滚
echo "Health check failed, initiating rollback"
// 停止新版本
sh 'docker-compose -f docker-compose-new.yml down'
// 重新启动旧版本
sh 'docker-compose -f docker-compose-previous.yml up -d'
error 'Deployment failed, rolled back to previous version'
}
} catch (Exception e) {
// 部署过程中出现异常，触发回滚
echo "Exception during deployment: ${e.message}"
// 停止新版本
sh 'docker-compose -f docker-compose-new.yml down'
// 重新启动旧版本
sh 'docker-compose -f docker-compose-previous.yml up -d'
error 'Deployment failed due to exception, rolled back to previous version'
}
}
}
}
第六章：婚姻生活质量提升——监控与优化
6.1 监控与反馈
在Jenkins中，可以通过集成日志工具（如ELK Stack、Splunk）实时监控构建和部署过程中的日志，快速定位问题。
post {
always {
// 发送构建日志到ELK
sh '''
curl -X POST 'http://your-elasticsearch:9200/jenkins-builds/_doc' \\
-H 'Content-Type: application/json' \\
-d "{
\"job_name\": \"${env.JOB_NAME}\",
\"build_number\": \"${env.BUILD_NUMBER}\",
\"build_result\": \"${currentBuild.result}\",
\"build_time\": \"${currentBuild.duration}\",
\"commit_id\": \"${env.GIT_COMMIT}\"
}"
'''
// 发送通知到Slack
slackSend(
channel: '#ci-cd',
message: "构建 ${currentBuild.result}: Job '${env.JOB_NAME}' [${env.BUILD_NUMBER}] (${env.GIT_BRANCH} - ${env.GIT_COMMIT.take(7)})"
)
}
}
6.2 质量门禁——婚姻中的底线原则
在CI/CD流程中，可以设置质量门禁，确保只有通过测试的代码才能进入下一个阶段。例如：
- 单元测试通过率必须达到90%以上
- 集成测试通过率必须达到95%以上
stage('Quality Gate') {
steps {
script {
// 检查测试覆盖率
def coverage = getTestCoverage()
if (coverage < 0.9) { // 90%覆盖率要求
error "测试覆盖率不足90%，当前覆盖率为${coverage * 100}%"
}
// 检查代码质量
def qualityGateStatus = getSonarQualityGate()
if (qualityGateStatus != 'OK') {
error "代码质量门禁未通过"
}
// 检查安全漏洞
def securityIssues = getSecurityIssues()
if (securityIssues.critical > 0) {
error "存在关键安全漏洞，无法继续部署"
}
}
}
}
第七章：结语——白头偕老的自动化婚姻
通过基于Jenkins的CI/CD自动化部署，企业可以显著提升开发效率和代码质量，同时降低部署风险。从代码提交到生产部署，整个流程都可以通过自动化完成，从而实现"代码即交付"的目标。
无论是Ruby on Rails还是PHP项目，Jenkins都能提供强大的自动化支持。关键在于：
- 从小处着手：从简单的Freestyle项目开始，逐步过渡到复杂的Pipeline。
- 版本化一切：将Jenkinsfile与代码一起存放在版本控制中。
- 安全第一：合理管理凭证和权限，确保自动化流程的安全性。
- 监控与改进：持续监控CI/CD流程的性能，不断优化。
正如Martin Fowler所说："持续集成并不能消除bug，而是让它们浮出水面变得非常容易。"通过Jenkins自动化部署，我们可以及早发现问题，快速交付价值，让开发团队能够专注于创造性的工作，而不是繁琐的部署过程。
开始你的Jenkins自动化之旅吧，让你的Ruby和PHP应用享受"皇室般"的部署待遇！
扫一扫
46
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
