community.general.taiga_issue module – Creates/deletes an issue in a Taiga Project Management Platform

Note

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

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. You need further requirements to be able to use this module, see Requirements for details.

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

Synopsis

  • Creates/deletes an issue in a Taiga Project Management Platform (https://taiga.io).

  • An issue is identified by the combination of project, issue subject and issue type.

  • This module implements the creation or deletion of issues (not the update).

Requirements

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

  • python-taiga

Parameters

Parameter

Comments

attachment

path

Path to a file to be attached to the issue.

attachment_description

string

A string describing the file to be attached to the issue.

Default: ""

description

string

The issue description.

Default: ""

issue_type

string / required

The issue type. Must exist previously.

priority

string

The issue priority. Must exist previously.

Default: "Normal"

project

string / required

Name of the project containing the issue. Must exist previously.

severity

string

The issue severity. Must exist previously.

Default: "Normal"

state

string

Whether the issue should be present or not.

Choices:

  • "present" ← (default)

  • "absent"

status

string

The issue status. Must exist previously.

Default: "New"

subject

string / required

The issue subject.

tags

list / elements=string

A lists of tags to be assigned to the issue.

Default: []

taiga_host

string

The hostname of the Taiga instance.

Default: "https://api.taiga.io"

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

  • The authentication is achieved either by the environment variable TAIGA_TOKEN or by the pair of environment variables TAIGA_USERNAME and TAIGA_PASSWORD

Examples

- name: Create an issue in the my hosted Taiga environment and attach an error log
  community.general.taiga_issue:
    taiga_host: https://mytaigahost.example.com
    project: myproject
    subject: An error has been found
    issue_type: Bug
    priority: High
    status: New
    severity: Important
    description: An error has been found. Please check the attached error log for details.
    attachment: /path/to/error.log
    attachment_description: Error log file
    tags:
      - Error
      - Needs manual check
    state: present

- name: Deletes the previously created issue
  community.general.taiga_issue:
    taiga_host: https://mytaigahost.example.com
    project: myproject
    subject: An error has been found
    issue_type: Bug
    state: absent

Authors

  • Alejandro Guirao (@lekum)