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

Note

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

To install it use: ansible-galaxy collection install community.general.

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

- 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)