Huawei Cloud EulerOS 2.

安装 Jenkins
Huawei Cloud EulerOS 2.0

安装 Jenkins 目前服务器上已经有openjdk21
一、环境准备
当前服务器环境:
-
操作系统:Huawei Cloud EulerOS 2.0

-
已安装 JDK:OpenJDK 21
确认 JDK 版本(执行以下命令):
java -version
预期输出示例:
openjdk version "21" 2023-09-19
OpenJDK Runtime Environment (build 21+35-2513)
OpenJDK 64-Bit Server VM (build 21+35-2513, mixed mode, sharing)
二、安装 Jenkins
2.1 添加 Jenkins 官方仓库
执行以下命令导入 Jenkins GPG 密钥:
sudo rpm --import https://pkg.jenkins.io/redhat-stable/jenkins.io.key
强制导入正确的 GPG 密钥(解决校验失败)
sudo rpm --import https://pkg.jenkins.io/redhat-stable/jenkins.io-2023.key
绕过官方慢源,国内高速安装
sudo dnf install -y jenkins --nogpgcheck
装完后执行(必须)
sudo systemctl daemon-reload
sudo systemctl start jenkins
sudo systemctl enable jenkins
sudo systemctl status jenkins
创建 Jenkins 仓库文件:
sudo tee /etc/yum.repos.d/jenkins.repo <<EOF
jenkins
name=Jenkins
baseurl=https://pkg.jenkins.io/redhat-stable
gpgcheck=1
EOF
2.2 安装 Jenkins 软件包
更新 yum 缓存并安装 Jenkins:
sudo yum clean all
sudo yum makecache
安装最新版 Jenkins
sudo yum install -y jenkins
编辑 Jenkins 配置文件:
sudo vi /etc/sysconfig/jenkins
修改指定jdk路径
JENKINS_JAVA_CMD="/usr/bin/java"
2.3 启动并设置开机自启
启动 Jenkins 服务:
sudo systemctl start jenkins
设置开机自启:
sudo systemctl enable jenkins
检查服务状态:
sudo systemctl status jenkins
预期输出包含active (running)表示启动成功。
三、防火墙配置
开放 Jenkins 默认端口(8080):
sudo firewall-cmd --add-port=8080/tcp --permanent
sudo firewall-cmd --reload
四、初始化 Jenkins
4.1 访问 Jenkins 网页界面
在浏览器中输入服务器 IP 地址和端口:
4.2 获取初始管理员密码
执行以下命令查看初始密码:
sudo cat /var/lib/jenkins/secrets/initialAdminPassword
将输出的密码复制到网页界面的输入框中,点击"继续"。

4.3 安装推荐插件
选择"安装推荐的插件",等待插件安装完成。

选社区推荐
一、社区必装核心(100% 必装,初始化就该勾)
这是全球 Jenkins 社区公认的 "标配",少一个都不好用:
- Pipeline (流水线核心,现代 Jenkins 基石)
- Pipeline: Stage View (流水线可视化,看阶段状态)
- Git + Git Client (拉代码必备,几乎所有项目)
- Credentials Binding (安全管理账号 / 密钥 / Token)
- Localization: Chinese (Simplified) (简体中文汉化)
- Role-Based Authorization Strategy (基于角色的权限管理,社区首选)
- Timestamper (日志加时间戳,排查问题必备)
- Workspace Cleanup (构建后自动清理空间)
- Job Configuration History (配置变更记录 + 回滚,运维必备)
- Build Timeout (防止构建卡死占资源)

4.4 创建管理员用户
按照提示填写管理员用户名、密码、邮箱等信息,完成后点击"保存并完成"。
4.5 完成初始化
确认 Jenkins URL(默认无需修改),点击"开始使用 Jenkins",至此安装完成。
五、验证安装
使用创建的管理员账号登录 Jenkins,进入主界面,验证是否正常加载。
六、常见问题处理
6.1 JDK 版本兼容性
若启动 Jenkins 时报错"Unsupported Java version",可能是 Jenkins 版本与 OpenJDK 21 不兼容。解决方案:
sudo yum remove jenkins
sudo yum install -y jenkins-2.401.3-1.1 (或其他兼容 OpenJDK 21 的版本)
6.2 端口占用问题
若 8080 端口被占用,修改 Jenkins 配置文件:
sudo vi /etc/sysconfig/jenkins
修改JENKINS_PORT="8080"为其他未占用端口,保存后重启服务:
sudo systemctl restart jenkins