背景

在持续集成/持续部署（CI/CD）流程中，部署完成后的结果通知至关重要。当Jenkins自动构建并完成部署后，团队需要第一时间获知成功或失败状态，以便及时处理问题。钉钉作为国内常用的企业协作工具，通过自定义机器人Webhook可轻松接收此类通知。

前置条件

• 已搭建可用的Jenkins环境，并拥有至少一个构建/部署任务。
• 在目标钉钉群中添加自定义机器人，获取Webhook地址，并记录安全设置（如加签关键词或IP白名单）。

实现方案

方案一：使用钉钉插件

Jenkins插件中心提供“DingTalk”插件，安装后在任务配置的“构建后操作”中选择“钉钉通知”，填写Webhook和自定义消息模板即可。优点是图形化配置，无需编写代码。

方案二：通过Shell脚本调用Webhook

在Jenkins任务的“构建”步骤中添加“Execute shell”，使用curl命令向钉钉Webhook发送POST请求，实现通知。此方式灵活，便于在脚本中根据构建状态定制消息。

# 示例：根据部署结果发送通知
DINGTALK_WEBHOOK="https://oapi.dingtalk.com/robot/send?access_token=YOUR_TOKEN"
if [ "$JOB_STATUS" = "SUCCESS" ]; then
  curl -X POST "$DINGTALK_WEBHOOK" -H 'Content-Type: application/json' -d '{"msgtype":"text","text":{"content":"部署成功: 项目'${JOB_NAME}' 构建号'${BUILD_NUMBER}'"}}'
else
  curl -X POST "$DINGTALK_WEBHOOK" -H 'Content-Type: application/json' -d '{"msgtype":"text","text":{"content":"部署失败: 构建号'${BUILD_NUMBER}' 请检查日志"}}'
fi

注意事项

1. Webhook地址属于敏感信息，建议通过Jenkins凭据（Credentials）管理，避免明文出现在脚本或日志中。
2. 钉钉机器人具有安全限制，若配置了自定义关键词，消息内容必须包含该关键词；若使用加签模式，需在请求中携带签名参数。
3. 如使用Markdown消息类型（msgtype=markdown），需要正确转义特殊字符，确保展示正常。
4. 对于长时间运行的部署任务，可在脚本中设置超时或重试逻辑，避免网络抖动导致通知丢失。

通过上述方法，团队可以快速将Jenkins自动部署结果推送至钉钉群，实现透明化的CI/CD流程，提升协作效率。