From 117eda84cefd133d4e750ca5ee16af0fde4291d4 Mon Sep 17 00:00:00 2001 From: Muiris Woulfe Date: Mon, 4 Mar 2024 08:40:43 +0000 Subject: [PATCH] Documentation: Adding Classic Azure DevOps details (#471) There is a lack of documentation about how to set up PR Metrics using classic (UI) pipelines in Azure DevOps, which can cause confusion, particularly around gaining access to secrets. This change adds the relevant information, making it easier for people to set this up. --- docs/azure-pipelines-task.md | 23 +++++++++++++++++++++++ docs/images/task-definition.png | Bin 0 -> 19794 bytes docs/images/variable-definition.png | Bin 0 -> 26206 bytes 3 files changed, 23 insertions(+) create mode 100644 docs/images/task-definition.png create mode 100644 docs/images/variable-definition.png diff --git a/docs/azure-pipelines-task.md b/docs/azure-pipelines-task.md index 6cee05cd..04835b14 100644 --- a/docs/azure-pipelines-task.md +++ b/docs/azure-pipelines-task.md @@ -66,6 +66,29 @@ steps: continueOnError: true ``` +## Classic Pipelines + +For classic pipelines, you need to specify the secret as an environment +variable. + +First, create a new environment variable in the pipeline definition under the +variables tab with the name `PR_Metrics_Access_Token` and the value of the PAT +as outlined above. Mark the variable as a secret to ensure it is not exposed in +the logs. + +![Screenshot of the variable definition](images/variable-definition.png) + +Then, add the task to the pipeline and expose the secret as an environment +variable. To do this, expand the "Environment Variables" section and press "+" +to add a new variable. In the first text box, add `PR_METRICS_ACCESS_TOKEN` and +in the second, add `$(PR_Metrics_Access_Token)`. + +![Screenshot of the task definition](images/task-definition.png) + +You can use a name other than `PR_Metrics_Access_Token` if you wish, but you +will need to keep the name unified across the variable and task definitions. The +name `PR_METRICS_ACCESS_TOKEN` cannot be altered. + ## Always Close Comment The `AlwaysCloseComment` option is not available for GitHub PRs as the main size diff --git a/docs/images/task-definition.png b/docs/images/task-definition.png new file mode 100644 index 0000000000000000000000000000000000000000..2ebfe0a11c2e71dd877846feb55bbe3bac93894d GIT binary patch literal 19794 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 literal 0 HcmV?d00001 diff --git a/docs/images/variable-definition.png b/docs/images/variable-definition.png new file mode 100644 index 0000000000000000000000000000000000000000..fec24ae23519e81a6b78d8db9ce94214e239b9bf GIT binary patch literal 26206 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