jenkins如何安装配置

下面给你一份从零开始安装与配置 Jenkins的实用指南，覆盖 Linux（最常用）、Windows、Docker 三种方式，并包含基础配置步骤。

一、Jenkins 简介

Jenkins 是一个开源的**持续集成 / 持续交付（CI/CD）**工具，用于：

• 自动构建
• 自动测试
• 自动部署

二、环境准备

基本需求

• JDK（Jenkins 2.4xx 需要 Java 11 或 17）
• 至少 2GB 内存（推荐 4GB+）
• 端口：默认 8080

检查 Java

java -version

如果没有 Java：

# Ubuntu
sudo apt install openjdk-17-jdk

# CentOS
sudo yum install java-17-openjdk

三、Linux 安装 Jenkins（推荐）

1️⃣ 添加 Jenkins 源（Ubuntu 示例）

sudo apt update
sudo apt install -y wget curl gnupg

wget -O - https://pkg.jenkins.io/debian/jenkins.io.key | sudo gpg --dearmor -o /usr/share/keyrings/jenkins.gpg

echo "deb [signed-by=/usr/share/keyrings/jenkins.gpg] https://pkg.jenkins.io/debian binary/" | sudo tee /etc/apt/sources.list.d/jenkins.list

sudo apt update

2️⃣ 安装 Jenkins

sudo apt install jenkins -y

3️⃣ 启动 Jenkins

sudo systemctl start jenkins
sudo systemctl enable jenkins

4️⃣ 查看状态

sudo systemctl status jenkins

四、Windows 安装 Jenkins

1. 下载安装包
   https://www.jenkins.io/download/
2. 双击 jenkins.msi
3. 按向导安装（会注册为 Windows 服务）
4. 浏览器访问：

   http://localhost:8080
   

五、Docker 安装 Jenkins（最快）

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

查看初始密码：

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

六、初始配置 Jenkins

1️⃣ 访问页面

http://服务器IP:8080

2️⃣ 解锁 Jenkins

查看管理员密码：

# Linux
sudo cat /var/lib/jenkins/secrets/initialAdminPassword

3️⃣ 安装插件

• 选择 “安装推荐插件”
• 常用插件：
  • Git
  • Maven Integration
  • Pipeline
  • Docker
  • SSH

4️⃣ 创建管理员用户

设置：

• 用户名
• 密码
• 邮箱

七、基础配置（必做）

1️⃣ 配置 JDK

Manage Jenkins → Global Tool Configuration

• JDK → 添加 JDK
• 取消“自动安装”
• 填写 JAVA_HOME

2️⃣ 配置 Git

which git

填入路径，如：

/usr/bin/git

3️⃣ 配置 Maven（Java 项目）

• 添加 Maven
• 指定 MAVEN_HOME

八、创建一个简单任务（Freestyle）

1. 新建任务 → Freestyle project
2. 源码管理 → Git
3. 构建 → 执行 shell

mvn clean package

4. 保存并构建

九、常见问题

❌ 端口被占用

修改：

sudo vim /etc/default/jenkins

HTTP_PORT=9090

❌ 插件安装慢

使用国内镜像：

https://mirrors.tuna.tsinghua.edu.cn/jenkins/

❌ Jenkins 无法启动

journalctl -u jenkins -f

十、下一步建议

• 学习 Jenkins Pipeline（Jenkinsfile）
• 集成 GitLab / GitHub Webhook
• 配合 Docker / Kubernetes

如果你告诉我：

• ✅ 操作系统（Ubuntu / CentOS / Windows）
• ✅ 用途（Java /前端 / Docker / K8s）

我可以给你更针对性的安装和流水线示例。