Skip to main content

建 Jenkins 平台步骤

以下是搭建 Jenkins 项目平台 的完整步骤，涵盖 安装、配置、流水线创建 和 自动化部署，适用于 Linux/Windows 环境：

1. 安装 Jenkins

Linux (Ubuntu/CentOS)

# 安装 Java (Jenkins 依赖)
sudo apt update && sudo apt install openjdk-11-jdk -y  # Ubuntu
sudo yum install java-11-openjdk -y                   # CentOS

# 添加 Jenkins 仓库并安装
curl -fsSL https://pkg.jenkins.io/debian/jenkins.io.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 binary/" | sudo tee /etc/apt/sources.list.d/jenkins.list > /dev/null
sudo apt update && sudo apt install jenkins -y

# 启动 Jenkins
sudo systemctl start jenkins
sudo systemctl enable jenkins

Windows

  1. 下载 Jenkins Windows Installer 并运行。
  2. 安装完成后，访问 http://localhost:8080。

2. 初始配置

  1. 解锁 Jenkins
    访问 http://<服务器IP>:8080，输入初始密码（路径在终端显示，通常为 /var/lib/jenkins/secrets/initialAdminPassword）。
  2. 安装推荐插件
    选择 "Install suggested plugins"（包括 Git、Pipeline 等核心插件）。
  3. 创建管理员账户
    设置用户名和密码。

3. 关键插件安装

进入 Manage Jenkins > Plugins，安装以下插件：

  • Git：代码仓库集成。
  • Pipeline：定义流水线任务。
  • Docker：容器化构建支持。
  • Blue Ocean：可视化流水线编辑器（可选）。
  • SSH Agent：远程服务器部署。

4. 创建第一个流水线项目

方式1：自由风格项目

  1. 新建任务 > 选择 "Freestyle project"。
  2. 配置 Git 仓库：
    • 在 "Source Code Management" 中选择 Git，填写仓库 URL（如 https://github.com/your-repo.git）。
    • 添加凭据（GitHub 用户名/密码或 SSH 密钥）。
  3. 构建触发器：
    • 定时构建：H/5 * * * *（每5分钟检查一次）。
    • GitHub Webhook：需在 GitHub 仓库设置中配置 Webhook URL（http://<Jenkins-IP>:8080/github-webhook/）。
  4. 构建步骤：
    • 执行 Shell 命令（如 mvn clean package）或调用 Docker 构建。

方式2：Pipeline 脚本（推荐）

  1. 新建任务 > 选择 "Pipeline"。
  2. 在 Pipeline 选项卡中，输入脚本示例： 
    pipeline {
    agent any
    stages {
        stage('Checkout') {
            steps {
                git 'https://github.com/your-repo.git'
            }
        }
        stage('Build') {
            steps {
                sh 'mvn clean package'
            }
        }
        stage('Test') {
            steps {
                sh 'mvn test'
            }
        }
        stage('Deploy') {
            steps {
                sh 'docker build -t myapp .'
                sh 'docker push myrepo/myapp'
            }
        }
    }
}

5. 集成 Docker 和 Kubernetes

Docker 构建

  1. 确保 Jenkins 服务器已安装 Docker，并将 Jenkins 用户加入 docker 组： 
    sudo usermod -aG docker jenkins
sudo systemctl restart jenkins
  2. 在 Pipeline 中添加 Docker 步骤： 
    stage('Docker Build') {
    steps {
        script {
            docker.build("myapp:${env.BUILD_ID}").push()
        }
    }
}

Kubernetes 部署

  1. 安装 Kubernetes CLI (kubectl) 并配置 ~/.kube/config。
  2. 添加 Pipeline 阶段： 
    stage('Deploy to k8s') {
    steps {
        sh 'kubectl apply -f k8s/deployment.yaml'
    }
}

6. 配置自动化触发

GitHub Webhook

  1. 在 GitHub 仓库 > Settings > Webhooks 中添加：
    • Payload URL: http://<Jenkins-IP>:8080/github-webhook/
    • Content type: application/json
  2. 在 Jenkins 任务中勾选 "GitHub hook trigger for GITScm polling"。

Jenkinsfile（代码即配置）

  1. 在项目根目录创建 Jenkinsfile，提交到仓库。
  2. Jenkins 任务选择 "Pipeline script from SCM"，指定仓库和文件路径。

7. 监控与安全

  • 日志查看：
    进入任务控制台输出界面，实时查看构建日志。
  • 权限管理：
    Manage Jenkins > Configure Global Security，启用 "Role-Based Strategy"。
  • 备份：
    定期备份 /var/lib/jenkins 目录。

8. 常见问题解决

  • 权限不足： 
    sudo chown -R jenkins:jenkins /var/lib/jenkins
  • 插件安装失败：
    更换 Jenkins 插件镜像源（Manage Jenkins > Plugin Manager > Advanced，修改 Update Site 为清华镜像）。
  • 端口冲突：
    修改 Jenkins 端口： 
    sudo systemctl edit jenkins
# 添加 Environment="JENKINS_PORT=8081"
sudo systemctl restart jenkins

总结

  • 快速开始：通过 Docker 或包管理器一键安装 Jenkins。
  • 核心能力：通过 Pipeline 实现代码构建、测试、部署全自动化。
  • 扩展性：集成 Docker/K8s、GitHub Webhook 等现代工具链。

完成后，团队可实现代码提交后自动触发测试和部署，显著提升交付效率！ 🚀

No Comments
Back to top