Github plugin integration example
To configure the Github plugin integration, complete the following steps:
-
In the Integration Name field, enter a name for the integration, such as
"Git tutorial."
Such as GitHub tutorial. Later, we use this name to associate the integration to our value
stream.
-
In the Url field, enter the URL for the GitHub project that you
configured earlier .
The URL is similar to this example,
https://github.com/myGitHubID/myGitHubProject.
-
In the Name field, enter the name of the GitHub repository.
Using the example URL from the preceding step, the name is
myGitHubProject.
-
In the Owner field, enter the GitHub account that owns the
repository.
Using the example URL, the owner is myGitHubID.
-
In the Token field, enter your Github personal access token to
authenticate with the Github repository.
In GitHub, to generate a personal access token, go to
Settings>Developer settings>Personal access
tokens then click Generate new token and select the scope
repo which allows to access repositories.
-
In the API URL field, enter the GitHub API URL.
For enterprise Github account, use GitHub API URL
https://example.com/api/v3.
For public Github account, use GitHub API URL
https://api.github.com.
-
Select the Show Hidden Properties check box.
The hidden fields are displayed.
-
Enter the custom time for the plugin job in the Plugin Job
Timeout field.
Note: The default time is 1h, you can specify the maximum
time a plugin job should be allowed to run before being automatically
canceled in the following format:
- 30m for 30 minutes
- 1h for one hour
- 1d for one day
- Optional:
Select the Interval time to set the frequency to run the
schedule event.
Note: If you do not want to change the interval time of
the schedule event while creating the integration, the default sync
intervals defined in the plugin are applied.
-
Click Add.
The integration is listed on the Integrations page. If the integration
is successful, the Status field displays Online. If the
status is not Online, use the View log option to
troubleshoot the integration. You can increase the logging level in the integration configuration if
you need more troubleshooting information.