feat: add azure devops support by olblak · Pull Request #8586 · updatecli/updatecli

olblak · 2026-04-24T20:20:40Z

This pull request introduces support for Azure DevOps.

The scm kind azuredevops can now be used to interact with Azure DevOps repositories.
The scm kind azuredevopssearch is a special scm plugin that allows to interact with all Azure DevOps repositories from an organization matching specific regex rules.
The action of kind azuredevops/pullrequest can be used to automatically open pull request on a Azure DevOps repository. This action is compatible with the scm of kind azuredevops and azuredevopssearch

When a scm is specified then Updatecli clone the repository in a temporary location and run all git operation from there.

Credentials

Credentials can be specified either using the spec parameter username and token, or using the environment variable
UPDATECLI_AZURE_DEVOPS_USERNAME and UPDATECLI_AZURE_DEVOPS_TOKEN. The token must be a Personal Access Token (PAT) with the appropriate permissions to access the repositories and create pull requests.
If the environment variable is specified, then it overrides the credentials specified in the spec parameters.

Examples

Azure DevOps repository

scms:
  default:
    kind: azuredevops
    spec:
      organization: updatecli
      project: "updatecli"
      repository: "updatecli-test"
      branch: main
      username: xxx
      token: yyy
actions:
  default:
    kind: azuredevops/pullrequest
    scmid: default

Azure DevOps Search

scms:
  azuredevops:
    kind: azuredevopssearch
    spec:
      organization: updatecli
      #project: ".*" # Optional
      #repository: ".*" # Optional
      branch: "^main$"
      username: xxx
      token: yyy

actions:
  default:
    kind: azuredevops/pullrequest
    scmid: azuredevops

Test

To test this pull request, you can run the following commands:

cd <to_package_directory>
go test

Additional Information

Checklist

I have updated the documentation via pull request in website repository.

Tradeoff

Potential improvement

Signed-off-by: Olblak <me@olblak.com>

Copilot

Pull request overview

Adds first-class Azure DevOps support to Updatecli by introducing an Azure DevOps SCM implementation, an azuredevopssearch SCM for repository/branch discovery, and an Azure DevOps pull request action, then wires them into the pipeline engine, JSON schema generation, scaffolding templates, and e2e configs.

Changes:

Introduce Azure DevOps SCM (azuredevops) plus summary helpers/tests.
Add Azure DevOps repo/branch discovery SCM (azuredevopssearch) with generator + tests.
Add Azure DevOps pull request action/resource implementation (create/exist/clean) with tests, and integrate into engine/pipeline/schema/scaffold/e2e.

Reviewed changes

Copilot reviewed 28 out of 29 changed files in this pull request and generated 10 comments.

Show a summary per file

File	Description
pkg/plugins/scms/azuredevopssearch/main.go	New `azuredevopssearch` SCM constructor and client wiring
pkg/plugins/scms/azuredevopssearch/spec.go	`azuredevopssearch` spec definition + validation/sanitization
pkg/plugins/scms/azuredevopssearch/specGenerator.go	Project/repo/branch discovery and spec generation
pkg/plugins/scms/azuredevopssearch/description.go	Summary output for `azuredevopssearch`
pkg/plugins/scms/azuredevopssearch/main_test.go	Tests for defaults/sanitization and invalid regex
pkg/plugins/scms/azuredevopssearch/specGenerator_test.go	Tests for discovery behavior and limits
pkg/plugins/scms/azuredevops/main.go	Azure DevOps SCM implementation (clone/checkout/commit/push/etc.)
pkg/plugins/scms/azuredevops/summary.go	Summary formatting for Azure DevOps SCM
pkg/plugins/scms/azuredevops/summary_test.go	Tests for summary formatting (incl. URL credentials stripping)
pkg/plugins/resources/azuredevops/client/main.go	Azure DevOps API client (PAT connection + core/git clients)
pkg/plugins/resources/azuredevops/client/spec.go	Azure DevOps client spec + URL helpers (GitURL / PullRequestURL)
pkg/plugins/resources/azuredevops/pullrequest/main.go	Azure DevOps pull request action constructor + SCM inheritance
pkg/plugins/resources/azuredevops/pullrequest/spec.go	Pull request action spec definition
pkg/plugins/resources/azuredevops/pullrequest/utils.go	PR/branch helper logic (find PR, ref lookup, iteration checks)
pkg/plugins/resources/azuredevops/pullrequest/exist.go	Action “exist” check implementation
pkg/plugins/resources/azuredevops/pullrequest/create.go	PR create/update implementation and body generation
pkg/plugins/resources/azuredevops/pullrequest/clean.go	Cleanup logic (close empty PRs)
pkg/plugins/resources/azuredevops/pullrequest/main_test.go	Tests for action constructor + refName helper
pkg/plugins/resources/azuredevops/pullrequest/create_test.go	Tests for PR body generation/merge behavior
pkg/plugins/resources/azuredevops/pullrequest/clean_test.go	Tests for PR cleanup helpers (iterations/refs/head-match retry)
pkg/core/pipeline/scm/main.go	Register `azuredevops` SCM and `azuredevopssearch` kind handling
pkg/core/pipeline/scm/config.go	Include Azure DevOps kinds in SCM JSON schema “oneOf”
pkg/core/engine/configuration.go	Expand `azuredevopssearch` into multiple concrete SCM pipelines
pkg/core/pipeline/action/main.go	Register `azuredevops/pullrequest` action handler + JSON schema
pkg/core/pipeline/action/main_test.go	Add validation test case for azuredevops action kind normalization
pkg/core/scaffold/assets/updatecli.d/_scm.azuredevops.yaml	Add scaffold partial for Azure DevOps SCM + PR action
e2e/updatecli.d/success.d/azuredevops/scm.yaml	Add e2e pipeline manifest for Azure DevOps SCM + PR action
go.mod	Add Azure DevOps Go SDK dependencies
go.sum	Dependency checksum updates

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Signed-off-by: Olblak <me@olblak.com>

Don't make project and repository required on the client creation Signed-off-by: Olblak <me@olblak.com>

Signed-off-by: Olblak <me@olblak.com>

Copilot

Pull request overview

Copilot reviewed 28 out of 29 changed files in this pull request and generated 5 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Signed-off-by: Olblak <me@olblak.com>

Copilot

Pull request overview

Copilot reviewed 29 out of 30 changed files in this pull request and generated 5 comments.

+	t.Run("merges existing markdown body for pull request updates", func(t *testing.T) {
+		report := &reports.Action{
+			Title:       "test",
+			Description: "new update description",
+		}
+		pr := AzureDevOps{}
+
+		got, err := pr.pullRequestBody("existing body", report, true)
+		require.NoError(t, err)
+
+		mergedDescription, err := reports.MergeFromMarkdown("existing body", report.ToActionsMarkdownString())
+		require.NoError(t, err)
+
+		expected, err := utils.GeneratePullRequestBodyMarkdown("", mergedDescription)
+		require.NoError(t, err)
+
+		assert.Equal(t, expected, got)


+      # {{ if .scm.email }}
+      email: '{{ .scm.email }}'
+      # {{ end }}
+      url: '{{ .scm.url }}'


+// Clone runs `git clone`.
+func (a *AzureDevOps) Clone() (string, error) {
+
+	// This global is shared across all SCMs/pipelines in the same process,
+	// Clone() mutates the global go-git setting transport.UnsupportedCapabilities and then need to be restored.
+	// otherwise it can cause surprising behavior (and data races) when multiple pipelines run or
+	// when other SCMs clone/fetch after an Azure DevOps clone.
+	currentUnsupportedCapabilities := transport.UnsupportedCapabilities
+	defer func() {
+		transport.UnsupportedCapabilities = currentUnsupportedCapabilities
+	}()
+
+	transport.UnsupportedCapabilities = []capability.Capability{
+		capability.ThinPack,


+
+const (
+	DefaultRepositoryLimit = 10
+	ErrOrganizationEmpty   = "azure DevOps organization is required for azuredevopssearch SCM"


+type Spec struct {
+	// Organization defines the Azure DevOps organization URL to interact with.
+	Organization string `yaml:",omitempty"`
+	// "url" defines the Azure DevOps organization URL to interact with.
+	URL string `yaml:",omitempty"`
+	// "project" defines the Azure DevOps project containing the repository.
+	Project string `yaml:",omitempty" jsonschema:"required"`
+	// "repository" defines the Azure DevOps repository name.
+	Repository string `yaml:",omitempty" jsonschema:"required"`
+	// "username" defines the username used for git authentication.
+	Username string `yaml:",omitempty"`
+	// "token" specifies the personal access token used to authenticate with Azure DevOps.
+	Token string `yaml:",omitempty"`
+}
+
+// Validate validates that a spec contains the required Azure DevOps settings.
+func (s Spec) Validate() error {
+	missingParameters := []string{}
+
+	if s.Organization == "" {
+		missingParameters = append(missingParameters, "organization")
+	}
+
+	if len(missingParameters) > 0 {
+		logrus.Errorf("missing parameter(s) [%s]", strings.Join(missingParameters, ","))
+		return fmt.Errorf("wrong azure devops configuration")
+	}
+
+	return nil
+}


Signed-off-by: Olblak <me@olblak.com>

feat: add azure devops support

09e0816

Signed-off-by: Olblak <me@olblak.com>

olblak added enhancement New feature or request scm-azuredevops labels Apr 24, 2026

olblak marked this pull request as draft April 24, 2026 20:20

olblak added 6 commits April 25, 2026 10:02

feat: add azuredevops e2e test

f63c5b8

Signed-off-by: Olblak <me@olblak.com>

chore: add organization parameter

5cf04ae

fix: align azure devops pr body with bitbucket

346544b

Signed-off-by: Olblak <me@olblak.com>

fix: add missing test

be21b62

Signed-off-by: Olblak <me@olblak.com>

fix: add missing azuredevops policy scaffold asset

e54a07a

Signed-off-by: Olblak <me@olblak.com>

feat: add azuredevopssearch to update multiple repositories

18c7a65

Signed-off-by: Olblak <me@olblak.com>

olblak marked this pull request as ready for review April 26, 2026 12:16

Merge branch 'main' into issue/7090

fd0a993

olblak requested a review from Copilot April 26, 2026 12:16

Copilot started reviewing on behalf of olblak April 26, 2026 12:16 View session

Copilot AI reviewed Apr 26, 2026

View reviewed changes

olblak and others added 6 commits April 26, 2026 14:27

Merge branch 'main' into issue/7090

6afc516

Merge branch 'main' into issue/7090

b22f5aa

chore: go mod tidy

0019d6b

Signed-off-by: Olblak <me@olblak.com>

chore: make projet and repository optional

aec2766

Don't make project and repository required on the client creation Signed-off-by: Olblak <me@olblak.com>

fix: correctly restore unsupportedCapabilities

0a0e665

Signed-off-by: Olblak <me@olblak.com>

feat: support reset pullrequest description

a8e6040

Signed-off-by: Olblak <me@olblak.com>

olblak requested a review from Copilot April 27, 2026 11:25

Copilot started reviewing on behalf of olblak April 27, 2026 11:26 View session

Copilot AI reviewed Apr 27, 2026

View reviewed changes

Comment thread pkg/plugins/scms/azuredevops/main.go

Comment thread pkg/core/pipeline/action/main.go

Comment thread pkg/plugins/resources/azuredevops/client/spec.go

Comment thread e2e/updatecli.d/success.d/azuredevops/scm.yaml Outdated

Comment thread e2e/updatecli.d/success.d/azuredevops/scm.yaml

olblak and others added 6 commits May 2, 2026 11:53

Merge branch 'main' into issue/7090

86baf5d

feat: allow to use global env variable to auth on azure devops

eed6796

Signed-off-by: Olblak <me@olblak.com>

fix: azuredevops/pullrequest test

69bf0fa

Signed-off-by: Olblak <me@olblak.com>

Merge branch 'main' into issue/7090

526c60a

fix: e2e pipeline title

c9af8d8

Signed-off-by: Olblak <me@olblak.com>

Merge branch 'issue/7090' of github.com:olblak/updatecli into issue/7090

2512001

olblak added 2 commits May 6, 2026 22:08

fix: git capabilities reset

58ac567

Signed-off-by: Olblak <me@olblak.com>

feat: allow azuredevopssearch to search all project by default

21c6f03

Signed-off-by: Olblak <me@olblak.com>

olblak requested a review from Copilot May 6, 2026 20:14

Copilot started reviewing on behalf of olblak May 6, 2026 20:15 View session

Copilot AI reviewed May 6, 2026

View reviewed changes

olblak and others added 11 commits May 6, 2026 22:37

fix: use filtercontain

0708d26

Signed-off-by: Olblak <me@olblak.com>

fix: add missing organisation in scaffold config

ae41582

Signed-off-by: Olblak <me@olblak.com>

Merge branch 'main' into issue/7090

72a0f48

Merge branch 'main' into issue/7090

f533cb4

doc: update README.md to mention scm

8002126

Signed-off-by: Olblak <me@olblak.com>

Merge branch 'issue/7090' of github.com:olblak/updatecli into issue/7090

bb68d4f

doc: remove toc

c9bebcc

Signed-off-by: Olblak <me@olblak.com>

fix: e2e test

5360368

Signed-off-by: Olblak <me@olblak.com>

Merge branch 'main' into issue/7090

0af38bc

Fix e2e test to ignore warning: content

62519fd

Signed-off-by: Olblak <me@olblak.com>

Merge branch 'issue/7090' of github.com:olblak/updatecli into issue/7090

a5da238

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat: add azure devops support#8586

feat: add azure devops support#8586
olblak wants to merge 33 commits into
updatecli:mainfrom
olblak:issue/7090

olblak commented Apr 24, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

olblak commented Apr 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Examples

Azure DevOps repository

Azure DevOps Search

Test

Additional Information

Checklist

Tradeoff

Potential improvement

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

olblak commented Apr 24, 2026 •

edited

Loading