If you already have a development and deployment ecosystem in place, you can easily integrate it with GitHub Enterprise.
Project management using JIRA
GitHub Enterprise configuration
Connecting JIRA to a GitHub Enterprise organization
- Sign into your GitHub Enterprise account at http[s]://[hostname]/login.
- In the upper right corner of any page, click the account settings (gear) icon.
- In the left sidebar, click the name of your organization.
- In the left sidebar, click Applications.
- In the upper right corner of the Organization applications box, click Register new application.
- Fill in the application settings:
- In the Application name field, type "JIRA".
- In the Homepage URL field, type the full URL of your JIRA instance.
- In the Authorization callback URL field, type the full URL of your JIRA instance.
- Click Register application.
- At the top of the page, note the Client ID and Client Secret. You will need these for configuring your JIRA instance.
Connecting JIRA to a GitHub Enterprise personal account
- Sign into your GitHub Enterprise account at http[s]://[hostname]/login.
- In the upper right corner of any page, click the account settings (gear) icon.
- In the left sidebar, click Applications.
- In the upper right corner of the Developer applications box, click Register new application.
- Fill in the application settings:
- In the Application name field, type "JIRA".
- In the Homepage URL field, type the full URL of your JIRA instance.
- In the Authorization callback URL field, type the full URL of your JIRA instance.
- Click Register application.
- At the top of the page, note the Client ID and Client Secret. You will need these for configuring your JIRA instance.
JIRA instance configuration
- On your JIRA instance, log into an account with administrative access.
- At the top of the page, click the settings (gear) icon.
- In the settings dropdown, choose Add-ons.
- In the left sidebar, under Source control, click DVCS accounts.
- Click Link Bitbucket or GitHub account.
- In the Add New Account modal, fill in your GitHub Enterprise settings:
- From the Host dropdown menu, choose GitHub Enterprise.
- In the Team or User Account field, type the name of your GitHub Enterprise organization or personal account.
- In the OAuth Key field, type the Client ID of your GitHub Enterprise developer application.
- In the OAuth Secret field, type the Client Secret for your GitHub Enterprise developer application.
- If you don't want to link new repositories owned by your GitHub Enterprise organization or personal account, unselect Auto Link New Repositories.
- If you don't want to enable smart commits, unselect Enable Smart Commits.
- Click Add.
- Review the permissions you are granting to your GitHub Enterprise account and click Authorize application.
- If necessary, type your password to continue.
Continuous integration using Jenkins
You can automatically trigger build jobs on a Jenkins server when pushes are made to a repository in your GitHub Enterprise instance.
Requirements
- Install the Jenkins GitHub plugin on your Jenkins server.
GitHub Enterprise configuration
- Sign into GitHub Enterprise with your personal user account.
- Navigate to the repository you want to connect to your Jenkins build server.
- In the right sidebar, click Settings.
- In the left sidebar, click Webhooks & Services.
- In the Services box, click Add service.
- Select "Jenkins (GitHub plugin)".
- In the Jenkins hook URL field, type the URL of your Jenkins server's webhook endpoint. This is where your GitHub Enterprise instance will send JSON payloads when a push is made.
- Click Add service.
Continuous integration using Travis CI
You can automatically trigger build jobs on Travis CI when pushes are made to a repository in your GitHub Enterprise instance. Additionally, you can display the build status in the README for the repository.
Trigger builds on push
GitHub Enterprise configuration
- Sign into GitHub Enterprise with your personal user account.
- Navigate to the repository you want to connect to Travis.
- In the right sidebar, click Settings.
- In the left sidebar, click Wehooks & Services.
- In the Services box, click Add service.
- Select "Travis CI".
- Fill in the configuration settings:
- In the User field, type your Travis CI username.
- In the Token field, type your Travis CI token.
- In the Domain field, type the domain of your project on Travis CI.
- Click Add service.
README build status
- Navigate to your repository's page on Travis CI.
- In the top right corner of the page, click the build status image.
- In the build dialog, copy the URL from the Markdown field.
- In your GitHub Enterprise repository, paste the build status URL into the repository's README.