安装 Jenkins
1. 安装 Java
Jenkins 需要 Java 运行环境。你可以安装 OpenJDK 或 Oracle JDK。
使用 OpenJDK:
sudo apt update
sudo apt install openjdk-11-jdk
验证 Java 安装:
java -version
2. 安装 Jenkins
添加 Jenkins 仓库:
wget -q -O - https://pkg.jenkins.io/debian-stable/jenkins.io.key | sudo apt-key add -
sudo sh -c 'echo deb http://pkg.jenkins.io/debian-stable binary/ > /etc/apt/sources.list.d/jenkins.list'
更新包列表并安装 Jenkins:
sudo apt update
sudo apt install jenkins
3. 启动 Jenkins
sudo systemctl start jenkins
设置 Jenkins 开机自启动:
sudo systemctl enable jenkins
4. 配置防火墙(如果需要)
确保防火墙允许 Jenkins 默认端口(8080)的流量。
sudo ufw allow 8080
访问 Jenkins Web 界面
打开浏览器,访问 Jenkins 的 Web 界面:
http://<your-server-ip>:8080
初始化 Jenkins
-
解锁 Jenkins:
- 第一次访问 Jenkins 时,你会看到一个解锁页面。
- 打开终端,运行以下命令获取初始管理员密码:
sudo cat /var/lib/jenkins/secrets/initialAdminPassword
- 将获取到的密码复制并粘贴到 Jenkins 界面中的“Administrator password”字段中,然后点击“Continue”。
-
安装插件:
- Jenkins 会提示你选择安装推荐的插件或自定义插件。建议选择“Install suggested plugins”(安装建议插件)。
- 等待插件安装完成。
-
创建第一个管理员用户:
- 插件安装完成后,Jenkins 会提示你创建第一个管理员用户。填写用户名、密码、全名和电子邮件地址,然后点击“Save and Finish”。
-
实例配置:
- 完成用户创建后,点击“Start using Jenkins”开始使用 Jenkins。
配置 Jenkins
1. 配置全局工具
- 进入 Jenkins 主界面,点击左侧菜单栏的“Manage Jenkins”。
- 选择“Global Tool Configuration”。
- 添加 Maven、Git 等工具的路径或自动安装配置。
2. 配置 Jenkins 用户权限
- 进入 Jenkins 主界面,点击左侧菜单栏的“Manage Jenkins”。
- 选择“Configure Global Security”。
- 选择“Matrix-based security”或“Project-based Matrix Authorization Strategy”,根据需要配置用户权限。
3. 创建 Jenkins Job
-
创建一个新的 Jenkins Job:
- 进入 Jenkins 主界面,点击左上角的“New Item”。
- 输入 Job 名称(例如
MyMavenProject
),选择 Job 类型(例如 Freestyle project),然后点击“OK”。
-
配置 Source Code Management:
- 在“Source Code Management”部分,选择“Git”。
- 输入项目的 Git 仓库 URL(例如
https://github.com/yourusername/yourproject.git
)。 - 添加 Git 凭证(如果需要)。
-
配置 Build Triggers:
- 在“Build Triggers”部分,选择“Poll SCM”。
- 输入调度表达式(例如
H/5 * * * *
表示每 5 分钟轮询一次)。
-
配置 Build Steps:
- 在“Build”部分,点击“Add build step”。
- 选择“Invoke top-level Maven targets”。
- 输入 Maven 版本(例如
3.6.3
)。 - 输入目标(例如
clean install
)。
-
配置 Post-build Actions:
- 在“Post-build Actions”部分,点击“Add post-build action”。
- 选择“Archive the artifacts”。
- 输入要归档的文件模式(例如
target/*.jar
)。
-
保存配置:
- 点击“Save”保存配置。
运行 Jenkins Job
-
手动触发构建:
- 进入 Job 页面,点击“Build Now”手动触发构建。
-
查看构建结果:
- 构建完成后,点击“Build History”中的构建编号,查看构建日志和结果。
其他常用配置
1. 配置 Jenkins 代理节点
- 进入 Jenkins 主界面,点击左侧菜单栏的“Manage Jenkins”。
- 选择“Manage Nodes and Clouds”。
- 点击“New Node”。
- 输入节点名称,选择节点类型(永久或临时),然后点击“OK”。
- 配置节点信息,包括标签、远程根目录、启动方法等。
- 点击“Save”保存配置。
2. 配置 Jenkins 插件
- 进入 Jenkins 主界面,点击左侧菜单栏的“Manage Jenkins”。
- 选择“Manage Plugins”。
- 在“Available”标签页中搜索需要的插件,勾选后点击“Install without restart”。
- 在“Installed”标签页中查看已安装的插件。
总结
以上是 Jenkins 的基本配置步骤,涵盖了从安装到创建和运行 Job 的全过程。