Skip to main content
Version: Next

Gerrit Locations

The Gerrit integration supports loading catalog entities from Gerrit hosted gits. Entities can be added to static catalog configuration, or registered with the catalog-import plugin.

Gerrit 3.9+ supports inline editing via URL. The integration enables this by default, following Gerrit's official URL pattern for inline edits.

Configuration

To use this integration, add at least one Gerrit configuration to your root app-config.yaml:

integrations:
gerrit:
- host: gerrit.company.com
gitilesBaseUrl: https://gerrit.company.com/gitiles
baseUrl: https://gerrit.company.com/gerrit
cloneUrl: https://gerrit.company.com/clone
disableEditUrl: false
username: ${GERRIT_USERNAME}
password: ${GERRIT_PASSWORD}

Directly under the gerrit key is a list of provider configurations, where you can list the Gerrit instances you want to fetch data from. Each entry is a structure with up to six elements:

  • host: The host of the Gerrit instance, e.g. gerrit.company.com.
  • gitilesBaseUrl: The base url of the Gitiles instance.
  • baseUrl (optional): Needed if the Gerrit instance is not reachable at the base of the host option (e.g. https://gerrit.company.com) set the address here. This is the address that you would open in a browser.
  • cloneUrl (optional): The base URL for HTTP clones. Will default to baseUrl if not set. The address used to clone a repo is the cloneUrl plus the repo name.
  • disableEditUrl (optional): Disable the edit mode.
  • username (optional): The Gerrit username to use in API requests. If neither a username nor password are supplied, anonymous access will be used.
  • password (optional): The password or http token for the Gerrit user.