Documentation

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

New in version 2.0.

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

Options

parameter required default choices comments
attachment
no None
Path to a file to be attached to the issue.
attachment_description
no
A string describing the file to be attached to the issue.
description
no
The issue description.
issue_type
yes
The issue type. Must exist previously.
priority
no Normal
The issue priority. Must exist previously.
project
yes
Name of the project containing the issue. Must exist previously.
severity
no Normal
The issue severity. Must exist previously.
state
no present
  • present
  • absent
Whether the issue should be present or not.
status
no New
The issue status. Must exist previously.
subject
yes
The issue subject.
tags
no
A lists of tags to be assigned to the issue.
taiga_host
no https://api.taiga.io
The hostname of the Taiga instance.

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

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

Status

This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.

Support

This module is community maintained without core committer oversight.

For more information on what this means please read Module Support

For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Testing Ansible and Developing Modules.