Project management using JIRA

GitHub Enterprise configuration

Connecting JIRA to a GitHub Enterprise organization

1. Sign into your GitHub Enterprise account at http[s]://[hostname]/login.
2. In the upper right corner of any page, click the account settings (gear) icon.
3. In the left sidebar, click the name of your organization.
4. In the left sidebar, click Applications.
5. In the upper right corner of the Organization applications box, click Register new application.
6. 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.
7. Click Register application.
8. 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

1. Sign into your GitHub Enterprise account at http[s]://[hostname]/login.
2. In the upper right corner of any page, click the account settings (gear) icon.
3. In the left sidebar, click Applications.
4. In the upper right corner of the Developer applications box, click Register new application.
5. 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.
6. Click Register application.
7. 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

1. On your JIRA instance, log into an account with administrative access.
2. At the top of the page, click the settings (gear) icon.
3. In the settings dropdown, choose Add-ons.
4. In the left sidebar, under Source control, click DVCS accounts.
5. Click Link Bitbucket or GitHub account.
6. 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.
7. Review the permissions you are granting to your GitHub Enterprise account and click Authorize application.
8. 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

1. Sign into GitHub Enterprise with your personal user account.
2. Navigate to the repository you want to connect to your Jenkins build server.
3. In the right sidebar, click Settings.
4. In the left sidebar, click Webhooks & Services.
5. In the Services box, click Add service.
6. Select "Jenkins (GitHub plugin)".
7. 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.
8. 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

1. Sign into GitHub Enterprise with your personal user account.
2. Navigate to the repository you want to connect to Travis.
3. In the right sidebar, click Settings.
4. In the left sidebar, click Wehooks & Services.
5. In the Services box, click Add service.
6. Select "Travis CI".
7. 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.
8. Click Add service.

README build status

1. Navigate to your repository's page on Travis CI.
2. In the top right corner of the page, click the build status image.
3. In the build dialog, copy the URL from the Markdown field.
4. In your GitHub Enterprise repository, paste the build status URL into the repository's README.