Docs4dev
Docs
ansible / latest / collections / community / general / taiga_issue_module.html

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

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

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)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/taiga_issue_module.html