community.general.pagerduty_change 模块 – 将代码或基础设施更改作为 PagerDuty 更改事件进行跟踪

注意

此模块是 community.general 集合 (版本 10.1.0) 的一部分。

如果您使用的是 ansible 包，则可能已安装此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install community.general。要使用此模块，您需要其他依赖项，有关详细信息，请参阅 需求。

要在 playbook 中使用它，请指定：community.general.pagerduty_change。

community.general 1.3.0 中的新增功能

概要

  • 每次运行此模块时，此模块都允许您创建一个 PagerDuty 更改事件。

  • 这不是幂等操作，每次运行时都会创建一个新的更改事件。

需求

执行此模块的主机需要以下需求。

  • PagerDuty 集成密钥

参数

参数

注释

环境

字符串

环境名称，通常为 production、staging 等。

集成密钥

字符串 / 必需

标识更改所涉及服务的集成密钥。这可以通过在 PagerDuty 中向服务添加集成来找到。

链接文本

字符串

用于 URL 的描述性文本，可在其中获取有关部署的更多信息。

字符串

可获取有关部署的更多信息的 URL。

仓库

字符串

项目仓库的 URL。

版本

字符串

正在部署的版本的标识符，通常是版本控制系统中的数字或 SHA。

来源

字符串

更改事件的来源。

默认值： "Ansible"

摘要

字符串 / 必需

发生的更改的简短描述。

URL

字符串

提交更改事件的 URL。

默认值： "https://events.pagerduty.com/v2/change/enqueue"

用户

字符串

触发此部署的用户或进程的名称。

验证证书

布尔值

如果为 false，则不会验证目标 URL 的 SSL 证书。这仅应在使用自签名证书的个人控制站点上使用。

选项

  • false

  • true ← (默认)

属性

属性

支持

描述

检查模式

支持：完全支持

检查模式只做一件事，除了在 url 看起来正确的情况下返回 changed=true。

可以在 check_mode 下运行并返回更改状态预测，而无需修改目标。

差异模式

支持：不支持

在差异模式下，将返回有关已更改内容（或可能需要在 check_mode 中更改的内容）的详细信息。

示例

- name: Track the deployment as a PagerDuty change event
  community.general.pagerduty_change:
    integration_key: abc123abc123abc123abc123abc123ab
    summary: The application was deployed

- name: Track the deployment as a PagerDuty change event with more details
  community.general.pagerduty_change:
    integration_key: abc123abc123abc123abc123abc123ab
    summary: The application was deployed
    source: Ansible Deploy
    user: ansible
    repo: github.com/ansible/ansible
    revision: '4.2'
    environment: production
    link_url: https://github.com/ansible-collections/community.general/pull/1269
    link_text: View changes on GitHub

作者

  • Adam Vaughan (@adamvaughan)