1. 创建第一个Jenkins自由风格任务
任务目标
在Jenkins中创建一个自由风格任务（Freestyle Project），配置一个执行Shell命令的构建步骤，手动触发一次构建，并通过控制台输出验证任务配置正确。
前置条件
- 已安装并启动Jenkins（本案例基于Jenkins 2.4xx版本，界面为简体中文）
- 已使用管理员账号登录Jenkins
- Jenkins所在主机为Linux/macOS环境（Windows环境需将构建步骤改为“执行Windows批处理命令”）
操作步骤
1. 新建任务
- 点击Jenkins首页左侧菜单中的新建任务。
- 输入任务名称：
first-freestyle-job。 - 选择构建一个自由风格的软件项目，点击确定。
2. 配置构建步骤
- 在任务配置页中找到构建部分，点击添加构建步骤，选择执行shell。
- 在命令输入框中粘贴以下内容：
echo "===== Jenkins Build Environment Info ====="
echo "Job Name: ${JOB_NAME}"
echo "Build Number: ${BUILD_NUMBER}"
echo "Workspace: ${WORKSPACE}"
echo "Node Name: ${NODE_NAME}"
echo "Current Directory: $(pwd)"
echo "System Time: $(date)"
echo "==========================================="
- 点击页面底部的保存按钮。
3. 手动触发构建
- 进入任务页面（
first-freestyle-job），点击左侧的立即构建。 - 页面左侧会出现一个带有构建编号（如
#1）的条目，同时右侧会显示构建进度条。
4. 查看控制台输出
- 等待构建状态变为蓝色球（成功）或点击构建编号进入构建详情页。
- 点击左侧的控制台输出，查看完整日志。
验证方法
控制台输出中应包含以下关键内容，满足全部条件即判定任务创建成功：
- 以
===== Jenkins Build Environment Info =====开头，以===========================================结尾。 - 输出中包含
Job Name: first-freestyle-job，与创建的任务名称一致。 Build Number为本次构建的编号（首次构建为1）。Workspace路径存在且指向Jenkins为该任务分配的工作目录。- 日志末尾出现
Finished: SUCCESS，且构建状态为蓝色球。
常见问题
- 构建失败且日志显示“Permission denied”：Jenkins运行用户对工作目录无执行权限，检查
${WORKSPACE}目录权限。 - 控制台输出为中文乱码：Jenkins系统管理→系统配置→全局属性中增加环境变量
LANG=zh_CN.UTF-8后重启Jenkins。 - 找不到“执行shell”选项：确认任务类型为“自由风格项目”，且Jenkins运行在Unix-like系统上。
至此，第一个Jenkins自由风格任务已创建并验证完成。该任务展示了Jenkins任务的最小闭环：创建→配置→触发→查看结果，后续案例将在此基础上扩展源码管理、构建触发器、参数化构建等能力。