github_issue - View GitHub issue.

New in version 2.4.

Synopsis

  • View GitHub issue for a given repository.

Requirements

The below requirements are needed on the host that executes this module.

  • github3.py >= 1.0.0a4

Parameters

Parameter Choices/Defaults Comments
action
    Choices:
  • [u'get_status']
Default:
get_status
Get various details about issue depending upon action specified.
issue
required
Default:
none
Issue number for which information is required.
organization
required
Default:
none
Name of the GitHub organization in which the repository is hosted.
repo
required
Default:
none
Name of repository from which issue needs to be retrieved.

Examples

- name: Check if GitHub issue is closed or not
  github_issue:
    organization: ansible
    repo: ansible
    issue: 23642
    action: get_status
  register: r

- name: Take action depending upon issue status
  debug:
    msg: Do something when issue 23642 is open
  when: r.issue_status == 'open'

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key Returned Description
get_status
string
success
State of the GitHub issue

Sample:
open, closed


Status

This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.

Author

  • Abhijeet Kasurde (@akasurde)

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.5/modules/github_issue_module.html