community.general.bigpanda – Notify BigPanda about deployments

Note

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

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

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

Comments

component

aliases: name

string / required

The name of the component being deployed. Ex: billing

deployment_message

string

added in 0.2.0 of community.general

Message about the deployment.

description

string

Free text description of the deployment.

env

string

The environment name, typically ‘production’, ‘staging’, etc.

hosts

aliases: host

string

Name of affected host name. Can be a list.

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

owner

string

The person responsible for the deployment.

source_system

string

Source system used in the requests to the API

Default: “ansible”

state

string / required

State of the deployment.

Choices:

  • started

  • finished

  • failed

token

string / required

API token.

url

string

Base URL of the API server.

Default: “https://api.bigpanda.io”

validate_certs

boolean

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.

Choices:

  • no

  • yes ← (default)

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)