Documentation
  • Docs »
  • taiga_issue – Creates/deletes an issue in a Taiga Project Management Platform

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

Authors

  • Alejandro Guirao (@lekum)

Hint

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