云电脑安装Jekins,自动化构建网站项目
在云电脑上安装Jenkins并配置自动化构建网站项目,核心是完成Java环境准备、Jenkins安装、插件配置和构建任务创建。
零基础用户按步骤操作,通常可在半小时内完成首次构建。
环境检查与Java准备
云电脑通常预装Linux系统,建议使用Ubuntu或CentOS。
首先确认系统版本和内存,Jenkins需要至少1GB内存,推荐2GB以上。
cat /etc/os-release
free -h
Jenkins依赖Java 11或17。
安装OpenJDK 17:
# Ubuntu/Debian
sudo apt update
sudo apt install -y openjdk-17-jdk
# CentOS/RHEL
sudo yum install -y java-17-openjdk-devel
验证Java安装:
java -version
看到版本号输出即表示成功。
安装Jenkins并启动服务
添加Jenkins官方仓库并安装。
以下命令适用于Ubuntu,CentOS可参考官方文档调整。
# 导入密钥
sudo wget -O /usr/share/keyrings/jenkins-keyring.asc \
https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key
# 添加仓库
echo "deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc] \
https://pkg.jenkins.io/debian-stable binary/" | sudo tee \
/etc/apt/sources.list.d/jenkins.list > /dev/null
# 安装
sudo apt update
sudo apt install -y jenkins
启动并设置开机自启:
sudo systemctl enable jenkins
sudo systemctl start jenkins
sudo systemctl status jenkins
状态显示active (running)即成功。
若启动失败,查看日志定位:sudo journalctl -u jenkins -n 50。
解锁与初始化配置
浏览器访问http://云电脑IP:8080,会看到解锁页面。
获取初始密码:
sudo cat /var/lib/jenkins/secrets/initialAdminPassword
复制密码填入网页,选择“安装推荐的插件”。
插件安装完成后,创建管理员账号,建议设置强密码并记录。
若云电脑安全组未放行8080端口,需在控制台添加入站规则。
创建自动化构建任务
以构建一个静态网站项目为例,假设代码托管在Git仓库。
- 在Jenkins首页点击“新建Item”,输入任务名如
build-website,选择“Freestyle project”,确定。 - 在“源码管理”选择Git,填入仓库URL和凭证。凭证可添加用户名密码或SSH密钥。
- 在“构建触发器”勾选“GitHub hook trigger for GITScm polling”或“Poll SCM”定时检查。若用Webhook,需在Git仓库配置回调地址
http://云电脑IP:8080/github-webhook/。 - 在“构建环境”可勾选“Delete workspace before build starts”确保干净构建。
- 在“构建”步骤添加“Execute shell”,根据项目类型填写命令。例如:
# 安装依赖并构建
npm install
npm run build
# 部署到网站目录
rsync -av --delete dist/ /var/www/html/
若项目使用Maven,可改用“Invoke top-level Maven targets”。
- 保存后点击“立即构建”,在“构建历史”查看控制台输出。
避坑指南
- 权限问题:Jenkins默认以
jenkins用户运行,若部署目录需要root权限,可修改目录属主或配置sudo免密。 - 端口冲突:8080被占用时,编辑
/etc/default/jenkins修改HTTP_PORT,重启服务。 - 插件安装慢:在“系统管理-插件管理-高级”中替换更新站点为国内镜像,如清华源。
- 构建失败:常见原因是环境变量缺失,可在“构建环境”中设置
PATH,或在Execute shell中显式指定命令绝对路径。
验证自动化效果
手动触发构建,观察控制台输出是否显示Finished: SUCCESS。
然后向Git仓库推送一次代码,若配置了Webhook或轮询,Jenkins应自动开始构建。
检查部署目录文件时间戳是否更新,浏览器访问网站确认内容变化。
自动化构建能减少手动部署错误,适合频繁更新的网站项目。
首次配置后,后续只需关注代码提交和构建结果通知。
常见疑问
云电脑重启后Jenkins会自启吗? 执行过systemctl enable jenkins就会自启,否则需手动启动。
构建时提示npm: command not found怎么办? 在云电脑上全局安装Node.js,或使用Jenkins的NodeJS插件配置。
如何让Jenkins构建后发送通知? 安装Email Extension或钉钉插件,在任务中配置收件人和触发条件。
能否构建Docker镜像? 可以,在构建步骤中执行docker build和docker push,需确保Jenkins用户有Docker权限。