Merge pull request #1878 from YashodhaSamarawickrama/azure-devops-support

ThusharaSampath · web-flow · commit ae6bb1ca81f7 · 2025-12-22T11:42:13.000+05:30
Update docs to include support for Azure DevOps
diff --git a/en/developer-docs/docs/develop-components/develop-components-with-git.md b/en/developer-docs/docs/develop-components/develop-components-with-git.md
@@ -1,6 +1,6 @@
 # Develop Components With Git
 
-Choreo enables you to develop components by connecting your GitHub, Bitbucket, or GitLab repository. You have the flexibility to either connect an existing repository or start with an empty repository and commit the source code later. By integrating your repositories with Choreo, you can automate tasks and optimize workflows across multiple systems, all within the Choreo platform.  Choreo currently supports GitHub, Bitbucket, and GitLab as Git providers. 
+Choreo enables you to develop components by connecting your GitHub, Bitbucket, GitLab or Azure DevOps repository. You have the flexibility to either connect an existing repository or start with an empty repository and commit the source code later. By integrating your repositories with Choreo, you can automate tasks and optimize workflows across multiple systems, all within the Choreo platform.  Choreo currently supports GitHub, Bitbucket, GitLab and Azure DevOps as Git providers. 
 
 !!! tip
     Choreo supports both Bitbucket Server and Bitbucket Cloud. The currently supported Bitbucket Server version is 8.9.2.
@@ -104,3 +104,13 @@ Authorizing using a personal access token (PAT) obtained from your GitLab self-m
 |Permission    | Description                                                                         |
 |--------------|-------------------------------------------------------------------------------------|
 |API           | Grants full read/write access to the API, covering all groups and projects, as well as read/write access to the repository.|
+
+## Authorize Azure DevOps with Choreo
+
+Authorizing Choreo using a Personal Access Token (PAT) from Azure DevOps grants Choreo the following permissions to perform actions on your behalf within the selected organization and project.
+
+| Permission   | Read | Write | Description                                                                                           | 
+|--------------|------|-------|------------------------------------------------------------------------------------------------------ |
+| Project      | Y    | N     | Read project metadata to identify and validate the selected Azure DevOps project                      |
+| Team         | Y    | N     | Read team and organization-level information required for repository access                           |
+| Code         | Y    | Y     | Read repository content and branches, and create branches or commits when initializing components     |
diff --git a/en/developer-docs/docs/references/faq.md b/en/developer-docs/docs/references/faq.md
@@ -36,7 +36,7 @@ If you have a log monitoring product or service, such as Azure Monitor, you can
 Choreo allows a maximum request payload size of 50 MB.
 
 ### Q: What source control software does Choreo support?
-Choreo now supports GitHub, Bitbucket and GitLab.
+Choreo now supports GitHub, Bitbucket, GitLab and Azure DevOps.
 
 ### Q: Why don't I see the undeployed builds for my component in Choreo?
 You are allowed to build your component any number of times. However, Choreo has a limit on retaining undeployed builds. For users on the free-tier, Choreo will retain **only one** undeployed build. For those on any other tier, Choreo will retain the **latest five** undeployed builds.
diff --git a/en/developer-docs/docs/what-is-choreo.md b/en/developer-docs/docs/what-is-choreo.md
@@ -21,7 +21,7 @@
 ### Development
 - **Language Flexibility**: Use your preferred programming languages to build services, APIs, tasks, and event handlers without changing tools or workflows.
 - **VS Code Integration**: Collaborate and manage code using Visual Studio Code, with support for a familiar, feature-rich development environment.
-- **Git Integration**: Connect to Git-based platforms such as GitHub, Bitbucket, or GitLab by linking an existing repository to develop components.
+- **Git Integration**: Connect to Git-based platforms such as GitHub, Bitbucket, GitLab or Azure DevOps by linking an existing repository to develop components.
 
 ### Deployment
 - **CI/CD**: Automate builds and deployments using Choreo’s integrated CI/CD pipelines. Supports customizable workflows and deployment tracks.
diff --git a/en/pe-docs/docs/infrastructure/credentials/set-up-git-provider-authentication-for-choreo-deployments.md b/en/pe-docs/docs/infrastructure/credentials/set-up-git-provider-authentication-for-choreo-deployments.md
@@ -1,6 +1,6 @@
 # Set Up Git Provider Authentication for Choreo Deployments
 
-Choreo enables you to develop components by connecting your GitHub, Bitbucket, or GitLab repository. You have the flexibility to either connect an existing repository or start with an empty repository and commit the source code later. By integrating your repositories with Choreo, you can automate tasks and optimize workflows across multiple systems, all within the Choreo platform.  Choreo currently supports GitHub, Bitbucket, and GitLab as Git providers. 
+Choreo enables you to develop components by connecting your GitHub, Bitbucket, GitLab or Azure DevOps repository. You have the flexibility to either connect an existing repository or start with an empty repository and commit the source code later. By integrating your repositories with Choreo, you can automate tasks and optimize workflows across multiple systems, all within the Choreo platform.  Choreo currently supports GitHub, Bitbucket, GitLab and Azure DevOps as Git providers. 
 
 !!! tip
     Choreo supports both Bitbucket Server and Bitbucket Cloud. The currently supported Bitbucket Server version is 8.9.2.
@@ -9,7 +9,7 @@ In Choreo, you can connect a Git repository that contains some source code or a
 
 ## Connect a Git repository to Choreo
 
-You can connect Bitbucket, Gitlab repositories to choreo organization using a Personal Access Token(PAT). For github, the developers can install  [WSO2 Cloud App](https://github.com/marketplace/choreo-apps) during component creation and get necessary permissions via Github itself.
+You can connect Bitbucket, GitLab, Azure DevOps repositories to choreo organization using a Personal Access Token (PAT). For GitHub, the developers can install  [WSO2 Cloud App](https://github.com/marketplace/choreo-apps) during component creation and get necessary permissions via GitHub itself.
 
 1. Sign in to the [Choreo Console](https://console.choreo.dev/).
 2. In the Choreo Console header, go to the **Organization** list and select your organization. 
@@ -49,3 +49,13 @@ Authorizing using a personal access token (PAT) obtained from your GitLab self-m
 |Permission    | Description                                                                         |
 |--------------|-------------------------------------------------------------------------------------|
 |API           | Grants full read/write access to the API, covering all groups and projects, as well as read/write access to the repository.|
+
+## Authorize Azure DevOps with Choreo
+
+Authorizing Choreo using a Personal Access Token (PAT) from Azure DevOps grants Choreo the following permissions to perform actions on your behalf within the selected organization and project.
+
+| Permission   | Read | Write | Description                                                                                           | 
+|--------------|------|-------|------------------------------------------------------------------------------------------------------ |
+| Project      | Y    | N     | Read project metadata to identify and validate the selected Azure DevOps project                      |
+| Team         | Y    | N     | Read team and organization-level information required for repository access                           |
+| Code         | Y    | Y     | Read repository content and branches, and create branches or commits when initializing components     |
diff --git a/en/pe-docs/docs/references/faq.md b/en/pe-docs/docs/references/faq.md
@@ -36,7 +36,7 @@ If you have a log monitoring product or service, such as Azure Monitor, you can
 Choreo allows a maximum request payload size of 50 MB.
 
 ### Q: What source control software does Choreo support?
-Choreo now supports GitHub, Bitbucket and GitLab.
+Choreo now supports GitHub, Bitbucket, GitLab and Azure DevOps.
 
 ### Q: Why don't I see the undeployed builds for my component in Choreo?
 You are allowed to build your component any number of times. However, Choreo has a limit on retaining undeployed builds. For users on the free-tier, Choreo will retain **only one** undeployed build. For those on any other tier, Choreo will retain the **latest five** undeployed builds.
diff --git a/en/pe-docs/docs/what-is-choreo.md b/en/pe-docs/docs/what-is-choreo.md
@@ -20,7 +20,7 @@ Choreo is designed to reduce the cognitive and operational load for developers w
 - **Flexible Deployments**: Run Choreo on your existing infrastructure with no vendor lock-in.
 
 ### Application Delivery
-- **Seamless Git Integration**: Native integration with GitHub, BitBucket, and GitLab to support GitOps-based workflows.
+- **Seamless Git Integration**: Native integration with GitHub, BitBucket, GitLab and Azure DevOps to support GitOps-based workflows.
 - **Automated CI/CD Pipelines**: Automates build and deployment pipelines with support for extensions using Argo Workflows.
 - **Secrets & Config Management**: Securely manage secrets, configurations, and configurations for API gateways natively within the platform.
 
@@ -37,7 +37,7 @@ Choreo is designed to reduce the cognitive and operational load for developers w
 
 ### Developer Self-Service Portal
 - **Internal Marketplace**: Provide a centralized hub for developers to discover and reuse existing services and resources  across the organization, fostering collaboration and reuse.
-- **Instant Onboarding**: Connect apps from Git repos (GitHub, GitLab, Bitbucket) or container registries for easy onboarding and CI/CD-driven deployments to any environment.
+- **Instant Onboarding**: Connect apps from Git repos (GitHub, GitLab, Bitbucket, Azure DevOps) or container registries for easy onboarding and CI/CD-driven deployments to any environment.
 - **Self-Service Observability**: Enable teams to access logs, metrics, and insights with built-in access controls, allowing real-time monitoring and issue diagnosis.
 
 ### Unified Portal for Platform Engineers
