温馨提示×

Jenkins配置步骤是什么

小樊
39
2026-08-04 16:26:05
栏目: 编程语言

Jenkins 的配置步骤会根据部署方式(本地、Docker、K8s)使用场景(CI/CD、流水线、权限等)有所不同。下面我给你一个通用、标准、从零开始的 Jenkins 配置流程,适合大多数企业或个人项目。


一、Jenkins 安装(基础前提)

✅ 方式一:Docker 安装(最常用,推荐)

docker run -d \
  --name jenkins \
  -p 8080:8080 \
  -p 50000:50000 \
  -v jenkins_home:/var/jenkins_home \
  jenkins/jenkins:lts

访问:

http://localhost:8080

✅ 方式二:Linux 系统安装(以 Ubuntu 为例)

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

wget -q -O - https://pkg.jenkins.io/debian-stable/jenkins.io.key | sudo apt-key add -
sudo sh -c 'echo deb https://pkg.jenkins.io/debian-stable binary/ > /etc/apt/sources.list.d/jenkins.list'

sudo apt update
sudo apt install jenkins -y
sudo systemctl start jenkins

二、Jenkins 初始化配置(首次启动)

1️⃣ 解锁 Jenkins

查看初始密码:

docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword

cat /var/lib/jenkins/secrets/initialAdminPassword

在页面输入密码。


2️⃣ 安装插件

推荐选择:

  • 安装推荐插件(Install suggested plugins)

常用插件(后续可补装):

  • Git
  • Pipeline
  • Docker Pipeline
  • Blue Ocean
  • Credentials Binding
  • SSH Agent

3️⃣ 创建管理员账号

设置:

  • 用户名
  • 密码
  • 邮箱

三、全局系统配置(重点)

✅ 1. 全局工具配置

路径:

Manage Jenkins → Global Tool Configuration

配置内容:

  • JDK
  • Git
  • Maven / Gradle
  • NodeJS
  • Docker

示例(Git):

Name: Default Git
Path: /usr/bin/git

✅ 2. 系统配置

路径:

Manage Jenkins → Configure System

常见配置:

  • Jenkins URL
  • 全局环境变量
  • 邮件通知(SMTP)
  • 构建超时时间

四、凭证(Credentials)配置(非常重要)

路径:

Manage Jenkins → Manage Credentials

常用凭证类型

类型 用途
Username + Password Git / 服务器
SSH Private Key Git / SSH
Secret Text Token(GitHub、DockerHub)

示例:

  • GitHub Token
  • Docker Hub 密码
  • 服务器 SSH Key

五、创建任务(Job / Pipeline)

✅ 方式一:Freestyle 项目(简单)

适合:

  • 新手
  • 简单构建

步骤:

  1. New Item → Freestyle project
  2. 配置 Git 仓库
  3. 构建步骤(Shell / Bat)
  4. 保存并构建

✅ 方式二:Pipeline(企业生产级,推荐)

1️⃣ 新建 Pipeline 项目

New Item → Pipeline

2️⃣ Pipeline 脚本示例

pipeline {
    agent any

    stages {
        stage('拉取代码') {
            steps {
                git 'https://github.com/your/repo.git'
            }
        }

        stage('构建') {
            steps {
                sh 'mvn clean package'
            }
        }

        stage('部署') {
            steps {
                sh 'docker build -t myapp .'
            }
        }
    }
}

六、权限与安全配置(企业必做)

✅ 启用权限控制

路径:

Manage Jenkins → Configure Global Security

推荐:

  • ✅ Logged-in users can do anything
  • Role-Based Strategy

七、常见集成配置

✅ Jenkins + Git

  • Webhook
  • Poll SCM
  • GitHub / GitLab 插件

✅ Jenkins + Docker

  • Docker Agent
  • Docker Pipeline

✅ Jenkins + K8s

  • Kubernetes Plugin
  • 动态 Slave

八、备份与维护

备份 Jenkins

/var/jenkins_home

jenkins_home 数据卷

升级 Jenkins

  • 插件升级
  • Jenkins WAR 升级

九、标准 Jenkins 配置流程总结

安装 Jenkins
↓
初始化(解锁 + 插件)
↓
全局工具配置
↓
凭证配置
↓
创建 Job / Pipeline
↓
权限配置
↓
集成 Git / Docker / K8s
↓
持续维护

如果你愿意,我可以:

  • ✅ 给你 Docker + Jenkins + Git + Spring Boot 全流程
  • ✅ 给你 Jenkinsfile 模板
  • ✅ 对比 Jenkins vs GitLab CI
  • ✅ 按 公司生产环境给你定制配置方案

你可以直接告诉我:你现在的部署环境和使用场景是什么?

0