Использование предопределенных переменных

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Переменные дают вам удобный способ переноса ключевых бит данных в различные части вашего конвейера. Здесь приведен список заранее определенных переменных, доступных вам для применения. Существует несколько других предопределенных переменных, но они в основном для внутреннего использования.

Эти переменные автоматически задаются системой и доступны только для чтения. (Исключения: Build.Clean и System.Debug.)

В конвейерах YAML можно ссылаться на предопределенные переменные как переменные среды. Например, переменная Build.ArtifactStagingDirectory становится переменной BUILD_ARTIFACTSTAGINGDIRECTORY.

Для классических конвейеров можно использовать переменные выпуска в задачах развертывания для совместного использования общих сведений (например, имени среды, группы ресурсов и т. д.).

Узнайте больше о работе с переменными.

Build.Clean

Это нерекомендуемая переменная, которая изменяет способ очистки источника агента сборки. Сведения о том, как очистить источник, см. в статье "Очистка локального репозитория" агента.

System.AccessToken

System.AccessToken — это специальная переменная, которая несет маркер безопасности, используемый выполняющейся сборкой.

YAML

В YAML необходимо явно сопоставить System.AccessToken конвейер с помощью переменной. Это можно сделать на шаге или уровне задач:

steps:
  - script: |
      echo "Using System.AccessToken to authenticate"
      git clone https://$(System.AccessToken)@dev.azure.com/yourorganization/yourproject/_git/yourrepository
    displayName: 'Clone repository using System.AccessToken'
    env:
      SYSTEM_ACCESSTOKEN: $(System.AccessToken)

Вы можете настроить область по умолчанию для System.AccessToken использования области авторизации задания сборки.

Классическое

Вы можете разрешить скриптам и задачам доступ к System.AccessToken на уровне задания.

1. Перейдите к заданию

2. В разделе "Дополнительные параметры" установите флажок "Разрешить скрипты", чтобы получить доступ к поле маркера OAuth.

Этот флажок также оставляет набор учетных данных в Git, чтобы вы могли выполнять отправки и извлечения в скриптах.

System.Debug

Для более подробных журналов для отладки проблем конвейера определите System.Debug и задайте для него значение true.

1. Измените конвейер.

2. Выберите Переменные.

3. Добавьте новую переменную с именем System.Debug и значением true.

   

4. Сохраните новую переменную.

Параметр System.Debug настройки true подробных журналов для всех запусков. Подробные журналы можно также настроить для одного запуска с помощью флажка Enable system диагностика.

Можно также задать System.Debug true в качестве переменной в конвейере или шаблоне.

variables:
  system.debug: 'true'

Если System.Debug задано trueзначение , для дополнительной переменной Agent.Diagnostic задано значение true. Когда Agent.Diagnostic это trueтак, агент собирает больше журналов, которые можно использовать для устранения неполадок с сетью для локальных агентов. Дополнительные сведения см. в разделе Сетевая диагностика для локальных агентов.

Примечание.

Переменная Agent.Diagnostic доступна с агентом версии 2.200.0 и выше.

Дополнительные сведения см. в разделе "Просмотр журналов для диагностики проблем конвейера".

Переменные агента (DevOps Services)

Примечание.

Переменные агента можно использовать в качестве переменных среды в скриптах и в качестве параметров в задачах сборки. Их нельзя использовать для настройки номера сборки или применения метки или тега элемента управления версиями.

«Переменная»	Description
Agent.BuildDirectory	Локальный путь агента, в котором создаются все папки для заданного конвейера сборки. Эта переменная имеет то же значение, что Pipeline.Workspaceи . Например: /home/vsts/work/1.
Agent.ContainerMapping	Сопоставление имен ресурсов контейнера в YAML с идентификаторами Docker во время выполнения. Пример следует за таблицей.
Agent.HomeDirectory	Каталог, в который устанавливается агент. Это содержит программное обеспечение агента. Например: c:\agent.
Agent.Id	Идентификатор агента.
Agent.JobName	Имя выполняемого задания. Обычно это будет "Задание"; или "__default", но в сценариях с несколькими конфигурациями будет конфигурация.
Agent.JobStatus	Состояние сборки. Canceled Failed Succeeded SucceededWithIssues (частично успешно) Skipped (последнее задание) Переменная среды должна быть указана как AGENT_JOBSTATUS. Более ранние agent.jobstatus версии доступны для обратной совместимости.
Agent.MachineName	Имя компьютера, на котором установлен агент.
Agent.Name	Имя агента, зарегистрированного в пуле. Если вы используете локальный агент, то это имя указывается вами. См. агенты.
Agent.OS	Операционная система узла агента. Допустимые значения: Windows_NT Darwin Linux Если вы работаете в контейнере, узел агента и контейнер могут работать в разных операционных системах.
Agent.OSArchitecture	Архитектура процессора операционной системы узла агента. Допустимые значения: X86 X64 ARM
Agent.TempDirectory	Временная папка, которая очищается после каждого задания конвейера. Этот каталог используется задачами, такими как задача интерфейса командной строки .NET Core для хранения временных элементов, таких как результаты теста перед публикацией. Например, /home/vsts/work/_temp для Ubuntu.
Agent.ToolsDirectory	Каталог, используемый задачами, такими как установщик инструментов node и использование версии Python для переключения между несколькими версиями средства. Эти задачи добавляют средства из этого каталога PATH , чтобы последующие шаги сборки могли использовать их. Узнайте об управлении этим каталогом в локальном агенте.
Agent.WorkFolder	Рабочий каталог для этого агента. Например: c:\agent_work. Примечание. Этот каталог не гарантируется для записи задачами конвейера (например, при сопоставлении с контейнером)

Пример agent.ContainerMapping:

{
  "one_container": {
    "id": "bdbb357d73a0bd3550a1a5b778b62a4c88ed2051c7802a0659f1ff6e76910190"
  },
  "another_container": {
    "id": "82652975109ec494876a8ccbb875459c945982952e0a72ad74c91216707162bb"
  }
}

Переменные сборки (DevOps Services)

При использовании переменной в шаблоне, который не помечен как доступный в шаблонах, переменная не будет отображаться. Переменная не будет отображаться, так как его значение недоступно в области шаблона.

«Переменная»	Description	Доступно в шаблонах?
Build.ArtifactStagingDirectory	Локальный путь к агенту, в котором копируются артефакты перед отправкой в место назначения. Например: c:\agent_work\1\a. Типичным способом использования этой папки является публикация артефактов сборки с помощью задач копирования файлов и задач публикации артефактов сборки . Примечание. Build.ArtifactStagingDirectory и Build.StagingDirectory являются взаимозаменяемыми. Этот каталог очищается перед каждой новой сборкой, поэтому вам не нужно самостоятельно очистить его. См . артефакты в Azure Pipelines. Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями.	No
Build.BuildId	Идентификатор записи для завершенной сборки.	No
Build.BuildNumber	Имя завершенной сборки, также известное как номер выполнения. Вы можете указать , что входит в это значение. Типичное использование этой переменной заключается в том, чтобы сделать его частью формата меток, который указывается на вкладке репозитория. Примечание. Это значение может содержать пробелы или другие недопустимые символы меток. В таких случаях формат метки завершается ошибкой. Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями.	No
Build.BuildUri	Универсальный код ресурса (URI) для сборки. Например: vstfs:///Build/Build/1430. Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями.	No
Build.BinariesDirectory	Локальный путь агента, который можно использовать в качестве выходной папки для скомпилированных двоичных файлов. По умолчанию новые конвейеры сборки не настроены для очистки этого каталога. Вы можете определить сборку, чтобы очистить ее на вкладке репозитория. Например: c:\agent_work\1\b. Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями.	No
Build.ContainerId	Идентификатор контейнера для артефакта. При отправке артефакта в конвейере он добавляется в контейнер, который относится к конкретному артефакту.	No
Build.CronSchedule.DisplayName	Расписание displayName cron, которое активировало запуск конвейера. Эта переменная устанавливается только в том случае, если запуск конвейера активируется запланированным триггером YAML. Дополнительные сведения см. в определении schedules.cron — Build.CronSchedule.DisplayName	Да
Build.DefinitionName	Имя конвейера сборки. Примечание. Это значение может содержать пробелы или другие недопустимые символы меток. В таких случаях формат метки завершается ошибкой.	Да
Build.DefinitionVersion	Версия конвейера сборки.	Да
Build.QueuedBy	См. статью "Как заданы переменные идентификации?". Примечание. Это значение может содержать пробелы или другие недопустимые символы меток. В таких случаях формат метки завершается ошибкой.	Да
Build.QueuedById	См. статью "Как заданы переменные идентификации?".	Да
Build.Reason	Событие, вызвавшее выполнение сборки. Manual: пользователь вручную застроил сборку. IndividualCI: непрерывная интеграция (CI), активируется принудительной отправкой Git или проверкой TFVC. BatchedCI: непрерывная интеграция (CI), активируется принудительной отправкой Git или возвратом TFVC, и выбраны изменения пакетной службы. Schedule: запланированный триггер. ValidateShelveset: пользователь вручную застроил сборку определенного набора полок TFVC. CheckInShelveset: воротный триггер регистрации . PullRequest: сборка была активирована политикой ветви Git, требующей сборки. BuildCompletion: сборка была активирована другой сборкой ResourceTrigger: сборка была активирована триггером ресурса или была активирована другой сборкой. См . инструкции по триггерам конвейера сборки, улучшению качества кода с помощью политик ветвей.	Да
Build.Repository.Clean	Значение, выбранное для очистки в параметрах исходного репозитория. Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями.	No
Build.Repository.LocalPath	Локальный путь к агенту, в котором скачиваются файлы исходного кода. Например: c:\agent_work\1\s. По умолчанию новые конвейеры сборки обновляют только измененные файлы. Вы можете изменить способ скачивания файлов на вкладке репозитория. Важно отметить: если вы извлекаете только один репозиторий Git, этот путь является точным путем к коду. При извлечении нескольких репозиториев поведение выглядит следующим образом (и может отличаться от значения переменной Build.SourcesDirectory): Если шаг выхода для репозитория самостоятельного (основного) не определен, или путь к извлечению является путь $(Pipeline.Workspace)/s/&<RepoName> по умолчанию для самостоятельного репозитория, значение этой переменной возвращается к значению по умолчанию.$(Pipeline.Workspace)/s Если для самостоятельного (первичного) репозитория установлен пользовательский путь к извлечению (и это не его путь по умолчанию с несколькими заказами), эта переменная содержит точный путь к самостоятельному репозиторию. Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями.	No
Build.Repository.ID	Уникальный идентификатор репозитория. Это не изменится, даже если имя репозитория выполняется. Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями.	No
Build.Repository.Name	Имя триггерного репозитория. Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями.	No
Build.Repository.Provider	Тип триггерного репозитория. TfsGit: репозиторий Git TFS TfsVersionControl: система управления версиями Team Foundation Git: репозиторий Git, размещенный на внешнем сервере GitHub Svn:Ниспровержение Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями.	No
Build.Repository.Tfvc.Workspace	Определяется, система управления версиями Team Foundation ли репозиторий. Имя рабочей области TFVC, используемой агентом сборки. Например, если агент.BuildDirectory c:\agent_work\12 и Agent.Id есть 8, имя рабочей области может быть следующим: ws_12_8 Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями.	No
Build.Repository.Uri	URL-адрес для триггерного репозитория. Например: Git: https://fabrikamfiber@dev.azure.com/fabrikamfiber/_git/Scripts TFVC: https://dev.azure.com/fabrikamfiber/ Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями.	No
Build.RequestedFor	См. статью "Как заданы переменные идентификации?". Примечание. Это значение может содержать пробелы или другие недопустимые символы меток. В таких случаях формат метки завершается ошибкой.	Да
Build.RequestedForEmail	См. статью "Как заданы переменные идентификации?".	Да
Build.RequestedForId	См. статью "Как заданы переменные идентификации?".	Да
Build.SourceBranch	Ветвь триггерного репозитория сборка была помещена в очередь. Некоторые примеры: Ветвь репозитория Git: refs/heads/main Запрос на вытягивание репозитория Git: refs/pull/1/merge Ветвь репозитория TFVC: $/teamproject/main Вход в репозиторий TFVC: Gated_2016-06-06_05.20.51.4369;username@live.com Сборка набора полок репозитория TFVC: myshelveset;username@live.com При активации конвейера тегом: refs/tags/your-tag-name При использовании этой переменной в формате номера сборки символы косой черты (/) заменяются символами _подчеркивания. Примечание. В TFVC, если вы выполняете воротную сборку или вручную создаете набор полок, эту переменную нельзя использовать в формате номера сборки.	Да
Build.SourceBranchName	Имя ветви в триггерном репозитории сборки было в очереди. Ветвь репозитория Git, запрос на вытягивание или тег: последний сегмент пути в ссылке. Например, в refs/heads/main этом значении есть main. В refs/heads/feature/tools этом значении имеется toolsзначение . В refs/tags/your-tag-name этом значении имеется your-tag-nameзначение . Ветвь репозитория TFVC: последний сегмент пути к корневому серверу рабочей области. Например, в $/teamproject/main этом значении есть main. Репозиторий TFVC, включаемые в систему или сборка набора полок, — это имя набора полок. Например, Gated_2016-06-06_05.20.51.4369;username@live.com или myshelveset;username@live.com. Примечание. В TFVC, если вы выполняете воротную сборку или вручную создаете набор полок, эту переменную нельзя использовать в формате номера сборки.	Да
Build.SourcesDirectory	Локальный путь к агенту, в котором скачиваются файлы исходного кода. Например: c:\agent_work\1\s. По умолчанию новые конвейеры сборки обновляют только измененные файлы. Важно отметить: если вы извлекаете только один репозиторий Git, этот путь является точным путем к коду. Если вы извлекаете несколько репозиториев, оно возвращается к значению по умолчанию, то $(Pipeline.Workspace)/sесть, даже если локальный (первичный) репозиторий извлекается в пользовательский путь, отличный от его пути $(Pipeline.Workspace)/s/<RepoName> по умолчанию для нескольких проверок (в этом отношении переменная отличается от поведения переменной Build.Repository.LocalPath). Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями.	No
Build.SourceVersion	Последнее изменение элемента управления версиями триггерного репозитория, включенного в эту сборку. Git: идентификатор фиксации. TFVC: набор изменений. Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями.	Да
Build.SourceVersionMessage	Комментарий фиксации или набора изменений для триггерного репозитория. Мы усечены сообщение на первую строку или 200 символов, в зависимости от того, что меньше. Соответствует Build.SourceVersionMessage сообщению о Build.SourceVersion фиксации. Фиксация Build.SourceVersion для сборки PR — это фиксация слияния (а не фиксация в исходной ветви). Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями. Кроме того, эта переменная доступна только на уровне шага и недоступна на уровнях задания или этапа (т. е. сообщение не извлекается до запуска задания и извлечения кода). Примечание. Эта переменная доступна в TFS 2015.4. Примечание. Переменная Build.SourceVersionMessage не работает с классическими конвейерами сборки в репозиториях Bitbucket при включении пакетной службы при включении сборки.	No
Build.StagingDirectory	Локальный путь к агенту, в котором копируются артефакты перед отправкой в место назначения. Например: c:\agent_work\1\a. Типичным способом использования этой папки является публикация артефактов сборки с помощью задач копирования файлов и задач публикации артефактов сборки . Примечание. Build.ArtifactStagingDirectory и Build.StagingDirectory являются взаимозаменяемыми. Этот каталог очищается перед каждой новой сборкой, поэтому вам не нужно самостоятельно очистить его. См . артефакты в Azure Pipelines. Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями.	No
Build.Repository.Git.SubmoduleCheckout	Значение, выбранное для вложенных модулей checkout, на вкладке репозитория. При извлечении нескольких репозиториев это значение отслеживает параметр триггера репозитория. Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями.	No
Build.SourceTfvcShelveset	Определяется, система управления версиями Team Foundation ли репозиторий. Если вы используете воротную сборку или сборку с набором полок, для этого задано имя набора полок, который вы создаете. Примечание. Эта переменная дает недопустимое значение для использования сборки в формате номера сборки.	No
Build.TriggeredBy.BuildId	Если сборка была активирована другой сборкой, эта переменная имеет значение BuildID триггера сборки. В классических конвейерах эта переменная активируется триггером завершения сборки. Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями. Если вы активируете конвейер YAML, resourcesиспользуйте переменные ресурсов.	No
Build.TriggeredBy.DefinitionId	Если сборка была активирована другой сборкой, эта переменная имеет значение DefinitionID триггера сборки. В классических конвейерах эта переменная активируется триггером завершения сборки. Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями. Если вы активируете конвейер YAML, resourcesиспользуйте переменные ресурсов.	No
Build.TriggeredBy.DefinitionName	Если сборка была активирована другой сборкой, эта переменная имеет имя запускающего конвейера сборки. В классических конвейерах эта переменная активируется триггером завершения сборки. Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями. Если вы активируете конвейер YAML, resourcesиспользуйте переменные ресурсов.	No
Build.TriggeredBy.BuildNumber	Если сборка была активирована другой сборкой, эта переменная имеет значение числа триггерной сборки. В классических конвейерах эта переменная активируется триггером завершения сборки. Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями. Если вы активируете конвейер YAML, resourcesиспользуйте переменные ресурсов.	No
Build.TriggeredBy.ProjectID	Если сборка была активирована другой сборкой, эта переменная имеет идентификатор проекта, содержащего триггерную сборку. В классических конвейерах эта переменная активируется триггером завершения сборки. Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями. Если вы активируете конвейер YAML, resourcesиспользуйте переменные ресурсов.	No
Common.TestResultsDirectory	Локальный путь к агенту, в котором создаются результаты теста. Например: c:\agent_work\1\TestResults. Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями.	No

Переменные конвейера (DevOps Services)

«Переменная»	Description
Pipeline.Workspace	Каталог рабочей области для определенного конвейера. Эта переменная имеет то же значение, что Agent.BuildDirectoryи . Например, /home/vsts/work/1.

Совет

При использовании классических конвейеров выпуска можно использовать классические выпуски и переменные артефактов для хранения и доступа к данным во всем конвейере.

Переменные задания развертывания (DevOps Services)

Эти переменные относятся к определенному заданию развертывания и будут разрешены только во время выполнения задания.

«Переменная»	Description
Environment.Name	Имя среды, целевой в задании развертывания, для выполнения шагов развертывания и записи журнала развертывания. Например, smarthotel-dev.
Environment.Id	Идентификатор среды, целевой в задании развертывания. Например, 10.
Environment.ResourceName	Имя конкретного ресурса в среде, целевой в задании развертывания, для выполнения шагов развертывания и записи журнала развертывания. Например, это пространство имен Kubernetes, bookings которое было добавлено в качестве ресурса в среду smarthotel-dev.
Environment.ResourceId	Идентификатор конкретного ресурса в среде, целевой в задании развертывания для выполнения шагов развертывания. Например, 4.
Strategy.Name	Имя стратегии развертывания: canaryили runOncerolling.
Strategy.CycleName	Текущее имя цикла в развертывании. Параметры: PreIteration, Iterationили PostIteration.

Системные переменные (DevOps Services)

При использовании переменной в шаблоне, который не помечен как доступный в шаблонах, переменная не будет отображаться. Переменная не будет отображаться, так как его значение недоступно в области шаблона.

«Переменная»	Description	Доступно в шаблонах?
System.AccessToken	Используйте маркер OAuth для доступа к REST API. Используйте System.AccessToken из скриптов YAML. Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями.	Да
System.CollectionId	GUID коллекции TFS или организации Azure DevOps.	Да
System.CollectionUri	URI коллекции TFS или организации Azure DevOps. Например: https://dev.azure.com/fabrikamfiber/.	Да
System.DefaultWorkingDirectory	Локальный путь к агенту, в котором скачиваются файлы исходного кода. Например: c:\agent_work\1\s По умолчанию новые конвейеры сборки обновляют только измененные файлы. Вы можете изменить способ скачивания файлов на вкладке репозитория. Эта переменная является областью действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не как часть номера сборки или в качестве тега управления версиями.	Да
System.DefinitionId	Идентификатор конвейера сборки.	Да
System.HostType	Задайте значение build , если конвейер является сборкой. В выпуске значения предназначены deployment для задания группы развертывания, gates во время оценки шлюзов и release для других заданий (агентов и агентов без агента).	Да
System.JobAttempt	Установите значение 1 при первой попытке этого задания и увеличивается каждый раз при повторном выполнении задания.	No
System.JobDisplayName	Имя, доступное для чтения человеком, заданное заданию.	No
System.JobId	Уникальный идентификатор для одной попытки одного задания. Значение уникально для текущего конвейера.	No
System.JobName	Имя задания, обычно используемое для выражения зависимостей и доступа к выходным переменным.	No
System.OidcRequestUri	Создайте проверку подлинности с идентификатором idToken Записи с помощью OpenID Connect (OIDC). Подробнее.	Да
System.PhaseAttempt	Установите значение 1 при первой попытке этого этапа и увеличивается каждый раз при повторном выполнении задания. Примечание. "Этап" является в основном избыточной концепцией, которая представляет время разработки для задания (в то время как задание было версией среды выполнения этапа). В основном мы удалили концепцию "этап" из Azure Pipelines. Матрица и многоконфигурные задания являются единственным местом, где "этап" по-прежнему отличается от "задания". Один этап может создать экземпляры нескольких заданий, которые отличаются только в их входных данных.	No
System.PhaseDisplayName	Читаемое человеком имя, заданное этапу.	No
System.PhaseName	Строковый идентификатор задания, обычно используемый для выражения зависимостей и доступа к выходным переменным.	No
System.PlanId	Строковый идентификатор для одного запуска конвейера.	No
System.PullRequest.IsFork	Если запрос на вытягивание выполняется из вилки репозитория, эта переменная имеет значение True. В противном случае для него задано значение False.	Да
System.PullRequest.PullRequestId	Идентификатор запроса на вытягивание, вызвавшего эту сборку. Например: 17. (Эта переменная инициализирована только в том случае, если сборка запущена из-заGit PR, затронутый политикой ветви).	No
System.PullRequest.PullRequestNumber	Количество запроса на вытягивание, вызвавшего эту сборку. Эта переменная заполняется для запросов на вытягивание из GitHub с другим идентификатором запроса на вытягивание и номером запроса на вытягивание. Эта переменная доступна только в конвейере YAML, если на pr влияет политика ветви.	No
System.PullRequest.targetBranchName	Имя целевой ветви для запроса на вытягивание. Эта переменная может использоваться в конвейере для условного выполнения задач или шагов на основе целевой ветви запроса на вытягивание. Например, может потребоваться активировать другой набор тестов или средств анализа кода в зависимости от ветви, в которой изменения объединяются.	No
System.PullRequest.SourceBranch	Ветвь, которая проверяется в запросе на вытягивание. Например, refs/heads/users/raisa/new-feature для Azure Repos. (Эта переменная инициализирована только в том случае, если сборка запущена из-заGit PR, затронутый политикой ветви). Эта переменная доступна только в конвейере YAML, если на pr влияет политика ветви.	No
System.PullRequest.SourceCommitId	Фиксация, которая проверяется в запросе на вытягивание. (Эта переменная инициализирована только в том случае, если сборка запущена из-заGit PR, затронутый политикой ветви). Эта переменная доступна только в конвейере YAML, если на pr влияет политика ветви.
System.PullRequest.SourceRepositoryURI	URL-адрес репозитория, содержащего запрос на вытягивание. Например: https://dev.azure.com/ouraccount/_git/OurProject.	No
System.PullRequest.TargetBranch	Ветвь, которая является целью запроса на вытягивание. Например, refs/heads/main если репозиторий находится в Azure Repos и main когда репозиторий находится в GitHub. Эта переменная инициализируется только в том случае, если сборка запущена из-за Git PR, затронутой политикой ветви. Эта переменная доступна только в конвейере YAML, если на pr влияет политика ветви.	No
System.StageAttempt	Установите значение 1 при первой попытке этого этапа и увеличивается каждый раз при повторном выполнении этапа.	No
System.StageDisplayName	Читаемое человеком имя, заданное сцене.	No
System.StageName	Строковый идентификатор этапа, обычно используемый для выражения зависимостей и доступа к выходным переменным.	No
System.TeamFoundationCollectionUri	URI коллекции TFS или организации Azure DevOps. Например: https://dev.azure.com/fabrikamfiber/. Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями.	Да
System.TeamProject	Имя проекта, содержащего эту сборку.	Да
System.TeamProjectId	Идентификатор проекта, к которому принадлежит эта сборка.	Да
System.TimelineId	Строковый идентификатор для сведений о выполнении и журналах одного запуска конвейера.	No
TF_BUILD	True Установите значение, если скрипт выполняется задачей сборки. Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями.	No

Проверяет переменные (DevOps Services)

«Переменная»	Description
Checks.StageAttempt	Установите значение 1 при первой попытке этого этапа и увеличивается каждый раз при повторном выполнении этапа. Эта переменная может использоваться только в рамках утверждения или проверки среды. Например, можно использовать $(Checks.StageAttempt) в проверке REST API invoke.

Как задаются переменные идентификации?

Значение зависит от того, что вызвало сборку и зависит от репозиториев Azure Repos.

Если сборка активируется...	Затем значения Build.QueuedBy и Build.QueuedById основаны на...	Затем значения Build.RequestedFor и Build.RequestedForId основаны на...
В Git или триггерах непрерывной интеграции (CI)	Например, системное удостоверение: [DefaultCollection]\Project Collection Service Accounts	Пользователь, который вытолкнул или проверил изменения.
В Git или по сборке политики ветви.	Например, системное удостоверение: [DefaultCollection]\Project Collection Service Accounts	Пользователь, который проверил изменения.
В TFVC с помощью воротного триггера регистрации	Пользователь, который проверил изменения.	Пользователь, который проверил изменения.
В Git или TFVC с помощью запланированных триггеров	Например, системное удостоверение: [DefaultCollection]\Project Collection Service Accounts	Например, системное удостоверение: [DefaultCollection]\Project Collection Service Accounts
Так как вы нажали кнопку сборки очереди	Вы	Вы