1. 创建第一个自由风格项目
任务目标
在Jenkins中创建一个自由风格项目(Freestyle Project),配置一个执行echo命令的构建步骤,手动触发构建并查看控制台输出,验证Jenkins任务执行链路是否正常。
前置条件
- 已安装Jenkins(版本2.303+),可通过
http://localhost:8080访问 - 已使用管理员账号登录Jenkins
- Jenkins主节点可正常执行shell命令(Linux/macOS)或批处理命令(Windows)
操作步骤
- 点击Jenkins首页左上角新建任务(或New Item)
- 输入任务名称:
first-freestyle-project,选择自由风格项目(Freestyle project),点击确定 - 在构建部分,点击添加构建步骤,选择执行 shell(Linux/macOS)或执行 Windows 批处理命令(Windows)
- 在命令输入框中粘贴以下脚本:
echo "=== Jenkins Freestyle Project Started ==="
echo "Build ID: ${BUILD_ID}"
echo "Job Name: ${JOB_NAME}"
echo "Workspace: ${WORKSPACE}"
echo "=== Build Completed Successfully ==="
- 点击保存
- 进入任务页面,点击左侧立即构建(Build Now)
- 在构建历史中点击最新构建号(如
#1),选择控制台输出查看执行日志
验证方法
控制台输出中应依次显示以下内容,且构建状态为成功(蓝色球图标):
=== Jenkins Freestyle Project Started ===
Build ID: 1
Job Name: first-freestyle-project
Workspace: /var/lib/jenkins/workspace/first-freestyle-project
=== Build Completed Successfully ===
Finished: SUCCESS
其中BUILD_ID、JOB_NAME、WORKSPACE的具体值由Jenkins自动注入,WORKSPACE路径取决于你的Jenkins安装目录。若输出中出现Finished: SUCCESS,且上述四行echo内容完整打印,则任务创建与执行链路验证通过。
常见问题
- 构建失败(红色球):点击构建号进入控制台输出,查看具体错误信息。常见原因为shell命令不存在或权限不足。
- 找不到“执行 shell”选项:确认Jenkins运行在Linux/macOS系统;Windows系统应选择“执行 Windows 批处理命令”。
- 控制台输出为空:检查构建步骤是否已正确添加并保存,重新触发一次构建。