community.general.bitbucket_pipeline_variable module – Manages Bitbucket pipeline variables

Note

This module is part of the community.general collection (version 9.4.0).

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

Synopsis

  • Manages Bitbucket pipeline variables.

Parameters

Parameter

Comments

client_id

string

The OAuth consumer key.

If not set the environment variable BITBUCKET_CLIENT_ID will be used.

client_secret

string

The OAuth consumer secret.

If not set the environment variable BITBUCKET_CLIENT_SECRET will be used.

name

string / required

The pipeline variable name.

password

string

added in community.general 4.0.0

The App password.

If not set the environment variable BITBUCKET_PASSWORD will be used.

repository

string / required

The repository name.

secured

boolean

Whether to encrypt the variable value.

Choices:

  • false ← (default)

  • true

state

string / required

Indicates desired state of the variable.

Choices:

  • "absent"

  • "present"

user

aliases: username

string

added in community.general 4.0.0

The username.

If not set the environment variable BITBUCKET_USERNAME will be used.

username is an alias of user since community.general 6.0.0. It was an alias of workspace before.

value

string

The pipeline variable value.

workspace

string / required

The repository owner.

Note: username used to be an alias of this option. Since community.general 6.0.0 it is an alias of user.

Attributes

Attribute

Support

Description

check_mode

Support: full

Can run in check_mode and return changed status prediction without modifying target.

diff_mode

Support: none

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode.

Notes

Note

  • Check mode is supported.

  • For secured values return parameter changed is always true.

  • Bitbucket OAuth consumer key and secret can be obtained from Bitbucket profile -> Settings -> Access Management -> OAuth.

  • Bitbucket App password can be created from Bitbucket profile -> Personal Settings -> App passwords.

  • If both OAuth and Basic Auth credentials are passed, OAuth credentials take precedence.

Examples

- name: Create or update pipeline variables from the list
  community.general.bitbucket_pipeline_variable:
    repository: 'bitbucket-repo'
    workspace: bitbucket_workspace
    name: '{{ item.name }}'
    value: '{{ item.value }}'
    secured: '{{ item.secured }}'
    state: present
  with_items:
    - { name: AWS_ACCESS_KEY, value: ABCD1234, secured: false }
    - { name: AWS_SECRET, value: qwe789poi123vbn0, secured: true }

- name: Remove pipeline variable
  community.general.bitbucket_pipeline_variable:
    repository: bitbucket-repo
    workspace: bitbucket_workspace
    name: AWS_ACCESS_KEY
    state: absent

Authors

  • Evgeniy Krysanov (@catcombo)