community.general.bigpanda – Notify BigPanda about deployments

From Get docs
Ansible/docs/2.11/collections/community/general/bigpanda module


community.general.bigpanda – Notify BigPanda about deployments

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.bigpanda.


Synopsis

  • Notify BigPanda when deployments start and end (successfully or not). Returns a deployment object containing all the parameters for future module calls.

Parameters

Parameter Choices/Defaults Comments

component

string / required

The name of the component being deployed. Ex: billing


aliases: name

deployment_message

string

added in 0.2.0 of community.general

Message about the deployment.

message alias is deprecated in community.general 0.2.0, since it is used internally by Ansible Core Engine.


aliases: message

description

string

Free text description of the deployment.

env

string

The environment name, typically 'production', 'staging', etc.

hosts

string

Name of affected host name. Can be a list.

If not specified, it defaults to the remote system's hostname.


aliases: host

owner

string

The person responsible for the deployment.

source_system

string

Default:

"ansible"

Source system used in the requests to the API

state

string / required

  • started
  • finished
  • failed

State of the deployment.

token

string / required

API token.

url

string

Default:

Base URL of the API server.

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.

version

string / required

The deployment version.



Examples

- name: Notify BigPanda about a deployment
  community.general.bigpanda:
    component: myapp
    version: '1.3'
    token: '{{ bigpanda_token }}'
    state: started

- name: Notify BigPanda about a deployment
  community.general.bigpanda:
    component: myapp
    version: '1.3'
    token: '{{ bigpanda_token }}'
    state: finished

# If outside servers aren't reachable from your machine, use delegate_to and override hosts:
- name: Notify BigPanda about a deployment
  community.general.bigpanda:
    component: myapp
    version: '1.3'
    token: '{{ bigpanda_token }}'
    hosts: '{{ ansible_hostname }}'
    state: started
  delegate_to: localhost
  register: deployment

- name: Notify BigPanda about a deployment
  community.general.bigpanda:
    component: '{{ deployment.component }}'
    version: '{{ deployment.version }}'
    token: '{{ deployment.token }}'
    state: finished
  delegate_to: localhost

Authors

  • Hagai Kariti (@hkariti)

© 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/bigpanda_module.html