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

From Get docs
Ansible/docs/2.10/collections/community/general/taiga issue module


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

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

  • 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:

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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/general/taiga_issue_module.html