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

Note

This plugin is part of the community.general collection.

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