From cda455259f18f77e8d5992d0980f44cace65e50c Mon Sep 17 00:00:00 2001
From: naokihaba <59875779+naokihaba@users.noreply.github.com>
Date: Mon, 24 Aug 2026 20:47:15 +0900
Subject: [PATCH 1/2] docs: add Azure Pipelines integration details to CI guide

---
 docs/guide/ci.md | 37 +++++++++++++++++++++++++++++++++++--
 1 file changed, 35 insertions(+), 2 deletions(-)

diff --git a/docs/guide/ci.md b/docs/guide/ci.md
index d6f035d709..33eb97d80f 100644
--- a/docs/guide/ci.md
+++ b/docs/guide/ci.md
@@ -4,7 +4,7 @@ You can use `voidzero-dev/setup-vp` to use Vite+ in CI environments.
 
 ## Overview
 
-[`voidzero-dev/setup-vp`](https://github.com/voidzero-dev/setup-vp) provides integrations for GitHub Actions and GitLab CI/CD. Both install Vite+ and can install project dependencies. The GitHub Action can also set up Node.js and cache package manager data automatically, while the GitLab CI/CD template uses the Node.js runtime and cache configuration provided by the job.
+[`voidzero-dev/setup-vp`](https://github.com/voidzero-dev/setup-vp) provides integrations for GitHub Actions, GitLab CI/CD, and Azure Pipelines. All three install Vite+ and can install project dependencies. The GitHub Action and Azure Pipelines template can also set up Node.js and cache package manager data automatically, while the GitLab CI/CD template uses the Node.js runtime and cache configuration provided by the job.
 
 ## setup-vp Versioning
 
@@ -35,7 +35,7 @@ When you use a commit SHA, add the exact release tag in a comment. Renovate uses
 - uses: voidzero-dev/setup-vp@<commit-sha> # <setup-vp-version>
 ```
 
-These settings apply only to GitHub Actions workflows. For GitLab CI/CD, update both version values together.
+These settings apply only to GitHub Actions workflows. For GitLab CI/CD and Azure Pipelines, update both version values together.
 
 ## GitHub Actions
 
@@ -85,6 +85,39 @@ The GitLab CI/CD integration differs from the GitHub Action in a few ways:
 
 For advanced configuration and the complete input reference, see the [`setup-vp` GitLab CI/CD documentation](https://github.com/voidzero-dev/setup-vp#gitlab-cicd).
 
+## Azure Pipelines
+
+Use the reusable `setup-vp` step template in your Azure Pipelines configuration. Create a GitHub service connection named `github`, then set the repository `ref` and `setupRef` to the same release tag or commit SHA:
+
+```yaml [azure-pipelines.yml]
+resources:
+  repositories:
+    - repository: setupVp
+      type: github
+      endpoint: github
+      name: voidzero-dev/setup-vp
+      ref: refs/tags/<setup-vp-version>
+
+pool:
+  vmImage: ubuntu-latest
+
+steps:
+  - checkout: self
+  - template: azure/setup-vp.yml@setupVp
+    parameters:
+      setupRef: '<setup-vp-version>'
+      nodeVersion: 24.x
+      cache: true
+      runInstall: true
+  - script: vp check
+  - script: vp test
+  - script: vp build
+```
+
+The Azure Pipelines template supports Microsoft-hosted Linux, macOS, and Windows agents. It uses Azure's native `UseNode@1` and `Cache@2` tasks to set up Node.js and cache package-manager data.
+
+For advanced configuration and the complete parameter reference, see the [`setup-vp` Azure Pipelines documentation](https://github.com/voidzero-dev/setup-vp#azure-pipelines).
+
 ## Simplifying Existing Workflows
 
 If you are migrating an existing GitHub Actions workflow, you can often replace large blocks of Node, package-manager, and cache setup with a single `setup-vp` step.

From 67af9116a541030b42009c55dbb3a18cd255a48c Mon Sep 17 00:00:00 2001
From: naokihaba <59875779+naokihaba@users.noreply.github.com>
Date: Mon, 24 Aug 2026 21:01:20 +0900
Subject: [PATCH 2/2] docs: update Azure Pipelines instructions for setup-vp
 template usage

---
 docs/guide/ci.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/docs/guide/ci.md b/docs/guide/ci.md
index 33eb97d80f..c64fe477ff 100644
--- a/docs/guide/ci.md
+++ b/docs/guide/ci.md
@@ -87,7 +87,7 @@ For advanced configuration and the complete input reference, see the [`setup-vp`
 
 ## Azure Pipelines
 
-Use the reusable `setup-vp` step template in your Azure Pipelines configuration. Create a GitHub service connection named `github`, then set the repository `ref` and `setupRef` to the same release tag or commit SHA:
+Use the reusable `setup-vp` step template in your Azure Pipelines configuration. Create a GitHub service connection named `github`, then reference the template from the `setup-vp` repository:
 
 ```yaml [azure-pipelines.yml]
 resources:
@@ -114,6 +114,8 @@ steps:
   - script: vp build
 ```
 
+Pin `ref` and `setupRef` to the same tag or commit SHA for strict reproducibility.
+
 The Azure Pipelines template supports Microsoft-hosted Linux, macOS, and Windows agents. It uses Azure's native `UseNode@1` and `Cache@2` tasks to set up Node.js and cache package-manager data.
 
 For advanced configuration and the complete parameter reference, see the [`setup-vp` Azure Pipelines documentation](https://github.com/voidzero-dev/setup-vp#azure-pipelines).