GitHub

GitHub is a platform that allows developers to create, store, manage and share their code. It uses Git software, providing the distributed version control of Git plus access control, bug tracking, software feature requests, task management, continuous integration, and wikis for every project.

For Automation Reporting distribution of Zebrunner, this integration allows users to:

1. Link issues to failed automated tests
2. View history of issues, linked to a particular test
3. Automatically link not closed issues to failed tests based on history of failure reasons
4. View issue linked to a test directly from Zebrunner

For Test Case Management distribution of Zebrunner, this integration allows users to:

1. Link issues to test case executions, allowing to track discrepancy in expected behaviour
2. View history of issues, linked to executions of a particular test case
3. View issue linked to a test case execution directly from Zebrunner

Obtaining Personal access token

1. Log in to your GitHub workspace
2. In the upper-right corner of any page on GitHub, click your profile photo, then click Settings
3. In the left sidebar, click <> Developer settings
4. In the left sidebar, under Personal access tokens, click Tokens (classic)
5. Select Generate new token
6. Fill in Note, select desired Expiration, and select repo scope (Full control of private repositories). This scope is necessary to access issues in your private repositories
7. Click the Generate token at the bottom of the page
8. Copy the generated token

Configuring integration

The following steps need to be performed to add a GitHub integration:

1. Navigate to Setting → Integrations → GitHub
2. Click the Integration button
3. Enter your URL, username and personal access token
4. Select the projects to add the integration to. For more information, refer to Selecting projects documentation
5. (optional) Click the Test button to check connectivity
6. Click the Save button