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 flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
Maintenance
This module is flagged as community which means that it is maintained by the Ansible Community. See Module Maintenance & Support for more info.
For a list of other modules that are also maintained by the Ansible Community, see here.
Author
- 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.6/modules/taiga_issue_module.html