Skip to content

Commit 3723d22

Browse files
Update JSON schemas for v6.5.1211 (#1245)
This PR updates the embedded JSON schemas to match the schemas from Sourcegraph v6.5.1211. ## Changes - Updates JSON schema files referenced in MDX documentation - Maintains version consistency between code and documentation ## Automation This PR was created automatically by the schema sync tool during the v6.5.1211 release process. /cc @sourcegraph/release --------- Co-authored-by: Maedah Batool <[email protected]>
1 parent 7e3a47b commit 3723d22

File tree

13 files changed

+1421
-841
lines changed

13 files changed

+1421
-841
lines changed

docs/admin/code_hosts/aws_codecommit.mdx

Lines changed: 28 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -34,16 +34,15 @@ AWS CodeCommit connections support the following configuration options, which ar
3434

3535
{/* SCHEMA_SYNC_START: admin/code_hosts/aws_codecommit.schema.json */}
3636
{/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
37-
{/* Last updated: Manual setup - will be automated via sourcegraph/sourcegraph releases */}
37+
{/* Last updated: 2025-07-07T17:35:38Z via sourcegraph/sourcegraph@v6.5.1211 */}
3838
```json
3939
{
40+
// REQUIRED:
4041
// The AWS access key ID to use when listing and updating repositories from AWS CodeCommit. Must have the AWSCodeCommitReadOnly IAM policy.
4142
"accessKeyID": null,
4243

4344
// A list of repositories to never mirror from AWS CodeCommit.
44-
//
4545
// Supports excluding by name ({"name": "git-codecommit.us-west-1.amazonaws.com/repo-name"}) or by ARN ({"id": "arn:aws:codecommit:us-west-1:999999999999:name"}).
46-
"exclude": null,
4746
// Other example values:
4847
// - [
4948
// {
@@ -61,35 +60,55 @@ AWS CodeCommit connections support the following configuration options, which ar
6160
// "name": "go-client"
6261
// }
6362
// ]
63+
"exclude": null,
6464

65+
// REQUIRED:
6566
// The Git credentials used for authentication when cloning an AWS CodeCommit repository over HTTPS.
66-
//
6767
// See the AWS CodeCommit documentation on Git credentials for CodeCommit: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_ssh-keys.html#git-credentials-code-commit.
6868
// For detailed instructions on how to create the credentials in IAM, see this page: https://docs.aws.amazon.com/codecommit/latest/userguide/setting-up-gc.html
69-
"gitCredentials": null,
69+
"gitCredentials": {
70+
"password": null,
71+
"username": null
72+
},
73+
74+
// SSH cipher to use when cloning via SSH. Must be a valid choice from `ssh -Q cipher`.
75+
"gitSSHCipher": null,
76+
77+
// SSH keys to use when cloning Git repo.
78+
"gitSSHCredential": null,
79+
80+
// The ID of the SSH key created for your IAM users. It is required when using SSH to clone repositories.
81+
"gitSSHKeyID": null,
82+
83+
// The type of Git URLs to use for cloning and fetching Git repositories.
84+
// Valid options: "http", "ssh"
85+
"gitURLType": "http",
7086

7187
// Deprecated and ignored field which will be removed entirely in the next release. AWS CodeCommit repositories can no longer be enabled or disabled explicitly. Configure which repositories should not be mirrored via "exclude" instead.
7288
"initialRepositoryEnablement": false,
7389

90+
// The maximum number of repos that will be deleted per sync. A value of 0 or less indicates no maximum.
91+
"maxDeletions": 0,
92+
93+
// REQUIRED:
7494
// The AWS region in which to access AWS CodeCommit. See the list of supported regions at https://docs.aws.amazon.com/codecommit/latest/userguide/regions.html#regions-git.
95+
// Valid options: "ap-northeast-1", "ap-northeast-2", "ap-south-1", "ap-southeast-1", "ap-southeast-2", "ca-central-1", "eu-central-1", "eu-west-1", "eu-west-2", "eu-west-3", "sa-east-1", "us-east-1", "us-east-2", "us-west-1", "us-west-2"
7596
"region": "us-east-1",
7697

7798
// The pattern used to generate a the corresponding Sourcegraph repository name for an AWS CodeCommit repository. In the pattern, the variable "{name}" is replaced with the repository's name.
78-
//
7999
// For example, if your Sourcegraph instance is at https://src.example.com, then a repositoryPathPattern of "awsrepos/{name}" would mean that a AWS CodeCommit repository named "myrepo" is available on Sourcegraph at https://src.example.com/awsrepos/myrepo.
80-
//
81100
// It is important that the Sourcegraph repository name generated with this pattern be unique to this code host. If different code hosts generate repository names that collide, Sourcegraph's behavior is undefined.
82-
"repositoryPathPattern": "{name}",
83101
// Other example values:
84102
// - "git-codecommit.us-west-1.amazonaws.com/{name}"
85103
// - "git-codecommit.eu-central-1.amazonaws.com/{name}"
104+
"repositoryPathPattern": "{name}",
86105

106+
// REQUIRED:
87107
// The AWS secret access key (that corresponds to the AWS access key ID set in `accessKeyID`).
88108
"secretAccessKey": null
89109
}
90110
```
91111
{/* SCHEMA_SYNC_END: admin/code_hosts/aws_codecommit.schema.json */}
92-
93112
## Setup steps for SSH connections to AWS CodeCommit repositories
94113

95114
To add CodeCommit repositories in Docker Container:

docs/admin/code_hosts/azuredevops.mdx

Lines changed: 47 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -67,14 +67,15 @@ Azure DevOps connections support the following configuration options, which are
6767

6868
{/* SCHEMA_SYNC_START: admin/code_hosts/azuredevops.schema.json */}
6969
{/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
70-
{/* Last updated: Manual setup - will be automated via sourcegraph/sourcegraph releases */}
70+
{/* Last updated: 2025-07-07T17:35:37Z via sourcegraph/sourcegraph@v6.5.1211 */}
7171
```json
72+
// Authentication alternatives: token OR windowsPassword
73+
7274
{
7375
// A flag to enforce Azure DevOps repository access permissions
7476
"enforcePermissions": false,
7577

7678
// A list of repositories to never mirror from Azure DevOps Services.
77-
"exclude": null,
7879
// Other example values:
7980
// - [
8081
// {
@@ -92,43 +93,77 @@ Azure DevOps connections support the following configuration options, which are
9293
// "pattern": "^topsecretproject/.*"
9394
// }
9495
// ]
96+
"exclude": null,
97+
98+
// SSH cipher to use when cloning via SSH. Must be a valid choice from `ssh -Q cipher`.
99+
"gitSSHCipher": null,
100+
101+
// SSH keys to use when cloning Git repo.
102+
"gitSSHCredential": null,
95103

96104
// The type of Git URLs to use for cloning and fetching Git repositories.
97-
//
98105
// If "http", Sourcegraph will access repositories using Git URLs of the form http(s)://dev.azure.com/myrepo.git.
99-
//
100-
// If "ssh", Sourcegraph will access repositories using Git URLs of the form git@ssh.dev.azure.com:v3/myrepo. See the documentation for how to provide SSH private keys and known_hosts: https://sourcegraph.com/docs/admin/repo/auth#repositories-that-need-http-s-or-ssh-authentication.
106+
// If "ssh", Sourcegraph will access repositories using Git URLs of the form [email protected]:v3/myrepo. See the documentation for how to provide SSH private keys and known_hosts: https://sourcegraph.com/docs/admin/repo/auth.
107+
// Valid options: "http", "ssh"
101108
"gitURLType": "http",
102109

110+
// The maximum number of repos that will be deleted per sync. A value of 0 or less indicates no maximum.
111+
"maxDeletions": 0,
112+
103113
// An array of organization names identifying Azure DevOps organizations whose repositories should be mirrored on Sourcegraph.
104-
"orgs": null,
105114
// Other example values:
106-
// - ["name"]
115+
// - [
116+
// "name"
117+
// ]
107118
// - [
108119
// "kubernetes",
109120
// "golang",
110121
// "facebook"
111122
// ]
123+
"orgs": null,
112124

113125
// An array of projects "org/project" strings specifying which Azure DevOps projects' repositories should be mirrored on Sourcegraph.
126+
// Other example values:
127+
// - [
128+
// "org/project"
129+
// ]
114130
"projects": null,
131+
132+
// Rate limit applied when making background API requests.
133+
"rateLimit": {
134+
"enabled": false,
135+
"requestsPerHour": 0
136+
},
137+
138+
// The pattern used to generate the corresponding Sourcegraph repository name for a Azure DevOps repository.
139+
// - "{host}" is replaced with the Azure DevOps URL's host (such as dev.azure.com)
140+
// - "{orgName}" is replaced with the repository's parent projects owning organization (or collection on DevOps server)
141+
// - "{projectName}" is replaced with the repository's parent project
142+
// - "{repositoryName}" is replaced with the repository's name.
143+
// For example, if your Azure DevOps is https://dev.azure.com and your Sourcegraph is https://src.example.com, then a repositoryPathPattern of "{host}/{orgName}/{projectName}/{repositoryName}" would mean that a Azure DevOps repository at https://dev.azure.com/MYORG/MYPROJECT/MYREPO is available on Sourcegraph at https://src.example.com/dev.azure.com/MYORG/MYPROJECT/MYREPO.
144+
// It is important that the Sourcegraph repository name generated with this pattern be unique to this code host. If different code hosts generate repository names that collide, Sourcegraph's behavior is undefined.
115145
// Other example values:
116-
// - ["org/project"]
146+
// - "{projectName}/{repositoryName}"
147+
"repositoryPathPattern": "{host}/{orgName}/{projectName}/{repositoryName}",
117148

118149
// The Personal Access Token associated with the Azure DevOps username used for authentication.
119150
"token": null,
120151

152+
// REQUIRED:
121153
// URL for Azure DevOps Services, set to https://dev.azure.com.
122-
"url": null,
123154
// Other example values:
124155
// - "https://dev.azure.com"
156+
"url": null,
125157

126-
// A username for authentication with the Azure DevOps code host.
127-
"username": null
158+
// REQUIRED:
159+
// A username for authentication with the Azure DevOps code host. Typically an email address when connect to Azure DevOps Services (cloud) and a domain\username when connecting to Azure DevOp Server (onPrem)
160+
"username": null,
161+
162+
// Windows account password (Azure Devops Server OnPrem Only): This is needed to clone the repo, the Token will be used for REST API calls
163+
"windowsPassword": null
128164
}
129165
```
130166
{/* SCHEMA_SYNC_END: admin/code_hosts/azuredevops.schema.json */}
131-
132167
## Webhooks
133168

134169
Please consult [this page](/admin/config/webhooks/incoming) in order to configure webhooks.

docs/admin/code_hosts/bitbucket_cloud.mdx

Lines changed: 35 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -118,27 +118,29 @@ Bitbucket Cloud connections support the following configuration options, which a
118118

119119
{/* SCHEMA_SYNC_START: admin/code_hosts/bitbucket_cloud.schema.json */}
120120
{/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
121-
{/* Last updated: Manual setup - will be automated via sourcegraph/sourcegraph releases */}
121+
{/* Last updated: 2025-07-07T17:35:37Z via sourcegraph/sourcegraph@v6.5.1211 */}
122122
```json
123+
// Authentication alternatives: username + appPassword
124+
123125
{
124126
// The workspace access token to use when authenticating with Bitbucket Cloud.
125127
"accessToken": null,
126128

127129
// The API URL of Bitbucket Cloud, such as https://api.bitbucket.org. Generally, admin should not modify the value of this option because Bitbucket Cloud is a public hosting platform.
128-
"apiURL": null,
129130
// Other example values:
130131
// - "https://api.bitbucket.org"
132+
"apiURL": null,
131133

132134
// The app password to use when authenticating to the Bitbucket Cloud. Also set the corresponding "username" field.
133135
"appPassword": null,
134136

135137
// If non-null, enforces Bitbucket Cloud repository permissions. This requires that there is an item in the [site configuration json](https://sourcegraph.com/docs/admin/config/site_config#auth-providers) `auth.providers` field, of type "bitbucketcloud" with the same `url` field as specified in this `BitbucketCloudConnection`.
136-
"authorization": null,
138+
"authorization": {
139+
"identityProvider": null
140+
},
137141

138142
// A list of repositories to never mirror from Bitbucket Cloud. Takes precedence over "teams" configuration.
139-
//
140143
// Supports excluding by name ({"name": "myorg/myrepo"}) or by UUID ({"uuid": "{fceb73c7-cef6-4abe-956d-e471281126bd}"}).
141-
"exclude": null,
142144
// Other example values:
143145
// - [
144146
// {
@@ -159,55 +161,72 @@ Bitbucket Cloud connections support the following configuration options, which a
159161
// "pattern": "^topsecretproject/.*"
160162
// }
161163
// ]
164+
"exclude": null,
165+
166+
// SSH cipher to use when cloning via SSH. Must be a valid choice from `ssh -Q cipher`.
167+
"gitSSHCipher": null,
168+
169+
// SSH keys to use when cloning Git repo.
170+
"gitSSHCredential": null,
162171

163172
// The type of Git URLs to use for cloning and fetching Git repositories on this Bitbucket Cloud.
164-
//
165173
// If "http", Sourcegraph will access Bitbucket Cloud repositories using Git URLs of the form https://bitbucket.org/myteam/myproject.git.
166-
//
167174
// If "ssh", Sourcegraph will access Bitbucket Cloud repositories using Git URLs of the form [email protected]:myteam/myproject.git. See the documentation for how to provide SSH private keys and known_hosts: https://sourcegraph.com/docs/admin/repo/auth#repositories-that-need-http-s-or-ssh-authentication.
168-
"gitURLType": "http",
175+
// Valid options: "http", "ssh"
169176
// Other example values:
170177
// - "ssh"
178+
"gitURLType": "http",
179+
180+
// The maximum number of repos that will be deleted per sync. A value of 0 or less indicates no maximum.
181+
"maxDeletions": 0,
171182

172183
// Rate limit applied when making background API requests to Bitbucket Cloud.
173184
"rateLimit": {
174185
"enabled": true,
175186
"requestsPerHour": 7200
176187
},
177188

189+
// An array of repository "projectKey/repositorySlug" strings specifying repositories to mirror on Sourcegraph.
190+
// Other example values:
191+
// - [
192+
// "myproject/myrepo",
193+
// "myproject/myotherrepo"
194+
// ]
195+
"repos": null,
196+
178197
// The pattern used to generate the corresponding Sourcegraph repository name for a Bitbucket Cloud repository.
179-
//
180-
// - "{host}" is replaced with the Bitbucket Cloud URL's host (such as bitbucket.org), and "{nameWithOwner}" is replaced with the Bitbucket Cloud repository's "owner/path" (such as "myorg/myrepo").
181-
//
198+
// - "{host}" is replaced with the Bitbucket Cloud URL's host (such as bitbucket.org), and "{nameWithOwner}" is replaced with the Bitbucket Cloud repository's "owner/path" (such as "myorg/myrepo").
182199
// For example, if your Bitbucket Cloud is https://bitbucket.org and your Sourcegraph is https://src.example.com, then a repositoryPathPattern of "{host}/{nameWithOwner}" would mean that a Bitbucket Cloud repository at https://bitbucket.org/alice/my-repo is available on Sourcegraph at https://src.example.com/bitbucket.org/alice/my-repo.
183-
//
184200
// It is important that the Sourcegraph repository name generated with this pattern be unique to this code host. If different code hosts generate repository names that collide, Sourcegraph's behavior is undefined.
185201
"repositoryPathPattern": "{host}/{nameWithOwner}",
186202

187203
// An array of team names identifying Bitbucket Cloud teams whose repositories should be mirrored on Sourcegraph.
188-
"teams": null,
189204
// Other example values:
190-
// - ["name"]
205+
// - [
206+
// "name"
207+
// ]
191208
// - [
192209
// "kubernetes",
193210
// "golang",
194211
// "facebook"
195212
// ]
213+
"teams": null,
196214

215+
// REQUIRED:
197216
// URL of Bitbucket Cloud, such as https://bitbucket.org. Generally, admin should not modify the value of this option because Bitbucket Cloud is a public hosting platform.
198-
"url": null,
199217
// Other example values:
200218
// - "https://bitbucket.org"
219+
"url": null,
201220

202221
// The username to use when authenticating to the Bitbucket Cloud. Also set the corresponding "appPassword" field.
203222
"username": null,
204223

224+
// ⚠️ DEPRECATED: Deprecated in favour of first class webhooks. See https://sourcegraph.com/docs/admin/config/webhooks/incoming#deprecation-notice
205225
// A shared secret used to authenticate incoming webhooks (minimum 12 characters).
206226
"webhookSecret": null
207227
}
208228
```
209229
{/* SCHEMA_SYNC_END: admin/code_hosts/bitbucket_cloud.schema.json */}
210-
211230
## Webhooks
212231

213232
Using the `webhooks` property on the external service has been deprecated.

0 commit comments

Comments
 (0)