The GitHub package contains actions and web triggers that integrate GitHub with Automation 360 to automate various GitHub workflows such as issue and pull request management, viewing repositories and branches, and commenting in issues and pull requests. The web trigger enables you to create event-driven automation based on various GitHub events.

Overview

The GitHub package actions enables you to create, retrieve, list, update, comment and merge the data available in a GitHub repository. Each action contains an option to capture the response data in variables for use in other downstream actions within the same automation session as global variables are currently not supported. The web triggers can be configured to listen for events in any GitHub organization or repository. The trigger listens for events and starts the configured actions when the events occur. For more information about GitHub web triggers, see GitHub web triggers.

The Connect action in the package authenticates the connection between GitHub repository and the Control Room. The authentication requires a GitHub personal access token. The package supports both classic and fine-grained tokens. Ensure that you use a valid token with required permissions. For more information about creating GitHub personal access tokens, see Managing your personal access tokens.

Actions in GitHub package

Use Get actions to retrieve details of a specific artifact such as issue, pull request or repository. Use List actions to list all available artifacts within the specified repository. The GitHub package contains the following actions:

Action Description
Connect Authenticates the connection to GitHub and establishes the session context.
Create issue Creates an issue in a GitHub repository.
Get issue Retrieves the details of an issue from a GitHub repository.
List issues Lists all issues available in a GitHub repository.
Update issue Updates specific fields of an issue in a GitHub repository.
Create pull request Creates a pull request in a GitHub repository.
Get pull request Retrieves the details of a pull request from a GitHub repository.
List pull requests Lists all pull requests available in a GitHub repository.
Merge pull request Merges a pull request to the base branch of the GitHub repository.
Get repository Retrieves the details of a specific repository in GitHub.
List repositories Lists all repositories of the specified GitHub user.
List branches Lists all branches in the specified GitHub repository.
Add comment Adds a comment to an issue or pull request in the specified GitHub repository.
Disconnect Disconnects the automation session from GitHub and ends the session.