Setting up the Integration

Preconfigure your Organization

Ensure that your Code Ocean admin has already configured the Git provider organization from the Admin Dashboard.

Configure Personal Access Token for Code Ocean

In order to establish the API call and complete the integration, follow the steps below. Note that the exact process varies depending on the Git provider, but the objective is to retrieve the token from the Git provider and add the token to your Code Ocean account.

Generate a personal access token (PAT) in your Git provider's account

GitHub

Creating a GitHub Personal Access Token

1. In the upper-right corner of the page, click your profile photo, then click Settings.

2. In the left sidebar, click Developer settings.

3. In the left sidebar, click Personal access tokens.

4. Click Generate new token.

5. Fill out the form and check the repo box for the scope.

For more information about how to generate a Github PAT, read this article from GitHub.

GitLab

Creating a GitLab Personal Access Token

You can create as many personal access tokens as required.

1. In the top-right corner, select your avatar.

2. Select Edit profile.

3. On the left sidebar, select Access Tokens.

4. Enter a name and optional expiry date for the token.

5. Select the desired scopes.

6. Select Create personal access token.

For more information about how to generate a GitLab PAT, read this article from Gitlab.

Bitbucket

For information about how to generate a Bitbucket PAT ("App Password"), read this article from Bitbucket.

Azure DevOps

Creating an Azure DevOps Personal Access Token

1. Sign in to your Azure DevOps organization.

2. Open User Settings by clicking the icon in the top right of the screen and select Personal access tokens.

3. Select + New Token.

4. Complete the required fields and choose the appropriate scope for the token.

For more information about how to generate an Azure DevOps PAT, read this article from Azure DevOps.

Save the PAT in Code Ocean under your account page

1. Click the Account icon

2. From the Credentials screen click +Add Credentials

3. Click <Git provider> Credentials

4. Enter your Git provider's username and PAT.