下面是以centos举例,详细告诉大家如何搭建jenkins进行自动化代码的持续集成
环境准备
-
更新系统包
sudo yum update -y
2.安装依赖工具
Jenkins 需要 Java 环境
(1)先下载java安装包
wget https://download.oracle.com/java/21/latest/jdk-21_linux-x64_bin.tar.g
(2)解压缩归档文件
下载完成后,使用以下命令解压缩 tar.gz 文件:
tar -xvzf jdk-21_linux-x64_bin.tar.gz
(3)移动解压缩后的 JDK 目录到 /usr/local
将解压缩后的 JDK 目录移动到 /usr/local
目录中:
sudo mv jdk-21.0.4 /usr/local/
(4)配置 JAVA_HOME 和 PATH 环境变量
安装nano
python
sudo yum install nano
打开或者创建文件 /etc/profile.d/java.sh
文件:
sudo nano /etc/profile.d/java.sh
在文件中加入以下内容:
export JAVA_HOME=/usr/local/jdk-21.0.4
export PATH=$JAVA_HOME/bin:$PATH
保存并关闭文件后,使更改立即生效:
source /etc/profile.d/java.sh
(5)验证安装
通过运行以下命令验证 Java 是否安装并配置成功:
java -version
应该会显示类似于以下的输出:
java version "21.0.1" 2023-10-17
Java(TM) SE Runtime Environment (build 21.0.1+8)
Java HotSpot(TM) 64-Bit Server VM (build 21.0.1+8, mixed mode)
3、安装 Jenkins
(1)添加 Jenkins 仓库
sudo wget -O /etc/yum.repos.d/jenkins.repo https://pkg.jenkins.io/redhat/jenkins.repo
sudo rpm --import https://pkg.jenkins.io/redhat/jenkins.io-2023.key
(2)安装 Jenkins
sudo yum install jenkins
注意,在这里如果遇到类似:"Could not resolve host: mirrorlist.centos.org; Unknown error"这样的报错,编辑CentOS-Base.repo文件
python
sudo nano /etc/yum.repos.d/CentOS-Base.repo
然后将里面内容变成:其实在这里换的就是yum源,也可以换成其他可用的源,比如阿里源
python
# CentOS-Base.repo
#
# The mirror system uses the connecting IP address of the client and the
# update status of each mirror to pick mirrors that are updated to and
# geographically close to the client. You should use this for CentOS updates
# unless you are manually picking other mirrors.
#
# If the mirrorlist= does not work for you, as a fall back you can try the
# remarked out baseurl= line instead.
#
#
[base]
name=CentOS-$releasever - Base
#mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=os&infra=$infra
baseurl=http://vault.centos.org/7.9.2009/os/$basearch/
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-7
#released updates
[updates]
name=CentOS-$releasever - Updates
#mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=updates&infra=$infra
baseurl=http://vault.centos.org/7.9.2009/updates/x86_64/
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-7
#additional packages that may be useful
[extras]
name=CentOS-$releasever - Extras
#mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=extras&infra=$infra
baseurl=http://vault.centos.org/7.9.2009/extras/x86_64/
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-7
执行命令清除缓存
python
sudo yum clean all
然后再次执行更新命令
python
sudo yum upgrade
最终jenkins安装成功会如下图所示,可以通过命令查看:rpm -qa | grep jenkins
(3)启动并设置 Jenkins 在系统启动时自动启动
sudo systemctl start jenkins.service
sudo systemctl enable jenkins
sudo systemctl start jenkins
如果在启动的时候无法启动:有可能是之前安装的java不兼容,这个时候可以把之前安装的java卸载
1)切换到安装目录
2)删除安装包
python
sudo rm -rf sudo rm -rf jdk-21.0.4
- 移除环境变量设置并使之生效
python
sudo nano /etc/profile.d/java.sh
source /etc/profile.d/java.sh
如下就是已经卸载成功
4)重新安装java
python
# 选择适合自己的linux系统的java版本,由于我的是cenos7,所以下载链接是下面这个
sudo wget https://download.oracle.com/java/17/archive/jdk-17.0.11_linux-x64_bin.rpm
# 安装
sudo yum localinstall jdk-17.0.11_linux-x64_bin.rpm
#查看java17是否安装成功
java -version
再次执行上面步骤:(3)启动并设置 Jenkins 在系统启动时自动启动
如何jenkins启动成功,可以看到如下图
打开 Jenkins 的防火墙端口
sudo firewall-cmd --permanent --remove-service=jenkins
sudo firewall-cmd --permanent --new-service=jenkins
sudo firewall-cmd --permanent --service=jenkins --set-short="Jenkins ports"
sudo firewall-cmd --permanent --service=jenkins --set-description="Jenkins port exceptions"
sudo firewall-cmd --permanent --service=jenkins --add-port=8080/tcp
sudo firewall-cmd --permanent --add-service=jenkins
sudo firewall-cmd --reload
- 在浏览器中访问 Jenkins
在浏览器中访问http://<your_server_ip_or_domain>:8080
。
如果访问的时候,页面打不开
尝试从以下几个方面解决:
1)编辑/etc/sysconfig/jenkins文件
python
sudo vi /etc/sysconfig/jenkins
初次访问时需要输入初始管理员密码。你可以通过以下命令找到该密码:
sudo cat /var/lib/jenkins/secrets/initialAdminPassword
Jenkins 初始设置
- 进行初始设置
- 选择"Install Suggested Plugins"来安装推荐的插件。
- 创建管理员用户。
- 配置 Jenkins URL。
安装必要的 Jenkins 插件
- 安装 Python 插件
通过 Jenkins 的插件管理 (Manage Jenkins
->Manage Plugins
) 安装以下插件:ShiningPanda
(Python 插件)
配置 Jenkins 执行 Python 任务
- 创建一个新的 Jenkins 任务
- 在 Jenkins 主页面点击"New Item"。
- 输入任务名称并选择"Freestyle project"。
- 在 "General" 部分,根据需要配置描述等信息。
- 配置任务的源码管理
- 在 "Source Code Management" 部分,根据你的版本控制系统(比如 Git)添加对应的配置信息。
- 构建环境
- 在 "Build Environment" 部分,勾选 "Provide Node & Label" 并选择 Python 版本。
- 构建步骤
-
在 "Build" 部分,点击
Add build step
并选择 "Execute Shell"。 -
在 Shell 脚本中输入运行 Python 自动化脚本的命令。例如:
python3 -m venv venv source venv/bin/activate pip install -r requirements.txt python run_tests.py
-
配置定时触发
- 设置定时触发
-
在 "Build Triggers" 部分,勾选 "Build periodically"。
-
使用日程表格式的表达式来设定构建频率。例如,若每天凌晨2点运行自动化测试脚本,Cron 表达式如下:
H 2 * * *
-
确保一切正常
- 测试 Jenkins 任务
- 手动触发一次 Jenkins 任务,确保配置无误并且测试脚本能成功运行。
- 监控并解决潜在问题
- 查看 Jenkins 控制台输出日志,确保每次构建都能成功完成并记录任何可能的错误。
这样,你的 Jenkins 配置就完成了,可以定时运行 Python 自动化测试。定期检查 Jenkins 的构建结果和输出日志,确保一切运行正常并及时处理错误。