Использование предопределенных переменных
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 необходимо явно сопоставить 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.Debug
Для более подробных журналов для отладки проблем конвейера определите System.Debug
и задайте для него значение true
.
Измените конвейер.
Выберите Переменные.
Добавьте новую переменную с именем
System.Debug
и значениемtrue
.Сохраните новую переменную.
Параметр 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 | Состояние сборки.
AGENT_JOBSTATUS . Более ранние agent.jobstatus версии доступны для обратной совместимости. |
Agent.MachineName | Имя компьютера, на котором установлен агент. |
Agent.Name | Имя агента, зарегистрированного в пуле. Если вы используете локальный агент, то это имя указывается вами. См. агенты. |
Agent.OS | Операционная система узла агента. Допустимые значения:
|
Agent.OSArchitecture | Архитектура процессора операционной системы узла агента. Допустимые значения:
|
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 | Событие, вызвавшее выполнение сборки.
|
Да |
Build.Repository.Clean | Значение, выбранное для очистки в параметрах исходного репозитория. Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями. |
No |
Build.Repository.LocalPath | Локальный путь к агенту, в котором скачиваются файлы исходного кода. Например: c:\agent_work\1\s .По умолчанию новые конвейеры сборки обновляют только измененные файлы. Вы можете изменить способ скачивания файлов на вкладке репозитория. Важно отметить: если вы извлекаете только один репозиторий Git, этот путь является точным путем к коду. При извлечении нескольких репозиториев поведение выглядит следующим образом (и может отличаться от значения переменной Build.SourcesDirectory):
|
No |
Build.Repository.ID | Уникальный идентификатор репозитория. Это не изменится, даже если имя репозитория выполняется. Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями. |
No |
Build.Repository.Name | Имя триггерного репозитория. Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями. |
No |
Build.Repository.Provider | Тип триггерного репозитория.
|
No |
Build.Repository.Tfvc.Workspace | Определяется, система управления версиями Team Foundation ли репозиторий. Имя рабочей области TFVC, используемой агентом сборки. Например, если агент.BuildDirectory c:\agent_work\12 и Agent.Id есть 8 , имя рабочей области может быть следующим: ws_12_8 Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями. |
No |
Build.Repository.Uri | URL-адрес для триггерного репозитория. Например: Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями. |
No |
Build.RequestedFor | См. статью "Как заданы переменные идентификации?". Примечание. Это значение может содержать пробелы или другие недопустимые символы меток. В таких случаях формат метки завершается ошибкой. |
Да |
Build.RequestedForEmail | См. статью "Как заданы переменные идентификации?". | Да |
Build.RequestedForId | См. статью "Как заданы переменные идентификации?". | Да |
Build.SourceBranch | Ветвь триггерного репозитория сборка была помещена в очередь. Некоторые примеры:
/ ) заменяются символами _ подчеркивания.Примечание. В TFVC, если вы выполняете воротную сборку или вручную создаете набор полок, эту переменную нельзя использовать в формате номера сборки. |
Да |
Build.SourceBranchName | Имя ветви в триггерном репозитории сборки было в очереди.
|
Да |
Build.SourcesDirectory | Локальный путь к агенту, в котором скачиваются файлы исходного кода. Например: c:\agent_work\1\s .По умолчанию новые конвейеры сборки обновляют только измененные файлы. Важно отметить: если вы извлекаете только один репозиторий Git, этот путь является точным путем к коду. Если вы извлекаете несколько репозиториев, оно возвращается к значению по умолчанию, то $(Pipeline.Workspace)/s есть, даже если локальный (первичный) репозиторий извлекается в пользовательский путь, отличный от его пути $(Pipeline.Workspace)/s/<RepoName> по умолчанию для нескольких проверок (в этом отношении переменная отличается от поведения переменной Build.Repository.LocalPath).Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями. |
No |
Build.SourceVersion | Последнее изменение элемента управления версиями триггерного репозитория, включенного в эту сборку.
|
Да |
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 или runOnce rolling . |
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. |
Переменные агента (DevOps Server 2022)
Примечание.
Переменные агента можно использовать в качестве переменных среды в скриптах и в качестве параметров в задачах сборки. Их нельзя использовать для настройки номера сборки или применения метки или тега элемента управления версиями.
«Переменная» | Description |
---|---|
Agent.BuildDirectory | Локальный путь агента, в котором создаются все папки для заданного конвейера сборки. Эта переменная имеет то же значение, что Pipeline.Workspace и . Например: /home/vsts/work/1 . |
Agent.ContainerMapping | Сопоставление имен ресурсов контейнера в YAML с идентификаторами Docker во время выполнения. Пример следует за таблицей. |
Agent.HomeDirectory | Каталог, в который устанавливается агент. Это содержит программное обеспечение агента. Например: c:\agent . |
Agent.Id | Идентификатор агента. |
Agent.JobName | Имя выполняемого задания. Обычно это будет "Задание" или "__default", но в сценариях с несколькими конфигурациями будет конфигурация. |
Agent.JobStatus | Состояние сборки.
AGENT_JOBSTATUS . Более ранние agent.jobstatus версии доступны для обратной совместимости. |
Agent.MachineName | Имя компьютера, на котором установлен агент. |
Agent.Name | Имя агента, зарегистрированного в пуле. Если вы используете локальный агент, то это имя указывается вами. См. агенты. |
Agent.OS | Операционная система узла агента. Допустимые значения:
|
Agent.OSArchitecture | Архитектура процессора операционной системы узла агента. Допустимые значения:
|
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 Server 2022)
При использовании переменной в шаблоне, который не помечен как доступный в шаблонах, переменная не будет отображаться. Переменная не будет отображаться, так как его значение недоступно в области шаблона.
«Переменная» | 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. Эта переменная доступна в Azure DevOps Server 2022.1 и выше. |
Да |
Build.DefinitionName | Имя конвейера сборки. Примечание. Это значение может содержать пробелы или другие недопустимые символы меток. В таких случаях формат метки завершается ошибкой. |
Да |
Build.DefinitionVersion | Версия конвейера сборки. | Да |
Build.QueuedBy | См. статью "Как заданы переменные идентификации?". Примечание. Это значение может содержать пробелы или другие недопустимые символы меток. В таких случаях формат метки завершается ошибкой. |
Да |
Build.QueuedById | См. статью "Как заданы переменные удостоверения?. | Да |
Build.Reason | Событие, вызвавшее выполнение сборки.
|
Да |
Build.Repository.Clean | Значение, выбранное для очистки в параметрах исходного репозитория. Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями. |
No |
Build.Repository.LocalPath | Локальный путь к агенту, в котором скачиваются файлы исходного кода. Например: c:\agent_work\1\s . По умолчанию новые конвейеры сборки обновляют только измененные файлы. Вы можете изменить способ скачивания файлов на вкладке репозитория. Важно отметить: если вы извлекаете только один репозиторий Git, этот путь является точным путем к коду. При извлечении нескольких репозиториев поведение выглядит следующим образом (и может отличаться от значения переменной Build.SourcesDirectory):
|
No |
Build.Repository.ID | Уникальный идентификатор репозитория. Это не изменится, даже если имя репозитория выполняется. Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями. |
No |
Build.Repository.Name | Имя триггерного репозитория. Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями. |
No |
Build.Repository.Provider | Тип триггерного репозитория.
|
No |
Build.Repository.Tfvc.Workspace | Определяется, система управления версиями Team Foundation ли репозиторий. Имя рабочей области TFVC, используемой агентом сборки. Например, если агент.BuildDirectory и c:\agent_work\12 Agent.Id есть8 , имя рабочей области может быть следующим: ws_12_8 Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями. |
No |
Build.Repository.Uri | URL-адрес для триггерного репозитория. Например:Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями. | No |
Build.RequestedFor | См. статью "Как заданы переменные идентификации?". Примечание. Это значение может содержать пробелы или другие недопустимые символы меток. В таких случаях формат метки завершается ошибкой. |
Да |
Build.RequestedForEmail | См. статью "Как заданы переменные идентификации?". | Да |
Build.RequestedForId | См. статью "Как заданы переменные идентификации?". | Да |
Build.SourceBranch | Ветвь триггерного репозитория сборка была помещена в очередь. Некоторые примеры:
/ ) заменяются символами _ подчеркивания.Примечание. В TFVC, если вы выполняете воротную сборку или вручную создаете набор полок, эту переменную нельзя использовать в формате номера сборки. |
Да |
Build.SourceBranchName | Имя ветви в триггерном репозитории сборки было в очереди.
|
Да |
Build.SourcesDirectory | Локальный путь к агенту, в котором скачиваются файлы исходного кода. Например: c:\agent_work\1\s . По умолчанию новые конвейеры сборки обновляют только измененные файлы. Важно отметить: если вы извлекаете только один репозиторий Git, этот путь является точным путем к коду. Если вы извлекаете несколько репозиториев, оно возвращается к значению по умолчанию, то $(Pipeline.Workspace)/s есть, даже если локальный (первичный) репозиторий извлекается в пользовательский путь, отличный от его пути $(Pipeline.Workspace)/s/<RepoName> по умолчанию для нескольких проверок (в этом отношении переменная отличается от поведения переменной Build.Repository.LocalPath).Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями. |
No |
Build.SourceVersion | Последнее изменение элемента управления версиями триггерного репозитория, включенного в эту сборку.
|
Да |
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 Server 2022)
«Переменная» | Description |
---|---|
Pipeline.Workspace | Каталог рабочей области для определенного конвейера. Эта переменная имеет то же значение, что Agent.BuildDirectory и . Например, /home/vsts/work/1 . |
Совет
При использовании классических конвейеров выпуска можно использовать классические выпуски и переменные артефактов для хранения и доступа к данным во всем конвейере.
Переменные задания развертывания (DevOps Server 2022)
Эти переменные относятся к определенному заданию развертывания и будут разрешены только во время выполнения задания.
«Переменная» | Description |
---|---|
Environment.Name | Имя среды, целевой в задании развертывания, для выполнения шагов развертывания и записи журнала развертывания. Например, smarthotel-dev . |
Environment.Id | Идентификатор среды, целевой в задании развертывания. Например, 10 . |
Environment.ResourceName | Имя конкретного ресурса в среде, целевой в задании развертывания, для выполнения шагов развертывания и записи журнала развертывания. Например, это пространство имен Kubernetes, bookings которое было добавлено в качестве ресурса в среду smarthotel-dev . |
Environment.ResourceId | Идентификатор конкретного ресурса в среде, целевой в задании развертывания для выполнения шагов развертывания. Например, 4 . |
Strategy.Name | Имя стратегии развертывания: canary или runOnce rolling . |
Strategy.CycleName | Текущее имя цикла в развертывании. Параметры: PreIteration , Iteration или PostIteration . |
Системные переменные (DevOps Server 2022)
При использовании переменной в шаблоне, который не помечен как доступный в шаблонах, переменная не будет отображаться. Переменная не будет отображаться, так как его значение недоступно в области шаблона.
«Переменная» | 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.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.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 Server 2022)
«Переменная» | Description |
---|---|
Checks.StageAttempt | Установите значение 1 при первой попытке этого этапа и увеличивается каждый раз при повторном выполнении этапа. Эта переменная может использоваться только в рамках утверждения или проверки среды. Например, можно использовать $(Checks.StageAttempt) в проверке REST API invoke. |
Переменные агента (DevOps Server 2020)
Примечание.
Переменные агента можно использовать в качестве переменных среды в скриптах и в качестве параметров в задачах сборки. Их нельзя использовать для настройки номера сборки или применения метки или тега элемента управления версиями.
«Переменная» | Description |
---|---|
Agent.BuildDirectory | Локальный путь агента, в котором создаются все папки для заданного конвейера сборки. Эта переменная имеет то же значение, что Pipeline.Workspace и . Например: /home/vsts/work/1 . |
Agent.HomeDirectory | Каталог, в который устанавливается агент. Это содержит программное обеспечение агента. Например: c:\agent . |
Agent.Id | Идентификатор агента. |
Agent.JobName | Имя выполняемого задания. Обычно это будет "Задание" или "__default", но в сценариях с несколькими конфигурациями будет конфигурация. |
Agent.JobStatus | Состояние сборки.
AGENT_JOBSTATUS . Более ранние agent.jobstatus версии доступны для обратной совместимости. |
Agent.MachineName | Имя компьютера, на котором установлен агент. |
Agent.Name | Имя агента, зарегистрированного в пуле. Если вы используете локальный агент, то это имя задается вами. См. агенты. |
Agent.OS | Операционная система узла агента. Допустимые значения:
|
Agent.OSArchitecture | Архитектура процессора операционной системы узла агента. Допустимые значения:
|
Agent.TempDirectory | Временная папка, которая очищается после каждого задания конвейера. Этот каталог используется задачами, такими как задача интерфейса командной строки .NET Core для хранения временных элементов, таких как результаты теста перед публикацией. Например, /home/vsts/work/_temp для Ubuntu. |
Agent.ToolsDirectory | Каталог, используемый задачами, такими как установщик инструментов node и использование версии Python для переключения между несколькими версиями средства. Эти задачи добавляют средства из этого каталога PATH , чтобы последующие шаги сборки могли использовать их. Узнайте об управлении этим каталогом в локальном агенте. |
Agent.WorkFolder | Рабочий каталог для этого агента. Например: c:\agent_work . Примечание. Этот каталог не гарантируется для записи задачами конвейера (например, при сопоставлении с контейнером) |
Переменные сборки (DevOps Server 2020)
При использовании переменной в шаблоне, который не помечен как доступный в шаблонах, переменная не будет отображаться. Переменная не будет отображаться, так как его значение недоступно в области шаблона.
«Переменная» | 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.DefinitionName | Имя конвейера сборки. Примечание. Это значение может содержать пробелы или другие недопустимые символы меток. В этих случаях формат метки завершится ошибкой. |
Да |
Build.DefinitionVersion | Версия конвейера сборки. | Да |
Build.QueuedBy | См. статью "Как заданы переменные идентификации?". Примечание. Это значение может содержать пробелы или другие недопустимые символы меток. В таких случаях формат метки завершается ошибкой. |
Да |
Build.QueuedById | См. статью "Как заданы переменные идентификации?". | Да |
Build.Reason | Событие, вызвавшее выполнение сборки.
|
Да |
Build.Repository.Clean | Значение, выбранное для очистки в параметрах исходного репозитория. Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями. |
No |
Build.Repository.LocalPath | Локальный путь к агенту, в котором скачиваются файлы исходного кода. Например: c:\agent_work\1\s . По умолчанию новые конвейеры сборки обновляют только измененные файлы. Вы можете изменить способ скачивания файлов на вкладке репозитория. Важно отметить: если вы извлекаете только один репозиторий Git, этот путь будет точным путем к коду. При извлечении нескольких репозиториев поведение выглядит следующим образом (и может отличаться от значения переменной Build.SourcesDirectory):
|
No |
Build.Repository.ID | Уникальный идентификатор репозитория. Это не изменится, даже если имя репозитория выполняется. Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями. |
No |
Build.Repository.Name | Имя триггерного репозитория. Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями. |
No |
Build.Repository.Provider | Тип триггерного репозитория.
|
No |
Build.Repository.Tfvc.Workspace | Определяется, система управления версиями Team Foundation ли репозиторий. Имя рабочей области TFVC, используемой агентом сборки. Например, если агент.BuildDirectory и c:\agent_work\12 Agent.Id есть8 , имя рабочей области может быть следующим: ws_12_8 Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями. |
No |
Build.Repository.Uri | URL-адрес для триггерного репозитория. Например: Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями. |
No |
Build.RequestedFor | См. статью "Как заданы переменные идентификации?". Примечание. Это значение может содержать пробелы или другие недопустимые символы меток. В таких случаях формат метки завершается ошибкой. |
Да |
Build.RequestedForEmail | См. статью "Как заданы переменные идентификации?". | Да |
Build.RequestedForId | См. статью "Как заданы переменные идентификации?". | Да |
Build.SourceBranch | Ветвь триггерного репозитория сборка была помещена в очередь. Некоторые примеры:
/ ) заменяются символами _ подчеркивания. Примечание. В TFVC, если вы выполняете воротную сборку или вручную создаете набор полок, эту переменную нельзя использовать в формате номера сборки. |
Да |
Build.SourceBranchName | Имя ветви в триггерном репозитории сборки было в очереди.
|
Да |
Build.SourcesDirectory | Локальный путь к агенту, в котором скачиваются файлы исходного кода. Например: c:\agent_work\1\s . По умолчанию новые конвейеры сборки обновляют только измененные файлы. Важно отметить: если вы извлекаете только один репозиторий Git, этот путь является точным путем к коду. Если вы извлекаете несколько репозиториев, оно возвращается к значению по умолчанию, то $(Pipeline.Workspace)/s есть, даже если локальный (первичный) репозиторий извлекается в пользовательский путь, отличный от его пути $(Pipeline.Workspace)/s/<RepoName> по умолчанию для нескольких проверок (в этом отношении переменная отличается от поведения переменной Build.Repository.LocalPath). Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями. |
No |
Build.SourceVersion | Последнее изменение элемента управления версиями триггерного репозитория, включенного в эту сборку.
|
Да |
Build.SourceVersionMessage | Комментарий фиксации или набора изменений для триггерного репозитория. Мы усечены сообщение на первую строку или 200 символов, в зависимости от того, что меньше. Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями. Кроме того, эта переменная доступна только на уровне шага и недоступна на уровне задания или этапа (т. е. сообщение не извлекается до начала задания и извлечения кода). Примечание. Эта переменная доступна в 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 триггера сборки. В классических конвейерах эта переменная активируется триггером завершения сборки. Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями. |
No |
Build.TriggeredBy.DefinitionId | Если сборка была активирована другой сборкой, эта переменная имеет значение DefinitionID триггера сборки. В классических конвейерах эта переменная активируется триггером завершения сборки. Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями. |
No |
Build.TriggeredBy.DefinitionName | Если сборка была активирована другой сборкой, эта переменная имеет имя запускающего конвейера сборки. В классических конвейерах эта переменная активируется триггером завершения сборки. Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями. |
No |
Build.TriggeredBy.BuildNumber | Если сборка была активирована другой сборкой, эта переменная имеет значение числа триггерной сборки. В классических конвейерах эта переменная активируется триггером завершения сборки. Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями. |
No |
Build.TriggeredBy.ProjectID | Если сборка была активирована другой сборкой, эта переменная имеет идентификатор проекта, содержащего триггерную сборку. В классических конвейерах эта переменная активируется триггером завершения сборки. Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями. |
No |
Common.TestResultsDirectory | Локальный путь к агенту, в котором создаются результаты теста. Например: c:\agent_work\1\TestResults . Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями. |
No |
Переменные конвейера (DevOps Server 2020)
«Переменная» | Description |
---|---|
Pipeline.Workspace | Каталог рабочей области для определенного конвейера. Эта переменная имеет то же значение, что Agent.BuildDirectory и . Например, /home/vsts/work/1 . |
Переменные задания развертывания (DevOps Server 2020)
Эти переменные относятся к определенному заданию развертывания и будут разрешены только во время выполнения задания.
«Переменная» | Description |
---|---|
Environment.Name | Имя среды, целевой в задании развертывания, для выполнения шагов развертывания и записи журнала развертывания. Например, smarthotel-dev . |
Environment.Id | Идентификатор среды, целевой в задании развертывания. Например, 10 . |
Environment.ResourceName | Имя конкретного ресурса в среде, целевой в задании развертывания, для выполнения шагов развертывания и записи журнала развертывания. Например, это пространство имен Kubernetes, bookings которое было добавлено в качестве ресурса в среду smarthotel-dev . |
Environment.ResourceId | Идентификатор конкретного ресурса в среде, целевой в задании развертывания для выполнения шагов развертывания. Например, 4 . |
Системные переменные (DevOps Server 2020)
При использовании переменной в шаблоне, который не помечен как доступный в шаблонах, переменная не будет отображаться. Переменная не будет отображаться, так как его значение недоступно в области шаблона.
«Переменная» | Description | Доступно в шаблонах? |
---|---|---|
System.AccessToken | Используйте маркер OAuth для доступа к REST API. Используйте System.AccessToken из скриптов YAML. Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями. |
Да |
System.CollectionId | GUID коллекции TFS или организации Azure DevOps | Да |
System.CollectionUri | Строковый универсальный код ресурса (URI) коллекции Team Foundation Server. | Да |
System.DefaultWorkingDirectory | Локальный путь к агенту, в котором скачиваются файлы исходного кода. Например: c:\agent_work\1\s По умолчанию новые конвейеры сборки обновляют только измененные файлы. Вы можете изменить способ скачивания файлов на вкладке репозитория. Эта переменная является областью действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не как часть номера сборки или в качестве тега управления версиями. |
No |
System.DefinitionId | Идентификатор конвейера сборки. | Да |
System.HostType | Задайте значение build , если конвейер является сборкой. В выпуске значения предназначены deployment для задания группы развертывания, gates во время оценки шлюзов и release для других заданий (агентов и агентов без агента). |
Да |
System.JobAttempt | Установите значение 1 при первой попытке этого задания и увеличивается каждый раз при повторном выполнении задания. | No |
System.JobDisplayName | Имя, доступное для чтения человеком, заданное заданию. | No |
System.JobId | Уникальный идентификатор для одной попытки одного задания. Значение уникально для текущего конвейера. | No |
System.JobName | Имя задания, обычно используемое для выражения зависимостей и доступа к выходным переменным. | No |
System.PhaseAttempt | Установите значение 1 при первой попытке этого этапа и увеличивается каждый раз при повторном выполнении задания. Примечание. "Этап" является в основном избыточной концепцией, которая представляет время разработки для задания (в то время как задание было версией среды выполнения этапа). В основном мы удалили концепцию "этап" из Azure Pipelines. Матрица и многоконфигурные задания являются единственным местом, где "этап" по-прежнему отличается от "job". Один этап может создать экземпляры нескольких заданий, которые отличаются только в их входных данных. |
No |
System.PhaseDisplayName | Читаемое человеком имя, заданное этапу. | No |
System.PhaseName | Строковый идентификатор задания, обычно используемый для выражения зависимостей и доступа к выходным переменным. | No |
System.StageAttempt | Установите значение 1 при первой попытке этого этапа и увеличивается каждый раз при повторном выполнении задания. | No |
System.StageDisplayName | Читаемое человеком имя, заданное сцене. | No |
System.StageName | Строковый идентификатор этапа, обычно используемый для выражения зависимостей и доступа к выходным переменным. | Да |
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 . (Эта переменная инициализирована только в том случае, если сборка запущена из-за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.TeamFoundationCollectionUri | Универсальный код ресурса (URI) коллекции team foundation. Например: https://dev.azure.com/fabrikamfiber/ . Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями. |
Да |
System.TeamProject | Имя проекта, содержащего эту сборку. | Да |
System.TeamProjectId | Идентификатор проекта, к которому принадлежит эта сборка. | Да |
TF_BUILD | True Установите значение, если скрипт выполняется задачей сборки. Эта переменная является областью действия агента и может использоваться в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в составе номера сборки или в качестве тега элемента управления версиями. |
No |
Переменные агента (DevOps Server 2019)
Примечание.
Переменные агента можно использовать в качестве переменных среды в скриптах и в качестве параметров в задачах сборки. Их нельзя использовать для настройки номера сборки или применения метки или тега элемента управления версиями.
«Переменная» | Description |
---|---|
Agent.BuildDirectory | Локальный путь агента, в котором создаются все папки для заданного конвейера сборки. Например: c:\agent_work\1 . |
Agent.HomeDirectory | Каталог, в который устанавливается агент. Это содержит программное обеспечение агента. Например: c:\agent . |
Agent.Id | Идентификатор агента. |
Agent.JobName | Имя выполняемого задания. Обычно это будет "Задание" или "__default", но в сценариях с несколькими конфигурациями будет конфигурация. |
Agent.JobStatus | Состояние сборки.
AGENT_JOBSTATUS . Более ранние agent.jobstatus версии доступны для обратной совместимости. |
Agent.MachineName | Имя компьютера, на котором установлен агент. |
Agent.Name | Имя агента, зарегистрированного в пуле. Если вы используете локальный агент, то это имя будет задано вами. См. агенты. |
Agent.OS | Операционная система узла агента. Допустимые значения:
|
Agent.OSArchitecture | Архитектура процессора операционной системы узла агента. Допустимые значения:
|
Agent.TempDirectory | Временная папка, которая очищается после каждого задания конвейера. Этот каталог используется задачами, такими как задача интерфейса командной строки .NET Core для хранения временных элементов, таких как результаты теста перед публикацией. |
Agent.ToolsDirectory | Каталог, используемый задачами, такими как установщик инструментов node и использование версии Python для переключения между несколькими версиями средства. Эти задачи добавляют средства из этого каталога PATH , чтобы последующие шаги сборки могли использовать их. Узнайте об управлении этим каталогом в локальном агенте. |
Agent.WorkFolder | Рабочий каталог для этого агента. Например: c:\agent_work . Этот каталог не гарантируется для записи задачами конвейера (например, при сопоставлении с контейнером). |
Переменные сборки (DevOps Server 2019)
«Переменная» | Description |
---|---|
Build.ArtifactStagingDirectory | Локальный путь к агенту, в котором копируются артефакты перед отправкой в место назначения. Например: c:\agent_work\1\a . Типичным способом использования этой папки является публикация артефактов сборки с помощью задач копирования файлов и задач публикации артефактов сборки . Примечание. Build.ArtifactStagingDirectory и Build.StagingDirectory являются взаимозаменяемыми. Этот каталог очищается перед каждой новой сборкой, поэтому вам не нужно самостоятельно очистить его. См . артефакты в Azure Pipelines. Эта переменная является областью действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не как часть номера сборки или в качестве тега управления версиями. |
Build.BuildId | Идентификатор записи для завершенной сборки. |
Build.BuildNumber | Имя завершенной сборки. Можно указать формат номера сборки, который создает это значение в параметрах конвейера. Типичное использование этой переменной заключается в том, чтобы сделать его частью формата меток, который указывается на вкладке репозитория. Примечание. Это значение может содержать пробелы или другие недопустимые символы меток. В таких случаях формат метки завершается ошибкой. Эта переменная является областью действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не как часть номера сборки или в качестве тега управления версиями. |
Build.BuildUri | Универсальный код ресурса (URI) для сборки. Например: vstfs:///Build/Build/1430 . Эта переменная является областью действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не как часть номера сборки или в качестве тега управления версиями. |
Build.BinariesDirectory | Локальный путь агента, который можно использовать в качестве выходной папки для скомпилированных двоичных файлов. По умолчанию новые конвейеры сборки не настроены для очистки этого каталога. Вы можете определить сборку, чтобы очистить ее на вкладке репозитория. Например: c:\agent_work\1\b . Эта переменная является областью действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не как часть номера сборки или в качестве тега управления версиями. |
Build.DefinitionName | Имя конвейера сборки. Примечание. Это значение может содержать пробелы или другие недопустимые символы меток. В этих случаях формат метки завершится ошибкой. |
Build.DefinitionVersion | Версия конвейера сборки. |
Build.QueuedBy | См. статью "Как заданы переменные идентификации?". Примечание. Это значение может содержать пробелы или другие недопустимые символы меток. В таких случаях формат метки завершается ошибкой. |
Build.QueuedById | См. статью "Как заданы переменные идентификации?". |
Build.Reason | Событие, вызвавшее выполнение сборки.
|
Build.Repository.Clean | Значение, выбранное для очистки в параметрах исходного репозитория. Эта переменная является областью действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не как часть номера сборки или в качестве тега управления версиями. |
Build.Repository.LocalPath | Локальный путь к агенту, в котором скачиваются файлы исходного кода. Например: c:\agent_work\1\s По умолчанию новые конвейеры сборки обновляют только измененные файлы. Вы можете изменить способ скачивания файлов на вкладке репозитория. Эта переменная является областью действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не как часть номера сборки или в качестве тега управления версиями. Эта переменная синонимом Build.SourcesDirectory. |
Build.Repository.Name | Имя репозитория. Эта переменная является областью действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не как часть номера сборки или в качестве тега управления версиями. |
Build.Repository.Provider | Выбранный тип репозитория.
|
Build.Repository.Tfvc.Workspace | Определяется, система управления версиями Team Foundation ли репозиторий. Имя рабочей области TFVC, используемой агентом сборки. Например, если агент.BuildDirectory и c:\agent_work\12 Agent.Id есть8 , имя рабочей области может быть следующим: ws_12_8 Эта переменная является областью действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не как часть номера сборки или в качестве тега управления версиями. |
Build.Repository.Uri | URL-адрес репозитория. Например: Эта переменная является областью действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не как часть номера сборки или в качестве тега управления версиями. |
Build.RequestedFor | См. статью "Как заданы переменные идентификации?". Примечание. Это значение может содержать пробелы или другие недопустимые символы меток. В таких случаях формат метки завершается ошибкой. |
Build.RequestedForEmail | См. статью "Как заданы переменные идентификации?". |
Build.RequestedForId | См. статью "Как заданы переменные идентификации?". |
Build.SourceBranch | Ветвь сборка была помещена в очередь. Некоторые примеры:
/ ) заменяются символами подчеркивания (_ ). Примечание. В TFVC, если вы выполняете воротную сборку или вручную создаете набор полок, эту переменную нельзя использовать в формате номера сборки. |
Build.SourceBranchName | Имя ветви сборки было в очереди.
|
Build.SourcesDirectory | Локальный путь к агенту, в котором скачиваются файлы исходного кода. Например: c:\agent_work\1\s .По умолчанию новые конвейеры сборки обновляют только измененные файлы. Вы можете изменить способ скачивания файлов на вкладке репозитория. Эта переменная является областью действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не как часть номера сборки или в качестве тега управления версиями. Эта переменная является синонимом Build.Repository.LocalPath. |
Build.SourceVersion | Последнее изменение элемента управления версиями, которое входит в эту сборку.
|
Build.SourceVersionMessage | Комментарий фиксации или набора изменений. Мы усечены сообщение на первую строку или 200 символов, в зависимости от того, что меньше. Эта переменная является областью действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не как часть номера сборки или в качестве тега управления версиями. Примечание. Эта переменная доступна в TFS 2015.4. Примечание. Переменная Build.SourceVersionMessage не работает с классическими конвейерами сборки в репозиториях Bitbucket при включении пакетной службы при включении сборки. |
Build.StagingDirectory | Локальный путь к агенту, в котором копируются артефакты перед отправкой в место назначения. Например: c:\agent_work\1\a . Типичным способом использования этой папки является публикация артефактов сборки с помощью задач копирования файлов и задач публикации артефактов сборки . Примечание. Build.ArtifactStagingDirectory и Build.StagingDirectory являются взаимозаменяемыми. Этот каталог очищается перед каждой новой сборкой, поэтому вам не нужно самостоятельно очистить его. См . артефакты в Azure Pipelines. Эта переменная является областью действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не как часть номера сборки или в качестве тега управления версиями. |
Build.Repository.Git.SubmoduleCheckout | Значение, выбранное для вложенных модулей checkout, на вкладке репозитория. Эта переменная является областью действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не как часть номера сборки или в качестве тега управления версиями. |
Build.SourceTfvcShelveset | Определяется, система управления версиями Team Foundation ли репозиторий. Если вы используете воротную сборку или сборку с набором полок, для этого задано имя набора полок, который вы создаете. Примечание. Эта переменная дает недопустимое значение для использования сборки в формате номера сборки. |
Build.TriggeredBy.BuildId | Если сборка была активирована другой сборкой, эта переменная имеет значение BuildID триггера сборки. Эта переменная является областью действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не как часть номера сборки или в качестве тега управления версиями. |
Build.TriggeredBy.DefinitionId | Если сборка была активирована другой сборкой, эта переменная имеет значение DefinitionID триггера сборки. Эта переменная является областью действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не как часть номера сборки или в качестве тега управления версиями. |
Build.TriggeredBy.DefinitionName | Если сборка была активирована другой сборкой, эта переменная имеет имя запускающего конвейера сборки. Эта переменная является областью действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не как часть номера сборки или в качестве тега управления версиями. |
Build.TriggeredBy.BuildNumber | Если сборка была активирована другой сборкой, эта переменная имеет значение числа триггерной сборки. Эта переменная является областью действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не как часть номера сборки или в качестве тега управления версиями. |
Build.TriggeredBy.ProjectID | Если сборка была активирована другой сборкой, эта переменная имеет идентификатор проекта, содержащего триггерную сборку. Эта переменная является областью действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не как часть номера сборки или в качестве тега управления версиями. |
Common.TestResultsDirectory | Локальный путь к агенту, в котором создаются результаты теста. Например: c:\agent_work\1\TestResults . Эта переменная является областью действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не как часть номера сборки или в качестве тега управления версиями. |
Системные переменные (DevOps Server 2019)
Пример скрипта PowerShell: доступ к REST API
«Переменная» | Description |
---|---|
System.AccessToken | Используйте маркер OAuth для доступа к REST API. Используйте System.AccessToken из скриптов YAML. Эта переменная является областью действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не как часть номера сборки или в качестве тега управления версиями. |
System.CollectionId | GUID коллекции TFS или организации Azure DevOps |
System.DefaultWorkingDirectory | Локальный путь к агенту, в котором скачиваются файлы исходного кода. Например: c:\agent_work\1\s По умолчанию новые конвейеры сборки обновляют только измененные файлы. Вы можете изменить способ скачивания файлов на вкладке репозитория. Эта переменная является областью действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не как часть номера сборки или в качестве тега управления версиями. |
System.DefinitionId | Идентификатор конвейера сборки. |
System.HostType | Задайте значение build , если конвейер является сборкой. В выпуске значения относятся deployment к заданию группы развертывания и release заданию агента. |
System.PullRequest.IsFork | Если запрос на вытягивание выполняется из вилки репозитория, эта переменная имеет значение True . В противном случае для него задано значение False . |
System.PullRequest.PullRequestId | Идентификатор запроса на вытягивание, вызвавшего эту сборку. Например: 17 . (Эта переменная инициализирована только в том случае, если сборка запущена из-заGit PR, затронутый политикой ветви.) |
System.PullRequest.PullRequestNumber | Количество запроса на вытягивание, вызвавшего эту сборку. Эта переменная заполняется для запросов на вытягивание из GitHub, которые имеют другой идентификатор запроса на вытягивание и номер запроса на вытягивание. |
System.PullRequest.SourceBranch | Ветвь, которая проверяется в запросе на вытягивание. Например: refs/heads/users/raisa/new-feature . (Эта переменная инициализирована только в том случае, если сборка запущена из-заGit PR, затронутый политикой ветви.) |
System.PullRequest.SourceCommitId | Фиксация, которая проверяется в запросе на вытягивание. (Эта переменная инициализирована только в том случае, если сборка запущена из-заGit PR, затронутый политикой ветви.) |
System.PullRequest.SourceRepositoryURI | URL-адрес репозитория, содержащего запрос на вытягивание. Например: https://dev.azure.com/ouraccount/_git/OurProject . (Эта переменная инициализирована только в том случае, если сборка запущена из-заAzure Repos Git PR, затронутый политикой ветви. Он не инициализирован для GitHub PRs.) |
System.PullRequest.TargetBranch | Ветвь, которая является целью запроса на вытягивание. Например: refs/heads/main . Эта переменная инициализируется только в том случае, если сборка запущена из-за Git PR, затронутой политикой ветви. |
System.TeamFoundationCollectionUri | Универсальный код ресурса (URI) коллекции team foundation. Например: https://dev.azure.com/fabrikamfiber/ . Эта переменная является областью действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не как часть номера сборки или в качестве тега управления версиями. |
System.TeamProject | Имя проекта, содержащего эту сборку. |
System.TeamProjectId | Идентификатор проекта, к которому принадлежит эта сборка. |
TF_BUILD | True Установите значение, если скрипт выполняется задачей сборки. Эта переменная является областью действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не как часть номера сборки или в качестве тега управления версиями. |
Как задаются переменные идентификации?
Значение зависит от того, что вызвало сборку и зависит от репозиториев 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 |
Так как вы нажали кнопку сборки очереди | Вы | Вы |