Linking code from Gerrit

Authenticating with Gerrit is currently not supported. If you need this capability, please raise a feature request.

Sourcebot can sync code from self-hosted gerrit instances.

Connecting to a Gerrit instance

To connect to a gerrit instance, provide the url property to your config:

{
    "type": "gerrit",
    "url": "https://gerrit.example.com"
    // .. rest of config ..
}

Examples

{
    "type": "gerrit",
    "url": "https://gerrit.example.com",
    // Sync all repos under project1 and project2/sub-project
    "projects": [
        "project1/**",
        "project2/sub-project/**"
    ]
}

{
    "type": "gerrit",
    "url": "https://gerrit.example.com",
    // Sync all repos under project1 and project2/sub-project...
    "projects": [
        "project1/**",
        "project2/sub-project/**"
    ],
    // ...except:
    "exclude": {
        // any project that matches these glob patterns
        "projects": [
            "project1/foo-project",
            "project2/sub-project/some-sub-folder/**"
        ]
    }
}

Schema reference

schemas/v3/gerrit.json

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "title": "GerritConnectionConfig",
  "properties": {
    "type": {
      "const": "gerrit",
      "description": "Gerrit Configuration"
    },
    "url": {
      "type": "string",
      "format": "url",
      "description": "The URL of the Gerrit host.",
      "examples": [
        "https://gerrit.example.com"
      ],
      "pattern": "^https?:\\/\\/[^\\s/$.?#].[^\\s]*$"
    },
    "projects": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "List of specific projects to sync. If not specified, all projects will be synced. Glob patterns are supported",
      "examples": [
        [
          "project1/repo1",
          "project2/**"
        ]
      ]
    },
    "exclude": {
      "type": "object",
      "properties": {
        "projects": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "examples": [
            [
              "project1/repo1",
              "project2/**"
            ]
          ],
          "description": "List of specific projects to exclude from syncing."
        }
      },
      "additionalProperties": false
    }
  },
  "required": [
    "type",
    "url"
  ],
  "additionalProperties": false
}

General

Connecting your code

More

Linking code from Gerrit

Connecting to a Gerrit instance

Examples

Schema reference

General

Connecting your code

More

​Connecting to a Gerrit instance

​Examples

​Schema reference

Connecting to a Gerrit instance

Examples

Schema reference