Documentation

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

                        This is an Extras Module

                        For more information on what this means please read Extras Modules

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