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
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
-
|
|
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
- This module is not guaranteed to have a backwards compatible interface. [preview]
- This module is maintained by the Ansible Community. [community]
Authors
- Alejandro Guirao (@lekum)
Hint
If you notice any issues in this documentation you can edit this document to improve it.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/taiga_issue_module.html