mirror of
https://github.com/sourcebot-dev/sourcebot.git
synced 2025-12-11 20:05:25 +00:00
docs: Add docs generation to schema build command (#284)
This commit is contained in:
Brendan Kellam
GitHub
parent
14ce633cf0
commit
0119510ce3
26 changed files with 3306 additions and 1534 deletions
|
|
@ -5,6 +5,7 @@ sidebarTitle: Bitbucket Cloud
|
||||||
|
|
||||||
import BitbucketToken from '/snippets/bitbucket-token.mdx';
|
import BitbucketToken from '/snippets/bitbucket-token.mdx';
|
||||||
import BitbucketAppPassword from '/snippets/bitbucket-app-password.mdx';
|
import BitbucketAppPassword from '/snippets/bitbucket-app-password.mdx';
|
||||||
|
import BitbucketSchema from '/snippets/schemas/v3/bitbucket.schema.mdx'
|
||||||
|
|
||||||
## Examples
|
## Examples
|
||||||
|
|
||||||
|
|
@ -98,104 +99,6 @@ In order to index private repositories, you'll need to provide authentication cr
|
||||||
<Accordion title="Reference">
|
<Accordion title="Reference">
|
||||||
[schemas/v3/bitbucket.json](https://github.com/sourcebot-dev/sourcebot/blob/main/schemas/v3/bitbucket.json)
|
[schemas/v3/bitbucket.json](https://github.com/sourcebot-dev/sourcebot/blob/main/schemas/v3/bitbucket.json)
|
||||||
|
|
||||||
```json
|
<BitbucketSchema />
|
||||||
{
|
|
||||||
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
||||||
"type": "object",
|
|
||||||
"title": "BitbucketConnectionConfig",
|
|
||||||
"properties": {
|
|
||||||
"type": {
|
|
||||||
"const": "bitbucket",
|
|
||||||
"description": "Bitbucket configuration"
|
|
||||||
},
|
|
||||||
"user": {
|
|
||||||
"type": "string",
|
|
||||||
"description": "The username to use for authentication. Only needed if token is an app password."
|
|
||||||
},
|
|
||||||
"token": {
|
|
||||||
"$ref": "./shared.json#/definitions/Token",
|
|
||||||
"description": "An authentication token.",
|
|
||||||
"examples": [
|
|
||||||
{
|
|
||||||
"secret": "SECRET_KEY"
|
|
||||||
}
|
|
||||||
]
|
|
||||||
},
|
|
||||||
"url": {
|
|
||||||
"type": "string",
|
|
||||||
"format": "url",
|
|
||||||
"default": "https://api.bitbucket.org/2.0",
|
|
||||||
"description": "Bitbucket URL",
|
|
||||||
"examples": [
|
|
||||||
"https://bitbucket.example.com"
|
|
||||||
],
|
|
||||||
"pattern": "^https?:\\/\\/[^\\s/$.?#].[^\\s]*$"
|
|
||||||
},
|
|
||||||
"deploymentType": {
|
|
||||||
"type": "string",
|
|
||||||
"enum": ["cloud", "server"],
|
|
||||||
"default": "cloud",
|
|
||||||
"description": "The type of Bitbucket deployment"
|
|
||||||
},
|
|
||||||
"workspaces": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"description": "List of workspaces to sync. Ignored if deploymentType is server."
|
|
||||||
},
|
|
||||||
"projects": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"description": "List of projects to sync"
|
|
||||||
},
|
|
||||||
"repos": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"description": "List of repos to sync"
|
|
||||||
},
|
|
||||||
"exclude": {
|
|
||||||
"type": "object",
|
|
||||||
"properties": {
|
|
||||||
"archived": {
|
|
||||||
"type": "boolean",
|
|
||||||
"default": false,
|
|
||||||
"description": "Exclude archived repositories from syncing."
|
|
||||||
},
|
|
||||||
"forks": {
|
|
||||||
"type": "boolean",
|
|
||||||
"default": false,
|
|
||||||
"description": "Exclude forked repositories from syncing."
|
|
||||||
},
|
|
||||||
"repos": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"examples": [
|
|
||||||
[
|
|
||||||
"cloud_workspace/repo1",
|
|
||||||
"server_project/repo2"
|
|
||||||
]
|
|
||||||
],
|
|
||||||
"description": "List of specific repos to exclude from syncing."
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"additionalProperties": false
|
|
||||||
},
|
|
||||||
"revisions": {
|
|
||||||
"$ref": "./shared.json#/definitions/GitRevisions"
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"required": [
|
|
||||||
"type"
|
|
||||||
],
|
|
||||||
"additionalProperties": false
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
</Accordion>
|
</Accordion>
|
||||||
|
|
@ -5,6 +5,7 @@ sidebarTitle: Bitbucket Data Center
|
||||||
|
|
||||||
import BitbucketToken from '/snippets/bitbucket-token.mdx';
|
import BitbucketToken from '/snippets/bitbucket-token.mdx';
|
||||||
import BitbucketAppPassword from '/snippets/bitbucket-app-password.mdx';
|
import BitbucketAppPassword from '/snippets/bitbucket-app-password.mdx';
|
||||||
|
import BitbucketSchema from '/snippets/schemas/v3/bitbucket.schema.mdx'
|
||||||
|
|
||||||
## Examples
|
## Examples
|
||||||
|
|
||||||
|
|
@ -77,104 +78,6 @@ Next, provide the access token to Sourcebot:
|
||||||
<Accordion title="Reference">
|
<Accordion title="Reference">
|
||||||
[schemas/v3/bitbucket.json](https://github.com/sourcebot-dev/sourcebot/blob/main/schemas/v3/bitbucket.json)
|
[schemas/v3/bitbucket.json](https://github.com/sourcebot-dev/sourcebot/blob/main/schemas/v3/bitbucket.json)
|
||||||
|
|
||||||
```json
|
<BitbucketSchema />
|
||||||
{
|
|
||||||
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
||||||
"type": "object",
|
|
||||||
"title": "BitbucketConnectionConfig",
|
|
||||||
"properties": {
|
|
||||||
"type": {
|
|
||||||
"const": "bitbucket",
|
|
||||||
"description": "Bitbucket configuration"
|
|
||||||
},
|
|
||||||
"user": {
|
|
||||||
"type": "string",
|
|
||||||
"description": "The username to use for authentication. Only needed if token is an app password."
|
|
||||||
},
|
|
||||||
"token": {
|
|
||||||
"$ref": "./shared.json#/definitions/Token",
|
|
||||||
"description": "An authentication token.",
|
|
||||||
"examples": [
|
|
||||||
{
|
|
||||||
"secret": "SECRET_KEY"
|
|
||||||
}
|
|
||||||
]
|
|
||||||
},
|
|
||||||
"url": {
|
|
||||||
"type": "string",
|
|
||||||
"format": "url",
|
|
||||||
"default": "https://api.bitbucket.org/2.0",
|
|
||||||
"description": "Bitbucket URL",
|
|
||||||
"examples": [
|
|
||||||
"https://bitbucket.example.com"
|
|
||||||
],
|
|
||||||
"pattern": "^https?:\\/\\/[^\\s/$.?#].[^\\s]*$"
|
|
||||||
},
|
|
||||||
"deploymentType": {
|
|
||||||
"type": "string",
|
|
||||||
"enum": ["cloud", "server"],
|
|
||||||
"default": "cloud",
|
|
||||||
"description": "The type of Bitbucket deployment"
|
|
||||||
},
|
|
||||||
"workspaces": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"description": "List of workspaces to sync. Ignored if deploymentType is server."
|
|
||||||
},
|
|
||||||
"projects": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"description": "List of projects to sync"
|
|
||||||
},
|
|
||||||
"repos": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"description": "List of repos to sync"
|
|
||||||
},
|
|
||||||
"exclude": {
|
|
||||||
"type": "object",
|
|
||||||
"properties": {
|
|
||||||
"archived": {
|
|
||||||
"type": "boolean",
|
|
||||||
"default": false,
|
|
||||||
"description": "Exclude archived repositories from syncing."
|
|
||||||
},
|
|
||||||
"forks": {
|
|
||||||
"type": "boolean",
|
|
||||||
"default": false,
|
|
||||||
"description": "Exclude forked repositories from syncing."
|
|
||||||
},
|
|
||||||
"repos": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"examples": [
|
|
||||||
[
|
|
||||||
"cloud_workspace/repo1",
|
|
||||||
"server_project/repo2"
|
|
||||||
]
|
|
||||||
],
|
|
||||||
"description": "List of specific repos to exclude from syncing."
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"additionalProperties": false
|
|
||||||
},
|
|
||||||
"revisions": {
|
|
||||||
"$ref": "./shared.json#/definitions/GitRevisions"
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"required": [
|
|
||||||
"type"
|
|
||||||
],
|
|
||||||
"additionalProperties": false
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
</Accordion>
|
</Accordion>
|
||||||
|
|
@ -3,6 +3,8 @@ title: Linking code from Gerrit
|
||||||
sidebarTitle: Gerrit
|
sidebarTitle: Gerrit
|
||||||
---
|
---
|
||||||
|
|
||||||
|
import GerritSchema from '/snippets/schemas/v3/gerrit.schema.mdx'
|
||||||
|
|
||||||
<Note>Authenticating with Gerrit is currently not supported. If you need this capability, please raise a [feature request](https://github.com/sourcebot-dev/sourcebot/discussions/categories/ideas).</Note>
|
<Note>Authenticating with Gerrit is currently not supported. If you need this capability, please raise a [feature request](https://github.com/sourcebot-dev/sourcebot/discussions/categories/ideas).</Note>
|
||||||
|
|
||||||
Sourcebot can sync code from self-hosted gerrit instances.
|
Sourcebot can sync code from self-hosted gerrit instances.
|
||||||
|
|
@ -69,73 +71,6 @@ To connect to a gerrit instance, provide the `url` property to your config:
|
||||||
<Accordion title="Reference">
|
<Accordion title="Reference">
|
||||||
[schemas/v3/gerrit.json](https://github.com/sourcebot-dev/sourcebot/blob/main/schemas/v3/gerrit.json)
|
[schemas/v3/gerrit.json](https://github.com/sourcebot-dev/sourcebot/blob/main/schemas/v3/gerrit.json)
|
||||||
|
|
||||||
```json
|
<GerritSchema />
|
||||||
{
|
|
||||||
"$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."
|
|
||||||
},
|
|
||||||
"readOnly": {
|
|
||||||
"type": "boolean",
|
|
||||||
"default": false,
|
|
||||||
"description": "Exclude read-only projects from syncing."
|
|
||||||
},
|
|
||||||
"hidden": {
|
|
||||||
"type": "boolean",
|
|
||||||
"default": false,
|
|
||||||
"description": "Exclude hidden projects from syncing."
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"additionalProperties": false
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"required": [
|
|
||||||
"type",
|
|
||||||
"url"
|
|
||||||
],
|
|
||||||
"additionalProperties": false
|
|
||||||
}
|
|
||||||
```
|
|
||||||
</Accordion>
|
</Accordion>
|
||||||
|
|
@ -3,6 +3,8 @@ title: Linking code from Gitea
|
||||||
sidebarTitle: Gitea
|
sidebarTitle: Gitea
|
||||||
---
|
---
|
||||||
|
|
||||||
|
import GiteaSchema from '/snippets/schemas/v3/gitea.schema.mdx'
|
||||||
|
|
||||||
Sourcebot can sync code from Gitea Cloud, and self-hosted.
|
Sourcebot can sync code from Gitea Cloud, and self-hosted.
|
||||||
|
|
||||||
## Examples
|
## Examples
|
||||||
|
|
@ -143,166 +145,6 @@ To connect to a custom Gitea deployment, provide the `url` property to your conf
|
||||||
<Accordion title="Reference">
|
<Accordion title="Reference">
|
||||||
[schemas/v3/gitea.json](https://github.com/sourcebot-dev/sourcebot/blob/main/schemas/v3/gitea.json)
|
[schemas/v3/gitea.json](https://github.com/sourcebot-dev/sourcebot/blob/main/schemas/v3/gitea.json)
|
||||||
|
|
||||||
```json
|
<GiteaSchema />
|
||||||
{
|
|
||||||
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
||||||
"type": "object",
|
|
||||||
"title": "GiteaConnectionConfig",
|
|
||||||
"properties": {
|
|
||||||
"type": {
|
|
||||||
"const": "gitea",
|
|
||||||
"description": "Gitea Configuration"
|
|
||||||
},
|
|
||||||
"token": {
|
|
||||||
"description": "A Personal Access Token (PAT).",
|
|
||||||
"examples": [
|
|
||||||
{
|
|
||||||
"secret": "SECRET_KEY"
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"anyOf": [
|
|
||||||
{
|
|
||||||
"type": "object",
|
|
||||||
"properties": {
|
|
||||||
"secret": {
|
|
||||||
"type": "string",
|
|
||||||
"description": "The name of the secret that contains the token."
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"required": [
|
|
||||||
"secret"
|
|
||||||
],
|
|
||||||
"additionalProperties": false
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"type": "object",
|
|
||||||
"properties": {
|
|
||||||
"env": {
|
|
||||||
"type": "string",
|
|
||||||
"description": "The name of the environment variable that contains the token. Only supported in declarative connection configs."
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"required": [
|
|
||||||
"env"
|
|
||||||
],
|
|
||||||
"additionalProperties": false
|
|
||||||
}
|
|
||||||
]
|
|
||||||
},
|
|
||||||
"url": {
|
|
||||||
"type": "string",
|
|
||||||
"format": "url",
|
|
||||||
"default": "https://gitea.com",
|
|
||||||
"description": "The URL of the Gitea host. Defaults to https://gitea.com",
|
|
||||||
"examples": [
|
|
||||||
"https://gitea.com",
|
|
||||||
"https://gitea.example.com"
|
|
||||||
],
|
|
||||||
"pattern": "^https?:\\/\\/[^\\s/$.?#].[^\\s]*$"
|
|
||||||
},
|
|
||||||
"orgs": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"examples": [
|
|
||||||
[
|
|
||||||
"my-org-name"
|
|
||||||
]
|
|
||||||
],
|
|
||||||
"description": "List of organizations to sync with. All repositories in the organization visible to the provided `token` (if any) will be synced, unless explicitly defined in the `exclude` property. If a `token` is provided, it must have the read:organization scope."
|
|
||||||
},
|
|
||||||
"repos": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"type": "string",
|
|
||||||
"pattern": "^[\\w.-]+\\/[\\w.-]+$"
|
|
||||||
},
|
|
||||||
"description": "List of individual repositories to sync with. Expected to be formatted as '{orgName}/{repoName}' or '{userName}/{repoName}'."
|
|
||||||
},
|
|
||||||
"users": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"examples": [
|
|
||||||
[
|
|
||||||
"username-1",
|
|
||||||
"username-2"
|
|
||||||
]
|
|
||||||
],
|
|
||||||
"description": "List of users to sync with. All repositories that the user owns will be synced, unless explicitly defined in the `exclude` property. If a `token` is provided, it must have the read:user scope."
|
|
||||||
},
|
|
||||||
"exclude": {
|
|
||||||
"type": "object",
|
|
||||||
"properties": {
|
|
||||||
"forks": {
|
|
||||||
"type": "boolean",
|
|
||||||
"default": false,
|
|
||||||
"description": "Exclude forked repositories from syncing."
|
|
||||||
},
|
|
||||||
"archived": {
|
|
||||||
"type": "boolean",
|
|
||||||
"default": false,
|
|
||||||
"description": "Exclude archived repositories from syncing."
|
|
||||||
},
|
|
||||||
"repos": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"default": [],
|
|
||||||
"description": "List of individual repositories to exclude from syncing. Glob patterns are supported."
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"additionalProperties": false
|
|
||||||
},
|
|
||||||
"revisions": {
|
|
||||||
"type": "object",
|
|
||||||
"description": "The revisions (branches, tags) that should be included when indexing. The default branch (HEAD) is always indexed. A maximum of 64 revisions can be indexed, with any additional revisions being ignored.",
|
|
||||||
"properties": {
|
|
||||||
"branches": {
|
|
||||||
"type": "array",
|
|
||||||
"description": "List of branches to include when indexing. For a given repo, only the branches that exist on the repo's remote *and* match at least one of the provided `branches` will be indexed. The default branch (HEAD) is always indexed. Glob patterns are supported. A maximum of 64 branches can be indexed, with any additional branches being ignored.",
|
|
||||||
"items": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"examples": [
|
|
||||||
[
|
|
||||||
"main",
|
|
||||||
"release/*"
|
|
||||||
],
|
|
||||||
[
|
|
||||||
"**"
|
|
||||||
]
|
|
||||||
],
|
|
||||||
"default": []
|
|
||||||
},
|
|
||||||
"tags": {
|
|
||||||
"type": "array",
|
|
||||||
"description": "List of tags to include when indexing. For a given repo, only the tags that exist on the repo's remote *and* match at least one of the provided `tags` will be indexed. Glob patterns are supported. A maximum of 64 tags can be indexed, with any additional tags being ignored.",
|
|
||||||
"items": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"examples": [
|
|
||||||
[
|
|
||||||
"latest",
|
|
||||||
"v2.*.*"
|
|
||||||
],
|
|
||||||
[
|
|
||||||
"**"
|
|
||||||
]
|
|
||||||
],
|
|
||||||
"default": []
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"additionalProperties": false
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"required": [
|
|
||||||
"type"
|
|
||||||
],
|
|
||||||
"additionalProperties": false
|
|
||||||
}
|
|
||||||
```
|
|
||||||
</Accordion>
|
</Accordion>
|
||||||
|
|
@ -3,6 +3,8 @@ title: Linking code from GitHub
|
||||||
sidebarTitle: GitHub
|
sidebarTitle: GitHub
|
||||||
---
|
---
|
||||||
|
|
||||||
|
import GitHubSchema from '/snippets/schemas/v3/github.schema.mdx'
|
||||||
|
|
||||||
Sourcebot can sync code from GitHub.com, GitHub Enterprise Server, and GitHub Enterprise Cloud.
|
Sourcebot can sync code from GitHub.com, GitHub Enterprise Server, and GitHub Enterprise Cloud.
|
||||||
|
|
||||||
## Examples
|
## Examples
|
||||||
|
|
@ -172,220 +174,6 @@ To connect to a GitHub host other than `github.com`, provide the `url` property
|
||||||
<Accordion title="Reference">
|
<Accordion title="Reference">
|
||||||
[schemas/v3/github.json](https://github.com/sourcebot-dev/sourcebot/blob/main/schemas/v3/github.json)
|
[schemas/v3/github.json](https://github.com/sourcebot-dev/sourcebot/blob/main/schemas/v3/github.json)
|
||||||
|
|
||||||
```json
|
<GitHubSchema />
|
||||||
{
|
|
||||||
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
||||||
"type": "object",
|
|
||||||
"title": "GithubConnectionConfig",
|
|
||||||
"properties": {
|
|
||||||
"type": {
|
|
||||||
"const": "github",
|
|
||||||
"description": "GitHub Configuration"
|
|
||||||
},
|
|
||||||
"token": {
|
|
||||||
"description": "A Personal Access Token (PAT).",
|
|
||||||
"examples": [
|
|
||||||
{
|
|
||||||
"secret": "SECRET_KEY"
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"anyOf": [
|
|
||||||
{
|
|
||||||
"type": "object",
|
|
||||||
"properties": {
|
|
||||||
"secret": {
|
|
||||||
"type": "string",
|
|
||||||
"description": "The name of the secret that contains the token."
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"required": [
|
|
||||||
"secret"
|
|
||||||
],
|
|
||||||
"additionalProperties": false
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"type": "object",
|
|
||||||
"properties": {
|
|
||||||
"env": {
|
|
||||||
"type": "string",
|
|
||||||
"description": "The name of the environment variable that contains the token. Only supported in declarative connection configs."
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"required": [
|
|
||||||
"env"
|
|
||||||
],
|
|
||||||
"additionalProperties": false
|
|
||||||
}
|
|
||||||
]
|
|
||||||
},
|
|
||||||
"url": {
|
|
||||||
"type": "string",
|
|
||||||
"format": "url",
|
|
||||||
"default": "https://github.com",
|
|
||||||
"description": "The URL of the GitHub host. Defaults to https://github.com",
|
|
||||||
"examples": [
|
|
||||||
"https://github.com",
|
|
||||||
"https://github.example.com"
|
|
||||||
],
|
|
||||||
"pattern": "^https?:\\/\\/[^\\s/$.?#].[^\\s]*$"
|
|
||||||
},
|
|
||||||
"users": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"type": "string",
|
|
||||||
"pattern": "^[\\w.-]+$"
|
|
||||||
},
|
|
||||||
"default": [],
|
|
||||||
"examples": [
|
|
||||||
[
|
|
||||||
"torvalds",
|
|
||||||
"DHH"
|
|
||||||
]
|
|
||||||
],
|
|
||||||
"description": "List of users to sync with. All repositories that the user owns will be synced, unless explicitly defined in the `exclude` property."
|
|
||||||
},
|
|
||||||
"orgs": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"type": "string",
|
|
||||||
"pattern": "^[\\w.-]+$"
|
|
||||||
},
|
|
||||||
"default": [],
|
|
||||||
"examples": [
|
|
||||||
[
|
|
||||||
"my-org-name"
|
|
||||||
],
|
|
||||||
[
|
|
||||||
"sourcebot-dev",
|
|
||||||
"commaai"
|
|
||||||
]
|
|
||||||
],
|
|
||||||
"description": "List of organizations to sync with. All repositories in the organization visible to the provided `token` (if any) will be synced, unless explicitly defined in the `exclude` property."
|
|
||||||
},
|
|
||||||
"repos": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"type": "string",
|
|
||||||
"pattern": "^[\\w.-]+\\/[\\w.-]+$"
|
|
||||||
},
|
|
||||||
"default": [],
|
|
||||||
"description": "List of individual repositories to sync with. Expected to be formatted as '{orgName}/{repoName}' or '{userName}/{repoName}'."
|
|
||||||
},
|
|
||||||
"topics": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"minItems": 1,
|
|
||||||
"default": [],
|
|
||||||
"description": "List of repository topics to include when syncing. Only repositories that match at least one of the provided `topics` will be synced. If not specified, all repositories will be synced, unless explicitly defined in the `exclude` property. Glob patterns are supported.",
|
|
||||||
"examples": [
|
|
||||||
[
|
|
||||||
"docs",
|
|
||||||
"core"
|
|
||||||
]
|
|
||||||
]
|
|
||||||
},
|
|
||||||
"exclude": {
|
|
||||||
"type": "object",
|
|
||||||
"properties": {
|
|
||||||
"forks": {
|
|
||||||
"type": "boolean",
|
|
||||||
"default": false,
|
|
||||||
"description": "Exclude forked repositories from syncing."
|
|
||||||
},
|
|
||||||
"archived": {
|
|
||||||
"type": "boolean",
|
|
||||||
"default": false,
|
|
||||||
"description": "Exclude archived repositories from syncing."
|
|
||||||
},
|
|
||||||
"repos": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"default": [],
|
|
||||||
"description": "List of individual repositories to exclude from syncing. Glob patterns are supported."
|
|
||||||
},
|
|
||||||
"topics": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"default": [],
|
|
||||||
"description": "List of repository topics to exclude when syncing. Repositories that match one of the provided `topics` will be excluded from syncing. Glob patterns are supported.",
|
|
||||||
"examples": [
|
|
||||||
[
|
|
||||||
"tests",
|
|
||||||
"ci"
|
|
||||||
]
|
|
||||||
]
|
|
||||||
},
|
|
||||||
"size": {
|
|
||||||
"type": "object",
|
|
||||||
"description": "Exclude repositories based on their disk usage. Note: the disk usage is calculated by GitHub and may not reflect the actual disk usage when cloned.",
|
|
||||||
"properties": {
|
|
||||||
"min": {
|
|
||||||
"type": "integer",
|
|
||||||
"description": "Minimum repository size (in bytes) to sync (inclusive). Repositories less than this size will be excluded from syncing."
|
|
||||||
},
|
|
||||||
"max": {
|
|
||||||
"type": "integer",
|
|
||||||
"description": "Maximum repository size (in bytes) to sync (inclusive). Repositories greater than this size will be excluded from syncing."
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"additionalProperties": false
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"additionalProperties": false
|
|
||||||
},
|
|
||||||
"revisions": {
|
|
||||||
"type": "object",
|
|
||||||
"description": "The revisions (branches, tags) that should be included when indexing. The default branch (HEAD) is always indexed. A maximum of 64 revisions can be indexed, with any additional revisions being ignored.",
|
|
||||||
"properties": {
|
|
||||||
"branches": {
|
|
||||||
"type": "array",
|
|
||||||
"description": "List of branches to include when indexing. For a given repo, only the branches that exist on the repo's remote *and* match at least one of the provided `branches` will be indexed. The default branch (HEAD) is always indexed. Glob patterns are supported. A maximum of 64 branches can be indexed, with any additional branches being ignored.",
|
|
||||||
"items": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"examples": [
|
|
||||||
[
|
|
||||||
"main",
|
|
||||||
"release/*"
|
|
||||||
],
|
|
||||||
[
|
|
||||||
"**"
|
|
||||||
]
|
|
||||||
],
|
|
||||||
"default": []
|
|
||||||
},
|
|
||||||
"tags": {
|
|
||||||
"type": "array",
|
|
||||||
"description": "List of tags to include when indexing. For a given repo, only the tags that exist on the repo's remote *and* match at least one of the provided `tags` will be indexed. Glob patterns are supported. A maximum of 64 tags can be indexed, with any additional tags being ignored.",
|
|
||||||
"items": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"examples": [
|
|
||||||
[
|
|
||||||
"latest",
|
|
||||||
"v2.*.*"
|
|
||||||
],
|
|
||||||
[
|
|
||||||
"**"
|
|
||||||
]
|
|
||||||
],
|
|
||||||
"default": []
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"additionalProperties": false
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"required": [
|
|
||||||
"type"
|
|
||||||
],
|
|
||||||
"additionalProperties": false
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
</Accordion>
|
</Accordion>
|
||||||
|
|
@ -3,6 +3,8 @@ title: Linking code from GitLab
|
||||||
sidebarTitle: GitLab
|
sidebarTitle: GitLab
|
||||||
---
|
---
|
||||||
|
|
||||||
|
import GitLabSchema from '/snippets/schemas/v3/gitlab.schema.mdx'
|
||||||
|
|
||||||
Sourcebot can sync code from GitLab.com, Self Managed (CE & EE), and Dedicated.
|
Sourcebot can sync code from GitLab.com, Self Managed (CE & EE), and Dedicated.
|
||||||
|
|
||||||
|
|
||||||
|
|
@ -177,208 +179,6 @@ To connect to a GitLab host other than `gitlab.com`, provide the `url` property
|
||||||
<Accordion title="Reference">
|
<Accordion title="Reference">
|
||||||
[schemas/v3/gitlab.json](https://github.com/sourcebot-dev/sourcebot/blob/main/schemas/v3/gitlab.json)
|
[schemas/v3/gitlab.json](https://github.com/sourcebot-dev/sourcebot/blob/main/schemas/v3/gitlab.json)
|
||||||
|
|
||||||
```json
|
<GitLabSchema />
|
||||||
{
|
|
||||||
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
||||||
"type": "object",
|
|
||||||
"title": "GitlabConnectionConfig",
|
|
||||||
"properties": {
|
|
||||||
"type": {
|
|
||||||
"const": "gitlab",
|
|
||||||
"description": "GitLab Configuration"
|
|
||||||
},
|
|
||||||
"token": {
|
|
||||||
"description": "An authentication token.",
|
|
||||||
"examples": [
|
|
||||||
{
|
|
||||||
"secret": "SECRET_KEY"
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"anyOf": [
|
|
||||||
{
|
|
||||||
"type": "object",
|
|
||||||
"properties": {
|
|
||||||
"secret": {
|
|
||||||
"type": "string",
|
|
||||||
"description": "The name of the secret that contains the token."
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"required": [
|
|
||||||
"secret"
|
|
||||||
],
|
|
||||||
"additionalProperties": false
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"type": "object",
|
|
||||||
"properties": {
|
|
||||||
"env": {
|
|
||||||
"type": "string",
|
|
||||||
"description": "The name of the environment variable that contains the token. Only supported in declarative connection configs."
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"required": [
|
|
||||||
"env"
|
|
||||||
],
|
|
||||||
"additionalProperties": false
|
|
||||||
}
|
|
||||||
]
|
|
||||||
},
|
|
||||||
"url": {
|
|
||||||
"type": "string",
|
|
||||||
"format": "url",
|
|
||||||
"default": "https://gitlab.com",
|
|
||||||
"description": "The URL of the GitLab host. Defaults to https://gitlab.com",
|
|
||||||
"examples": [
|
|
||||||
"https://gitlab.com",
|
|
||||||
"https://gitlab.example.com"
|
|
||||||
],
|
|
||||||
"pattern": "^https?:\\/\\/[^\\s/$.?#].[^\\s]*$"
|
|
||||||
},
|
|
||||||
"all": {
|
|
||||||
"type": "boolean",
|
|
||||||
"default": false,
|
|
||||||
"description": "Sync all projects visible to the provided `token` (if any) in the GitLab instance. This option is ignored if `url` is either unset or set to https://gitlab.com ."
|
|
||||||
},
|
|
||||||
"users": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"description": "List of users to sync with. All projects owned by the user and visible to the provided `token` (if any) will be synced, unless explicitly defined in the `exclude` property."
|
|
||||||
},
|
|
||||||
"groups": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"examples": [
|
|
||||||
[
|
|
||||||
"my-group"
|
|
||||||
],
|
|
||||||
[
|
|
||||||
"my-group/sub-group-a",
|
|
||||||
"my-group/sub-group-b"
|
|
||||||
]
|
|
||||||
],
|
|
||||||
"description": "List of groups to sync with. All projects in the group (and recursive subgroups) visible to the provided `token` (if any) will be synced, unless explicitly defined in the `exclude` property. Subgroups can be specified by providing the path to the subgroup (e.g. `my-group/sub-group-a`)."
|
|
||||||
},
|
|
||||||
"projects": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"examples": [
|
|
||||||
[
|
|
||||||
"my-group/my-project"
|
|
||||||
],
|
|
||||||
[
|
|
||||||
"my-group/my-sub-group/my-project"
|
|
||||||
]
|
|
||||||
],
|
|
||||||
"description": "List of individual projects to sync with. The project's namespace must be specified. See: https://docs.gitlab.com/ee/user/namespace/"
|
|
||||||
},
|
|
||||||
"topics": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"minItems": 1,
|
|
||||||
"description": "List of project topics to include when syncing. Only projects that match at least one of the provided `topics` will be synced. If not specified, all projects will be synced, unless explicitly defined in the `exclude` property. Glob patterns are supported.",
|
|
||||||
"examples": [
|
|
||||||
[
|
|
||||||
"docs",
|
|
||||||
"core"
|
|
||||||
]
|
|
||||||
]
|
|
||||||
},
|
|
||||||
"exclude": {
|
|
||||||
"type": "object",
|
|
||||||
"properties": {
|
|
||||||
"forks": {
|
|
||||||
"type": "boolean",
|
|
||||||
"default": false,
|
|
||||||
"description": "Exclude forked projects from syncing."
|
|
||||||
},
|
|
||||||
"archived": {
|
|
||||||
"type": "boolean",
|
|
||||||
"default": false,
|
|
||||||
"description": "Exclude archived projects from syncing."
|
|
||||||
},
|
|
||||||
"projects": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"default": [],
|
|
||||||
"examples": [
|
|
||||||
[
|
|
||||||
"my-group/my-project"
|
|
||||||
]
|
|
||||||
],
|
|
||||||
"description": "List of projects to exclude from syncing. Glob patterns are supported. The project's namespace must be specified, see: https://docs.gitlab.com/ee/user/namespace/"
|
|
||||||
},
|
|
||||||
"topics": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"description": "List of project topics to exclude when syncing. Projects that match one of the provided `topics` will be excluded from syncing. Glob patterns are supported.",
|
|
||||||
"examples": [
|
|
||||||
[
|
|
||||||
"tests",
|
|
||||||
"ci"
|
|
||||||
]
|
|
||||||
]
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"additionalProperties": false
|
|
||||||
},
|
|
||||||
"revisions": {
|
|
||||||
"type": "object",
|
|
||||||
"description": "The revisions (branches, tags) that should be included when indexing. The default branch (HEAD) is always indexed. A maximum of 64 revisions can be indexed, with any additional revisions being ignored.",
|
|
||||||
"properties": {
|
|
||||||
"branches": {
|
|
||||||
"type": "array",
|
|
||||||
"description": "List of branches to include when indexing. For a given repo, only the branches that exist on the repo's remote *and* match at least one of the provided `branches` will be indexed. The default branch (HEAD) is always indexed. Glob patterns are supported. A maximum of 64 branches can be indexed, with any additional branches being ignored.",
|
|
||||||
"items": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"examples": [
|
|
||||||
[
|
|
||||||
"main",
|
|
||||||
"release/*"
|
|
||||||
],
|
|
||||||
[
|
|
||||||
"**"
|
|
||||||
]
|
|
||||||
],
|
|
||||||
"default": []
|
|
||||||
},
|
|
||||||
"tags": {
|
|
||||||
"type": "array",
|
|
||||||
"description": "List of tags to include when indexing. For a given repo, only the tags that exist on the repo's remote *and* match at least one of the provided `tags` will be indexed. Glob patterns are supported. A maximum of 64 tags can be indexed, with any additional tags being ignored.",
|
|
||||||
"items": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"examples": [
|
|
||||||
[
|
|
||||||
"latest",
|
|
||||||
"v2.*.*"
|
|
||||||
],
|
|
||||||
[
|
|
||||||
"**"
|
|
||||||
]
|
|
||||||
],
|
|
||||||
"default": []
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"additionalProperties": false
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"required": [
|
|
||||||
"type"
|
|
||||||
],
|
|
||||||
"additionalProperties": false
|
|
||||||
}
|
|
||||||
```
|
|
||||||
</Accordion>
|
</Accordion>
|
||||||
|
|
@ -3,6 +3,8 @@ title: Configuring Sourcebot from a file (declarative config)
|
||||||
sidebarTitle: Declarative config
|
sidebarTitle: Declarative config
|
||||||
---
|
---
|
||||||
|
|
||||||
|
import ConfigSchema from '/snippets/schemas/v3/index.schema.mdx'
|
||||||
|
|
||||||
<Warning>
|
<Warning>
|
||||||
Declaratively defining `connections` is not available when [multi-tenancy](/self-hosting/more/tenancy) is enabled.
|
Declaratively defining `connections` is not available when [multi-tenancy](/self-hosting/more/tenancy) is enabled.
|
||||||
</Warning>
|
</Warning>
|
||||||
|
|
@ -34,600 +36,6 @@ Some teams require Sourcebot to be configured via a file (where it can be stored
|
||||||
<Accordion title="Reference">
|
<Accordion title="Reference">
|
||||||
[schemas/v3/index.json](https://github.com/sourcebot-dev/sourcebot/blob/main/schemas/v3/index.json)
|
[schemas/v3/index.json](https://github.com/sourcebot-dev/sourcebot/blob/main/schemas/v3/index.json)
|
||||||
|
|
||||||
```json
|
<ConfigSchema />
|
||||||
{
|
|
||||||
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
||||||
"type": "object",
|
|
||||||
"title": "SourcebotConfig",
|
|
||||||
"definitions": {
|
|
||||||
"Settings": {
|
|
||||||
"type": "object",
|
|
||||||
"description": "Defines the globabl settings for Sourcebot.",
|
|
||||||
"properties": {
|
|
||||||
"maxFileSize": {
|
|
||||||
"type": "number",
|
|
||||||
"description": "The maximum size of a file (in bytes) to be indexed. Files that exceed this maximum will not be indexed. Defaults to 2MB.",
|
|
||||||
"minimum": 1
|
|
||||||
},
|
|
||||||
"maxTrigramCount": {
|
|
||||||
"type": "number",
|
|
||||||
"description": "The maximum number of trigrams per document. Files that exceed this maximum will not be indexed. Default to 20000.",
|
|
||||||
"minimum": 1
|
|
||||||
},
|
|
||||||
"reindexIntervalMs": {
|
|
||||||
"type": "number",
|
|
||||||
"description": "The interval (in milliseconds) at which the indexer should re-index all repositories. Defaults to 1 hour.",
|
|
||||||
"minimum": 1
|
|
||||||
},
|
|
||||||
"resyncConnectionIntervalMs": {
|
|
||||||
"type": "number",
|
|
||||||
"description": "The interval (in milliseconds) at which the connection manager should check for connections that need to be re-synced. Defaults to 24 hours.",
|
|
||||||
"minimum": 1
|
|
||||||
},
|
|
||||||
"resyncConnectionPollingIntervalMs": {
|
|
||||||
"type": "number",
|
|
||||||
"description": "The polling rate (in milliseconds) at which the db should be checked for connections that need to be re-synced. Defaults to 1 second.",
|
|
||||||
"minimum": 1
|
|
||||||
},
|
|
||||||
"reindexRepoPollingIntervalMs": {
|
|
||||||
"type": "number",
|
|
||||||
"description": "The polling rate (in milliseconds) at which the db should be checked for repos that should be re-indexed. Defaults to 1 second.",
|
|
||||||
"minimum": 1
|
|
||||||
},
|
|
||||||
"maxConnectionSyncJobConcurrency": {
|
|
||||||
"type": "number",
|
|
||||||
"description": "The number of connection sync jobs to run concurrently. Defaults to 8.",
|
|
||||||
"minimum": 1
|
|
||||||
},
|
|
||||||
"maxRepoIndexingJobConcurrency": {
|
|
||||||
"type": "number",
|
|
||||||
"description": "The number of repo indexing jobs to run concurrently. Defaults to 8.",
|
|
||||||
"minimum": 1
|
|
||||||
},
|
|
||||||
"maxRepoGarbageCollectionJobConcurrency": {
|
|
||||||
"type": "number",
|
|
||||||
"description": "The number of repo GC jobs to run concurrently. Defaults to 8.",
|
|
||||||
"minimum": 1
|
|
||||||
},
|
|
||||||
"repoGarbageCollectionGracePeriodMs": {
|
|
||||||
"type": "number",
|
|
||||||
"description": "The grace period (in milliseconds) for garbage collection. Used to prevent deleting shards while they're being loaded. Defaults to 10 seconds.",
|
|
||||||
"minimum": 1
|
|
||||||
},
|
|
||||||
"repoIndexTimeoutMs": {
|
|
||||||
"type": "number",
|
|
||||||
"description": "The timeout (in milliseconds) for a repo indexing to timeout. Defaults to 2 hours.",
|
|
||||||
"minimum": 1
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"additionalProperties": false
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"properties": {
|
|
||||||
"$schema": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"settings": {
|
|
||||||
"$ref": "#/definitions/Settings"
|
|
||||||
},
|
|
||||||
"connections": {
|
|
||||||
"type": "object",
|
|
||||||
"description": "Defines a collection of connections from varying code hosts that Sourcebot should sync with. This is only available in single-tenancy mode.",
|
|
||||||
"patternProperties": {
|
|
||||||
"^[a-zA-Z0-9_-]+$": {
|
|
||||||
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
||||||
"title": "ConnectionConfig",
|
|
||||||
"oneOf": [
|
|
||||||
{
|
|
||||||
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
||||||
"type": "object",
|
|
||||||
"title": "GithubConnectionConfig",
|
|
||||||
"properties": {
|
|
||||||
"type": {
|
|
||||||
"const": "github",
|
|
||||||
"description": "GitHub Configuration"
|
|
||||||
},
|
|
||||||
"token": {
|
|
||||||
"description": "A Personal Access Token (PAT).",
|
|
||||||
"examples": [
|
|
||||||
{
|
|
||||||
"secret": "SECRET_KEY"
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"anyOf": [
|
|
||||||
{
|
|
||||||
"type": "object",
|
|
||||||
"properties": {
|
|
||||||
"secret": {
|
|
||||||
"type": "string",
|
|
||||||
"description": "The name of the secret that contains the token."
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"required": [
|
|
||||||
"secret"
|
|
||||||
],
|
|
||||||
"additionalProperties": false
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"type": "object",
|
|
||||||
"properties": {
|
|
||||||
"env": {
|
|
||||||
"type": "string",
|
|
||||||
"description": "The name of the environment variable that contains the token. Only supported in declarative connection configs."
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"required": [
|
|
||||||
"env"
|
|
||||||
],
|
|
||||||
"additionalProperties": false
|
|
||||||
}
|
|
||||||
]
|
|
||||||
},
|
|
||||||
"url": {
|
|
||||||
"type": "string",
|
|
||||||
"format": "url",
|
|
||||||
"default": "https://github.com",
|
|
||||||
"description": "The URL of the GitHub host. Defaults to https://github.com",
|
|
||||||
"examples": [
|
|
||||||
"https://github.com",
|
|
||||||
"https://github.example.com"
|
|
||||||
],
|
|
||||||
"pattern": "^https?:\\/\\/[^\\s/$.?#].[^\\s]*$"
|
|
||||||
},
|
|
||||||
"users": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"type": "string",
|
|
||||||
"pattern": "^[\\w.-]+$"
|
|
||||||
},
|
|
||||||
"default": [],
|
|
||||||
"examples": [
|
|
||||||
[
|
|
||||||
"torvalds",
|
|
||||||
"DHH"
|
|
||||||
]
|
|
||||||
],
|
|
||||||
"description": "List of users to sync with. All repositories that the user owns will be synced, unless explicitly defined in the `exclude` property."
|
|
||||||
},
|
|
||||||
"orgs": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"type": "string",
|
|
||||||
"pattern": "^[\\w.-]+$"
|
|
||||||
},
|
|
||||||
"default": [],
|
|
||||||
"examples": [
|
|
||||||
[
|
|
||||||
"my-org-name"
|
|
||||||
],
|
|
||||||
[
|
|
||||||
"sourcebot-dev",
|
|
||||||
"commaai"
|
|
||||||
]
|
|
||||||
],
|
|
||||||
"description": "List of organizations to sync with. All repositories in the organization visible to the provided `token` (if any) will be synced, unless explicitly defined in the `exclude` property."
|
|
||||||
},
|
|
||||||
"repos": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"type": "string",
|
|
||||||
"pattern": "^[\\w.-]+\\/[\\w.-]+$"
|
|
||||||
},
|
|
||||||
"default": [],
|
|
||||||
"description": "List of individual repositories to sync with. Expected to be formatted as '{orgName}/{repoName}' or '{userName}/{repoName}'."
|
|
||||||
},
|
|
||||||
"topics": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"minItems": 1,
|
|
||||||
"default": [],
|
|
||||||
"description": "List of repository topics to include when syncing. Only repositories that match at least one of the provided `topics` will be synced. If not specified, all repositories will be synced, unless explicitly defined in the `exclude` property. Glob patterns are supported.",
|
|
||||||
"examples": [
|
|
||||||
[
|
|
||||||
"docs",
|
|
||||||
"core"
|
|
||||||
]
|
|
||||||
]
|
|
||||||
},
|
|
||||||
"exclude": {
|
|
||||||
"type": "object",
|
|
||||||
"properties": {
|
|
||||||
"forks": {
|
|
||||||
"type": "boolean",
|
|
||||||
"default": false,
|
|
||||||
"description": "Exclude forked repositories from syncing."
|
|
||||||
},
|
|
||||||
"archived": {
|
|
||||||
"type": "boolean",
|
|
||||||
"default": false,
|
|
||||||
"description": "Exclude archived repositories from syncing."
|
|
||||||
},
|
|
||||||
"repos": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"default": [],
|
|
||||||
"description": "List of individual repositories to exclude from syncing. Glob patterns are supported."
|
|
||||||
},
|
|
||||||
"topics": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"default": [],
|
|
||||||
"description": "List of repository topics to exclude when syncing. Repositories that match one of the provided `topics` will be excluded from syncing. Glob patterns are supported.",
|
|
||||||
"examples": [
|
|
||||||
[
|
|
||||||
"tests",
|
|
||||||
"ci"
|
|
||||||
]
|
|
||||||
]
|
|
||||||
},
|
|
||||||
"size": {
|
|
||||||
"type": "object",
|
|
||||||
"description": "Exclude repositories based on their disk usage. Note: the disk usage is calculated by GitHub and may not reflect the actual disk usage when cloned.",
|
|
||||||
"properties": {
|
|
||||||
"min": {
|
|
||||||
"type": "integer",
|
|
||||||
"description": "Minimum repository size (in bytes) to sync (inclusive). Repositories less than this size will be excluded from syncing."
|
|
||||||
},
|
|
||||||
"max": {
|
|
||||||
"type": "integer",
|
|
||||||
"description": "Maximum repository size (in bytes) to sync (inclusive). Repositories greater than this size will be excluded from syncing."
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"additionalProperties": false
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"additionalProperties": false
|
|
||||||
},
|
|
||||||
"revisions": {
|
|
||||||
"type": "object",
|
|
||||||
"description": "The revisions (branches, tags) that should be included when indexing. The default branch (HEAD) is always indexed. A maximum of 64 revisions can be indexed, with any additional revisions being ignored.",
|
|
||||||
"properties": {
|
|
||||||
"branches": {
|
|
||||||
"type": "array",
|
|
||||||
"description": "List of branches to include when indexing. For a given repo, only the branches that exist on the repo's remote *and* match at least one of the provided `branches` will be indexed. The default branch (HEAD) is always indexed. Glob patterns are supported. A maximum of 64 branches can be indexed, with any additional branches being ignored.",
|
|
||||||
"items": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"examples": [
|
|
||||||
[
|
|
||||||
"main",
|
|
||||||
"release/*"
|
|
||||||
],
|
|
||||||
[
|
|
||||||
"**"
|
|
||||||
]
|
|
||||||
],
|
|
||||||
"default": []
|
|
||||||
},
|
|
||||||
"tags": {
|
|
||||||
"type": "array",
|
|
||||||
"description": "List of tags to include when indexing. For a given repo, only the tags that exist on the repo's remote *and* match at least one of the provided `tags` will be indexed. Glob patterns are supported. A maximum of 64 tags can be indexed, with any additional tags being ignored.",
|
|
||||||
"items": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"examples": [
|
|
||||||
[
|
|
||||||
"latest",
|
|
||||||
"v2.*.*"
|
|
||||||
],
|
|
||||||
[
|
|
||||||
"**"
|
|
||||||
]
|
|
||||||
],
|
|
||||||
"default": []
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"additionalProperties": false
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"required": [
|
|
||||||
"type"
|
|
||||||
],
|
|
||||||
"additionalProperties": false
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
||||||
"type": "object",
|
|
||||||
"title": "GitlabConnectionConfig",
|
|
||||||
"properties": {
|
|
||||||
"type": {
|
|
||||||
"const": "gitlab",
|
|
||||||
"description": "GitLab Configuration"
|
|
||||||
},
|
|
||||||
"token": {
|
|
||||||
"$ref": "#/properties/connections/patternProperties/%5E%5Ba-zA-Z0-9_-%5D%2B%24/oneOf/0/properties/token",
|
|
||||||
"description": "An authentication token.",
|
|
||||||
"examples": [
|
|
||||||
{
|
|
||||||
"secret": "SECRET_KEY"
|
|
||||||
}
|
|
||||||
]
|
|
||||||
},
|
|
||||||
"url": {
|
|
||||||
"type": "string",
|
|
||||||
"format": "url",
|
|
||||||
"default": "https://gitlab.com",
|
|
||||||
"description": "The URL of the GitLab host. Defaults to https://gitlab.com",
|
|
||||||
"examples": [
|
|
||||||
"https://gitlab.com",
|
|
||||||
"https://gitlab.example.com"
|
|
||||||
],
|
|
||||||
"pattern": "^https?:\\/\\/[^\\s/$.?#].[^\\s]*$"
|
|
||||||
},
|
|
||||||
"all": {
|
|
||||||
"type": "boolean",
|
|
||||||
"default": false,
|
|
||||||
"description": "Sync all projects visible to the provided `token` (if any) in the GitLab instance. This option is ignored if `url` is either unset or set to https://gitlab.com ."
|
|
||||||
},
|
|
||||||
"users": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"description": "List of users to sync with. All projects owned by the user and visible to the provided `token` (if any) will be synced, unless explicitly defined in the `exclude` property."
|
|
||||||
},
|
|
||||||
"groups": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"examples": [
|
|
||||||
[
|
|
||||||
"my-group"
|
|
||||||
],
|
|
||||||
[
|
|
||||||
"my-group/sub-group-a",
|
|
||||||
"my-group/sub-group-b"
|
|
||||||
]
|
|
||||||
],
|
|
||||||
"description": "List of groups to sync with. All projects in the group (and recursive subgroups) visible to the provided `token` (if any) will be synced, unless explicitly defined in the `exclude` property. Subgroups can be specified by providing the path to the subgroup (e.g. `my-group/sub-group-a`)."
|
|
||||||
},
|
|
||||||
"projects": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"examples": [
|
|
||||||
[
|
|
||||||
"my-group/my-project"
|
|
||||||
],
|
|
||||||
[
|
|
||||||
"my-group/my-sub-group/my-project"
|
|
||||||
]
|
|
||||||
],
|
|
||||||
"description": "List of individual projects to sync with. The project's namespace must be specified. See: https://docs.gitlab.com/ee/user/namespace/"
|
|
||||||
},
|
|
||||||
"topics": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"minItems": 1,
|
|
||||||
"description": "List of project topics to include when syncing. Only projects that match at least one of the provided `topics` will be synced. If not specified, all projects will be synced, unless explicitly defined in the `exclude` property. Glob patterns are supported.",
|
|
||||||
"examples": [
|
|
||||||
[
|
|
||||||
"docs",
|
|
||||||
"core"
|
|
||||||
]
|
|
||||||
]
|
|
||||||
},
|
|
||||||
"exclude": {
|
|
||||||
"type": "object",
|
|
||||||
"properties": {
|
|
||||||
"forks": {
|
|
||||||
"type": "boolean",
|
|
||||||
"default": false,
|
|
||||||
"description": "Exclude forked projects from syncing."
|
|
||||||
},
|
|
||||||
"archived": {
|
|
||||||
"type": "boolean",
|
|
||||||
"default": false,
|
|
||||||
"description": "Exclude archived projects from syncing."
|
|
||||||
},
|
|
||||||
"projects": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"default": [],
|
|
||||||
"examples": [
|
|
||||||
[
|
|
||||||
"my-group/my-project"
|
|
||||||
]
|
|
||||||
],
|
|
||||||
"description": "List of projects to exclude from syncing. Glob patterns are supported. The project's namespace must be specified, see: https://docs.gitlab.com/ee/user/namespace/"
|
|
||||||
},
|
|
||||||
"topics": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"description": "List of project topics to exclude when syncing. Projects that match one of the provided `topics` will be excluded from syncing. Glob patterns are supported.",
|
|
||||||
"examples": [
|
|
||||||
[
|
|
||||||
"tests",
|
|
||||||
"ci"
|
|
||||||
]
|
|
||||||
]
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"additionalProperties": false
|
|
||||||
},
|
|
||||||
"revisions": {
|
|
||||||
"$ref": "#/properties/connections/patternProperties/%5E%5Ba-zA-Z0-9_-%5D%2B%24/oneOf/0/properties/revisions"
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"required": [
|
|
||||||
"type"
|
|
||||||
],
|
|
||||||
"additionalProperties": false
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
||||||
"type": "object",
|
|
||||||
"title": "GiteaConnectionConfig",
|
|
||||||
"properties": {
|
|
||||||
"type": {
|
|
||||||
"const": "gitea",
|
|
||||||
"description": "Gitea Configuration"
|
|
||||||
},
|
|
||||||
"token": {
|
|
||||||
"$ref": "#/properties/connections/patternProperties/%5E%5Ba-zA-Z0-9_-%5D%2B%24/oneOf/0/properties/token",
|
|
||||||
"description": "A Personal Access Token (PAT).",
|
|
||||||
"examples": [
|
|
||||||
{
|
|
||||||
"secret": "SECRET_KEY"
|
|
||||||
}
|
|
||||||
]
|
|
||||||
},
|
|
||||||
"url": {
|
|
||||||
"type": "string",
|
|
||||||
"format": "url",
|
|
||||||
"default": "https://gitea.com",
|
|
||||||
"description": "The URL of the Gitea host. Defaults to https://gitea.com",
|
|
||||||
"examples": [
|
|
||||||
"https://gitea.com",
|
|
||||||
"https://gitea.example.com"
|
|
||||||
],
|
|
||||||
"pattern": "^https?:\\/\\/[^\\s/$.?#].[^\\s]*$"
|
|
||||||
},
|
|
||||||
"orgs": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"examples": [
|
|
||||||
[
|
|
||||||
"my-org-name"
|
|
||||||
]
|
|
||||||
],
|
|
||||||
"description": "List of organizations to sync with. All repositories in the organization visible to the provided `token` (if any) will be synced, unless explicitly defined in the `exclude` property. If a `token` is provided, it must have the read:organization scope."
|
|
||||||
},
|
|
||||||
"repos": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"type": "string",
|
|
||||||
"pattern": "^[\\w.-]+\\/[\\w.-]+$"
|
|
||||||
},
|
|
||||||
"description": "List of individual repositories to sync with. Expected to be formatted as '{orgName}/{repoName}' or '{userName}/{repoName}'."
|
|
||||||
},
|
|
||||||
"users": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"examples": [
|
|
||||||
[
|
|
||||||
"username-1",
|
|
||||||
"username-2"
|
|
||||||
]
|
|
||||||
],
|
|
||||||
"description": "List of users to sync with. All repositories that the user owns will be synced, unless explicitly defined in the `exclude` property. If a `token` is provided, it must have the read:user scope."
|
|
||||||
},
|
|
||||||
"exclude": {
|
|
||||||
"type": "object",
|
|
||||||
"properties": {
|
|
||||||
"forks": {
|
|
||||||
"type": "boolean",
|
|
||||||
"default": false,
|
|
||||||
"description": "Exclude forked repositories from syncing."
|
|
||||||
},
|
|
||||||
"archived": {
|
|
||||||
"type": "boolean",
|
|
||||||
"default": false,
|
|
||||||
"description": "Exclude archived repositories from syncing."
|
|
||||||
},
|
|
||||||
"repos": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"default": [],
|
|
||||||
"description": "List of individual repositories to exclude from syncing. Glob patterns are supported."
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"additionalProperties": false
|
|
||||||
},
|
|
||||||
"revisions": {
|
|
||||||
"$ref": "#/properties/connections/patternProperties/%5E%5Ba-zA-Z0-9_-%5D%2B%24/oneOf/0/properties/revisions"
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"required": [
|
|
||||||
"type"
|
|
||||||
],
|
|
||||||
"additionalProperties": false
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"$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
|
|
||||||
}
|
|
||||||
]
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"additionalProperties": false
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"additionalProperties": false
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
</Accordion>
|
</Accordion>
|
||||||
|
|
@ -3,6 +3,8 @@ title: Search contexts
|
||||||
sidebarTitle: Search contexts (EE)
|
sidebarTitle: Search contexts (EE)
|
||||||
---
|
---
|
||||||
|
|
||||||
|
import SearchContextSchema from '/snippets/schemas/v3/searchContext.schema.mdx'
|
||||||
|
|
||||||
<Note>
|
<Note>
|
||||||
This is only available in the Enterprise Edition. Please add your [license key](/self-hosting/license-key) to activate it.
|
This is only available in the Enterprise Edition. Please add your [license key](/self-hosting/license-key) to activate it.
|
||||||
</Note>
|
</Note>
|
||||||
|
|
@ -108,46 +110,9 @@ See [this doc](/docs/more/syntax-reference) for more details on the search query
|
||||||
## Schema reference
|
## Schema reference
|
||||||
|
|
||||||
<Accordion title="Reference">
|
<Accordion title="Reference">
|
||||||
```json
|
|
||||||
{
|
[schemas/v3/searchContext.json](https://github.com/sourcebot-dev/sourcebot/blob/main/schemas/v3/searchContext.json)
|
||||||
"type": "object",
|
|
||||||
"description": "Search context",
|
<SearchContextSchema />
|
||||||
"properties": {
|
|
||||||
"include": {
|
|
||||||
"type": "array",
|
|
||||||
"description": "List of repositories to include in the search context. Expected to be formatted as a URL without any leading http(s):// prefix (e.g., 'github.com/sourcebot-dev/sourcebot'). Glob patterns are supported.",
|
|
||||||
"items": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"examples": [
|
|
||||||
[
|
|
||||||
"github.com/sourcebot-dev/**",
|
|
||||||
"gerrit.example.org/sub/path/**"
|
|
||||||
]
|
|
||||||
]
|
|
||||||
},
|
|
||||||
"exclude": {
|
|
||||||
"type": "array",
|
|
||||||
"description": "List of repositories to exclude from the search context. Expected to be formatted as a URL without any leading http(s):// prefix (e.g., 'github.com/sourcebot-dev/sourcebot'). Glob patterns are supported.",
|
|
||||||
"items": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"examples": [
|
|
||||||
[
|
|
||||||
"github.com/sourcebot-dev/sourcebot",
|
|
||||||
"gerrit.example.org/sub/path/**"
|
|
||||||
]
|
|
||||||
]
|
|
||||||
},
|
|
||||||
"description": {
|
|
||||||
"type": "string",
|
|
||||||
"description": "Optional description of the search context that surfaces in the UI."
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"required": [
|
|
||||||
"include"
|
|
||||||
],
|
|
||||||
"additionalProperties": false
|
|
||||||
}
|
|
||||||
```
|
|
||||||
</Accordion>
|
</Accordion>
|
||||||
|
|
|
||||||
138
docs/snippets/schemas/v1/index.schema.mdx
Normal file
138
docs/snippets/schemas/v1/index.schema.mdx
Normal file
|
|
@ -0,0 +1,138 @@
|
||||||
|
{/* THIS IS A AUTO-GENERATED FILE. DO NOT MODIFY MANUALLY! */}
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
||||||
|
"type": "object",
|
||||||
|
"definitions": {
|
||||||
|
"RepoNameRegexIncludeFilter": {
|
||||||
|
"type": "string",
|
||||||
|
"description": "Only clone repos whose name matches the given regexp.",
|
||||||
|
"format": "regexp",
|
||||||
|
"default": "^(foo|bar)$"
|
||||||
|
},
|
||||||
|
"RepoNameRegexExcludeFilter": {
|
||||||
|
"type": "string",
|
||||||
|
"description": "Don't mirror repos whose names match this regexp.",
|
||||||
|
"format": "regexp",
|
||||||
|
"default": "^(fizz|buzz)$"
|
||||||
|
},
|
||||||
|
"ZoektConfig": {
|
||||||
|
"anyOf": [
|
||||||
|
{
|
||||||
|
"$ref": "#/definitions/GitHubConfig"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"$ref": "#/definitions/GitLabConfig"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"GitHubConfig": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"Type": {
|
||||||
|
"const": "github"
|
||||||
|
},
|
||||||
|
"GitHubUrl": {
|
||||||
|
"type": "string",
|
||||||
|
"description": "GitHub Enterprise url. If not set github.com will be used as the host."
|
||||||
|
},
|
||||||
|
"GitHubUser": {
|
||||||
|
"type": "string",
|
||||||
|
"description": "The GitHub user to mirror"
|
||||||
|
},
|
||||||
|
"GitHubOrg": {
|
||||||
|
"type": "string",
|
||||||
|
"description": "The GitHub organization to mirror"
|
||||||
|
},
|
||||||
|
"Name": {
|
||||||
|
"$ref": "#/definitions/RepoNameRegexIncludeFilter"
|
||||||
|
},
|
||||||
|
"Exclude": {
|
||||||
|
"$ref": "#/definitions/RepoNameRegexExcludeFilter"
|
||||||
|
},
|
||||||
|
"CredentialPath": {
|
||||||
|
"type": "string",
|
||||||
|
"description": "Path to a file containing a GitHub access token.",
|
||||||
|
"default": "~/.github-token"
|
||||||
|
},
|
||||||
|
"Topics": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"description": "Only mirror repos that have one of the given topics"
|
||||||
|
},
|
||||||
|
"ExcludeTopics": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"description": "Don't mirror repos that have one of the given topics"
|
||||||
|
},
|
||||||
|
"NoArchived": {
|
||||||
|
"type": "boolean",
|
||||||
|
"description": "Mirror repos that are _not_ archived",
|
||||||
|
"default": false
|
||||||
|
},
|
||||||
|
"IncludeForks": {
|
||||||
|
"type": "boolean",
|
||||||
|
"description": "Also mirror forks",
|
||||||
|
"default": false
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"Type"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"GitLabConfig": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"Type": {
|
||||||
|
"const": "gitlab"
|
||||||
|
},
|
||||||
|
"GitLabURL": {
|
||||||
|
"type": "string",
|
||||||
|
"description": "The GitLab API url.",
|
||||||
|
"default": "https://gitlab.com/api/v4/"
|
||||||
|
},
|
||||||
|
"Name": {
|
||||||
|
"$ref": "#/definitions/RepoNameRegexIncludeFilter"
|
||||||
|
},
|
||||||
|
"Exclude": {
|
||||||
|
"$ref": "#/definitions/RepoNameRegexExcludeFilter"
|
||||||
|
},
|
||||||
|
"OnlyPublic": {
|
||||||
|
"type": "boolean",
|
||||||
|
"description": "Only mirror public repos",
|
||||||
|
"default": false
|
||||||
|
},
|
||||||
|
"CredentialPath": {
|
||||||
|
"type": "string",
|
||||||
|
"description": "Path to a file containing a GitLab access token.",
|
||||||
|
"default": "~/.gitlab-token"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"Type"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"properties": {
|
||||||
|
"$schema": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"Configs": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"$ref": "#/definitions/ZoektConfig"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"Configs"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
```
|
||||||
643
docs/snippets/schemas/v2/index.schema.mdx
Normal file
643
docs/snippets/schemas/v2/index.schema.mdx
Normal file
|
|
@ -0,0 +1,643 @@
|
||||||
|
{/* THIS IS A AUTO-GENERATED FILE. DO NOT MODIFY MANUALLY! */}
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
||||||
|
"type": "object",
|
||||||
|
"title": "Sourcebot configuration schema",
|
||||||
|
"description": "A Sourcebot configuration file outlines which repositories Sourcebot should sync and index.",
|
||||||
|
"definitions": {
|
||||||
|
"Token": {
|
||||||
|
"anyOf": [
|
||||||
|
{
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"env": {
|
||||||
|
"type": "string",
|
||||||
|
"description": "The name of the environment variable that contains the token."
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"env"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"GitRevisions": {
|
||||||
|
"type": "object",
|
||||||
|
"description": "The revisions (branches, tags) that should be included when indexing. The default branch (HEAD) is always indexed.",
|
||||||
|
"properties": {
|
||||||
|
"branches": {
|
||||||
|
"type": "array",
|
||||||
|
"description": "List of branches to include when indexing. For a given repo, only the branches that exist on the repo's remote *and* match at least one of the provided `branches` will be indexed. The default branch (HEAD) is always indexed. Glob patterns are supported.",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"main",
|
||||||
|
"release/*"
|
||||||
|
],
|
||||||
|
[
|
||||||
|
"**"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"default": []
|
||||||
|
},
|
||||||
|
"tags": {
|
||||||
|
"type": "array",
|
||||||
|
"description": "List of tags to include when indexing. For a given repo, only the tags that exist on the repo's remote *and* match at least one of the provided `tags` will be indexed. Glob patterns are supported.",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"latest",
|
||||||
|
"v2.*.*"
|
||||||
|
],
|
||||||
|
[
|
||||||
|
"**"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"default": []
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"GitHubConfig": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"type": {
|
||||||
|
"const": "github",
|
||||||
|
"description": "GitHub Configuration"
|
||||||
|
},
|
||||||
|
"token": {
|
||||||
|
"$ref": "#/definitions/Token",
|
||||||
|
"description": "A Personal Access Token (PAT).",
|
||||||
|
"examples": [
|
||||||
|
"secret-token",
|
||||||
|
{
|
||||||
|
"env": "ENV_VAR_CONTAINING_TOKEN"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"url": {
|
||||||
|
"type": "string",
|
||||||
|
"format": "url",
|
||||||
|
"default": "https://github.com",
|
||||||
|
"description": "The URL of the GitHub host. Defaults to https://github.com",
|
||||||
|
"examples": [
|
||||||
|
"https://github.com",
|
||||||
|
"https://github.example.com"
|
||||||
|
],
|
||||||
|
"pattern": "^https?:\\/\\/[^\\s/$.?#].[^\\s]*$"
|
||||||
|
},
|
||||||
|
"users": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string",
|
||||||
|
"pattern": "^[\\w.-]+$"
|
||||||
|
},
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"torvalds",
|
||||||
|
"DHH"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"description": "List of users to sync with. All repositories that the user owns will be synced, unless explicitly defined in the `exclude` property."
|
||||||
|
},
|
||||||
|
"orgs": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string",
|
||||||
|
"pattern": "^[\\w.-]+$"
|
||||||
|
},
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"my-org-name"
|
||||||
|
],
|
||||||
|
[
|
||||||
|
"sourcebot-dev",
|
||||||
|
"commaai"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"description": "List of organizations to sync with. All repositories in the organization visible to the provided `token` (if any) will be synced, unless explicitly defined in the `exclude` property."
|
||||||
|
},
|
||||||
|
"repos": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string",
|
||||||
|
"pattern": "^[\\w.-]+\\/[\\w.-]+$"
|
||||||
|
},
|
||||||
|
"description": "List of individual repositories to sync with. Expected to be formatted as '{orgName}/{repoName}' or '{userName}/{repoName}'."
|
||||||
|
},
|
||||||
|
"topics": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"minItems": 1,
|
||||||
|
"description": "List of repository topics to include when syncing. Only repositories that match at least one of the provided `topics` will be synced. If not specified, all repositories will be synced, unless explicitly defined in the `exclude` property. Glob patterns are supported.",
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"docs",
|
||||||
|
"core"
|
||||||
|
]
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"exclude": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"forks": {
|
||||||
|
"type": "boolean",
|
||||||
|
"default": false,
|
||||||
|
"description": "Exclude forked repositories from syncing."
|
||||||
|
},
|
||||||
|
"archived": {
|
||||||
|
"type": "boolean",
|
||||||
|
"default": false,
|
||||||
|
"description": "Exclude archived repositories from syncing."
|
||||||
|
},
|
||||||
|
"repos": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"default": [],
|
||||||
|
"description": "List of individual repositories to exclude from syncing. Glob patterns are supported."
|
||||||
|
},
|
||||||
|
"topics": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"description": "List of repository topics to exclude when syncing. Repositories that match one of the provided `topics` will be excluded from syncing. Glob patterns are supported.",
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"tests",
|
||||||
|
"ci"
|
||||||
|
]
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"size": {
|
||||||
|
"type": "object",
|
||||||
|
"description": "Exclude repositories based on their disk usage. Note: the disk usage is calculated by GitHub and may not reflect the actual disk usage when cloned.",
|
||||||
|
"properties": {
|
||||||
|
"min": {
|
||||||
|
"type": "integer",
|
||||||
|
"description": "Minimum repository size (in bytes) to sync (inclusive). Repositories less than this size will be excluded from syncing."
|
||||||
|
},
|
||||||
|
"max": {
|
||||||
|
"type": "integer",
|
||||||
|
"description": "Maximum repository size (in bytes) to sync (inclusive). Repositories greater than this size will be excluded from syncing."
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"revisions": {
|
||||||
|
"$ref": "#/definitions/GitRevisions"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"type"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"GitLabConfig": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"type": {
|
||||||
|
"const": "gitlab",
|
||||||
|
"description": "GitLab Configuration"
|
||||||
|
},
|
||||||
|
"token": {
|
||||||
|
"$ref": "#/definitions/Token",
|
||||||
|
"description": "An authentication token.",
|
||||||
|
"examples": [
|
||||||
|
"secret-token",
|
||||||
|
{
|
||||||
|
"env": "ENV_VAR_CONTAINING_TOKEN"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"url": {
|
||||||
|
"type": "string",
|
||||||
|
"format": "url",
|
||||||
|
"default": "https://gitlab.com",
|
||||||
|
"description": "The URL of the GitLab host. Defaults to https://gitlab.com",
|
||||||
|
"examples": [
|
||||||
|
"https://gitlab.com",
|
||||||
|
"https://gitlab.example.com"
|
||||||
|
],
|
||||||
|
"pattern": "^https?:\\/\\/[^\\s/$.?#].[^\\s]*$"
|
||||||
|
},
|
||||||
|
"all": {
|
||||||
|
"type": "boolean",
|
||||||
|
"default": false,
|
||||||
|
"description": "Sync all projects visible to the provided `token` (if any) in the GitLab instance. This option is ignored if `url` is either unset or set to https://gitlab.com ."
|
||||||
|
},
|
||||||
|
"users": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"description": "List of users to sync with. All projects owned by the user and visible to the provided `token` (if any) will be synced, unless explicitly defined in the `exclude` property."
|
||||||
|
},
|
||||||
|
"groups": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"my-group"
|
||||||
|
],
|
||||||
|
[
|
||||||
|
"my-group/sub-group-a",
|
||||||
|
"my-group/sub-group-b"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"description": "List of groups to sync with. All projects in the group (and recursive subgroups) visible to the provided `token` (if any) will be synced, unless explicitly defined in the `exclude` property. Subgroups can be specified by providing the path to the subgroup (e.g. `my-group/sub-group-a`)."
|
||||||
|
},
|
||||||
|
"projects": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"my-group/my-project"
|
||||||
|
],
|
||||||
|
[
|
||||||
|
"my-group/my-sub-group/my-project"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"description": "List of individual projects to sync with. The project's namespace must be specified. See: https://docs.gitlab.com/ee/user/namespace/"
|
||||||
|
},
|
||||||
|
"topics": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"minItems": 1,
|
||||||
|
"description": "List of project topics to include when syncing. Only projects that match at least one of the provided `topics` will be synced. If not specified, all projects will be synced, unless explicitly defined in the `exclude` property. Glob patterns are supported.",
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"docs",
|
||||||
|
"core"
|
||||||
|
]
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"exclude": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"forks": {
|
||||||
|
"type": "boolean",
|
||||||
|
"default": false,
|
||||||
|
"description": "Exclude forked projects from syncing."
|
||||||
|
},
|
||||||
|
"archived": {
|
||||||
|
"type": "boolean",
|
||||||
|
"default": false,
|
||||||
|
"description": "Exclude archived projects from syncing."
|
||||||
|
},
|
||||||
|
"projects": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"default": [],
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"my-group/my-project"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"description": "List of projects to exclude from syncing. Glob patterns are supported. The project's namespace must be specified, see: https://docs.gitlab.com/ee/user/namespace/"
|
||||||
|
},
|
||||||
|
"topics": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"description": "List of project topics to exclude when syncing. Projects that match one of the provided `topics` will be excluded from syncing. Glob patterns are supported.",
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"tests",
|
||||||
|
"ci"
|
||||||
|
]
|
||||||
|
]
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"revisions": {
|
||||||
|
"$ref": "#/definitions/GitRevisions"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"type"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"GiteaConfig": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"type": {
|
||||||
|
"const": "gitea",
|
||||||
|
"description": "Gitea Configuration"
|
||||||
|
},
|
||||||
|
"token": {
|
||||||
|
"$ref": "#/definitions/Token",
|
||||||
|
"description": "An access token.",
|
||||||
|
"examples": [
|
||||||
|
"secret-token",
|
||||||
|
{
|
||||||
|
"env": "ENV_VAR_CONTAINING_TOKEN"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"url": {
|
||||||
|
"type": "string",
|
||||||
|
"format": "url",
|
||||||
|
"default": "https://gitea.com",
|
||||||
|
"description": "The URL of the Gitea host. Defaults to https://gitea.com",
|
||||||
|
"examples": [
|
||||||
|
"https://gitea.com",
|
||||||
|
"https://gitea.example.com"
|
||||||
|
],
|
||||||
|
"pattern": "^https?:\\/\\/[^\\s/$.?#].[^\\s]*$"
|
||||||
|
},
|
||||||
|
"orgs": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"my-org-name"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"description": "List of organizations to sync with. All repositories in the organization visible to the provided `token` (if any) will be synced, unless explicitly defined in the `exclude` property. If a `token` is provided, it must have the read:organization scope."
|
||||||
|
},
|
||||||
|
"repos": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string",
|
||||||
|
"pattern": "^[\\w.-]+\\/[\\w.-]+$"
|
||||||
|
},
|
||||||
|
"description": "List of individual repositories to sync with. Expected to be formatted as '{orgName}/{repoName}' or '{userName}/{repoName}'."
|
||||||
|
},
|
||||||
|
"users": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"username-1",
|
||||||
|
"username-2"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"description": "List of users to sync with. All repositories that the user owns will be synced, unless explicitly defined in the `exclude` property. If a `token` is provided, it must have the read:user scope."
|
||||||
|
},
|
||||||
|
"exclude": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"forks": {
|
||||||
|
"type": "boolean",
|
||||||
|
"default": false,
|
||||||
|
"description": "Exclude forked repositories from syncing."
|
||||||
|
},
|
||||||
|
"archived": {
|
||||||
|
"type": "boolean",
|
||||||
|
"default": false,
|
||||||
|
"description": "Exclude archived repositories from syncing."
|
||||||
|
},
|
||||||
|
"repos": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"default": [],
|
||||||
|
"description": "List of individual repositories to exclude from syncing. Glob patterns are supported."
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"revisions": {
|
||||||
|
"$ref": "#/definitions/GitRevisions"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"type"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"GerritConfig": {
|
||||||
|
"type": "object",
|
||||||
|
"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
|
||||||
|
},
|
||||||
|
"LocalConfig": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"type": {
|
||||||
|
"const": "local",
|
||||||
|
"description": "Local Configuration"
|
||||||
|
},
|
||||||
|
"path": {
|
||||||
|
"type": "string",
|
||||||
|
"description": "Path to the local directory to sync with. Relative paths are relative to the configuration file's directory.",
|
||||||
|
"pattern": ".+"
|
||||||
|
},
|
||||||
|
"watch": {
|
||||||
|
"type": "boolean",
|
||||||
|
"default": true,
|
||||||
|
"description": "Enables a file watcher that will automatically re-sync when changes are made within `path` (recursively). Defaults to true."
|
||||||
|
},
|
||||||
|
"exclude": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"paths": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string",
|
||||||
|
"pattern": ".+"
|
||||||
|
},
|
||||||
|
"description": "List of paths relative to the provided `path` to exclude from the index. .git, .hg, and .svn are always exluded.",
|
||||||
|
"default": [],
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"node_modules",
|
||||||
|
"bin",
|
||||||
|
"dist",
|
||||||
|
"build",
|
||||||
|
"out"
|
||||||
|
]
|
||||||
|
]
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"type",
|
||||||
|
"path"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"GitConfig": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"type": {
|
||||||
|
"const": "git",
|
||||||
|
"description": "Git Configuration"
|
||||||
|
},
|
||||||
|
"url": {
|
||||||
|
"type": "string",
|
||||||
|
"format": "url",
|
||||||
|
"description": "The URL to the git repository."
|
||||||
|
},
|
||||||
|
"revisions": {
|
||||||
|
"$ref": "#/definitions/GitRevisions"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"type",
|
||||||
|
"url"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"Repos": {
|
||||||
|
"anyOf": [
|
||||||
|
{
|
||||||
|
"$ref": "#/definitions/GitHubConfig"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"$ref": "#/definitions/GitLabConfig"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"$ref": "#/definitions/GiteaConfig"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"$ref": "#/definitions/GerritConfig"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"$ref": "#/definitions/LocalConfig"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"$ref": "#/definitions/GitConfig"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"Settings": {
|
||||||
|
"type": "object",
|
||||||
|
"description": "Global settings. These settings are applied to all repositories.",
|
||||||
|
"properties": {
|
||||||
|
"maxFileSize": {
|
||||||
|
"type": "integer",
|
||||||
|
"description": "The maximum size of a file (in bytes) to be indexed. Files that exceed this maximum will not be inexed. Defaults to 2MB (2097152 bytes).",
|
||||||
|
"default": 2097152,
|
||||||
|
"minimum": 1
|
||||||
|
},
|
||||||
|
"maxTrigramCount": {
|
||||||
|
"type": "integer",
|
||||||
|
"description": "The maximum amount of trigrams per document. Documents that exceed this maximum will not be indexed. Defaults to 20000",
|
||||||
|
"default": 20000,
|
||||||
|
"minimum": 1
|
||||||
|
},
|
||||||
|
"autoDeleteStaleRepos": {
|
||||||
|
"type": "boolean",
|
||||||
|
"description": "Automatically delete stale repositories from the index. Defaults to true.",
|
||||||
|
"default": true
|
||||||
|
},
|
||||||
|
"reindexInterval": {
|
||||||
|
"type": "integer",
|
||||||
|
"description": "The interval (in milliseconds) at which the indexer should re-index all repositories. Repositories are always indexed when first added. Defaults to 1 hour (3600000 milliseconds).",
|
||||||
|
"default": 3600000,
|
||||||
|
"minimum": 1
|
||||||
|
},
|
||||||
|
"resyncInterval": {
|
||||||
|
"type": "integer",
|
||||||
|
"description": "The interval (in milliseconds) at which the configuration file should be re-synced. The configuration file is always synced on startup. Defaults to 24 hours (86400000 milliseconds).",
|
||||||
|
"default": 86400000,
|
||||||
|
"minimum": 1
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"properties": {
|
||||||
|
"$schema": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"settings": {
|
||||||
|
"$ref": "#/definitions/Settings"
|
||||||
|
},
|
||||||
|
"repos": {
|
||||||
|
"type": "array",
|
||||||
|
"description": "Defines a collection of repositories from varying code hosts that Sourcebot should sync with.",
|
||||||
|
"items": {
|
||||||
|
"$ref": "#/definitions/Repos"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
```
|
||||||
180
docs/snippets/schemas/v3/bitbucket.schema.mdx
Normal file
180
docs/snippets/schemas/v3/bitbucket.schema.mdx
Normal file
|
|
@ -0,0 +1,180 @@
|
||||||
|
{/* THIS IS A AUTO-GENERATED FILE. DO NOT MODIFY MANUALLY! */}
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
||||||
|
"type": "object",
|
||||||
|
"title": "BitbucketConnectionConfig",
|
||||||
|
"properties": {
|
||||||
|
"type": {
|
||||||
|
"const": "bitbucket",
|
||||||
|
"description": "Bitbucket configuration"
|
||||||
|
},
|
||||||
|
"user": {
|
||||||
|
"type": "string",
|
||||||
|
"description": "The username to use for authentication. Only needed if token is an app password."
|
||||||
|
},
|
||||||
|
"token": {
|
||||||
|
"description": "An authentication token.",
|
||||||
|
"examples": [
|
||||||
|
{
|
||||||
|
"secret": "SECRET_KEY"
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"anyOf": [
|
||||||
|
{
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"secret": {
|
||||||
|
"type": "string",
|
||||||
|
"description": "The name of the secret that contains the token."
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"secret"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"env": {
|
||||||
|
"type": "string",
|
||||||
|
"description": "The name of the environment variable that contains the token. Only supported in declarative connection configs."
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"env"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"url": {
|
||||||
|
"type": "string",
|
||||||
|
"format": "url",
|
||||||
|
"default": "https://api.bitbucket.org/2.0",
|
||||||
|
"description": "Bitbucket URL",
|
||||||
|
"examples": [
|
||||||
|
"https://bitbucket.example.com"
|
||||||
|
],
|
||||||
|
"pattern": "^https?:\\/\\/[^\\s/$.?#].[^\\s]*$"
|
||||||
|
},
|
||||||
|
"deploymentType": {
|
||||||
|
"type": "string",
|
||||||
|
"enum": [
|
||||||
|
"cloud",
|
||||||
|
"server"
|
||||||
|
],
|
||||||
|
"default": "cloud",
|
||||||
|
"description": "The type of Bitbucket deployment"
|
||||||
|
},
|
||||||
|
"workspaces": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"description": "List of workspaces to sync. Ignored if deploymentType is server."
|
||||||
|
},
|
||||||
|
"projects": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"description": "List of projects to sync"
|
||||||
|
},
|
||||||
|
"repos": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"description": "List of repos to sync"
|
||||||
|
},
|
||||||
|
"exclude": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"archived": {
|
||||||
|
"type": "boolean",
|
||||||
|
"default": false,
|
||||||
|
"description": "Exclude archived repositories from syncing."
|
||||||
|
},
|
||||||
|
"forks": {
|
||||||
|
"type": "boolean",
|
||||||
|
"default": false,
|
||||||
|
"description": "Exclude forked repositories from syncing."
|
||||||
|
},
|
||||||
|
"repos": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"cloud_workspace/repo1",
|
||||||
|
"server_project/repo2"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"description": "List of specific repos to exclude from syncing."
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"revisions": {
|
||||||
|
"type": "object",
|
||||||
|
"description": "The revisions (branches, tags) that should be included when indexing. The default branch (HEAD) is always indexed. A maximum of 64 revisions can be indexed, with any additional revisions being ignored.",
|
||||||
|
"properties": {
|
||||||
|
"branches": {
|
||||||
|
"type": "array",
|
||||||
|
"description": "List of branches to include when indexing. For a given repo, only the branches that exist on the repo's remote *and* match at least one of the provided `branches` will be indexed. The default branch (HEAD) is always indexed. Glob patterns are supported. A maximum of 64 branches can be indexed, with any additional branches being ignored.",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"main",
|
||||||
|
"release/*"
|
||||||
|
],
|
||||||
|
[
|
||||||
|
"**"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"default": []
|
||||||
|
},
|
||||||
|
"tags": {
|
||||||
|
"type": "array",
|
||||||
|
"description": "List of tags to include when indexing. For a given repo, only the tags that exist on the repo's remote *and* match at least one of the provided `tags` will be indexed. Glob patterns are supported. A maximum of 64 tags can be indexed, with any additional tags being ignored.",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"latest",
|
||||||
|
"v2.*.*"
|
||||||
|
],
|
||||||
|
[
|
||||||
|
"**"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"default": []
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"type"
|
||||||
|
],
|
||||||
|
"if": {
|
||||||
|
"properties": {
|
||||||
|
"deploymentType": {
|
||||||
|
"const": "server"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"then": {
|
||||||
|
"required": [
|
||||||
|
"url"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
```
|
||||||
633
docs/snippets/schemas/v3/connection.schema.mdx
Normal file
633
docs/snippets/schemas/v3/connection.schema.mdx
Normal file
|
|
@ -0,0 +1,633 @@
|
||||||
|
{/* THIS IS A AUTO-GENERATED FILE. DO NOT MODIFY MANUALLY! */}
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
||||||
|
"title": "ConnectionConfig",
|
||||||
|
"oneOf": [
|
||||||
|
{
|
||||||
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
||||||
|
"type": "object",
|
||||||
|
"title": "GithubConnectionConfig",
|
||||||
|
"properties": {
|
||||||
|
"type": {
|
||||||
|
"const": "github",
|
||||||
|
"description": "GitHub Configuration"
|
||||||
|
},
|
||||||
|
"token": {
|
||||||
|
"description": "A Personal Access Token (PAT).",
|
||||||
|
"examples": [
|
||||||
|
{
|
||||||
|
"secret": "SECRET_KEY"
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"anyOf": [
|
||||||
|
{
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"secret": {
|
||||||
|
"type": "string",
|
||||||
|
"description": "The name of the secret that contains the token."
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"secret"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"env": {
|
||||||
|
"type": "string",
|
||||||
|
"description": "The name of the environment variable that contains the token. Only supported in declarative connection configs."
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"env"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"url": {
|
||||||
|
"type": "string",
|
||||||
|
"format": "url",
|
||||||
|
"default": "https://github.com",
|
||||||
|
"description": "The URL of the GitHub host. Defaults to https://github.com",
|
||||||
|
"examples": [
|
||||||
|
"https://github.com",
|
||||||
|
"https://github.example.com"
|
||||||
|
],
|
||||||
|
"pattern": "^https?:\\/\\/[^\\s/$.?#].[^\\s]*$"
|
||||||
|
},
|
||||||
|
"users": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string",
|
||||||
|
"pattern": "^[\\w.-]+$"
|
||||||
|
},
|
||||||
|
"default": [],
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"torvalds",
|
||||||
|
"DHH"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"description": "List of users to sync with. All repositories that the user owns will be synced, unless explicitly defined in the `exclude` property."
|
||||||
|
},
|
||||||
|
"orgs": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string",
|
||||||
|
"pattern": "^[\\w.-]+$"
|
||||||
|
},
|
||||||
|
"default": [],
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"my-org-name"
|
||||||
|
],
|
||||||
|
[
|
||||||
|
"sourcebot-dev",
|
||||||
|
"commaai"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"description": "List of organizations to sync with. All repositories in the organization visible to the provided `token` (if any) will be synced, unless explicitly defined in the `exclude` property."
|
||||||
|
},
|
||||||
|
"repos": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string",
|
||||||
|
"pattern": "^[\\w.-]+\\/[\\w.-]+$"
|
||||||
|
},
|
||||||
|
"default": [],
|
||||||
|
"description": "List of individual repositories to sync with. Expected to be formatted as '{orgName}/{repoName}' or '{userName}/{repoName}'."
|
||||||
|
},
|
||||||
|
"topics": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"minItems": 1,
|
||||||
|
"default": [],
|
||||||
|
"description": "List of repository topics to include when syncing. Only repositories that match at least one of the provided `topics` will be synced. If not specified, all repositories will be synced, unless explicitly defined in the `exclude` property. Glob patterns are supported.",
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"docs",
|
||||||
|
"core"
|
||||||
|
]
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"exclude": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"forks": {
|
||||||
|
"type": "boolean",
|
||||||
|
"default": false,
|
||||||
|
"description": "Exclude forked repositories from syncing."
|
||||||
|
},
|
||||||
|
"archived": {
|
||||||
|
"type": "boolean",
|
||||||
|
"default": false,
|
||||||
|
"description": "Exclude archived repositories from syncing."
|
||||||
|
},
|
||||||
|
"repos": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"default": [],
|
||||||
|
"description": "List of individual repositories to exclude from syncing. Glob patterns are supported."
|
||||||
|
},
|
||||||
|
"topics": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"default": [],
|
||||||
|
"description": "List of repository topics to exclude when syncing. Repositories that match one of the provided `topics` will be excluded from syncing. Glob patterns are supported.",
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"tests",
|
||||||
|
"ci"
|
||||||
|
]
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"size": {
|
||||||
|
"type": "object",
|
||||||
|
"description": "Exclude repositories based on their disk usage. Note: the disk usage is calculated by GitHub and may not reflect the actual disk usage when cloned.",
|
||||||
|
"properties": {
|
||||||
|
"min": {
|
||||||
|
"type": "integer",
|
||||||
|
"description": "Minimum repository size (in bytes) to sync (inclusive). Repositories less than this size will be excluded from syncing."
|
||||||
|
},
|
||||||
|
"max": {
|
||||||
|
"type": "integer",
|
||||||
|
"description": "Maximum repository size (in bytes) to sync (inclusive). Repositories greater than this size will be excluded from syncing."
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"revisions": {
|
||||||
|
"type": "object",
|
||||||
|
"description": "The revisions (branches, tags) that should be included when indexing. The default branch (HEAD) is always indexed. A maximum of 64 revisions can be indexed, with any additional revisions being ignored.",
|
||||||
|
"properties": {
|
||||||
|
"branches": {
|
||||||
|
"type": "array",
|
||||||
|
"description": "List of branches to include when indexing. For a given repo, only the branches that exist on the repo's remote *and* match at least one of the provided `branches` will be indexed. The default branch (HEAD) is always indexed. Glob patterns are supported. A maximum of 64 branches can be indexed, with any additional branches being ignored.",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"main",
|
||||||
|
"release/*"
|
||||||
|
],
|
||||||
|
[
|
||||||
|
"**"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"default": []
|
||||||
|
},
|
||||||
|
"tags": {
|
||||||
|
"type": "array",
|
||||||
|
"description": "List of tags to include when indexing. For a given repo, only the tags that exist on the repo's remote *and* match at least one of the provided `tags` will be indexed. Glob patterns are supported. A maximum of 64 tags can be indexed, with any additional tags being ignored.",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"latest",
|
||||||
|
"v2.*.*"
|
||||||
|
],
|
||||||
|
[
|
||||||
|
"**"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"default": []
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"type"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
||||||
|
"type": "object",
|
||||||
|
"title": "GitlabConnectionConfig",
|
||||||
|
"properties": {
|
||||||
|
"type": {
|
||||||
|
"const": "gitlab",
|
||||||
|
"description": "GitLab Configuration"
|
||||||
|
},
|
||||||
|
"token": {
|
||||||
|
"$ref": "#/oneOf/0/properties/token",
|
||||||
|
"description": "An authentication token.",
|
||||||
|
"examples": [
|
||||||
|
{
|
||||||
|
"secret": "SECRET_KEY"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"url": {
|
||||||
|
"type": "string",
|
||||||
|
"format": "url",
|
||||||
|
"default": "https://gitlab.com",
|
||||||
|
"description": "The URL of the GitLab host. Defaults to https://gitlab.com",
|
||||||
|
"examples": [
|
||||||
|
"https://gitlab.com",
|
||||||
|
"https://gitlab.example.com"
|
||||||
|
],
|
||||||
|
"pattern": "^https?:\\/\\/[^\\s/$.?#].[^\\s]*$"
|
||||||
|
},
|
||||||
|
"all": {
|
||||||
|
"type": "boolean",
|
||||||
|
"default": false,
|
||||||
|
"description": "Sync all projects visible to the provided `token` (if any) in the GitLab instance. This option is ignored if `url` is either unset or set to https://gitlab.com ."
|
||||||
|
},
|
||||||
|
"users": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"description": "List of users to sync with. All projects owned by the user and visible to the provided `token` (if any) will be synced, unless explicitly defined in the `exclude` property."
|
||||||
|
},
|
||||||
|
"groups": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"my-group"
|
||||||
|
],
|
||||||
|
[
|
||||||
|
"my-group/sub-group-a",
|
||||||
|
"my-group/sub-group-b"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"description": "List of groups to sync with. All projects in the group (and recursive subgroups) visible to the provided `token` (if any) will be synced, unless explicitly defined in the `exclude` property. Subgroups can be specified by providing the path to the subgroup (e.g. `my-group/sub-group-a`)."
|
||||||
|
},
|
||||||
|
"projects": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"my-group/my-project"
|
||||||
|
],
|
||||||
|
[
|
||||||
|
"my-group/my-sub-group/my-project"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"description": "List of individual projects to sync with. The project's namespace must be specified. See: https://docs.gitlab.com/ee/user/namespace/"
|
||||||
|
},
|
||||||
|
"topics": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"minItems": 1,
|
||||||
|
"description": "List of project topics to include when syncing. Only projects that match at least one of the provided `topics` will be synced. If not specified, all projects will be synced, unless explicitly defined in the `exclude` property. Glob patterns are supported.",
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"docs",
|
||||||
|
"core"
|
||||||
|
]
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"exclude": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"forks": {
|
||||||
|
"type": "boolean",
|
||||||
|
"default": false,
|
||||||
|
"description": "Exclude forked projects from syncing."
|
||||||
|
},
|
||||||
|
"archived": {
|
||||||
|
"type": "boolean",
|
||||||
|
"default": false,
|
||||||
|
"description": "Exclude archived projects from syncing."
|
||||||
|
},
|
||||||
|
"projects": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"default": [],
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"my-group/my-project"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"description": "List of projects to exclude from syncing. Glob patterns are supported. The project's namespace must be specified, see: https://docs.gitlab.com/ee/user/namespace/"
|
||||||
|
},
|
||||||
|
"topics": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"description": "List of project topics to exclude when syncing. Projects that match one of the provided `topics` will be excluded from syncing. Glob patterns are supported.",
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"tests",
|
||||||
|
"ci"
|
||||||
|
]
|
||||||
|
]
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"revisions": {
|
||||||
|
"$ref": "#/oneOf/0/properties/revisions"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"type"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
||||||
|
"type": "object",
|
||||||
|
"title": "GiteaConnectionConfig",
|
||||||
|
"properties": {
|
||||||
|
"type": {
|
||||||
|
"const": "gitea",
|
||||||
|
"description": "Gitea Configuration"
|
||||||
|
},
|
||||||
|
"token": {
|
||||||
|
"$ref": "#/oneOf/0/properties/token",
|
||||||
|
"description": "A Personal Access Token (PAT).",
|
||||||
|
"examples": [
|
||||||
|
{
|
||||||
|
"secret": "SECRET_KEY"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"url": {
|
||||||
|
"type": "string",
|
||||||
|
"format": "url",
|
||||||
|
"default": "https://gitea.com",
|
||||||
|
"description": "The URL of the Gitea host. Defaults to https://gitea.com",
|
||||||
|
"examples": [
|
||||||
|
"https://gitea.com",
|
||||||
|
"https://gitea.example.com"
|
||||||
|
],
|
||||||
|
"pattern": "^https?:\\/\\/[^\\s/$.?#].[^\\s]*$"
|
||||||
|
},
|
||||||
|
"orgs": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"my-org-name"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"description": "List of organizations to sync with. All repositories in the organization visible to the provided `token` (if any) will be synced, unless explicitly defined in the `exclude` property. If a `token` is provided, it must have the read:organization scope."
|
||||||
|
},
|
||||||
|
"repos": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string",
|
||||||
|
"pattern": "^[\\w.-]+\\/[\\w.-]+$"
|
||||||
|
},
|
||||||
|
"description": "List of individual repositories to sync with. Expected to be formatted as '{orgName}/{repoName}' or '{userName}/{repoName}'."
|
||||||
|
},
|
||||||
|
"users": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"username-1",
|
||||||
|
"username-2"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"description": "List of users to sync with. All repositories that the user owns will be synced, unless explicitly defined in the `exclude` property. If a `token` is provided, it must have the read:user scope."
|
||||||
|
},
|
||||||
|
"exclude": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"forks": {
|
||||||
|
"type": "boolean",
|
||||||
|
"default": false,
|
||||||
|
"description": "Exclude forked repositories from syncing."
|
||||||
|
},
|
||||||
|
"archived": {
|
||||||
|
"type": "boolean",
|
||||||
|
"default": false,
|
||||||
|
"description": "Exclude archived repositories from syncing."
|
||||||
|
},
|
||||||
|
"repos": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"default": [],
|
||||||
|
"description": "List of individual repositories to exclude from syncing. Glob patterns are supported."
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"revisions": {
|
||||||
|
"$ref": "#/oneOf/0/properties/revisions"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"type"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"$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."
|
||||||
|
},
|
||||||
|
"readOnly": {
|
||||||
|
"type": "boolean",
|
||||||
|
"default": false,
|
||||||
|
"description": "Exclude read-only projects from syncing."
|
||||||
|
},
|
||||||
|
"hidden": {
|
||||||
|
"type": "boolean",
|
||||||
|
"default": false,
|
||||||
|
"description": "Exclude hidden projects from syncing."
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"type",
|
||||||
|
"url"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
||||||
|
"type": "object",
|
||||||
|
"title": "BitbucketConnectionConfig",
|
||||||
|
"properties": {
|
||||||
|
"type": {
|
||||||
|
"const": "bitbucket",
|
||||||
|
"description": "Bitbucket configuration"
|
||||||
|
},
|
||||||
|
"user": {
|
||||||
|
"type": "string",
|
||||||
|
"description": "The username to use for authentication. Only needed if token is an app password."
|
||||||
|
},
|
||||||
|
"token": {
|
||||||
|
"$ref": "#/oneOf/0/properties/token",
|
||||||
|
"description": "An authentication token.",
|
||||||
|
"examples": [
|
||||||
|
{
|
||||||
|
"secret": "SECRET_KEY"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"url": {
|
||||||
|
"type": "string",
|
||||||
|
"format": "url",
|
||||||
|
"default": "https://api.bitbucket.org/2.0",
|
||||||
|
"description": "Bitbucket URL",
|
||||||
|
"examples": [
|
||||||
|
"https://bitbucket.example.com"
|
||||||
|
],
|
||||||
|
"pattern": "^https?:\\/\\/[^\\s/$.?#].[^\\s]*$"
|
||||||
|
},
|
||||||
|
"deploymentType": {
|
||||||
|
"type": "string",
|
||||||
|
"enum": [
|
||||||
|
"cloud",
|
||||||
|
"server"
|
||||||
|
],
|
||||||
|
"default": "cloud",
|
||||||
|
"description": "The type of Bitbucket deployment"
|
||||||
|
},
|
||||||
|
"workspaces": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"description": "List of workspaces to sync. Ignored if deploymentType is server."
|
||||||
|
},
|
||||||
|
"projects": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"description": "List of projects to sync"
|
||||||
|
},
|
||||||
|
"repos": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"description": "List of repos to sync"
|
||||||
|
},
|
||||||
|
"exclude": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"archived": {
|
||||||
|
"type": "boolean",
|
||||||
|
"default": false,
|
||||||
|
"description": "Exclude archived repositories from syncing."
|
||||||
|
},
|
||||||
|
"forks": {
|
||||||
|
"type": "boolean",
|
||||||
|
"default": false,
|
||||||
|
"description": "Exclude forked repositories from syncing."
|
||||||
|
},
|
||||||
|
"repos": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"cloud_workspace/repo1",
|
||||||
|
"server_project/repo2"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"description": "List of specific repos to exclude from syncing."
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"revisions": {
|
||||||
|
"$ref": "#/oneOf/0/properties/revisions"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"type"
|
||||||
|
],
|
||||||
|
"if": {
|
||||||
|
"properties": {
|
||||||
|
"deploymentType": {
|
||||||
|
"const": "server"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"then": {
|
||||||
|
"required": [
|
||||||
|
"url"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
```
|
||||||
70
docs/snippets/schemas/v3/gerrit.schema.mdx
Normal file
70
docs/snippets/schemas/v3/gerrit.schema.mdx
Normal file
|
|
@ -0,0 +1,70 @@
|
||||||
|
{/* THIS IS A AUTO-GENERATED FILE. DO NOT MODIFY MANUALLY! */}
|
||||||
|
```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."
|
||||||
|
},
|
||||||
|
"readOnly": {
|
||||||
|
"type": "boolean",
|
||||||
|
"default": false,
|
||||||
|
"description": "Exclude read-only projects from syncing."
|
||||||
|
},
|
||||||
|
"hidden": {
|
||||||
|
"type": "boolean",
|
||||||
|
"default": false,
|
||||||
|
"description": "Exclude hidden projects from syncing."
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"type",
|
||||||
|
"url"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
```
|
||||||
163
docs/snippets/schemas/v3/gitea.schema.mdx
Normal file
163
docs/snippets/schemas/v3/gitea.schema.mdx
Normal file
|
|
@ -0,0 +1,163 @@
|
||||||
|
{/* THIS IS A AUTO-GENERATED FILE. DO NOT MODIFY MANUALLY! */}
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
||||||
|
"type": "object",
|
||||||
|
"title": "GiteaConnectionConfig",
|
||||||
|
"properties": {
|
||||||
|
"type": {
|
||||||
|
"const": "gitea",
|
||||||
|
"description": "Gitea Configuration"
|
||||||
|
},
|
||||||
|
"token": {
|
||||||
|
"description": "A Personal Access Token (PAT).",
|
||||||
|
"examples": [
|
||||||
|
{
|
||||||
|
"secret": "SECRET_KEY"
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"anyOf": [
|
||||||
|
{
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"secret": {
|
||||||
|
"type": "string",
|
||||||
|
"description": "The name of the secret that contains the token."
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"secret"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"env": {
|
||||||
|
"type": "string",
|
||||||
|
"description": "The name of the environment variable that contains the token. Only supported in declarative connection configs."
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"env"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"url": {
|
||||||
|
"type": "string",
|
||||||
|
"format": "url",
|
||||||
|
"default": "https://gitea.com",
|
||||||
|
"description": "The URL of the Gitea host. Defaults to https://gitea.com",
|
||||||
|
"examples": [
|
||||||
|
"https://gitea.com",
|
||||||
|
"https://gitea.example.com"
|
||||||
|
],
|
||||||
|
"pattern": "^https?:\\/\\/[^\\s/$.?#].[^\\s]*$"
|
||||||
|
},
|
||||||
|
"orgs": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"my-org-name"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"description": "List of organizations to sync with. All repositories in the organization visible to the provided `token` (if any) will be synced, unless explicitly defined in the `exclude` property. If a `token` is provided, it must have the read:organization scope."
|
||||||
|
},
|
||||||
|
"repos": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string",
|
||||||
|
"pattern": "^[\\w.-]+\\/[\\w.-]+$"
|
||||||
|
},
|
||||||
|
"description": "List of individual repositories to sync with. Expected to be formatted as '{orgName}/{repoName}' or '{userName}/{repoName}'."
|
||||||
|
},
|
||||||
|
"users": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"username-1",
|
||||||
|
"username-2"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"description": "List of users to sync with. All repositories that the user owns will be synced, unless explicitly defined in the `exclude` property. If a `token` is provided, it must have the read:user scope."
|
||||||
|
},
|
||||||
|
"exclude": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"forks": {
|
||||||
|
"type": "boolean",
|
||||||
|
"default": false,
|
||||||
|
"description": "Exclude forked repositories from syncing."
|
||||||
|
},
|
||||||
|
"archived": {
|
||||||
|
"type": "boolean",
|
||||||
|
"default": false,
|
||||||
|
"description": "Exclude archived repositories from syncing."
|
||||||
|
},
|
||||||
|
"repos": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"default": [],
|
||||||
|
"description": "List of individual repositories to exclude from syncing. Glob patterns are supported."
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"revisions": {
|
||||||
|
"type": "object",
|
||||||
|
"description": "The revisions (branches, tags) that should be included when indexing. The default branch (HEAD) is always indexed. A maximum of 64 revisions can be indexed, with any additional revisions being ignored.",
|
||||||
|
"properties": {
|
||||||
|
"branches": {
|
||||||
|
"type": "array",
|
||||||
|
"description": "List of branches to include when indexing. For a given repo, only the branches that exist on the repo's remote *and* match at least one of the provided `branches` will be indexed. The default branch (HEAD) is always indexed. Glob patterns are supported. A maximum of 64 branches can be indexed, with any additional branches being ignored.",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"main",
|
||||||
|
"release/*"
|
||||||
|
],
|
||||||
|
[
|
||||||
|
"**"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"default": []
|
||||||
|
},
|
||||||
|
"tags": {
|
||||||
|
"type": "array",
|
||||||
|
"description": "List of tags to include when indexing. For a given repo, only the tags that exist on the repo's remote *and* match at least one of the provided `tags` will be indexed. Glob patterns are supported. A maximum of 64 tags can be indexed, with any additional tags being ignored.",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"latest",
|
||||||
|
"v2.*.*"
|
||||||
|
],
|
||||||
|
[
|
||||||
|
"**"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"default": []
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"type"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
```
|
||||||
216
docs/snippets/schemas/v3/github.schema.mdx
Normal file
216
docs/snippets/schemas/v3/github.schema.mdx
Normal file
|
|
@ -0,0 +1,216 @@
|
||||||
|
{/* THIS IS A AUTO-GENERATED FILE. DO NOT MODIFY MANUALLY! */}
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
||||||
|
"type": "object",
|
||||||
|
"title": "GithubConnectionConfig",
|
||||||
|
"properties": {
|
||||||
|
"type": {
|
||||||
|
"const": "github",
|
||||||
|
"description": "GitHub Configuration"
|
||||||
|
},
|
||||||
|
"token": {
|
||||||
|
"description": "A Personal Access Token (PAT).",
|
||||||
|
"examples": [
|
||||||
|
{
|
||||||
|
"secret": "SECRET_KEY"
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"anyOf": [
|
||||||
|
{
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"secret": {
|
||||||
|
"type": "string",
|
||||||
|
"description": "The name of the secret that contains the token."
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"secret"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"env": {
|
||||||
|
"type": "string",
|
||||||
|
"description": "The name of the environment variable that contains the token. Only supported in declarative connection configs."
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"env"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"url": {
|
||||||
|
"type": "string",
|
||||||
|
"format": "url",
|
||||||
|
"default": "https://github.com",
|
||||||
|
"description": "The URL of the GitHub host. Defaults to https://github.com",
|
||||||
|
"examples": [
|
||||||
|
"https://github.com",
|
||||||
|
"https://github.example.com"
|
||||||
|
],
|
||||||
|
"pattern": "^https?:\\/\\/[^\\s/$.?#].[^\\s]*$"
|
||||||
|
},
|
||||||
|
"users": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string",
|
||||||
|
"pattern": "^[\\w.-]+$"
|
||||||
|
},
|
||||||
|
"default": [],
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"torvalds",
|
||||||
|
"DHH"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"description": "List of users to sync with. All repositories that the user owns will be synced, unless explicitly defined in the `exclude` property."
|
||||||
|
},
|
||||||
|
"orgs": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string",
|
||||||
|
"pattern": "^[\\w.-]+$"
|
||||||
|
},
|
||||||
|
"default": [],
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"my-org-name"
|
||||||
|
],
|
||||||
|
[
|
||||||
|
"sourcebot-dev",
|
||||||
|
"commaai"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"description": "List of organizations to sync with. All repositories in the organization visible to the provided `token` (if any) will be synced, unless explicitly defined in the `exclude` property."
|
||||||
|
},
|
||||||
|
"repos": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string",
|
||||||
|
"pattern": "^[\\w.-]+\\/[\\w.-]+$"
|
||||||
|
},
|
||||||
|
"default": [],
|
||||||
|
"description": "List of individual repositories to sync with. Expected to be formatted as '{orgName}/{repoName}' or '{userName}/{repoName}'."
|
||||||
|
},
|
||||||
|
"topics": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"minItems": 1,
|
||||||
|
"default": [],
|
||||||
|
"description": "List of repository topics to include when syncing. Only repositories that match at least one of the provided `topics` will be synced. If not specified, all repositories will be synced, unless explicitly defined in the `exclude` property. Glob patterns are supported.",
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"docs",
|
||||||
|
"core"
|
||||||
|
]
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"exclude": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"forks": {
|
||||||
|
"type": "boolean",
|
||||||
|
"default": false,
|
||||||
|
"description": "Exclude forked repositories from syncing."
|
||||||
|
},
|
||||||
|
"archived": {
|
||||||
|
"type": "boolean",
|
||||||
|
"default": false,
|
||||||
|
"description": "Exclude archived repositories from syncing."
|
||||||
|
},
|
||||||
|
"repos": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"default": [],
|
||||||
|
"description": "List of individual repositories to exclude from syncing. Glob patterns are supported."
|
||||||
|
},
|
||||||
|
"topics": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"default": [],
|
||||||
|
"description": "List of repository topics to exclude when syncing. Repositories that match one of the provided `topics` will be excluded from syncing. Glob patterns are supported.",
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"tests",
|
||||||
|
"ci"
|
||||||
|
]
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"size": {
|
||||||
|
"type": "object",
|
||||||
|
"description": "Exclude repositories based on their disk usage. Note: the disk usage is calculated by GitHub and may not reflect the actual disk usage when cloned.",
|
||||||
|
"properties": {
|
||||||
|
"min": {
|
||||||
|
"type": "integer",
|
||||||
|
"description": "Minimum repository size (in bytes) to sync (inclusive). Repositories less than this size will be excluded from syncing."
|
||||||
|
},
|
||||||
|
"max": {
|
||||||
|
"type": "integer",
|
||||||
|
"description": "Maximum repository size (in bytes) to sync (inclusive). Repositories greater than this size will be excluded from syncing."
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"revisions": {
|
||||||
|
"type": "object",
|
||||||
|
"description": "The revisions (branches, tags) that should be included when indexing. The default branch (HEAD) is always indexed. A maximum of 64 revisions can be indexed, with any additional revisions being ignored.",
|
||||||
|
"properties": {
|
||||||
|
"branches": {
|
||||||
|
"type": "array",
|
||||||
|
"description": "List of branches to include when indexing. For a given repo, only the branches that exist on the repo's remote *and* match at least one of the provided `branches` will be indexed. The default branch (HEAD) is always indexed. Glob patterns are supported. A maximum of 64 branches can be indexed, with any additional branches being ignored.",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"main",
|
||||||
|
"release/*"
|
||||||
|
],
|
||||||
|
[
|
||||||
|
"**"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"default": []
|
||||||
|
},
|
||||||
|
"tags": {
|
||||||
|
"type": "array",
|
||||||
|
"description": "List of tags to include when indexing. For a given repo, only the tags that exist on the repo's remote *and* match at least one of the provided `tags` will be indexed. Glob patterns are supported. A maximum of 64 tags can be indexed, with any additional tags being ignored.",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"latest",
|
||||||
|
"v2.*.*"
|
||||||
|
],
|
||||||
|
[
|
||||||
|
"**"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"default": []
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"type"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
```
|
||||||
205
docs/snippets/schemas/v3/gitlab.schema.mdx
Normal file
205
docs/snippets/schemas/v3/gitlab.schema.mdx
Normal file
|
|
@ -0,0 +1,205 @@
|
||||||
|
{/* THIS IS A AUTO-GENERATED FILE. DO NOT MODIFY MANUALLY! */}
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
||||||
|
"type": "object",
|
||||||
|
"title": "GitlabConnectionConfig",
|
||||||
|
"properties": {
|
||||||
|
"type": {
|
||||||
|
"const": "gitlab",
|
||||||
|
"description": "GitLab Configuration"
|
||||||
|
},
|
||||||
|
"token": {
|
||||||
|
"description": "An authentication token.",
|
||||||
|
"examples": [
|
||||||
|
{
|
||||||
|
"secret": "SECRET_KEY"
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"anyOf": [
|
||||||
|
{
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"secret": {
|
||||||
|
"type": "string",
|
||||||
|
"description": "The name of the secret that contains the token."
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"secret"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"env": {
|
||||||
|
"type": "string",
|
||||||
|
"description": "The name of the environment variable that contains the token. Only supported in declarative connection configs."
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"env"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"url": {
|
||||||
|
"type": "string",
|
||||||
|
"format": "url",
|
||||||
|
"default": "https://gitlab.com",
|
||||||
|
"description": "The URL of the GitLab host. Defaults to https://gitlab.com",
|
||||||
|
"examples": [
|
||||||
|
"https://gitlab.com",
|
||||||
|
"https://gitlab.example.com"
|
||||||
|
],
|
||||||
|
"pattern": "^https?:\\/\\/[^\\s/$.?#].[^\\s]*$"
|
||||||
|
},
|
||||||
|
"all": {
|
||||||
|
"type": "boolean",
|
||||||
|
"default": false,
|
||||||
|
"description": "Sync all projects visible to the provided `token` (if any) in the GitLab instance. This option is ignored if `url` is either unset or set to https://gitlab.com ."
|
||||||
|
},
|
||||||
|
"users": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"description": "List of users to sync with. All projects owned by the user and visible to the provided `token` (if any) will be synced, unless explicitly defined in the `exclude` property."
|
||||||
|
},
|
||||||
|
"groups": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"my-group"
|
||||||
|
],
|
||||||
|
[
|
||||||
|
"my-group/sub-group-a",
|
||||||
|
"my-group/sub-group-b"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"description": "List of groups to sync with. All projects in the group (and recursive subgroups) visible to the provided `token` (if any) will be synced, unless explicitly defined in the `exclude` property. Subgroups can be specified by providing the path to the subgroup (e.g. `my-group/sub-group-a`)."
|
||||||
|
},
|
||||||
|
"projects": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"my-group/my-project"
|
||||||
|
],
|
||||||
|
[
|
||||||
|
"my-group/my-sub-group/my-project"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"description": "List of individual projects to sync with. The project's namespace must be specified. See: https://docs.gitlab.com/ee/user/namespace/"
|
||||||
|
},
|
||||||
|
"topics": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"minItems": 1,
|
||||||
|
"description": "List of project topics to include when syncing. Only projects that match at least one of the provided `topics` will be synced. If not specified, all projects will be synced, unless explicitly defined in the `exclude` property. Glob patterns are supported.",
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"docs",
|
||||||
|
"core"
|
||||||
|
]
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"exclude": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"forks": {
|
||||||
|
"type": "boolean",
|
||||||
|
"default": false,
|
||||||
|
"description": "Exclude forked projects from syncing."
|
||||||
|
},
|
||||||
|
"archived": {
|
||||||
|
"type": "boolean",
|
||||||
|
"default": false,
|
||||||
|
"description": "Exclude archived projects from syncing."
|
||||||
|
},
|
||||||
|
"projects": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"default": [],
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"my-group/my-project"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"description": "List of projects to exclude from syncing. Glob patterns are supported. The project's namespace must be specified, see: https://docs.gitlab.com/ee/user/namespace/"
|
||||||
|
},
|
||||||
|
"topics": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"description": "List of project topics to exclude when syncing. Projects that match one of the provided `topics` will be excluded from syncing. Glob patterns are supported.",
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"tests",
|
||||||
|
"ci"
|
||||||
|
]
|
||||||
|
]
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"revisions": {
|
||||||
|
"type": "object",
|
||||||
|
"description": "The revisions (branches, tags) that should be included when indexing. The default branch (HEAD) is always indexed. A maximum of 64 revisions can be indexed, with any additional revisions being ignored.",
|
||||||
|
"properties": {
|
||||||
|
"branches": {
|
||||||
|
"type": "array",
|
||||||
|
"description": "List of branches to include when indexing. For a given repo, only the branches that exist on the repo's remote *and* match at least one of the provided `branches` will be indexed. The default branch (HEAD) is always indexed. Glob patterns are supported. A maximum of 64 branches can be indexed, with any additional branches being ignored.",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"main",
|
||||||
|
"release/*"
|
||||||
|
],
|
||||||
|
[
|
||||||
|
"**"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"default": []
|
||||||
|
},
|
||||||
|
"tags": {
|
||||||
|
"type": "array",
|
||||||
|
"description": "List of tags to include when indexing. For a given repo, only the tags that exist on the repo's remote *and* match at least one of the provided `tags` will be indexed. Glob patterns are supported. A maximum of 64 tags can be indexed, with any additional tags being ignored.",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"latest",
|
||||||
|
"v2.*.*"
|
||||||
|
],
|
||||||
|
[
|
||||||
|
"**"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"default": []
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"type"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
```
|
||||||
770
docs/snippets/schemas/v3/index.schema.mdx
Normal file
770
docs/snippets/schemas/v3/index.schema.mdx
Normal file
|
|
@ -0,0 +1,770 @@
|
||||||
|
{/* THIS IS A AUTO-GENERATED FILE. DO NOT MODIFY MANUALLY! */}
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
||||||
|
"type": "object",
|
||||||
|
"title": "SourcebotConfig",
|
||||||
|
"definitions": {
|
||||||
|
"Settings": {
|
||||||
|
"type": "object",
|
||||||
|
"description": "Defines the global settings for Sourcebot.",
|
||||||
|
"properties": {
|
||||||
|
"maxFileSize": {
|
||||||
|
"type": "number",
|
||||||
|
"description": "The maximum size of a file (in bytes) to be indexed. Files that exceed this maximum will not be indexed. Defaults to 2MB.",
|
||||||
|
"minimum": 1
|
||||||
|
},
|
||||||
|
"maxTrigramCount": {
|
||||||
|
"type": "number",
|
||||||
|
"description": "The maximum number of trigrams per document. Files that exceed this maximum will not be indexed. Default to 20000.",
|
||||||
|
"minimum": 1
|
||||||
|
},
|
||||||
|
"reindexIntervalMs": {
|
||||||
|
"type": "number",
|
||||||
|
"description": "The interval (in milliseconds) at which the indexer should re-index all repositories. Defaults to 1 hour.",
|
||||||
|
"minimum": 1
|
||||||
|
},
|
||||||
|
"resyncConnectionIntervalMs": {
|
||||||
|
"type": "number",
|
||||||
|
"description": "The interval (in milliseconds) at which the connection manager should check for connections that need to be re-synced. Defaults to 24 hours.",
|
||||||
|
"minimum": 1
|
||||||
|
},
|
||||||
|
"resyncConnectionPollingIntervalMs": {
|
||||||
|
"type": "number",
|
||||||
|
"description": "The polling rate (in milliseconds) at which the db should be checked for connections that need to be re-synced. Defaults to 1 second.",
|
||||||
|
"minimum": 1
|
||||||
|
},
|
||||||
|
"reindexRepoPollingIntervalMs": {
|
||||||
|
"type": "number",
|
||||||
|
"description": "The polling rate (in milliseconds) at which the db should be checked for repos that should be re-indexed. Defaults to 1 second.",
|
||||||
|
"minimum": 1
|
||||||
|
},
|
||||||
|
"maxConnectionSyncJobConcurrency": {
|
||||||
|
"type": "number",
|
||||||
|
"description": "The number of connection sync jobs to run concurrently. Defaults to 8.",
|
||||||
|
"minimum": 1
|
||||||
|
},
|
||||||
|
"maxRepoIndexingJobConcurrency": {
|
||||||
|
"type": "number",
|
||||||
|
"description": "The number of repo indexing jobs to run concurrently. Defaults to 8.",
|
||||||
|
"minimum": 1
|
||||||
|
},
|
||||||
|
"maxRepoGarbageCollectionJobConcurrency": {
|
||||||
|
"type": "number",
|
||||||
|
"description": "The number of repo GC jobs to run concurrently. Defaults to 8.",
|
||||||
|
"minimum": 1
|
||||||
|
},
|
||||||
|
"repoGarbageCollectionGracePeriodMs": {
|
||||||
|
"type": "number",
|
||||||
|
"description": "The grace period (in milliseconds) for garbage collection. Used to prevent deleting shards while they're being loaded. Defaults to 10 seconds.",
|
||||||
|
"minimum": 1
|
||||||
|
},
|
||||||
|
"repoIndexTimeoutMs": {
|
||||||
|
"type": "number",
|
||||||
|
"description": "The timeout (in milliseconds) for a repo indexing to timeout. Defaults to 2 hours.",
|
||||||
|
"minimum": 1
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"SearchContext": {
|
||||||
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
||||||
|
"type": "object",
|
||||||
|
"title": "SearchContext",
|
||||||
|
"description": "Search context",
|
||||||
|
"properties": {
|
||||||
|
"include": {
|
||||||
|
"type": "array",
|
||||||
|
"description": "List of repositories to include in the search context. Expected to be formatted as a URL without any leading http(s):// prefix (e.g., 'github.com/sourcebot-dev/sourcebot'). Glob patterns are supported.",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"github.com/sourcebot-dev/**",
|
||||||
|
"gerrit.example.org/sub/path/**"
|
||||||
|
]
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"exclude": {
|
||||||
|
"type": "array",
|
||||||
|
"description": "List of repositories to exclude from the search context. Expected to be formatted as a URL without any leading http(s):// prefix (e.g., 'github.com/sourcebot-dev/sourcebot'). Glob patterns are supported.",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"github.com/sourcebot-dev/sourcebot",
|
||||||
|
"gerrit.example.org/sub/path/**"
|
||||||
|
]
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"description": {
|
||||||
|
"type": "string",
|
||||||
|
"description": "Optional description of the search context that surfaces in the UI."
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"include"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"properties": {
|
||||||
|
"$schema": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"settings": {
|
||||||
|
"$ref": "#/definitions/Settings"
|
||||||
|
},
|
||||||
|
"contexts": {
|
||||||
|
"type": "object",
|
||||||
|
"description": "[Sourcebot EE] Defines a collection of search contexts. This is only available in single-tenancy mode. See: https://docs.sourcebot.dev/self-hosting/more/search-contexts",
|
||||||
|
"patternProperties": {
|
||||||
|
"^[a-zA-Z0-9_-]+$": {
|
||||||
|
"$ref": "#/definitions/SearchContext"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"connections": {
|
||||||
|
"type": "object",
|
||||||
|
"description": "Defines a collection of connections from varying code hosts that Sourcebot should sync with. This is only available in single-tenancy mode.",
|
||||||
|
"patternProperties": {
|
||||||
|
"^[a-zA-Z0-9_-]+$": {
|
||||||
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
||||||
|
"title": "ConnectionConfig",
|
||||||
|
"oneOf": [
|
||||||
|
{
|
||||||
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
||||||
|
"type": "object",
|
||||||
|
"title": "GithubConnectionConfig",
|
||||||
|
"properties": {
|
||||||
|
"type": {
|
||||||
|
"const": "github",
|
||||||
|
"description": "GitHub Configuration"
|
||||||
|
},
|
||||||
|
"token": {
|
||||||
|
"description": "A Personal Access Token (PAT).",
|
||||||
|
"examples": [
|
||||||
|
{
|
||||||
|
"secret": "SECRET_KEY"
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"anyOf": [
|
||||||
|
{
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"secret": {
|
||||||
|
"type": "string",
|
||||||
|
"description": "The name of the secret that contains the token."
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"secret"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"env": {
|
||||||
|
"type": "string",
|
||||||
|
"description": "The name of the environment variable that contains the token. Only supported in declarative connection configs."
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"env"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"url": {
|
||||||
|
"type": "string",
|
||||||
|
"format": "url",
|
||||||
|
"default": "https://github.com",
|
||||||
|
"description": "The URL of the GitHub host. Defaults to https://github.com",
|
||||||
|
"examples": [
|
||||||
|
"https://github.com",
|
||||||
|
"https://github.example.com"
|
||||||
|
],
|
||||||
|
"pattern": "^https?:\\/\\/[^\\s/$.?#].[^\\s]*$"
|
||||||
|
},
|
||||||
|
"users": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string",
|
||||||
|
"pattern": "^[\\w.-]+$"
|
||||||
|
},
|
||||||
|
"default": [],
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"torvalds",
|
||||||
|
"DHH"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"description": "List of users to sync with. All repositories that the user owns will be synced, unless explicitly defined in the `exclude` property."
|
||||||
|
},
|
||||||
|
"orgs": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string",
|
||||||
|
"pattern": "^[\\w.-]+$"
|
||||||
|
},
|
||||||
|
"default": [],
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"my-org-name"
|
||||||
|
],
|
||||||
|
[
|
||||||
|
"sourcebot-dev",
|
||||||
|
"commaai"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"description": "List of organizations to sync with. All repositories in the organization visible to the provided `token` (if any) will be synced, unless explicitly defined in the `exclude` property."
|
||||||
|
},
|
||||||
|
"repos": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string",
|
||||||
|
"pattern": "^[\\w.-]+\\/[\\w.-]+$"
|
||||||
|
},
|
||||||
|
"default": [],
|
||||||
|
"description": "List of individual repositories to sync with. Expected to be formatted as '{orgName}/{repoName}' or '{userName}/{repoName}'."
|
||||||
|
},
|
||||||
|
"topics": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"minItems": 1,
|
||||||
|
"default": [],
|
||||||
|
"description": "List of repository topics to include when syncing. Only repositories that match at least one of the provided `topics` will be synced. If not specified, all repositories will be synced, unless explicitly defined in the `exclude` property. Glob patterns are supported.",
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"docs",
|
||||||
|
"core"
|
||||||
|
]
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"exclude": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"forks": {
|
||||||
|
"type": "boolean",
|
||||||
|
"default": false,
|
||||||
|
"description": "Exclude forked repositories from syncing."
|
||||||
|
},
|
||||||
|
"archived": {
|
||||||
|
"type": "boolean",
|
||||||
|
"default": false,
|
||||||
|
"description": "Exclude archived repositories from syncing."
|
||||||
|
},
|
||||||
|
"repos": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"default": [],
|
||||||
|
"description": "List of individual repositories to exclude from syncing. Glob patterns are supported."
|
||||||
|
},
|
||||||
|
"topics": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"default": [],
|
||||||
|
"description": "List of repository topics to exclude when syncing. Repositories that match one of the provided `topics` will be excluded from syncing. Glob patterns are supported.",
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"tests",
|
||||||
|
"ci"
|
||||||
|
]
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"size": {
|
||||||
|
"type": "object",
|
||||||
|
"description": "Exclude repositories based on their disk usage. Note: the disk usage is calculated by GitHub and may not reflect the actual disk usage when cloned.",
|
||||||
|
"properties": {
|
||||||
|
"min": {
|
||||||
|
"type": "integer",
|
||||||
|
"description": "Minimum repository size (in bytes) to sync (inclusive). Repositories less than this size will be excluded from syncing."
|
||||||
|
},
|
||||||
|
"max": {
|
||||||
|
"type": "integer",
|
||||||
|
"description": "Maximum repository size (in bytes) to sync (inclusive). Repositories greater than this size will be excluded from syncing."
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"revisions": {
|
||||||
|
"type": "object",
|
||||||
|
"description": "The revisions (branches, tags) that should be included when indexing. The default branch (HEAD) is always indexed. A maximum of 64 revisions can be indexed, with any additional revisions being ignored.",
|
||||||
|
"properties": {
|
||||||
|
"branches": {
|
||||||
|
"type": "array",
|
||||||
|
"description": "List of branches to include when indexing. For a given repo, only the branches that exist on the repo's remote *and* match at least one of the provided `branches` will be indexed. The default branch (HEAD) is always indexed. Glob patterns are supported. A maximum of 64 branches can be indexed, with any additional branches being ignored.",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"main",
|
||||||
|
"release/*"
|
||||||
|
],
|
||||||
|
[
|
||||||
|
"**"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"default": []
|
||||||
|
},
|
||||||
|
"tags": {
|
||||||
|
"type": "array",
|
||||||
|
"description": "List of tags to include when indexing. For a given repo, only the tags that exist on the repo's remote *and* match at least one of the provided `tags` will be indexed. Glob patterns are supported. A maximum of 64 tags can be indexed, with any additional tags being ignored.",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"latest",
|
||||||
|
"v2.*.*"
|
||||||
|
],
|
||||||
|
[
|
||||||
|
"**"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"default": []
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"type"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
||||||
|
"type": "object",
|
||||||
|
"title": "GitlabConnectionConfig",
|
||||||
|
"properties": {
|
||||||
|
"type": {
|
||||||
|
"const": "gitlab",
|
||||||
|
"description": "GitLab Configuration"
|
||||||
|
},
|
||||||
|
"token": {
|
||||||
|
"$ref": "#/properties/connections/patternProperties/%5E%5Ba-zA-Z0-9_-%5D%2B%24/oneOf/0/properties/token",
|
||||||
|
"description": "An authentication token.",
|
||||||
|
"examples": [
|
||||||
|
{
|
||||||
|
"secret": "SECRET_KEY"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"url": {
|
||||||
|
"type": "string",
|
||||||
|
"format": "url",
|
||||||
|
"default": "https://gitlab.com",
|
||||||
|
"description": "The URL of the GitLab host. Defaults to https://gitlab.com",
|
||||||
|
"examples": [
|
||||||
|
"https://gitlab.com",
|
||||||
|
"https://gitlab.example.com"
|
||||||
|
],
|
||||||
|
"pattern": "^https?:\\/\\/[^\\s/$.?#].[^\\s]*$"
|
||||||
|
},
|
||||||
|
"all": {
|
||||||
|
"type": "boolean",
|
||||||
|
"default": false,
|
||||||
|
"description": "Sync all projects visible to the provided `token` (if any) in the GitLab instance. This option is ignored if `url` is either unset or set to https://gitlab.com ."
|
||||||
|
},
|
||||||
|
"users": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"description": "List of users to sync with. All projects owned by the user and visible to the provided `token` (if any) will be synced, unless explicitly defined in the `exclude` property."
|
||||||
|
},
|
||||||
|
"groups": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"my-group"
|
||||||
|
],
|
||||||
|
[
|
||||||
|
"my-group/sub-group-a",
|
||||||
|
"my-group/sub-group-b"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"description": "List of groups to sync with. All projects in the group (and recursive subgroups) visible to the provided `token` (if any) will be synced, unless explicitly defined in the `exclude` property. Subgroups can be specified by providing the path to the subgroup (e.g. `my-group/sub-group-a`)."
|
||||||
|
},
|
||||||
|
"projects": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"my-group/my-project"
|
||||||
|
],
|
||||||
|
[
|
||||||
|
"my-group/my-sub-group/my-project"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"description": "List of individual projects to sync with. The project's namespace must be specified. See: https://docs.gitlab.com/ee/user/namespace/"
|
||||||
|
},
|
||||||
|
"topics": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"minItems": 1,
|
||||||
|
"description": "List of project topics to include when syncing. Only projects that match at least one of the provided `topics` will be synced. If not specified, all projects will be synced, unless explicitly defined in the `exclude` property. Glob patterns are supported.",
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"docs",
|
||||||
|
"core"
|
||||||
|
]
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"exclude": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"forks": {
|
||||||
|
"type": "boolean",
|
||||||
|
"default": false,
|
||||||
|
"description": "Exclude forked projects from syncing."
|
||||||
|
},
|
||||||
|
"archived": {
|
||||||
|
"type": "boolean",
|
||||||
|
"default": false,
|
||||||
|
"description": "Exclude archived projects from syncing."
|
||||||
|
},
|
||||||
|
"projects": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"default": [],
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"my-group/my-project"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"description": "List of projects to exclude from syncing. Glob patterns are supported. The project's namespace must be specified, see: https://docs.gitlab.com/ee/user/namespace/"
|
||||||
|
},
|
||||||
|
"topics": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"description": "List of project topics to exclude when syncing. Projects that match one of the provided `topics` will be excluded from syncing. Glob patterns are supported.",
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"tests",
|
||||||
|
"ci"
|
||||||
|
]
|
||||||
|
]
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"revisions": {
|
||||||
|
"$ref": "#/properties/connections/patternProperties/%5E%5Ba-zA-Z0-9_-%5D%2B%24/oneOf/0/properties/revisions"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"type"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
||||||
|
"type": "object",
|
||||||
|
"title": "GiteaConnectionConfig",
|
||||||
|
"properties": {
|
||||||
|
"type": {
|
||||||
|
"const": "gitea",
|
||||||
|
"description": "Gitea Configuration"
|
||||||
|
},
|
||||||
|
"token": {
|
||||||
|
"$ref": "#/properties/connections/patternProperties/%5E%5Ba-zA-Z0-9_-%5D%2B%24/oneOf/0/properties/token",
|
||||||
|
"description": "A Personal Access Token (PAT).",
|
||||||
|
"examples": [
|
||||||
|
{
|
||||||
|
"secret": "SECRET_KEY"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"url": {
|
||||||
|
"type": "string",
|
||||||
|
"format": "url",
|
||||||
|
"default": "https://gitea.com",
|
||||||
|
"description": "The URL of the Gitea host. Defaults to https://gitea.com",
|
||||||
|
"examples": [
|
||||||
|
"https://gitea.com",
|
||||||
|
"https://gitea.example.com"
|
||||||
|
],
|
||||||
|
"pattern": "^https?:\\/\\/[^\\s/$.?#].[^\\s]*$"
|
||||||
|
},
|
||||||
|
"orgs": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"my-org-name"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"description": "List of organizations to sync with. All repositories in the organization visible to the provided `token` (if any) will be synced, unless explicitly defined in the `exclude` property. If a `token` is provided, it must have the read:organization scope."
|
||||||
|
},
|
||||||
|
"repos": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string",
|
||||||
|
"pattern": "^[\\w.-]+\\/[\\w.-]+$"
|
||||||
|
},
|
||||||
|
"description": "List of individual repositories to sync with. Expected to be formatted as '{orgName}/{repoName}' or '{userName}/{repoName}'."
|
||||||
|
},
|
||||||
|
"users": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"username-1",
|
||||||
|
"username-2"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"description": "List of users to sync with. All repositories that the user owns will be synced, unless explicitly defined in the `exclude` property. If a `token` is provided, it must have the read:user scope."
|
||||||
|
},
|
||||||
|
"exclude": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"forks": {
|
||||||
|
"type": "boolean",
|
||||||
|
"default": false,
|
||||||
|
"description": "Exclude forked repositories from syncing."
|
||||||
|
},
|
||||||
|
"archived": {
|
||||||
|
"type": "boolean",
|
||||||
|
"default": false,
|
||||||
|
"description": "Exclude archived repositories from syncing."
|
||||||
|
},
|
||||||
|
"repos": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"default": [],
|
||||||
|
"description": "List of individual repositories to exclude from syncing. Glob patterns are supported."
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"revisions": {
|
||||||
|
"$ref": "#/properties/connections/patternProperties/%5E%5Ba-zA-Z0-9_-%5D%2B%24/oneOf/0/properties/revisions"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"type"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"$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."
|
||||||
|
},
|
||||||
|
"readOnly": {
|
||||||
|
"type": "boolean",
|
||||||
|
"default": false,
|
||||||
|
"description": "Exclude read-only projects from syncing."
|
||||||
|
},
|
||||||
|
"hidden": {
|
||||||
|
"type": "boolean",
|
||||||
|
"default": false,
|
||||||
|
"description": "Exclude hidden projects from syncing."
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"type",
|
||||||
|
"url"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
||||||
|
"type": "object",
|
||||||
|
"title": "BitbucketConnectionConfig",
|
||||||
|
"properties": {
|
||||||
|
"type": {
|
||||||
|
"const": "bitbucket",
|
||||||
|
"description": "Bitbucket configuration"
|
||||||
|
},
|
||||||
|
"user": {
|
||||||
|
"type": "string",
|
||||||
|
"description": "The username to use for authentication. Only needed if token is an app password."
|
||||||
|
},
|
||||||
|
"token": {
|
||||||
|
"$ref": "#/properties/connections/patternProperties/%5E%5Ba-zA-Z0-9_-%5D%2B%24/oneOf/0/properties/token",
|
||||||
|
"description": "An authentication token.",
|
||||||
|
"examples": [
|
||||||
|
{
|
||||||
|
"secret": "SECRET_KEY"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"url": {
|
||||||
|
"type": "string",
|
||||||
|
"format": "url",
|
||||||
|
"default": "https://api.bitbucket.org/2.0",
|
||||||
|
"description": "Bitbucket URL",
|
||||||
|
"examples": [
|
||||||
|
"https://bitbucket.example.com"
|
||||||
|
],
|
||||||
|
"pattern": "^https?:\\/\\/[^\\s/$.?#].[^\\s]*$"
|
||||||
|
},
|
||||||
|
"deploymentType": {
|
||||||
|
"type": "string",
|
||||||
|
"enum": [
|
||||||
|
"cloud",
|
||||||
|
"server"
|
||||||
|
],
|
||||||
|
"default": "cloud",
|
||||||
|
"description": "The type of Bitbucket deployment"
|
||||||
|
},
|
||||||
|
"workspaces": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"description": "List of workspaces to sync. Ignored if deploymentType is server."
|
||||||
|
},
|
||||||
|
"projects": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"description": "List of projects to sync"
|
||||||
|
},
|
||||||
|
"repos": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"description": "List of repos to sync"
|
||||||
|
},
|
||||||
|
"exclude": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"archived": {
|
||||||
|
"type": "boolean",
|
||||||
|
"default": false,
|
||||||
|
"description": "Exclude archived repositories from syncing."
|
||||||
|
},
|
||||||
|
"forks": {
|
||||||
|
"type": "boolean",
|
||||||
|
"default": false,
|
||||||
|
"description": "Exclude forked repositories from syncing."
|
||||||
|
},
|
||||||
|
"repos": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"cloud_workspace/repo1",
|
||||||
|
"server_project/repo2"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"description": "List of specific repos to exclude from syncing."
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"revisions": {
|
||||||
|
"$ref": "#/properties/connections/patternProperties/%5E%5Ba-zA-Z0-9_-%5D%2B%24/oneOf/0/properties/revisions"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"type"
|
||||||
|
],
|
||||||
|
"if": {
|
||||||
|
"properties": {
|
||||||
|
"deploymentType": {
|
||||||
|
"const": "server"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"then": {
|
||||||
|
"required": [
|
||||||
|
"url"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
```
|
||||||
45
docs/snippets/schemas/v3/searchContext.schema.mdx
Normal file
45
docs/snippets/schemas/v3/searchContext.schema.mdx
Normal file
|
|
@ -0,0 +1,45 @@
|
||||||
|
{/* THIS IS A AUTO-GENERATED FILE. DO NOT MODIFY MANUALLY! */}
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
||||||
|
"type": "object",
|
||||||
|
"title": "SearchContext",
|
||||||
|
"description": "Search context",
|
||||||
|
"properties": {
|
||||||
|
"include": {
|
||||||
|
"type": "array",
|
||||||
|
"description": "List of repositories to include in the search context. Expected to be formatted as a URL without any leading http(s):// prefix (e.g., 'github.com/sourcebot-dev/sourcebot'). Glob patterns are supported.",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"github.com/sourcebot-dev/**",
|
||||||
|
"gerrit.example.org/sub/path/**"
|
||||||
|
]
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"exclude": {
|
||||||
|
"type": "array",
|
||||||
|
"description": "List of repositories to exclude from the search context. Expected to be formatted as a URL without any leading http(s):// prefix (e.g., 'github.com/sourcebot-dev/sourcebot'). Glob patterns are supported.",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"github.com/sourcebot-dev/sourcebot",
|
||||||
|
"gerrit.example.org/sub/path/**"
|
||||||
|
]
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"description": {
|
||||||
|
"type": "string",
|
||||||
|
"description": "Optional description of the search context that surfaces in the UI."
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"include"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
```
|
||||||
80
docs/snippets/schemas/v3/shared.schema.mdx
Normal file
80
docs/snippets/schemas/v3/shared.schema.mdx
Normal file
|
|
@ -0,0 +1,80 @@
|
||||||
|
{/* THIS IS A AUTO-GENERATED FILE. DO NOT MODIFY MANUALLY! */}
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
||||||
|
"type": "object",
|
||||||
|
"definitions": {
|
||||||
|
"Token": {
|
||||||
|
"anyOf": [
|
||||||
|
{
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"secret": {
|
||||||
|
"type": "string",
|
||||||
|
"description": "The name of the secret that contains the token."
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"secret"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"env": {
|
||||||
|
"type": "string",
|
||||||
|
"description": "The name of the environment variable that contains the token. Only supported in declarative connection configs."
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"env"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"GitRevisions": {
|
||||||
|
"type": "object",
|
||||||
|
"description": "The revisions (branches, tags) that should be included when indexing. The default branch (HEAD) is always indexed. A maximum of 64 revisions can be indexed, with any additional revisions being ignored.",
|
||||||
|
"properties": {
|
||||||
|
"branches": {
|
||||||
|
"type": "array",
|
||||||
|
"description": "List of branches to include when indexing. For a given repo, only the branches that exist on the repo's remote *and* match at least one of the provided `branches` will be indexed. The default branch (HEAD) is always indexed. Glob patterns are supported. A maximum of 64 branches can be indexed, with any additional branches being ignored.",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"main",
|
||||||
|
"release/*"
|
||||||
|
],
|
||||||
|
[
|
||||||
|
"**"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"default": []
|
||||||
|
},
|
||||||
|
"tags": {
|
||||||
|
"type": "array",
|
||||||
|
"description": "List of tags to include when indexing. For a given repo, only the tags that exist on the repo's remote *and* match at least one of the provided `tags` will be indexed. Glob patterns are supported. A maximum of 64 tags can be indexed, with any additional tags being ignored.",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"latest",
|
||||||
|
"v2.*.*"
|
||||||
|
],
|
||||||
|
[
|
||||||
|
"**"
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"default": []
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
@ -6,7 +6,7 @@ const schema = {
|
||||||
"definitions": {
|
"definitions": {
|
||||||
"Settings": {
|
"Settings": {
|
||||||
"type": "object",
|
"type": "object",
|
||||||
"description": "Defines the globabl settings for Sourcebot.",
|
"description": "Defines the global settings for Sourcebot.",
|
||||||
"properties": {
|
"properties": {
|
||||||
"maxFileSize": {
|
"maxFileSize": {
|
||||||
"type": "number",
|
"type": "number",
|
||||||
|
|
@ -67,7 +67,9 @@ const schema = {
|
||||||
"additionalProperties": false
|
"additionalProperties": false
|
||||||
},
|
},
|
||||||
"SearchContext": {
|
"SearchContext": {
|
||||||
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
||||||
"type": "object",
|
"type": "object",
|
||||||
|
"title": "SearchContext",
|
||||||
"description": "Search context",
|
"description": "Search context",
|
||||||
"properties": {
|
"properties": {
|
||||||
"include": {
|
"include": {
|
||||||
|
|
|
||||||
|
|
@ -28,7 +28,7 @@ export interface SourcebotConfig {
|
||||||
};
|
};
|
||||||
}
|
}
|
||||||
/**
|
/**
|
||||||
* Defines the globabl settings for Sourcebot.
|
* Defines the global settings for Sourcebot.
|
||||||
*
|
*
|
||||||
* This interface was referenced by `SourcebotConfig`'s JSON-Schema
|
* This interface was referenced by `SourcebotConfig`'s JSON-Schema
|
||||||
* via the `definition` "Settings".
|
* via the `definition` "Settings".
|
||||||
|
|
|
||||||
44
packages/schemas/src/v3/searchContext.schema.ts
Normal file
44
packages/schemas/src/v3/searchContext.schema.ts
Normal file
|
|
@ -0,0 +1,44 @@
|
||||||
|
// THIS IS A AUTO-GENERATED FILE. DO NOT MODIFY MANUALLY!
|
||||||
|
const schema = {
|
||||||
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
||||||
|
"type": "object",
|
||||||
|
"title": "SearchContext",
|
||||||
|
"description": "Search context",
|
||||||
|
"properties": {
|
||||||
|
"include": {
|
||||||
|
"type": "array",
|
||||||
|
"description": "List of repositories to include in the search context. Expected to be formatted as a URL without any leading http(s):// prefix (e.g., 'github.com/sourcebot-dev/sourcebot'). Glob patterns are supported.",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"github.com/sourcebot-dev/**",
|
||||||
|
"gerrit.example.org/sub/path/**"
|
||||||
|
]
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"exclude": {
|
||||||
|
"type": "array",
|
||||||
|
"description": "List of repositories to exclude from the search context. Expected to be formatted as a URL without any leading http(s):// prefix (e.g., 'github.com/sourcebot-dev/sourcebot'). Glob patterns are supported.",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"github.com/sourcebot-dev/sourcebot",
|
||||||
|
"gerrit.example.org/sub/path/**"
|
||||||
|
]
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"description": {
|
||||||
|
"type": "string",
|
||||||
|
"description": "Optional description of the search context that surfaces in the UI."
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"include"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
} as const;
|
||||||
|
export { schema as searchContextSchema };
|
||||||
19
packages/schemas/src/v3/searchContext.type.ts
Normal file
19
packages/schemas/src/v3/searchContext.type.ts
Normal file
|
|
@ -0,0 +1,19 @@
|
||||||
|
// THIS IS A AUTO-GENERATED FILE. DO NOT MODIFY MANUALLY!
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Search context
|
||||||
|
*/
|
||||||
|
export interface SearchContext {
|
||||||
|
/**
|
||||||
|
* List of repositories to include in the search context. Expected to be formatted as a URL without any leading http(s):// prefix (e.g., 'github.com/sourcebot-dev/sourcebot'). Glob patterns are supported.
|
||||||
|
*/
|
||||||
|
include: string[];
|
||||||
|
/**
|
||||||
|
* List of repositories to exclude from the search context. Expected to be formatted as a URL without any leading http(s):// prefix (e.g., 'github.com/sourcebot-dev/sourcebot'). Glob patterns are supported.
|
||||||
|
*/
|
||||||
|
exclude?: string[];
|
||||||
|
/**
|
||||||
|
* Optional description of the search context that surfaces in the UI.
|
||||||
|
*/
|
||||||
|
description?: string;
|
||||||
|
}
|
||||||
|
|
@ -5,41 +5,56 @@ import { compileFromFile } from "json-schema-to-typescript";
|
||||||
import { glob } from "glob";
|
import { glob } from "glob";
|
||||||
|
|
||||||
|
|
||||||
const BANNER_COMMENT = '// THIS IS A AUTO-GENERATED FILE. DO NOT MODIFY MANUALLY!\n';
|
const BANNER_COMMENT = 'THIS IS A AUTO-GENERATED FILE. DO NOT MODIFY MANUALLY!';
|
||||||
|
|
||||||
(async () => {
|
(async () => {
|
||||||
const cwd = process.cwd();
|
const cwd = process.cwd();
|
||||||
const schemasBasePath = path.resolve(`${cwd}/../../schemas`);
|
const schemasBasePath = path.resolve(`${cwd}/../../schemas`);
|
||||||
const outDirRoot = path.resolve(`${cwd}/src`);
|
const srcDir = path.resolve(`${cwd}/src`);
|
||||||
|
const docsDir = path.resolve(`${cwd}/../../docs/snippets/schemas`);
|
||||||
const schemas = await glob(`${schemasBasePath}/**/*.json`);
|
const schemas = await glob(`${schemasBasePath}/**/*.json`);
|
||||||
|
|
||||||
await Promise.all(schemas.map(async (schemaPath) => {
|
await Promise.all(schemas.map(async (schemaPath) => {
|
||||||
const name = path.parse(schemaPath).name;
|
const name = path.parse(schemaPath).name;
|
||||||
const version = path.basename(path.dirname(schemaPath));
|
const version = path.basename(path.dirname(schemaPath));
|
||||||
const outDir = path.join(outDirRoot, version);
|
|
||||||
|
|
||||||
await mkdir(outDir, { recursive: true });
|
const srcOutDir = path.join(srcDir, version);
|
||||||
|
const docsOutDir = path.join(docsDir, version);
|
||||||
|
|
||||||
|
await mkdir(srcOutDir, { recursive: true });
|
||||||
|
await mkdir(docsOutDir, { recursive: true });
|
||||||
|
|
||||||
// Generate schema
|
// Generate schema
|
||||||
const schema = JSON.stringify(await $RefParser.bundle(schemaPath), null, 2);
|
const schema = JSON.stringify(await $RefParser.bundle(schemaPath), null, 2);
|
||||||
|
|
||||||
|
// Write to src
|
||||||
await writeFile(
|
await writeFile(
|
||||||
path.join(outDir, `${name}.schema.ts`),
|
path.join(srcOutDir, `${name}.schema.ts`),
|
||||||
BANNER_COMMENT +
|
`// ${BANNER_COMMENT}\n` +
|
||||||
'const schema = ' +
|
'const schema = ' +
|
||||||
schema +
|
schema +
|
||||||
` as const;\nexport { schema as ${name}Schema };`,
|
` as const;\nexport { schema as ${name}Schema };`,
|
||||||
);
|
);
|
||||||
|
|
||||||
|
// Write to docs
|
||||||
|
await writeFile(
|
||||||
|
path.join(docsOutDir, `${name}.schema.mdx`),
|
||||||
|
`{/* ${BANNER_COMMENT} */}\n` +
|
||||||
|
'```json\n' +
|
||||||
|
schema +
|
||||||
|
'\n```\n'
|
||||||
|
);
|
||||||
|
|
||||||
// Generate types
|
// Generate types
|
||||||
const content = await compileFromFile(schemaPath, {
|
const content = await compileFromFile(schemaPath, {
|
||||||
bannerComment: BANNER_COMMENT,
|
bannerComment: `// ${BANNER_COMMENT}\n`,
|
||||||
cwd: dirname(schemaPath),
|
cwd: dirname(schemaPath),
|
||||||
ignoreMinAndMaxItems: true,
|
ignoreMinAndMaxItems: true,
|
||||||
declareExternallyReferenced: true,
|
declareExternallyReferenced: true,
|
||||||
unreachableDefinitions: true,
|
unreachableDefinitions: true,
|
||||||
});
|
});
|
||||||
await writeFile(
|
await writeFile(
|
||||||
path.join(outDir, `${name}.type.ts`),
|
path.join(srcOutDir, `${name}.type.ts`),
|
||||||
content,
|
content,
|
||||||
)
|
)
|
||||||
}));
|
}));
|
||||||
|
|
|
||||||
|
|
@ -5,7 +5,7 @@
|
||||||
"definitions": {
|
"definitions": {
|
||||||
"Settings": {
|
"Settings": {
|
||||||
"type": "object",
|
"type": "object",
|
||||||
"description": "Defines the globabl settings for Sourcebot.",
|
"description": "Defines the global settings for Sourcebot.",
|
||||||
"properties": {
|
"properties": {
|
||||||
"maxFileSize": {
|
"maxFileSize": {
|
||||||
"type": "number",
|
"type": "number",
|
||||||
|
|
@ -66,44 +66,7 @@
|
||||||
"additionalProperties": false
|
"additionalProperties": false
|
||||||
},
|
},
|
||||||
"SearchContext": {
|
"SearchContext": {
|
||||||
"type": "object",
|
"$ref": "./searchContext.json"
|
||||||
"description": "Search context",
|
|
||||||
"properties": {
|
|
||||||
"include": {
|
|
||||||
"type": "array",
|
|
||||||
"description": "List of repositories to include in the search context. Expected to be formatted as a URL without any leading http(s):// prefix (e.g., 'github.com/sourcebot-dev/sourcebot'). Glob patterns are supported.",
|
|
||||||
"items": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"examples": [
|
|
||||||
[
|
|
||||||
"github.com/sourcebot-dev/**",
|
|
||||||
"gerrit.example.org/sub/path/**"
|
|
||||||
]
|
|
||||||
]
|
|
||||||
},
|
|
||||||
"exclude": {
|
|
||||||
"type": "array",
|
|
||||||
"description": "List of repositories to exclude from the search context. Expected to be formatted as a URL without any leading http(s):// prefix (e.g., 'github.com/sourcebot-dev/sourcebot'). Glob patterns are supported.",
|
|
||||||
"items": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"examples": [
|
|
||||||
[
|
|
||||||
"github.com/sourcebot-dev/sourcebot",
|
|
||||||
"gerrit.example.org/sub/path/**"
|
|
||||||
]
|
|
||||||
]
|
|
||||||
},
|
|
||||||
"description": {
|
|
||||||
"type": "string",
|
|
||||||
"description": "Optional description of the search context that surfaces in the UI."
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"required": [
|
|
||||||
"include"
|
|
||||||
],
|
|
||||||
"additionalProperties": false
|
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"properties": {
|
"properties": {
|
||||||
|
|
|
||||||
42
schemas/v3/searchContext.json
Normal file
42
schemas/v3/searchContext.json
Normal file
|
|
@ -0,0 +1,42 @@
|
||||||
|
{
|
||||||
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
||||||
|
"type": "object",
|
||||||
|
"title": "SearchContext",
|
||||||
|
"description": "Search context",
|
||||||
|
"properties": {
|
||||||
|
"include": {
|
||||||
|
"type": "array",
|
||||||
|
"description": "List of repositories to include in the search context. Expected to be formatted as a URL without any leading http(s):// prefix (e.g., 'github.com/sourcebot-dev/sourcebot'). Glob patterns are supported.",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"github.com/sourcebot-dev/**",
|
||||||
|
"gerrit.example.org/sub/path/**"
|
||||||
|
]
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"exclude": {
|
||||||
|
"type": "array",
|
||||||
|
"description": "List of repositories to exclude from the search context. Expected to be formatted as a URL without any leading http(s):// prefix (e.g., 'github.com/sourcebot-dev/sourcebot'). Glob patterns are supported.",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"examples": [
|
||||||
|
[
|
||||||
|
"github.com/sourcebot-dev/sourcebot",
|
||||||
|
"gerrit.example.org/sub/path/**"
|
||||||
|
]
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"description": {
|
||||||
|
"type": "string",
|
||||||
|
"description": "Optional description of the search context that surfaces in the UI."
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"include"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
Loading…
Reference in a new issue