GitLab Enterprise¶

Follow the instructions below to set up the Codacy integration with GitLab Enterprise:

Create a GitLab application¶

To integrate Codacy with GitLab Enterprise, you must create a GitLab application:

Open <gitlab enterprise url>/profile/applications, where <gitlab enterprise url> is the URL of your GitLab Enterprise instance.
Fill in the fields to register your Codacy instance on GitLab:
- Name: Name of the application. For example, Codacy.
- Redirect URI: Copy the URLs below, replacing the HTTP protocol and hostname with the correct values for your Codacy instance. This field is case sensitive.
```
https://codacy.example.com/login/GitLabEnterprise
https://codacy.example.com/add/addService/GitLabEnterprise
https://codacy.example.com/add/addPermissions/GitLabEnterprise
```
- Scopes: Enable the scopes:
  - api
  - read_user
  - read_repository
  - openid
Click Save application and take note of the generated Application Id and Secret.

Configure GitLab Enterprise on Codacy¶

After creating the GitLab application, you must configure it on Codacy:

Edit the file values-production.yaml that you used to install Codacy.

Set global.gitlabEnterprise.enabled: "true" and define the remaining values as described below using the information obtained when you created the GitLab application:

gitlabEnterprise:
  enabled: "true"
  login: "true" # Show login button for GitLab Enterprise
  hostname: "gitlab.example.com" # Hostname of your GitLab Enterprise instance
  protocol: "https" # Protocol of your GitLab Enterprise instance
  port: 443 # Port of your GitLab Enterprise instance
  clientId: "" # Application ID
  clientSecret: "" # Secret

Apply the new configuration by performing a Helm upgrade. To do so execute the command used to install Codacy:

Important

If you are using MicroK8s you must use the file values-microk8s.yaml together with the file values-production.yaml.

To do this, uncomment the last line before running the helm upgrade command below.
```
helm upgrade (...options used to install Codacy...) \
             --version 1.4.0 \
             --values values-production.yaml \
             # --values values-microk8s.yaml
```

After this is done you will be able to use GitLab Enterprise to authenticate to Codacy.

Share your feedback 📢

Did this page help you?

Thanks for the feedback! Is there anything else you'd like to tell us about this page?

255 characters left

We're sorry to hear that. Please let us know what we can improve:

255 characters left

Alternatively, you can create a more detailed issue on our GitHub repository.

Thanks for helping improve the Codacy documentation.

If you have a question or need help please contact support@codacy.com.

Last modified August 25, 2020