W3cubDocs

/Ansible

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

Requirements (on host that executes module)

  • python-taiga

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.

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

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