25.5. 创建自定义通知

• 信息始终只是字符串，仅一行。不支持新行。

• 消息正文可以是字典或文本块：

  • Webhooks 和 PagerDuty 的消息正文使用字典定义。这些的默认消息正文是 {{ job_metadata }}，您可以保留原样的值，或者提供自己的字典。

  • 电子邮件的消息正文使用文本块或多行字符串。默认消息正文为：

    {{ job_friendly_name }} #{{ job.id }} had status {{ job.status }}, view details at {{ url }} {{ job_metadata }}

    您可以编辑此文本，使 {{ job_metadata }} 留在，或者丢弃 {{ job_metadata }}。由于正文是文本块，它可以是您想要的任何字符串。{{ job_metadata }} 呈现为包含描述正在执行作业的字段的字典。在所有情况下，{{ job_metadata }} 包括以下字段：

    • id
    • name
    • url
    • created_by
    • started
    • finished
    • status

    • 追溯

      注意

      您无法查询 {{ job_metadata }} 中的各个字段。当您在通知模板中使用 {{ job_metadata }} 时，所有数据都会被返回。

      生成的字典类似如下：

      {"id": 18,
       "name": "Project - Space Procedures",
       "url": "https://host/#/jobs/project/18",
       "created_by": "admin",
       "started": "2019-10-26T00:20:45.139356+00:00",
       "finished": "2019-10-26T00:20:55.769713+00:00",
       "status": "successful",
       "traceback": ""
      }

      如果 {{ job_metadata }} 在作业中呈现，它将包括以下附加字段：

    • 清单（inventory）
    • project
    • playbook
    • credential
    • limit
    • extra_vars

    • 主机

      生成的字典类似如下：

      {"id": 12,
       "name": "JobTemplate - Launch Rockets",
       "url": "https://host/#/jobs/playbook/12",
       "created_by": "admin",
       "started": "2019-10-26T00:02:07.943774+00:00",
       "finished": null,
       "status": "running",
       "traceback": "",
       "inventory": "Inventory - Fleet",
       "project": "Project - Space Procedures",
       "playbook": "launch.yml",
       "credential": "Credential - Mission Control",
       "limit": "",
       "extra_vars": "{}",
       "hosts": {}
      }

      如果 {{ job_metadata }} 在工作流作业中呈现，它将包括以下附加字段：

    • body （此枚举工作流作业中的节点，并包含与每个节点关联的作业描述）

      生成的字典类似如下：

      {"id": 14,
       "name": "Workflow Job Template - Launch Mars Mission",
       "url": "https://host/#/workflows/14",
       "created_by": "admin",
       "started": "2019-10-26T00:11:04.554468+00:00",
       "finished": "2019-10-26T00:11:24.249899+00:00",
       "status": "successful",
       "traceback": "",
       "body": "Workflow job summary:
      
               node #1 spawns job #15, \"Assemble Fleet JT\", which finished with status successful.
               node #2 spawns job #16, \"Mission Start approval node\", which finished with status successful.\n
               node #3 spawns job #17, \"Deploy Fleet\", which finished with status successful."
      }

其他资源

• 如需更多信息，请参阅 Ansible 文档中的 使用带有 Jinja2 的变量。
• 自动化控制器需要有效的语法来检索正确的数据来显示消息。