taiga_issue – Creates/deletes an issue in a Taiga Project Management Platform

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	Choices/Defaults	Comments
attachment -		Path to a file to be attached to the issue.
attachment_description -	Default: ""	A string describing the file to be attached to the issue.
description -	Default: ""	The issue description.
issue_type - / required		The issue type. Must exist previously.
priority -	Default: "Normal"	The issue priority. Must exist previously.
project - / required		Name of the project containing the issue. Must exist previously.
severity -	Default: "Normal"	The issue severity. Must exist previously.
state -	Choices: present ← absent	Whether the issue should be present or not.
status -	Default: "New"	The issue status. Must exist previously.
subject - / required		The issue subject.
tags -	Default: []	A lists of tags to be assigned to the issue.
taiga_host -	Default: "https://api.taiga.io"	The hostname of the Taiga instance.

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

# Create an issue in the my hosted Taiga environment and attach an error log
- 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

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

Status

• This module is not guaranteed to have a backwards compatible interface. [preview]
• This module is maintained by the Ansible Community. [community]

Authors

• Alejandro Guirao (@lekum)

Hint

If you notice any issues in this documentation, you can edit this document to improve it.