community.general.pagerduty_change – Track a code or infrastructure change as a PagerDuty change event

Note

This plugin is part of the community.general collection (version 2.0.1).

To install it use: ansible-galaxy collection install community.general.

To use it in a playbook, specify: community.general.pagerduty_change.

New in version 1.3.0: of community.general

Synopsis
Requirements
Parameters
Notes
Examples

Synopsis

This module will let you create a PagerDuty change event each time the module is run.
This is not an idempotent action and a new change event will be created each time it is run.

Requirements

The below requirements are needed on the host that executes this module.

PagerDuty integration key

Parameters

Parameter	Choices/Defaults	Comments
environment string		The environment name, typically `production`, `staging`, etc.
integration_key string / required		The integration key that identifies the service the change was made to. This can be found by adding an integration to a service in PagerDuty.
link_text string		Descriptive text for a URL where more information about the deployment can be obtained.
link_url string		A URL where more information about the deployment can be obtained.
repo string		The URL of the project repository.
revision string		An identifier of the revision being deployed, typically a number or SHA from a version control system.
source string	Default: "Ansible"	The source of the change event.
summary string / required		A short description of the change that occurred.
url string	Default: "https://events.pagerduty.com/v2/change/enqueue%22	URL to submit the change event to.
user string		The name of the user or process that triggered this deployment.
validate_certs boolean	no yes ←	If `no`, SSL certificates for the target URL will not be validated. This should only be used on personally controlled sites using self-signed certificates.

Notes

Note

Supports check_mode. Note that check mode simply does nothing except returning changed=true in case the url seems to be correct.

Examples

- 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

Authors

Adam Vaughan (@adamvaughan)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/general/pagerduty_change_module.html