Skip to content

Commit ad45ed2

Browse files
committed
Update admin/code_hosts/azuredevops.schema.json schema for v6.5.1211
1 parent e23a4a5 commit ad45ed2

File tree

1 file changed

+65
-30
lines changed

1 file changed

+65
-30
lines changed

docs/admin/code_hosts/azuredevops.mdx

Lines changed: 65 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -67,68 +67,103 @@ 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-01T22:00:52Z 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
// - [
80-
// {
81-
// "name": "myorg/myproject/myrepo"
82-
// }
83-
// ]
81+
// - {
82+
// - "name": "myorg/myproject/myrepo"
83+
// - }
84+
// - ]
8485
// - [
85-
// {
86-
// "name": "myorg/myproject/myrepo"
87-
// },
88-
// {
89-
// "name": "myorg/myproject/myotherrepo"
90-
// },
91-
// {
92-
// "pattern": "^topsecretproject/.*"
93-
// }
94-
// ]
86+
// - {
87+
// - "name": "myorg/myproject/myrepo"
88+
// - },
89+
// - {
90+
// - "name": "myorg/myproject/myotherrepo"
91+
// - },
92+
// - {
93+
// - "pattern": "^topsecretproject/.*"
94+
// - }
95+
// - ]
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"]
107115
// - [
108-
// "kubernetes",
109-
// "golang",
110-
// "facebook"
111-
// ]
116+
// - "name"
117+
// - ]
118+
// - [
119+
// - "kubernetes",
120+
// - "golang",
121+
// - "facebook"
122+
// - ]
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
## Configuration Notes
133168

134169
### Token Requirements

0 commit comments

Comments
 (0)