1. 创建第一个自由风格项目

任务目标

在Jenkins中创建一个自由风格项目(Freestyle Project),配置一个执行echo命令的构建步骤,手动触发构建并查看控制台输出,验证Jenkins任务执行链路是否正常。

前置条件

  • 已安装Jenkins(版本2.303+),可通过http://localhost:8080访问
  • 已使用管理员账号登录Jenkins
  • Jenkins主节点可正常执行shell命令(Linux/macOS)或批处理命令(Windows)

操作步骤

  1. 点击Jenkins首页左上角新建任务(或New Item)
  2. 输入任务名称:first-freestyle-project,选择自由风格项目(Freestyle project),点击确定
  3. 在构建部分,点击添加构建步骤,选择执行 shell(Linux/macOS)或执行 Windows 批处理命令(Windows)
  4. 在命令输入框中粘贴以下脚本:
echo "=== Jenkins Freestyle Project Started ==="
echo "Build ID: ${BUILD_ID}"
echo "Job Name: ${JOB_NAME}"
echo "Workspace: ${WORKSPACE}"
echo "=== Build Completed Successfully ==="
  1. 点击保存
  2. 进入任务页面,点击左侧立即构建(Build Now)
  3. 在构建历史中点击最新构建号(如#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 批处理命令”。
  • 控制台输出为空:检查构建步骤是否已正确添加并保存,重新触发一次构建。