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

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

Примечание

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

ПеременнаяОписание
Agent. BuildDirectory

Локальный путь на агенте, где создаются все папки для данного конвейера сборки. Эта переменная имеет то же значение, что и Pipeline.Workspace .

Пример: /home/vsts/work/1

Agent. Контаинермаппинг

Сопоставление имен ресурсов контейнера в YAML с идентификаторами DOCKER во время выполнения.

Пример:

{"one_container": {"ID": "bdbb357d73a0bd3550a1a5b778b62a4c88ed2051c7802a0659f1ff6e76910190"}, "another_container": {"ИД": "82652975109ec494876a8ccbb875459c945982952e0a72ad74c91216707162bb"}}

Agent. Хомедиректори Каталог, в который устанавливается агент. Содержит программное обеспечение агента. Например: c:\agent.
Agent.Id Идентификатор агента.
Agent. JobName Имя выполняемого задания. Обычно это "Job" или "__default", но в сценариях с несколькими конфигурациями будет конфигурация.
Agent. JobStatus Состояние сборки.
  • Canceled
  • Failed
  • Succeeded
  • SucceededWithIssues (частично успешно)

На переменную среды следует ссылаться как на AGENT_JOBSTATUS . Более старая версия agent.jobstatus доступна для обеспечения обратной совместимости.

Agent. MachineName Имя компьютера, на котором установлен агент.
Agent.Name

Имя агента, зарегистрированного в пуле.

Если используется агент, размещенный в собственном расположении, это имя указывается пользователем. См. раздел агенты.

Agent.OS Операционная система узла агента. Допустимые значения:
  • Windows_NT
  • Darwin
  • Linux
Если вы используете контейнер, узел агента и контейнер могут работать под управлением разных операционных систем.
Agent. Осарчитектуре Архитектура процессора операционной системы узла агента. Допустимые значения:
  • X86
  • X64
  • ARM
Agent. TempDirectory

Временная папка, которая очищается после каждого задания конвейера. Этот каталог используется такими задачами, как .NET Core CLI задача для хранения временных элементов, таких как результаты теста перед их публикацией.

Пример: /home/vsts/work/_temp для Ubuntu

Agent. Тулсдиректори Каталог, используемый задачами, такими как установщик инструмента node , и использование версии Python для переключения между несколькими версиями средства. Эти задачи приводят к добавлению средств из этого каталога в PATH , чтобы последующие шаги сборки могли их использовать.

Сведения об управлении этим каталогом на собственном агенте.
Agent. WorkFolder Рабочий каталог для этого агента. Например: c:\agent_work.

Примечание. не гарантируется, что этот каталог будет доступен для записи с помощью задач конвейера (например, При сопоставлении с контейнером)

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


ПеременнаяОписаниеДоступно в шаблонах?
Сборка. ArtifactStagingDirectory

Локальный путь на агенте, в который копируются все артефакты перед отправкой в назначение. Пример: c:\agent_work\1\a

Обычным способом использования этой папки является публикация артефактов сборки с помощью задач копирование файлов и Публикация артефактов сборки .

Примечание. сборка. ArtifactStagingDirectory и сборка. StagingDirectory являются взаимозаменяемыми. Этот каталог очищается перед каждой новой сборкой, поэтому вам не нужно очищать его самостоятельно.

см. Artifacts в Azure Pipelines.

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

Нет
Сборка. BuildId Идентификатор записи для завершенной сборки. Нет
Build.BuildNumber Имя завершенной сборки, также называемое номером запуска. Можно указать, что включается в это значение.

Обычно эта переменная используется для того, чтобы сделать ее частью формата метки, указанного на вкладке репозиторий.

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



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

Нет
Сборка. ее BuildUri Универсальный код ресурса (URI) для сборки. Например: vstfs:///Build/Build/1430.

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

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

Например: c:\agent_work\1\b.

Эта переменная имеет область действия агента, и ее можно использовать как переменную среды в скрипте и как параметр в задаче сборки, но не как часть номера сборки или как тег управления версиями.
Нет
Сборка. ContainerId Идентификатор контейнера для артефакта. При передаче артефакта в конвейер он добавляется в контейнер, относящийся к конкретному артефакту. Нет
Build.DefinitionName Имя конвейера сборки.

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

Да
Сборка. Дефинитионверсион Версия конвейера сборки. Да
Сборка. Куеуедби См. раздел "как устанавливаютсяпеременные удостоверений?".

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

Да
Сборка. Куеуедбид См. раздел "как устанавливаютсяпеременные удостоверений?". Да
Сборка. Причина Событие, вызвавшее запуск сборки.
  • Manual: Пользователь вручную помещает сборку в очередь.
  • IndividualCI: IndividualCI , активируемая при возврате Git или TFVC.
  • BatchedCI: BatchedCI , активируемая при возврате Git или TFVC, и были выбраны изменения пакета .
  • Schedule: Триггер по Schedule .
  • ValidateShelveset: Пользователь вручную помещает сборку в очередь для определенного набора отложенных изменений TFVC.
  • CheckInShelveset: Триггер CheckInShelveset .
  • PullRequest: Сборка была активирована политикой ветви Git, для которой требуется сборка.
  • ResourceTrigger: Сборка была ResourceTrigger или вызвана другой сборкой.
См. раздел Создание триггеров конвейера, улучшение качества кода с помощью политик ветвей.
Да
Сборка. репозиторий. Очистка Значение, выбранное для очистки в исходных параметрах репозитория.

Эта переменная имеет область действия агента, и ее можно использовать как переменную среды в скрипте и как параметр в задаче сборки, но не как часть номера сборки или как тег управления версиями.
Нет
Сборка. репозиторий. LocalPath

Локальный путь на агенте, куда загружаются файлы исходного кода. Пример: c:\agent_work\1\s

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

Важное примечание. Если вы извлекаете только один репозиторий Git, этот путь будет точным путем к коду. Если вы извлекаете несколько репозиториев, поведение будет следующим (и может отличаться от значения переменной Build. SourcesDirectory):

  • Если на шаге извлечения для самого себя (первичного) репозитория не определен пользовательский путь извлечения или путь извлечения является путем множественного извлечения $(Pipeline.Workspace)/s/<RepoName> для саморепозитория, то значение этой переменной вернется к значению по умолчанию, то есть $(Pipeline.Workspace)/s .
  • Если на шаге извлечения для самого себя (первичного) репозитория определен пользовательский путь извлечения (а не путь, используемый по умолчанию для множественного извлечения), эта переменная будет содержать точный путь к собственному репозиторию.
Эта переменная имеет область действия агента, и ее можно использовать как переменную среды в скрипте и как параметр в задаче сборки, но не как часть номера сборки или как тег управления версиями.
Нет
Build.Repository.ID Уникальный идентификатор репозитория.

Это не изменится, даже если имя репозитория выполняется.

Эта переменная имеет область действия агента, и ее можно использовать как переменную среды в скрипте и как параметр в задаче сборки, но не как часть номера сборки или как тег управления версиями.
Нет
Build.Repository.Name Имя репозитория, запускающего триггер.

Эта переменная имеет область действия агента, и ее можно использовать как переменную среды в скрипте и как параметр в задаче сборки, но не как часть номера сборки или как тег управления версиями.
Нет
Сборка. репозиторий. поставщик Тип репозитория, запускающего триггер.
  • TfsGit: TfsGit
  • TfsVersionControl: TfsVersionControl
  • Git: Репозиторий Git, размещенный на внешнем сервере
  • GitHub
  • Svn: Subversion
Эта переменная имеет область действия агента, и ее можно использовать как переменную среды в скрипте и как параметр в задаче сборки, но не как часть номера сборки или как тег управления версиями.
Нет
Сборка. репозиторий. TFVC. Workspace определяется, если репозиторий система управления версиями Team Foundation. Имя рабочей области TFVC , используемой агентом сборки.


Например, если Agent. BuildDirectory имеет значение c:\agent_work\12 , а Agent.ID — 8 , имя рабочей области может быть следующим: ws_12_8

Эта переменная имеет область действия агента, и ее можно использовать как переменную среды в скрипте и как параметр в задаче сборки, но не как часть номера сборки или как тег управления версиями.
Нет
Сборка. репозиторий. URI URL-адрес репозитория, запускающего триггер. Например: Эта переменная имеет область действия агента, и ее можно использовать как переменную среды в скрипте и как параметр в задаче сборки, но не как часть номера сборки или как тег управления версиями. Нет
Сборка. RequestedFor См. раздел "как устанавливаютсяпеременные удостоверений?".

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

Да
Сборка. Рекуестедфоремаил См. раздел "как устанавливаютсяпеременные удостоверений?". Да
Сборка. Рекуестедфорид См. раздел "как устанавливаютсяпеременные удостоверений?". Да
Build.SourceBranch Ветвь репозитория активации, для которой была поставлена сборка. Некоторые примеры.
  • Ветвь репозитория Git: refs/heads/master
  • Запрос на вытягивание репозитория Git: refs/pull/1/merge
  • Ветвь репозитория TFVC: $/teamproject/main
  • Запись с проверкой изменений в репозитории TFVC: Gated_2016-06-06_05.20.51.4369;username@live.com
  • Сборка набора отложенных изменений репозитория TFVC: myshelveset;username@live.com
  • При активации конвейера с помощью тега: refs/tags/your-tag-name
При использовании этой переменной в формате номера сборки символы косой черты ( / ) заменяются символами подчеркивания _ .

Примечание. в TFVC при выполнении сборки с условным возвратом или создании набора отложенных изменений вручную эту переменную нельзя использовать в вашем формате номера сборки.
Да
Сборка. Саурцебранчнаме Имя ветви в репозитории триггеров, для которого сборка была поставлена в очередь.
  • Ветвь репозитория Git или запрос на вытягивание: последний сегмент пути в ссылке. Например, в refs/heads/master этом значении задано значение master . В refs/heads/feature/tools этом значении это значение равно tools .
  • Ветвь репозитория TFVC: последний сегмент пути в корневом каталоге сервера для рабочей области. Например, в $/teamproject/main этом значении задано значение main .
  • TFVCный возврат или сборка набора отложенных изменений репозитория с проверкой поименования — это имя набора отложенных изменений. Например, Gated_2016-06-06_05.20.51.4369;username@live.com или myshelveset;username@live.com.
Примечание. в TFVC при выполнении сборки с условным возвратом или создании набора отложенных изменений вручную эту переменную нельзя использовать в вашем формате номера сборки.
Да
Сборка. SourcesDirectory

Локальный путь на агенте, куда загружаются файлы исходного кода. Пример: c:\agent_work\1\s

По умолчанию новые конвейеры сборки обновляют только измененные файлы.

Важное примечание. Если вы извлекаете только один репозиторий Git, этот путь будет точным путем к коду. Если вы выберете несколько репозиториев, будет возвращено значение по умолчанию, то есть $(Pipeline.Workspace)/s даже если первичный (основной) репозиторий извлечен в пользовательский путь, отличный от используемого по умолчанию пути множественного извлечения $(Pipeline.Workspace)/s/<RepoName> (в данном случае переменная отличается от поведения переменной Build. Repository. LocalPath).

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

Нет
Сборка. SourceVersion Последний измененный элемент управления версиями в репозитории триггеров, включенном в эту сборку. Эта переменная имеет область действия агента, и ее можно использовать как переменную среды в скрипте и как параметр в задаче сборки, но не как часть номера сборки или как тег управления версиями. Да
Сборка. Саурцеверсионмессаже Комментарий к фиксации или набору изменений для репозитория, вызывающего срабатывание. Мы усекаете сообщение до первой строки или 200 символов, в зависимости от того, что короче.

Объект Build.SourceVersionMessage соответствует сообщению при Build.SourceVersion фиксации. Build.SourceVersionФиксация для сборки PR — это фиксация слияния (а не фиксация в исходной ветви).

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

Примечание. Эта переменная доступна в TFS 2015,4.

Нет
Сборка. StagingDirectory

Локальный путь на агенте, в который копируются все артефакты перед отправкой в назначение. Пример: c:\agent_work\1\a

Обычным способом использования этой папки является публикация артефактов сборки с помощью задач копирование файлов и Публикация артефактов сборки .

Примечание. сборка. ArtifactStagingDirectory и сборка. StagingDirectory являются взаимозаменяемыми. Этот каталог очищается перед каждой новой сборкой, поэтому вам не нужно очищать его самостоятельно.

см. Artifacts в Azure Pipelines.

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

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

Эта переменная имеет область действия агента, и ее можно использовать как переменную среды в скрипте и как параметр в задаче сборки, но не как часть номера сборки или как тег управления версиями.
Нет
Сборка. Саурцетфвкшелвесет определяется, если репозиторий система управления версиями Team Foundation.


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

Примечание. Эта переменная дает значение, недопустимое для использования сборки в формате номера сборки.
Нет
Сборка. Тригжередби. BuildId Если сборка была активирована другой сборкой, то для этой переменной задается значение BuildID сборки, вызывающей срабатывание. В классических конвейерах эта переменная активируется триггером завершения сборки.

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

Если вы запускаете конвейер YAML с помощью resources , вместо этого следует использовать resources .
Нет
Сборка. Тригжередби. DefinitionId Если сборка была активирована другой сборкой, то для этой переменной задается значение DefinitionID сборки, вызывающей срабатывание. В классических конвейерах эта переменная активируется триггером завершения сборки.

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

Если вы запускаете конвейер YAML с помощью resources , вместо этого следует использовать resources .
Нет
Сборка. Тригжередби. DefinitionName Если сборка была активирована другой сборкой, то для этой переменной задается имя активируемого конвейера сборки. В классических конвейерах эта переменная активируется триггером завершения сборки.

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

Если вы запускаете конвейер YAML с помощью resources , вместо этого следует использовать resources .
Нет
Сборка. Тригжередби. BuildNumber Если сборка была активирована другой сборкой, то для этой переменной задается номер сборки, вызывающей срабатывание. В классических конвейерах эта переменная активируется триггером завершения сборки.

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

Если вы запускаете конвейер YAML с помощью resources , вместо этого следует использовать resources .
Нет
Сборка. Тригжередби. ProjectID Если сборка была активирована другой сборкой, то для этой переменной задается идентификатор проекта, содержащего инициированную сборку. В классических конвейерах эта переменная активируется триггером завершения сборки.

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

Если вы запускаете конвейер YAML с помощью resources , вместо этого следует использовать resources .
Нет
Common. Тестресултсдиректори Локальный путь на агенте, где создаются результаты теста. Пример: c:\agent_work\1\TestResults

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

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

ПеременнаяОписание
Конвейер. Рабочая область Каталог рабочей области для конкретного конвейера. Эта переменная имеет то же значение, что и Agent.BuildDirectory .

Например, /home/vsts/work/1.

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

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

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

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

ПеременнаяОписаниеДоступно в шаблонах?
System. AccessToken Используйте маркер OAuth для доступа к REST API.

Используйте System. AccessToken из скриптов YAML.

Эта переменная имеет область действия агента, и ее можно использовать как переменную среды в скрипте и как параметр в задаче сборки, но не как часть номера сборки или как тег управления версиями.
Да
System. CollectionId идентификатор GUID коллекции TFS или Azure DevOps организации. Да
System. Uri_коллекции универсальный код ресурса (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. Жобаттемпт Задайте значение 1 при первом запуске этого задания и увеличивается при каждом повторении задания. Нет
System. Жобдисплайнаме Удобное для восприятия имя, присвоенное заданию. Нет
System. JobId Уникальный идентификатор для одной попытки выполнения одного задания. Значение уникально для текущего конвейера. Нет
System. JobName Имя задания, обычно используемое для выражения зависимостей и доступа к выходным переменным. Нет
System. Фасеаттемпт Задайте значение 1 при первом запуске этого этапа и увеличивается при каждом повторении задания.

Примечание. "Этап" — это наиболее избыточная концепция, которая представляет время разработки для задания (в то время как задание — это версия этапа выполнения фазы). В основном мы удалили понятие "этап" из Azure Pipelines. Задания Matrix и Multi-config являются единственным местом, где "этап" по-прежнему отличается от "Job". На одном этапе можно создать экземпляры нескольких заданий, которые отличаются только входными данными.
Нет
System. Фаседисплайнаме Удобное для восприятия имя, присвоенное этапу. Нет
System. Фасенаме Основанный на строках идентификатор задания, обычно используемый для выражения зависимостей и доступа к выходным переменным. Нет
System. Стажеаттемпт Задайте значение 1 при первом запуске этого этапа и увеличивается при каждом повторении задания. Нет
System. Стажедисплайнаме Удобное для восприятия имя, заданное для этапа. Нет
System. Стаженаме Основанный на строках идентификатор для этапа, обычно используемый для выражения зависимостей и доступа к выходным переменным. Да
System. PullRequest. подвилка Если запрос на вытягивание происходит из разветвления репозитория, для этой переменной задается значение True . В противном случае для него задается значение False . Да
System. PullRequest. PullRequestId Идентификатор запроса на вытягивание, вызвавшего эту сборку. Например: 17. (Эта переменная инициализируется только в том случае, если сборка запущена из-за того, что в ней затронута политика ветви Git). Нет
System. PullRequest. Пуллрекуестнумбер Номер запроса на вытягивание, вызвавшего эту сборку. эта переменная заполняется для запросов на вытягивание от GitHub, имеющих другой идентификатор запроса на вытягивание и номер запроса на включение внесенных изменений. Эта переменная доступна только в конвейере YAML, если политика ветвления затронула значение PR. Нет
System. PullRequest. параметр sourcebranch Ветвь, проверяемая в запросе на вытягивание. Например: refs/heads/users/raisa/new-feature для Azure Repos. (Эта переменная инициализируется только в том случае, если сборка запущена из-за того, что в ней затронута политика ветви Git). Эта переменная доступна только в конвейере YAML, если на запрос на вытягивание влияет политика ветви. Нет
System. PullRequest. Саурцерепоситорюри URL-адрес репозитория, который содержит запрос на вытягивание. Например: https://dev.azure.com/ouraccount/_git/OurProject. нет
System. PullRequest. Таржетбранч Ветвь, которая является целевым объектом запроса на вытягивание. например, refs/heads/master если репозиторий находится в Azure Repos и master когда репозиторий находится в GitHub. Эта переменная инициализируется только в том случае, если сборка запущена из-за того, что в ней затронута политика ветви. Эта переменная доступна только в конвейере YAML, если на запрос на вытягивание влияет политика ветви. Нет
System. Теамфаундатионколлектионури универсальный код ресурса (URI) коллекции TFS или Azure DevOps организации. Например: https://dev.azure.com/fabrikamfiber/.

Эта переменная имеет область действия агента, и ее можно использовать как переменную среды в скрипте и как параметр в задаче сборки, но не как часть номера сборки или как тег управления версиями.
Да
System.TeamProject Имя проекта, который содержит эту сборку. Да
System. Теампрожектид ИДЕНТИФИКАТОР проекта, к которому принадлежит эта сборка. Да
TF_BUILD Задайте значение, True Если скрипт выполняется задачей сборки.

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

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

ПеременнаяОписание
Проверяет. Стажеаттемпт Задайте значение 1 при первом запуске этого этапа и увеличивается при каждом повторении этапа.

Эту переменную можно использовать только в утверждении или проверке среды. Например, можно использовать $(Checks.StageAttempt) в $(Checks.StageAttempt).

Add the stage attempt as a parameter.

переменные агента (DevOps Server 2020)

Примечание

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

ПеременнаяОписание
Agent. BuildDirectory

Локальный путь на агенте, где создаются все папки для данного конвейера сборки. Эта переменная имеет то же значение, что и Pipeline.Workspace .

Пример: /home/vsts/work/1

Agent. Хомедиректори Каталог, в который устанавливается агент. Содержит программное обеспечение агента. Например: c:\agent.
Agent.Id Идентификатор агента.
Agent. JobName Имя выполняемого задания. Обычно это "Job" или "__default", но в сценариях с несколькими конфигурациями будет конфигурация.
Agent. JobStatus Состояние сборки.
  • Canceled
  • Failed
  • Succeeded
  • SucceededWithIssues (частично успешно)

На переменную среды следует ссылаться как на AGENT_JOBSTATUS . Более старая версия agent.jobstatus доступна для обеспечения обратной совместимости.

Agent. MachineName Имя компьютера, на котором установлен агент.
Agent.Name

Имя агента, зарегистрированного в пуле.

Если используется агент, размещенный в собственном расположении, это имя указывается пользователем. См. раздел агенты.

Agent.OS Операционная система узла агента. Допустимые значения:
  • Windows_NT
  • Darwin
  • Linux
Если вы используете контейнер, узел агента и контейнер могут работать под управлением разных операционных систем.
Agent. Осарчитектуре Архитектура процессора операционной системы узла агента. Допустимые значения:
  • X86
  • X64
  • ARM
Agent. TempDirectory

Временная папка, которая очищается после каждого задания конвейера. Этот каталог используется такими задачами, как .NET Core CLI задача для хранения временных элементов, таких как результаты теста перед их публикацией.

Пример: /home/vsts/work/_temp для Ubuntu

Agent. Тулсдиректори Каталог, используемый задачами, такими как установщик инструмента node , и использование версии Python для переключения между несколькими версиями средства. Эти задачи приводят к добавлению средств из этого каталога в PATH , чтобы последующие шаги сборки могли их использовать.

Сведения об управлении этим каталогом на собственном агенте.
Agent. WorkFolder Рабочий каталог для этого агента. Например: c:\agent_work.

Примечание. не гарантируется, что этот каталог будет доступен для записи с помощью задач конвейера (например, При сопоставлении с контейнером)

переменные сборки (DevOps Server 2020)


ПеременнаяОписаниеДоступно в шаблонах?
Сборка. ArtifactStagingDirectory

Локальный путь на агенте, в который копируются все артефакты перед отправкой в назначение. Пример: c:\agent_work\1\a

Обычным способом использования этой папки является публикация артефактов сборки с помощью задач копирование файлов и Публикация артефактов сборки .

Примечание. сборка. ArtifactStagingDirectory и сборка. StagingDirectory являются взаимозаменяемыми. Этот каталог очищается перед каждой новой сборкой, поэтому вам не нужно очищать его самостоятельно.

см. Artifacts в Azure Pipelines.

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

Нет
Сборка. BuildId Идентификатор записи для завершенной сборки. Нет
Build.BuildNumber Имя завершенной сборки, также называемое номером запуска. Можно указать, что включается в это значение.

Обычно эта переменная используется для того, чтобы сделать ее частью формата метки, указанного на вкладке репозиторий.

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



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

Нет
Сборка. ее BuildUri Универсальный код ресурса (URI) для сборки. Например: vstfs:///Build/Build/1430.

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

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

Например: c:\agent_work\1\b.

Эта переменная имеет область действия агента, и ее можно использовать как переменную среды в скрипте и как параметр в задаче сборки, но не как часть номера сборки или как тег управления версиями.
Нет
Сборка. ContainerId Идентификатор контейнера для артефакта. При передаче артефакта в конвейер он добавляется в контейнер, относящийся к конкретному артефакту. Нет
Build.DefinitionName Имя конвейера сборки.

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

Да
Сборка. Дефинитионверсион Версия конвейера сборки. Да
Сборка. Куеуедби См. раздел "как устанавливаютсяпеременные удостоверений?".

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

Да
Сборка. Куеуедбид См. раздел "как устанавливаютсяпеременные удостоверений?". Да
Сборка. Причина Событие, вызвавшее запуск сборки.
  • Manual: Пользователь вручную помещает сборку в очередь.
  • IndividualCI: IndividualCI , активируемая при возврате Git или TFVC.
  • BatchedCI: BatchedCI , активируемая при возврате Git или TFVC, и были выбраны изменения пакета .
  • Schedule: Триггер по Schedule .
  • ValidateShelveset: Пользователь вручную помещает сборку в очередь для определенного набора отложенных изменений TFVC.
  • CheckInShelveset: Триггер CheckInShelveset .
  • PullRequest: Сборка была активирована политикой ветви Git, для которой требуется сборка.
  • ResourceTrigger: Сборка была ResourceTrigger или вызвана другой сборкой.
См. раздел Создание триггеров конвейера, улучшение качества кода с помощью политик ветвей.
Да
Сборка. репозиторий. Очистка Значение, выбранное для очистки в исходных параметрах репозитория.

Эта переменная имеет область действия агента, и ее можно использовать как переменную среды в скрипте и как параметр в задаче сборки, но не как часть номера сборки или как тег управления версиями.
Нет
Сборка. репозиторий. LocalPath

Локальный путь на агенте, куда загружаются файлы исходного кода. Пример: c:\agent_work\1\s

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

Важное примечание. Если вы извлекаете только один репозиторий Git, этот путь будет точным путем к коду. Если вы извлекаете несколько репозиториев, поведение будет следующим (и может отличаться от значения переменной Build. SourcesDirectory):

  • Если на шаге извлечения для самого себя (первичного) репозитория не определен пользовательский путь извлечения или путь извлечения является путем множественного извлечения $(Pipeline.Workspace)/s/<RepoName> для саморепозитория, то значение этой переменной вернется к значению по умолчанию, то есть $(Pipeline.Workspace)/s .
  • Если на шаге извлечения для самого себя (первичного) репозитория определен пользовательский путь извлечения (а не путь, используемый по умолчанию для множественного извлечения), эта переменная будет содержать точный путь к собственному репозиторию.
Эта переменная имеет область действия агента, и ее можно использовать как переменную среды в скрипте и как параметр в задаче сборки, но не как часть номера сборки или как тег управления версиями.
Нет
Build.Repository.ID Уникальный идентификатор репозитория.

Это не изменится, даже если имя репозитория выполняется.

Эта переменная имеет область действия агента, и ее можно использовать как переменную среды в скрипте и как параметр в задаче сборки, но не как часть номера сборки или как тег управления версиями.
Нет
Build.Repository.Name Имя репозитория, запускающего триггер.

Эта переменная имеет область действия агента, и ее можно использовать как переменную среды в скрипте и как параметр в задаче сборки, но не как часть номера сборки или как тег управления версиями.
Нет
Сборка. репозиторий. поставщик Тип репозитория, запускающего триггер.
  • TfsGit: TfsGit
  • TfsVersionControl: TfsVersionControl
  • Git: Репозиторий Git, размещенный на внешнем сервере
  • GitHub
  • Svn: Subversion
Эта переменная имеет область действия агента, и ее можно использовать как переменную среды в скрипте и как параметр в задаче сборки, но не как часть номера сборки или как тег управления версиями.
Нет
Сборка. репозиторий. TFVC. Workspace определяется, если репозиторий система управления версиями Team Foundation. Имя рабочей области TFVC , используемой агентом сборки.


Например, если Agent. BuildDirectory имеет значение c:\agent_work\12 , а Agent.ID — 8 , имя рабочей области может быть следующим: ws_12_8

Эта переменная имеет область действия агента, и ее можно использовать как переменную среды в скрипте и как параметр в задаче сборки, но не как часть номера сборки или как тег управления версиями.
Нет
Сборка. репозиторий. URI URL-адрес репозитория, запускающего триггер. Например: Эта переменная имеет область действия агента, и ее можно использовать как переменную среды в скрипте и как параметр в задаче сборки, но не как часть номера сборки или как тег управления версиями. Нет
Сборка. RequestedFor См. раздел "как устанавливаютсяпеременные удостоверений?".

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

Да
Сборка. Рекуестедфоремаил См. раздел "как устанавливаютсяпеременные удостоверений?". Да
Сборка. Рекуестедфорид См. раздел "как устанавливаютсяпеременные удостоверений?". Да
Build.SourceBranch Ветвь репозитория активации, для которой была поставлена сборка. Некоторые примеры.
  • Ветвь репозитория Git: refs/heads/master
  • Запрос на вытягивание репозитория Git: refs/pull/1/merge
  • Ветвь репозитория TFVC: $/teamproject/main
  • Запись с проверкой изменений в репозитории TFVC: Gated_2016-06-06_05.20.51.4369;username@live.com
  • Сборка набора отложенных изменений репозитория TFVC: myshelveset;username@live.com
  • При активации конвейера с помощью тега: refs/tags/your-tag-name
При использовании этой переменной в формате номера сборки символы косой черты ( / ) заменяются символами подчеркивания _ .

Примечание. в TFVC при выполнении сборки с условным возвратом или создании набора отложенных изменений вручную эту переменную нельзя использовать в вашем формате номера сборки.
Да
Сборка. Саурцебранчнаме Имя ветви в репозитории триггеров, для которого сборка была поставлена в очередь.
  • Ветвь репозитория Git или запрос на вытягивание: последний сегмент пути в ссылке. Например, в refs/heads/master этом значении задано значение master . В refs/heads/feature/tools этом значении это значение равно tools .
  • Ветвь репозитория TFVC: последний сегмент пути в корневом каталоге сервера для рабочей области. Например, в $/teamproject/main этом значении задано значение main .
  • TFVCный возврат или сборка набора отложенных изменений репозитория с проверкой поименования — это имя набора отложенных изменений. Например, Gated_2016-06-06_05.20.51.4369;username@live.com или myshelveset;username@live.com.
Примечание. в TFVC при выполнении сборки с условным возвратом или создании набора отложенных изменений вручную эту переменную нельзя использовать в вашем формате номера сборки.
Да
Сборка. SourcesDirectory

Локальный путь на агенте, куда загружаются файлы исходного кода. Пример: c:\agent_work\1\s

По умолчанию новые конвейеры сборки обновляют только измененные файлы.

Важное примечание. Если вы извлекаете только один репозиторий Git, этот путь будет точным путем к коду. Если вы выберете несколько репозиториев, будет возвращено значение по умолчанию, то есть $(Pipeline.Workspace)/s даже если первичный (основной) репозиторий извлечен в пользовательский путь, отличный от используемого по умолчанию пути множественного извлечения $(Pipeline.Workspace)/s/<RepoName> (в данном случае переменная отличается от поведения переменной Build. Repository. LocalPath).

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

Нет
Сборка. SourceVersion Последний измененный элемент управления версиями в репозитории триггеров, включенном в эту сборку. Эта переменная имеет область действия агента, и ее можно использовать как переменную среды в скрипте и как параметр в задаче сборки, но не как часть номера сборки или как тег управления версиями. Да
Сборка. Саурцеверсионмессаже Комментарий к фиксации или набору изменений для репозитория, вызывающего срабатывание. Мы усекаете сообщение до первой строки или 200 символов, в зависимости от того, что короче.

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

Примечание. Эта переменная доступна в TFS 2015,4.

Нет
Сборка. StagingDirectory

Локальный путь на агенте, в который копируются все артефакты перед отправкой в назначение. Пример: c:\agent_work\1\a

Обычным способом использования этой папки является публикация артефактов сборки с помощью задач копирование файлов и Публикация артефактов сборки .

Примечание. сборка. ArtifactStagingDirectory и сборка. StagingDirectory являются взаимозаменяемыми. Этот каталог очищается перед каждой новой сборкой, поэтому вам не нужно очищать его самостоятельно.

см. Artifacts в Azure Pipelines.

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

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

Эта переменная имеет область действия агента, и ее можно использовать как переменную среды в скрипте и как параметр в задаче сборки, но не как часть номера сборки или как тег управления версиями.
Нет
Сборка. Саурцетфвкшелвесет определяется, если репозиторий система управления версиями Team Foundation.


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

Примечание. Эта переменная дает значение, недопустимое для использования сборки в формате номера сборки.
Нет
Сборка. Тригжередби. BuildId Если сборка была активирована другой сборкой, то для этой переменной задается значение BuildID сборки, вызывающей срабатывание. В классических конвейерах эта переменная активируется триггером завершения сборки.

Эта переменная имеет область действия агента, и ее можно использовать как переменную среды в скрипте и как параметр в задаче сборки, но не как часть номера сборки или как тег управления версиями.
Нет
Сборка. Тригжередби. DefinitionId Если сборка была активирована другой сборкой, то для этой переменной задается значение DefinitionID сборки, вызывающей срабатывание. В классических конвейерах эта переменная активируется триггером завершения сборки.

Эта переменная имеет область действия агента, и ее можно использовать как переменную среды в скрипте и как параметр в задаче сборки, но не как часть номера сборки или как тег управления версиями.
Нет
Сборка. Тригжередби. DefinitionName Если сборка была активирована другой сборкой, то для этой переменной задается имя активируемого конвейера сборки. В классических конвейерах эта переменная активируется триггером завершения сборки.

Эта переменная имеет область действия агента, и ее можно использовать как переменную среды в скрипте и как параметр в задаче сборки, но не как часть номера сборки или как тег управления версиями.
Нет
Сборка. Тригжередби. BuildNumber Если сборка была активирована другой сборкой, то для этой переменной задается номер сборки, вызывающей срабатывание. В классических конвейерах эта переменная активируется триггером завершения сборки.

Эта переменная имеет область действия агента, и ее можно использовать как переменную среды в скрипте и как параметр в задаче сборки, но не как часть номера сборки или как тег управления версиями.
Нет
Сборка. Тригжередби. ProjectID Если сборка была активирована другой сборкой, то для этой переменной задается идентификатор проекта, содержащего инициированную сборку. В классических конвейерах эта переменная активируется триггером завершения сборки.

Эта переменная имеет область действия агента, и ее можно использовать как переменную среды в скрипте и как параметр в задаче сборки, но не как часть номера сборки или как тег управления версиями.
Нет
Common. Тестресултсдиректори Локальный путь на агенте, где создаются результаты теста. Пример: c:\agent_work\1\TestResults

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

переменные конвейера (DevOps Server 2020)

ПеременнаяОписание
Конвейер. Рабочая область Каталог рабочей области для конкретного конвейера. Эта переменная имеет то же значение, что и Agent.BuildDirectory .

Например, /home/vsts/work/1.

переменные задания развертывания (DevOps Server 2020)

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

ПеременнаяОписание
Environment.Name Имя среды, целевой в задании развертывания, для выполнения шагов развертывания и записи журнала развертывания. Например, smarthotel-dev.
Environment.Id Идентификатор среды, целевой для задания развертывания. Например, 10.
Environment. ResourceName Имя конкретного ресурса в среде, целевой в задании развертывания, для выполнения шагов развертывания и записи журнала развертывания. Например, bookings это пространство имен Kubernetes, добавленное в качестве ресурса в среду smarthotel-dev .
Environment. ResourceId Идентификатор конкретного ресурса в среде, целевой в задании развертывания для выполнения шагов развертывания. Например, 4.

системные переменные (DevOps Server 2020)

ПеременнаяОписаниеДоступно в шаблонах?
System. AccessToken Используйте маркер OAuth для доступа к REST API.

Используйте System. AccessToken из скриптов YAML.

Эта переменная имеет область действия агента, и ее можно использовать как переменную среды в скрипте и как параметр в задаче сборки, но не как часть номера сборки или как тег управления версиями.
Да
System. CollectionId идентификатор GUID коллекции TFS или Azure DevOps организации Да
System. Uri_коллекции строка URI коллекции Team Foundation Server. Да
System. DefaultWorkingDirectory

Локальный путь на агенте, куда загружаются файлы исходного кода. Пример: c:\agent_work\1\s

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

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

Нет
System. DefinitionId Идентификатор конвейера сборки. Да
System. HostType Задайте значение, build Если конвейер является сборкой. Для выпуска значения задаются deployment для задания группы развертывания, в gates ходе оценки шлюзов, а release также для других (агентов и безагентных) заданий. Да
System. Жобаттемпт Задайте значение 1 при первом запуске этого задания и увеличивается при каждом повторении задания. Нет
System. Жобдисплайнаме Удобное для восприятия имя, присвоенное заданию. Нет
System. JobId Уникальный идентификатор для одной попытки выполнения одного задания. Значение уникально для текущего конвейера. Нет
System. JobName Имя задания, обычно используемое для выражения зависимостей и доступа к выходным переменным. Нет
System. Фасеаттемпт Задайте значение 1 при первом запуске этого этапа и увеличивается при каждом повторении задания.

Примечание. "Этап" — это наиболее избыточная концепция, которая представляет время разработки для задания (в то время как задание — это версия этапа выполнения фазы). В основном мы удалили понятие "этап" из Azure Pipelines. Задания Matrix и Multi-config являются единственным местом, где "этап" по-прежнему отличается от "Job". На одном этапе можно создать экземпляры нескольких заданий, которые отличаются только входными данными.
Нет
System. Фаседисплайнаме Удобное для восприятия имя, присвоенное этапу. Нет
System. Фасенаме Основанный на строках идентификатор задания, обычно используемый для выражения зависимостей и доступа к выходным переменным. Нет
System. Стажеаттемпт Задайте значение 1 при первом запуске этого этапа и увеличивается при каждом повторении задания. Нет
System. Стажедисплайнаме Удобное для восприятия имя, заданное для этапа. Нет
System. Стаженаме Основанный на строках идентификатор для этапа, обычно используемый для выражения зависимостей и доступа к выходным переменным. Да
System. PullRequest. подвилка Если запрос на вытягивание происходит из разветвления репозитория, для этой переменной задается значение True . В противном случае для него задается значение False . Да
System. PullRequest. PullRequestId Идентификатор запроса на вытягивание, вызвавшего эту сборку. Например: 17. (Эта переменная инициализируется только в том случае, если сборка запущена из-за того, что в ней затронута политика ветви Git). Нет
System. PullRequest. Пуллрекуестнумбер Номер запроса на вытягивание, вызвавшего эту сборку. эта переменная заполняется для запросов на вытягивание от GitHub, имеющих другой идентификатор запроса на вытягивание и номер запроса на включение внесенных изменений. Эта переменная доступна только в конвейере YAML, если политика ветвления затронула значение PR. Нет
System. PullRequest. параметр sourcebranch Ветвь, проверяемая в запросе на вытягивание. Например: refs/heads/users/raisa/new-feature. (Эта переменная инициализируется только в том случае, если сборка запущена из-за того, что в ней затронута политика ветви Git). Эта переменная доступна только в конвейере YAML, если на запрос на вытягивание влияет политика ветви. Нет
System. PullRequest. Саурцерепоситорюри URL-адрес репозитория, который содержит запрос на вытягивание. Например: https://dev.azure.com/ouraccount/_git/OurProject. нет
System. PullRequest. Таржетбранч Ветвь, которая является целевым объектом запроса на вытягивание. например, refs/heads/master если репозиторий находится в Azure Repos и master когда репозиторий находится в GitHub. Эта переменная инициализируется только в том случае, если сборка запущена из-за того, что в ней затронута политика ветви. Эта переменная доступна только в конвейере YAML, если на запрос на вытягивание влияет политика ветви. Нет
System. Теамфаундатионколлектионури Универсальный код ресурса (URI) коллекции Team Foundation. Пример: https://dev.azure.com/fabrikamfiber/

Эта переменная имеет область действия агента, и ее можно использовать как переменную среды в скрипте и как параметр в задаче сборки, но не как часть номера сборки или как тег управления версиями.
Да
System.TeamProject Имя проекта, который содержит эту сборку. Да
System. Теампрожектид ИДЕНТИФИКАТОР проекта, к которому принадлежит эта сборка. Да
TF_BUILD Задайте значение, True Если скрипт выполняется задачей сборки.

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

переменные агента (DevOps Server 2019)

Примечание

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

ПеременнаяОписание
Agent. BuildDirectory

Локальный путь на агенте, где создаются все папки для данного конвейера сборки.

Пример: c:\agent_work\1

Agent. Хомедиректори Каталог, в который устанавливается агент. Содержит программное обеспечение агента. Например: c:\agent.
Agent.Id Идентификатор агента.
Agent. JobName Имя выполняемого задания. Обычно это "Job" или "__default", но в сценариях с несколькими конфигурациями будет конфигурация.
Agent. JobStatus Состояние сборки.
  • Canceled
  • Failed
  • Succeeded
  • SucceededWithIssues (частично успешно)

На переменную среды следует ссылаться как на AGENT_JOBSTATUS . Более старая версия agent.jobstatus доступна для обеспечения обратной совместимости.

Agent. MachineName Имя компьютера, на котором установлен агент.
Agent.Name

Имя агента, зарегистрированного в пуле.

Если используется агент, размещенный в собственном расположении, это имя указывается пользователем. См. раздел агенты.

Agent.OS Операционная система узла агента. Допустимые значения:
  • Windows_NT
  • Darwin
  • Linux
Если вы используете контейнер, узел агента и контейнер могут работать под управлением разных операционных систем.
Agent. Осарчитектуре Архитектура процессора операционной системы узла агента. Допустимые значения:
  • X86
  • X64
  • ARM
Agent. TempDirectory Временная папка, которая очищается после каждого задания конвейера. Этот каталог используется такими задачами, как .NET Core CLI задача для хранения временных элементов, таких как результаты теста перед их публикацией.
Agent. Тулсдиректори Каталог, используемый задачами, такими как установщик инструмента node , и использование версии Python для переключения между несколькими версиями средства. Эти задачи приводят к добавлению средств из этого каталога в PATH , чтобы последующие шаги сборки могли их использовать.

Сведения об управлении этим каталогом на собственном агенте.
Agent. WorkFolder Рабочий каталог для этого агента. Например: c:\agent_work.

Не гарантируется, что этот каталог будет доступен для записи с помощью задач конвейера (например, При сопоставлении с контейнером)

переменные сборки (DevOps Server 2019)


ПеременнаяОписание
Сборка. ArtifactStagingDirectory

Локальный путь на агенте, в который копируются все артефакты перед отправкой в назначение. Пример: c:\agent_work\1\a

Обычным способом использования этой папки является публикация артефактов сборки с помощью задач копирование файлов и Публикация артефактов сборки .

Примечание. сборка. ArtifactStagingDirectory и сборка. StagingDirectory являются взаимозаменяемыми. Этот каталог очищается перед каждой новой сборкой, поэтому вам не нужно очищать его самостоятельно.

см. Artifacts в Azure Pipelines.

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

Сборка. BuildId Идентификатор записи для завершенной сборки.
Build.BuildNumber Имя завершенной сборки. Можно указать формат номера сборки, который создает это значение в параметрах конвейера.

Обычно эта переменная используется для того, чтобы сделать ее частью формата метки, указанного на вкладке репозиторий.

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



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

Сборка. ее BuildUri Универсальный код ресурса (URI) для сборки. Например: vstfs:///Build/Build/1430.

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

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

Например: c:\agent_work\1\b.

Эта переменная имеет область действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в качестве части номера сборки или тега управления версиями.
Build.DefinitionName Имя конвейера сборки.

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

Сборка. Дефинитионверсион Версия конвейера сборки.
Сборка. Куеуедби См. раздел "как устанавливаютсяпеременные удостоверений?".

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

Сборка. Куеуедбид См. раздел "как устанавливаютсяпеременные удостоверений?".
Сборка. Причина Событие, вызвавшее запуск сборки.
  • Manual: Пользователь вручную помещает сборку в очередь.
  • IndividualCI: IndividualCI , активируемая при возврате Git или TFVC.
  • BatchedCI: BatchedCI , активируемая при возврате Git или TFVC, и были выбраны изменения пакета .
  • Schedule: Триггер по Schedule .
  • ValidateShelveset: Пользователь вручную помещает сборку в очередь для определенного набора отложенных изменений TFVC.
  • CheckInShelveset: Триггер CheckInShelveset .
  • PullRequest: Сборка была активирована политикой ветви Git, для которой требуется сборка.
  • BuildCompletion: Сборка была BuildCompletion
См. раздел Создание триггеров конвейера, улучшение качества кода с помощью политик ветвей.
Сборка. репозиторий. Очистка Значение, выбранное для очистки в исходных параметрах репозитория.

Эта переменная имеет область действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в качестве части номера сборки или тега управления версиями.
Сборка. репозиторий. LocalPath

Локальный путь на агенте, куда загружаются файлы исходного кода. Пример: c:\agent_work\1\s

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

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

Эта переменная является синонимом сборки. SourcesDirectory.

Build.Repository.Name Имя репозитория.

Эта переменная имеет область действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в качестве части номера сборки или тега управления версиями.
Сборка. репозиторий. поставщик Тип выбранного репозитория.
  • TfsGit: TfsGit
  • TfsVersionControl: TfsVersionControl
  • Git: Репозиторий Git, размещенный на внешнем сервере
  • GitHub
  • Svn: Subversion
Эта переменная имеет область действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в качестве части номера сборки или тега управления версиями.
Сборка. репозиторий. TFVC. Workspace определяется, если репозиторий система управления версиями Team Foundation. Имя рабочей области TFVC , используемой агентом сборки.


Например, если Agent. BuildDirectory имеет значение c:\agent_work\12 , а Agent.ID — 8 , имя рабочей области может быть следующим: ws_12_8

Эта переменная имеет область действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в качестве части номера сборки или тега управления версиями.
Сборка. репозиторий. URI URL-адрес репозитория. Например: Эта переменная имеет область действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в качестве части номера сборки или тега управления версиями.
Сборка. RequestedFor См. раздел "как устанавливаютсяпеременные удостоверений?".

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

Сборка. Рекуестедфоремаил См. раздел "как устанавливаютсяпеременные удостоверений?".
Сборка. Рекуестедфорид См. раздел "как устанавливаютсяпеременные удостоверений?".
Build.SourceBranch Ветвь, в которой была поставлена сборка в очереди. Некоторые примеры.
  • Ветвь репозитория Git: refs/heads/master
  • Запрос на вытягивание репозитория Git: refs/pull/1/merge
  • Ветвь репозитория TFVC: $/teamproject/main
  • Запись с проверкой изменений в репозитории TFVC: Gated_2016-06-06_05.20.51.4369;username@live.com
  • Сборка набора отложенных изменений репозитория TFVC: myshelveset;username@live.com
При использовании этой переменной в формате номера сборки символы косой черты ( / ) заменяются символами подчеркивания _ .

Примечание. в TFVC при выполнении сборки с условным возвратом или создании набора отложенных изменений вручную эту переменную нельзя использовать в вашем формате номера сборки.
Сборка. Саурцебранчнаме Имя ветви, в которой была поставлена сборка.
  • Ветвь репозитория Git или запрос на вытягивание: последний сегмент пути в ссылке. Например, в refs/heads/master этом значении задано значение master . В refs/heads/feature/tools этом значении это значение равно tools .
  • Ветвь репозитория TFVC: последний сегмент пути в корневом каталоге сервера для рабочей области. Например, в $/teamproject/main этом значении main .
  • TFVCный возврат или сборка набора отложенных изменений репозитория с проверкой поименования — это имя набора отложенных изменений. Например, Gated_2016-06-06_05.20.51.4369;username@live.com или myshelveset;username@live.com.
Примечание. в TFVC при выполнении сборки с условным возвратом или создании набора отложенных изменений вручную эту переменную нельзя использовать в вашем формате номера сборки.
Сборка. SourcesDirectory

Локальный путь на агенте, куда загружаются файлы исходного кода. Пример: c:\agent_work\1\s

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

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

Эта переменная является синонимом Build. Repository. LocalPath.

Сборка. SourceVersion Последнее изменение управления версиями, включенное в эту сборку. Эта переменная имеет область действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в качестве части номера сборки или тега управления версиями.
Сборка. Саурцеверсионмессаже Комментарий к фиксации или набору изменений. Мы усекаете сообщение до первой строки или 200 символов, в зависимости от того, что короче.

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

Примечание. Эта переменная доступна в TFS 2015,4.

Сборка. StagingDirectory

Локальный путь на агенте, в который копируются все артефакты перед отправкой в назначение. Пример: c:\agent_work\1\a

Обычным способом использования этой папки является публикация артефактов сборки с помощью задач копирование файлов и Публикация артефактов сборки .

Примечание. сборка. ArtifactStagingDirectory и сборка. StagingDirectory являются взаимозаменяемыми. Этот каталог очищается перед каждой новой сборкой, поэтому вам не нужно очищать его самостоятельно.

см. Artifacts в Azure Pipelines.

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

Сборка. репозиторий. git. Субмодулечеккаут Значение, выбранное для подмодулей Checkout на вкладке репозиторий.

Эта переменная имеет область действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в качестве части номера сборки или тега управления версиями.
Сборка. Саурцетфвкшелвесет определяется, если репозиторий система управления версиями Team Foundation.


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

Примечание. Эта переменная дает значение, недопустимое для использования сборки в формате номера сборки.
Сборка. Тригжередби. BuildId Если сборка была активирована другой сборкой, то для этой переменной задается значение BuildID сборки, вызывающей срабатывание.

Эта переменная имеет область действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в качестве части номера сборки или тега управления версиями.
Сборка. Тригжередби. DefinitionId Если сборка была активирована другой сборкой, то для этой переменной задается значение DefinitionID сборки, вызывающей срабатывание.

Эта переменная имеет область действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в качестве части номера сборки или тега управления версиями.
Сборка. Тригжередби. DefinitionName Если сборка была активирована другой сборкой, то для этой переменной задается имя активируемого конвейера сборки.

Эта переменная имеет область действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в качестве части номера сборки или тега управления версиями.
Сборка. Тригжередби. BuildNumber Если сборка была активирована другой сборкой, то для этой переменной задается номер сборки, вызывающей срабатывание.

Эта переменная имеет область действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в качестве части номера сборки или тега управления версиями.
Сборка. Тригжередби. ProjectID Если сборка была активирована другой сборкой, то для этой переменной задается идентификатор проекта, содержащего инициированную сборку.

Эта переменная имеет область действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в качестве части номера сборки или тега управления версиями.
Common. Тестресултсдиректори Локальный путь на агенте, где создаются результаты теста. Пример: c:\agent_work\1\TestResults

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

системные переменные (DevOps Server 2019)

ПеременнаяОписание
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. подвилка Если запрос на вытягивание происходит из разветвления репозитория, для этой переменной задается значение True . В противном случае для него задается значение False .
System. PullRequest. PullRequestId Идентификатор запроса на вытягивание, вызвавшего эту сборку. Например: 17. (Эта переменная инициализируется только в том случае, если сборка запущена из-за того, что в ней затронута политика ветви.)
System. PullRequest. Пуллрекуестнумбер Номер запроса на вытягивание, вызвавшего эту сборку. эта переменная заполняется для запросов на вытягивание от GitHub, имеющих другой идентификатор запроса на вытягивание и номер запроса на включение внесенных изменений.
System. PullRequest. параметр sourcebranch Ветвь, проверяемая в запросе на вытягивание. Например: refs/heads/users/raisa/new-feature. (Эта переменная инициализируется только в том случае, если сборка запущена из-за того, что в ней затронута политика ветви.)
System. PullRequest. Саурцерепоситорюри URL-адрес репозитория, который содержит запрос на вытягивание. Например: https://dev.azure.com/ouraccount/_git/OurProject. (эта переменная инициализируется только в том случае, если сборка запущена из-за Azure Repos Git, затронутых политикой ветви. он не инициализируется для GitHub вытягивание.)
System. PullRequest. Таржетбранч Ветвь, которая является целевым объектом запроса на вытягивание. Например: refs/heads/master. Эта переменная инициализируется только в том случае, если сборка запущена из-за того, что в ней затронута политика ветви.
System. Теамфаундатионколлектионури Универсальный код ресурса (URI) коллекции Team Foundation. Например: https://dev.azure.com/fabrikamfiber/.

Эта переменная имеет область действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в качестве части номера сборки или тега управления версиями.
System.TeamProject Имя проекта, который содержит эту сборку.
System. Теампрожектид ИДЕНТИФИКАТОР проекта, к которому принадлежит эта сборка.
TF_BUILD Задайте значение, True Если скрипт выполняется задачей сборки.

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

Переменные агента (TFS 2018)

Примечание

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

ПеременнаяОписание
Agent. BuildDirectory

Локальный путь на агенте, где создаются все папки для данного конвейера сборки.

Пример: c:\agent_work\1

Agent. Хомедиректори Каталог, в который устанавливается агент. Содержит программное обеспечение агента. Например: c:\agent.
Agent.Id Идентификатор агента.
Agent. JobStatus Состояние сборки.
  • Canceled
  • Failed
  • Succeeded
  • SucceededWithIssues (частично успешно)

На переменную среды следует ссылаться как на AGENT_JOBSTATUS . Более старая версия agent.jobstatus доступна для обеспечения обратной совместимости.

Agent. MachineName Имя компьютера, на котором установлен агент.
Agent.Name

Имя агента, зарегистрированного в пуле.

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

Agent. TempDirectory Временная папка, которая очищается после каждого задания конвейера. Этот каталог используется такими задачами, как .NET Core CLI задача для хранения временных элементов, таких как результаты теста перед их публикацией.
Agent. Тулсдиректори Каталог, используемый задачами, такими как установщик инструмента node , и использование версии Python для переключения между несколькими версиями средства. Эти задачи приводят к добавлению средств из этого каталога в PATH , чтобы последующие шаги сборки могли их использовать.

Сведения об управлении этим каталогом на собственном агенте.
Agent. WorkFolder Рабочий каталог для этого агента. Например: c:\agent_work.

Переменные сборки (TFS 2018)


ПеременнаяОписание
Сборка. ArtifactStagingDirectory Локальный путь на агенте, в который копируются все артефакты перед отправкой в назначение.

Локальный путь на агенте, в который копируются все артефакты перед отправкой в назначение. Пример: c:\agent_work\1\a

Обычным способом использования этой папки является публикация артефактов сборки с помощью задач копирование файлов и Публикация артефактов сборки .

Примечание. сборка. ArtifactStagingDirectory и сборка. StagingDirectory являются взаимозаменяемыми. Этот каталог очищается перед каждой новой сборкой, поэтому вам не нужно очищать его самостоятельно.

см. Artifacts в Azure Pipelines.

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

Сборка. BuildId Идентификатор записи для завершенной сборки.
Build.BuildNumber Имя завершенной сборки. Можно указать формат номера сборки, который создает это значение в параметрах конвейера.

Обычно эта переменная используется для того, чтобы сделать ее частью формата метки, указанного на вкладке репозиторий.

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



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

Сборка. ее BuildUri Универсальный код ресурса (URI) для сборки. Например: vstfs:///Build/Build/1430.

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

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

Например: c:\agent_work\1\b.

Эта переменная имеет область действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в качестве части номера сборки или тега управления версиями.
Build.DefinitionName Имя конвейера сборки.

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

Сборка. Дефинитионверсион Версия конвейера сборки.
Сборка. Куеуедби См. раздел "как устанавливаютсяпеременные удостоверений?".

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

Сборка. Куеуедбид См. раздел "как устанавливаютсяпеременные удостоверений?".
Сборка. Причина Событие, вызвавшее запуск сборки.
  • Manual: Пользователь вручную помещает сборку в очередь из пользовательского интерфейса или вызова API.
  • IndividualCI: IndividualCI , активируемая при возврате Git или TFVC.
  • BatchedCI: BatchedCI , активируемая при возврате Git или TFVC, и были выбраны изменения пакета .
  • Schedule: Триггер по Schedule .
  • ValidateShelveset: Пользователь вручную помещает сборку в очередь для определенного набора отложенных изменений TFVC.
  • CheckInShelveset: Триггер CheckInShelveset .
  • PullRequest: Сборка была активирована политикой ветви Git, для которой требуется сборка.
См. раздел Создание триггеров конвейера, улучшение качества кода с помощью политик ветвей.
Сборка. репозиторий. Очистка Значение, выбранное для очистки в исходных параметрах репозитория.

Эта переменная имеет область действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в качестве части номера сборки или тега управления версиями.
Сборка. репозиторий. LocalPath

Локальный путь на агенте, куда загружаются файлы исходного кода. Пример: c:\agent_work\1\s

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

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

Эта переменная является синонимом сборки. SourcesDirectory.

Build.Repository.Name Имя репозитория.

Эта переменная имеет область действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в качестве части номера сборки или тега управления версиями.
Сборка. репозиторий. поставщик Тип выбранного репозитория.
  • TfsGit: TfsGit
  • TfsVersionControl: TfsVersionControl
  • Git: Репозиторий Git, размещенный на внешнем сервере
  • Svn: Subversion
Эта переменная имеет область действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в качестве части номера сборки или тега управления версиями.
Сборка. репозиторий. TFVC. Workspace определяется, если репозиторий система управления версиями Team Foundation. Имя рабочей области TFVC , используемой агентом сборки.

Например, если Agent. BuildDirectory имеет значение c:\agent_work\12 , а Agent.ID — 8 , имя рабочей области может быть следующим: ws_12_8

Эта переменная имеет область действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в качестве части номера сборки или тега управления версиями.
Сборка. репозиторий. URI URL-адрес репозитория. Например:
  • Git https://fabrikamfiber/tfs/DefaultCollection/Scripts/_git/Scripts
  • TFVC https://fabrikamfiber/tfs/DefaultCollection/
Эта переменная имеет область действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в качестве части номера сборки или тега управления версиями.
Сборка. RequestedFor См. раздел "как устанавливаютсяпеременные удостоверений?".

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

Сборка. Рекуестедфоремаил См. раздел "как устанавливаютсяпеременные удостоверений?".
Сборка. Рекуестедфорид См. раздел "как устанавливаютсяпеременные удостоверений?".
Build.SourceBranch Ветвь, в которой была поставлена сборка в очереди. Некоторые примеры.
  • Ветвь репозитория Git: refs/heads/master
  • Запрос на вытягивание репозитория Git: refs/pull/1/merge
  • Ветвь репозитория TFVC: $/teamproject/main
  • Запись с проверкой изменений в репозитории TFVC: Gated_2016-06-06_05.20.51.4369;username@live.com
  • Сборка набора отложенных изменений репозитория TFVC: myshelveset;username@live.com
При использовании этой переменной в формате номера сборки символы косой черты ( / ) заменяются символами подчеркивания _ .

Примечание. в TFVC при выполнении сборки с условным возвратом или создании набора отложенных изменений вручную эту переменную нельзя использовать в вашем формате номера сборки.
Сборка. Саурцебранчнаме Имя ветви, в которой была поставлена сборка.
  • Ветвь репозитория Git или запрос на вытягивание: последний сегмент пути в ссылке. Например, в refs/heads/master этом значении задано значение master . В refs/heads/feature/tools этом значении это значение равно tools .
  • Ветвь репозитория TFVC: последний сегмент пути в корневом каталоге сервера для рабочей области. Например, в $/teamproject/main этом значении main .
  • TFVCный возврат или сборка набора отложенных изменений репозитория с проверкой поименования — это имя набора отложенных изменений. Например, Gated_2016-06-06_05.20.51.4369;username@live.com или myshelveset;username@live.com.
Примечание. в TFVC при выполнении сборки с условным возвратом или создании набора отложенных изменений вручную эту переменную нельзя использовать в вашем формате номера сборки.
Сборка. SourcesDirectory

Локальный путь на агенте, куда загружаются файлы исходного кода. Пример: c:\agent_work\1\s

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

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

Эта переменная является синонимом Build. Repository. LocalPath.

Сборка. SourceVersion Последнее изменение управления версиями, включенное в эту сборку. Эта переменная имеет область действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в качестве части номера сборки или тега управления версиями.
Сборка. Саурцеверсионмессаже Комментарий к фиксации или набору изменений. Мы усекаете сообщение до первой строки или 200 символов, в зависимости от того, что короче.

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

Примечание. Эта переменная доступна в TFS 2015,4.

Сборка. StagingDirectory

Локальный путь на агенте, в который копируются все артефакты перед отправкой в назначение. Пример: c:\agent_work\1\a

Обычным способом использования этой папки является публикация артефактов сборки с помощью задач копирование файлов и Публикация артефактов сборки .

Примечание. сборка. ArtifactStagingDirectory и сборка. StagingDirectory являются взаимозаменяемыми. Этот каталог очищается перед каждой новой сборкой, поэтому вам не нужно очищать его самостоятельно.

см. Artifacts в Azure Pipelines.

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

Сборка. репозиторий. git. Субмодулечеккаут Значение, выбранное для подмодулей Checkout на вкладке репозиторий.

Эта переменная имеет область действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в качестве части номера сборки или тега управления версиями.
Сборка. Саурцетфвкшелвесет определяется, если репозиторий система управления версиями Team Foundation.

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

Примечание. Эта переменная дает значение, недопустимое для использования сборки в формате номера сборки.
Common. Тестресултсдиректори Локальный путь на агенте, где создаются результаты теста. Пример: c:\agent_work\1\TestResults

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

Системные переменные (TFS 2018)

ПеременнаяОписание
System. AccessToken Используйте маркер OAuth для доступа к REST API.

Эта переменная имеет область действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в качестве части номера сборки или тега управления версиями.
System. CollectionId идентификатор GUID коллекции TFS или Azure DevOps организации
System. DefaultWorkingDirectory

Локальный путь на агенте, куда загружаются файлы исходного кода. Пример: c:\agent_work\1\s

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

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

System. DefinitionId Идентификатор конвейера сборки.
System. HostType Задайте значение, build Если конвейер является сборкой, или release Если конвейер является выпуском.
System. PullRequest. подвилка Если запрос на вытягивание происходит из разветвления репозитория, для этой переменной задается значение True . В противном случае для него задается значение False . Доступно в TFS 2018,2.
System. PullRequest. PullRequestId Идентификатор запроса на вытягивание, вызвавшего эту сборку. Например: 17. (Эта переменная инициализируется только в том случае, если сборка запущена из-за того, что в ней затронута политика ветви.)
System. PullRequest. параметр sourcebranch Ветвь, проверяемая в запросе на вытягивание. Например: refs/heads/users/raisa/new-feature. (Эта переменная инициализируется только в том случае, если сборка запущена из-за того, что в ней затронута политика ветви.)
System. PullRequest. Саурцерепоситорюри URL-адрес репозитория, который содержит запрос на вытягивание. Например: http://our-server:8080/tfs/DefaultCollection/_git/OurProject. (эта переменная инициализируется только в том случае, если сборка запущена из-за Azure Repos Git, затронутой политикой ветви.)
System. PullRequest. Таржетбранч Ветвь, которая является целевым объектом запроса на вытягивание. Например: refs/heads/master. Эта переменная инициализируется только в том случае, если сборка запущена из-за того, что в ней затронута политика ветви.
System. Теамфаундатионколлектионури Универсальный код ресурса (URI) коллекции Team Foundation. Например: http://our-server:8080/tfs/DefaultCollection/.

Эта переменная имеет область действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в качестве части номера сборки или тега управления версиями.
System.TeamProject Имя проекта, который содержит эту сборку.
System. Теампрожектид ИДЕНТИФИКАТОР проекта, к которому принадлежит эта сборка.
TF_BUILD Задайте значение, True Если скрипт выполняется задачей сборки.

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

Переменные агента (TFS 2017)

Примечание

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

ПеременнаяОписание
Agent. BuildDirectory

Локальный путь на агенте, где создаются все папки для данного конвейера сборки.

Пример: c:\agent_work\1

Agent.ComputerName Имя компьютера, на котором установлен агент.
Agent. Хомедиректори Каталог, в который устанавливается агент. Содержит программное обеспечение агента. Например: c:\agent.
Agent.Id Идентификатор агента.
Agent. JobStatus Состояние сборки.
  • Canceled
  • Failed
  • Succeeded
  • SucceededWithIssues (частично успешно)

На переменную среды следует ссылаться как на AGENT_JOBSTATUS . Более старая версия agent.jobstatus доступна для обеспечения обратной совместимости.

Agent.Name

Имя агента, зарегистрированного в пуле.

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

Agent. WorkFolder Рабочий каталог для этого агента. Например: c:\agent_work.

Переменные сборки (TFS 2017)


ПеременнаяОписание
Сборка. ArtifactStagingDirectory Локальный путь на агенте, в который копируются все артефакты перед отправкой в назначение.

Локальный путь на агенте, в который копируются все артефакты перед отправкой в назначение. Пример: c:\agent_work\1\a

Обычным способом использования этой папки является публикация артефактов сборки с помощью задач копирование файлов и Публикация артефактов сборки .

Примечание. сборка. ArtifactStagingDirectory и сборка. StagingDirectory являются взаимозаменяемыми. Этот каталог очищается перед каждой новой сборкой, поэтому вам не нужно очищать его самостоятельно.

см. Artifacts в Azure Pipelines.

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

Сборка. BuildId Идентификатор записи для завершенной сборки.
Build.BuildNumber Имя завершенной сборки. Можно указать формат номера сборки, который создает это значение в параметрах конвейера.

Обычно эта переменная используется для того, чтобы сделать ее частью формата метки, указанного на вкладке репозиторий.

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



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

Сборка. ее BuildUri Универсальный код ресурса (URI) для сборки. Например: vstfs:///Build/Build/1430.

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

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

Например: c:\agent_work\1\b.

Эта переменная имеет область действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в качестве части номера сборки или тега управления версиями.
Build.DefinitionName Имя конвейера сборки.

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

Сборка. Дефинитионверсион Версия конвейера сборки.
Сборка. Куеуедби См. раздел "как устанавливаютсяпеременные удостоверений?".

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

Сборка. Куеуедбид См. раздел "как устанавливаютсяпеременные удостоверений?".
Сборка. Причина Событие, вызвавшее запуск сборки. Доступно в TFS 2017,3.
  • Manual: Пользователь вручную помещает сборку в очередь.
  • IndividualCI: IndividualCI , активируемая при возврате Git или TFVC.
  • BatchedCI: BatchedCI , активируемая при возврате Git или TFVC, и были выбраны изменения пакета .
  • Schedule: Триггер по Schedule .
  • ValidateShelveset: Пользователь вручную помещает сборку в очередь для определенного набора отложенных изменений TFVC.
  • CheckInShelveset: Триггер CheckInShelveset .
  • PullRequest: Сборка была активирована политикой ветви Git, для которой требуется сборка.
См. раздел Создание триггеров конвейера, улучшение качества кода с помощью политик ветвей.
Сборка. репозиторий. Очистка Значение, выбранное для очистки в исходных параметрах репозитория.

Эта переменная имеет область действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в качестве части номера сборки или тега управления версиями.
Сборка. репозиторий. LocalPath

Локальный путь на агенте, куда загружаются файлы исходного кода. Пример: c:\agent_work\1\s

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

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

Эта переменная является синонимом сборки. SourcesDirectory.

Build.Repository.Name Имя репозитория.

Эта переменная имеет область действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в качестве части номера сборки или тега управления версиями.
Сборка. репозиторий. поставщик Тип выбранного репозитория.
  • TfsGit: TfsGit
  • TfsVersionControl: TfsVersionControl
  • Git: Репозиторий Git, размещенный на внешнем сервере
  • Svn: Subversion
Эта переменная имеет область действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в качестве части номера сборки или тега управления версиями.
Сборка. репозиторий. TFVC. Workspace определяется, если репозиторий система управления версиями Team Foundation. Имя рабочей области TFVC , используемой агентом сборки.

Например, если Agent. BuildDirectory имеет значение c:\agent_work\12 , а Agent.ID — 8 , имя рабочей области может быть следующим: ws_12_8

Эта переменная имеет область действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в качестве части номера сборки или тега управления версиями.
Сборка. репозиторий. URI URL-адрес репозитория. Например:
  • Git https://fabrikamfiber/tfs/DefaultCollection/Scripts/_git/Scripts
  • TFVC https://fabrikamfiber/tfs/DefaultCollection/
Эта переменная имеет область действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в качестве части номера сборки или тега управления версиями.
Сборка. RequestedFor См. раздел "как устанавливаютсяпеременные удостоверений?".

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

Сборка. Рекуестедфоремаил См. раздел "как устанавливаютсяпеременные удостоверений?".
Сборка. Рекуестедфорид См. раздел "как устанавливаютсяпеременные удостоверений?".
Build.SourceBranch Ветвь, в которой была поставлена сборка в очереди. Некоторые примеры.
  • Ветвь репозитория Git: refs/heads/master
  • Запрос на вытягивание репозитория Git: refs/pull/1/merge
  • Ветвь репозитория TFVC: $/teamproject/main
  • Запись с проверкой изменений в репозитории TFVC: Gated_2016-06-06_05.20.51.4369;username@live.com
  • Сборка набора отложенных изменений репозитория TFVC: myshelveset;username@live.com
При использовании этой переменной в формате номера сборки символы косой черты ( / ) заменяются символами подчеркивания _ .

Примечание. в TFVC при выполнении сборки с условным возвратом или создании набора отложенных изменений вручную эту переменную нельзя использовать в вашем формате номера сборки.
Сборка. Саурцебранчнаме Имя ветви, в которой была поставлена сборка.
  • Ветвь репозитория Git или запрос на вытягивание: последний сегмент пути в ссылке. Например, в refs/heads/master этом значении задано значение master . В refs/heads/feature/tools этом значении это значение равно tools .
  • Ветвь репозитория TFVC: последний сегмент пути в корневом каталоге сервера для рабочей области. Например, в $/teamproject/main этом значении main .
  • TFVCный возврат или сборка набора отложенных изменений репозитория с проверкой поименования — это имя набора отложенных изменений. Например, Gated_2016-06-06_05.20.51.4369;username@live.com или myshelveset;username@live.com.
Примечание. в TFVC при выполнении сборки с условным возвратом или создании набора отложенных изменений вручную эту переменную нельзя использовать в вашем формате номера сборки.
Сборка. SourcesDirectory

Локальный путь на агенте, куда загружаются файлы исходного кода. Пример: c:\agent_work\1\s

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

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

Эта переменная является синонимом Build. Repository. LocalPath.

Сборка. SourceVersion Последнее изменение управления версиями, включенное в эту сборку. Эта переменная имеет область действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в качестве части номера сборки или тега управления версиями.
Сборка. Саурцеверсионмессаже Комментарий к фиксации или набору изменений. Мы усекаете сообщение до первой строки или 200 символов, в зависимости от того, что короче.

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

Примечание. Эта переменная доступна в TFS 2015,4.

Сборка. StagingDirectory

Локальный путь на агенте, в который копируются все артефакты перед отправкой в назначение. Пример: c:\agent_work\1\a

Обычным способом использования этой папки является публикация артефактов сборки с помощью задач копирование файлов и Публикация артефактов сборки .

Примечание. сборка. ArtifactStagingDirectory и сборка. StagingDirectory являются взаимозаменяемыми. Этот каталог очищается перед каждой новой сборкой, поэтому вам не нужно очищать его самостоятельно.

см. Artifacts в Azure Pipelines.

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

Сборка. репозиторий. git. Субмодулечеккаут Значение, выбранное для подмодулей Checkout на вкладке репозиторий.

Эта переменная имеет область действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в качестве части номера сборки или тега управления версиями.
Сборка. Саурцетфвкшелвесет определяется, если репозиторий система управления версиями Team Foundation.

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

Примечание. Эта переменная дает значение, недопустимое для использования сборки в формате номера сборки.
Common. Тестресултсдиректори Локальный путь на агенте, где создаются результаты теста. Пример: c:\agent_work\1\TestResults

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

Системные переменные (TFS 2017)

ПеременнаяОписание
System. AccessToken Используйте маркер OAuth для доступа к REST API.
System. CollectionId идентификатор GUID коллекции TFS или Azure DevOps организации
System. DefaultWorkingDirectory

Локальный путь на агенте, куда загружаются файлы исходного кода. Пример: c:\agent_work\1\s

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

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

System. DefinitionId Идентификатор конвейера сборки.
System. HostType Задайте значение, build Если конвейер является сборкой, или release Если конвейер является выпуском.
System. PullRequest. PullRequestId Идентификатор запроса на вытягивание, вызвавшего эту сборку. Например: 17. (Эта переменная инициализируется только в том случае, если сборка запущена из-за того, что в ней затронута политика ветви.)
System. PullRequest. параметр sourcebranch Ветвь, проверяемая в запросе на вытягивание. Например: refs/heads/users/raisa/new-feature. (Эта переменная инициализируется только в том случае, если сборка запущена из-за того, что в ней затронута политика ветви.)
System. PullRequest. Саурцерепоситорюри URL-адрес репозитория, который содержит запрос на вытягивание. Например: http://our-server:8080/tfs/DefaultCollection/_git/OurProject. (эта переменная инициализируется только в том случае, если сборка запущена из-за Azure Repos Git, затронутой политикой ветви.)
System. PullRequest. Таржетбранч Ветвь, которая является целевым объектом запроса на вытягивание. Например: refs/heads/master. Эта переменная инициализируется только в том случае, если сборка запущена из-за того, что в ней затронута политика ветви.
System. Теамфаундатионколлектионури Универсальный код ресурса (URI) коллекции Team Foundation. Например: http://our-server:8080/tfs/DefaultCollection/.

Эта переменная имеет область действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в качестве части номера сборки или тега управления версиями.
System.TeamProject Имя проекта, который содержит эту сборку.
System. Теампрожектид ИДЕНТИФИКАТОР проекта, к которому принадлежит эта сборка.
TF_BUILD Задайте значение, True Если скрипт выполняется задачей сборки.

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

Переменные агента (TFS 2015)

Примечание

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

ПеременнаяОписание
Agent. BuildDirectory

Локальный путь на агенте, где создаются все папки для данного конвейера сборки.

Например:

  • TFS 2015,4: C:\TfsData\Agents\Agent-MACHINENAME_work\1
  • Установленный пользователем агент TFS 2015 RTM: C:\Agent_work\6c3842c6
  • Встроенный агент TFS 2015 RTM: C:\TfsData\Build_work\6c3842c6
Agent. Хомедиректори

Каталог, в который устанавливается агент. Содержит программное обеспечение агента.

Например:

  • TFS 2015,4: C:\TfsData\Agents\Agent-MACHINENAME
  • Установленный пользователем агент TFS 2015 RTM: C:\Agent
  • Встроенный агент TFS 2015 RTM: C:\Program Files\Microsoft Team Foundation Server 14.0\Build
Agent.Id Идентификатор агента.
Agent. JobStatus Состояние сборки.
  • Canceled
  • Failed
  • Succeeded
  • SucceededWithIssues (частично успешно)

Примечание. На переменную среды можно ссылаться только так, как . AGENT_JOBSTATUS отсутствовал в TFS 2015.

Agent. MachineName Имя компьютера, на котором установлен агент. Эта переменная доступна в tfs 2015,4, а не в TFS 2015 RTM.
Agent.Name

Имя агента, зарегистрированного в пуле.

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

Agent. WorkFolder Рабочий каталог для этого агента. Например: c:\agent_work.

Переменные сборки (TFS 2015)


ПеременнаяОписание
Сборка. ArtifactStagingDirectory Локальный путь на агенте, в который копируются все артефакты перед отправкой в назначение.

Обычным способом использования этой папки является публикация артефактов сборки с помощью задач копирование файлов и Публикация артефактов сборки . см. Artifacts в Azure Pipelines.

Например:
  • TFS 2015,4: C:\TfsData\Agents\Agent-MACHINENAME_work\1\a
  • Агент по умолчанию для TFS 2015 RTM: C:\TfsData\Build_work\6c3842c6\artifacts
  • Агент TFS 2015 RTM, установленный вами: C:\Agent_work\6c3842c6\artifacts
Этот каталог очищается перед каждой новой сборкой, поэтому вам не нужно очищать его самостоятельно.

В TFS 2015,4сборка. ArtifactStagingDirectory и сборка. StagingDirectory являются взаимозаменяемыми.

Эта переменная имеет область действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в качестве части номера сборки или тега управления версиями.
Сборка. BuildId Идентификатор записи для завершенной сборки.
Build.BuildNumber Имя завершенной сборки. Можно указать формат номера сборки, который создает это значение в параметрах конвейера.

Обычно эта переменная используется для того, чтобы сделать ее частью формата метки, указанного на вкладке репозиторий.

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

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

Сборка. ее BuildUri Универсальный код ресурса (URI) для сборки. Например: vstfs:///Build/Build/1430.

Эта переменная имеет область действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в качестве части номера сборки или тега управления версиями.
Сборка. BinariesDirectory Локальный путь на агенте можно использовать в качестве выходной папки для скомпилированных двоичных файлов. Доступно в TFS 2015,4.

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

Пример: C:\TfsData\Agents\Agent-MACHINENAME_work\1\b

Эта переменная имеет область действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в качестве части номера сборки или тега управления версиями.
Build.DefinitionName Имя конвейера сборки.

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

Сборка. Дефинитионверсион Версия конвейера сборки.
Сборка. Куеуедби См. раздел "как устанавливаютсяпеременные удостоверений?".

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

Сборка. Куеуедбид См. раздел "как устанавливаютсяпеременные удостоверений?".
Сборка. репозиторий. Очистка Значение, выбранное для очистки в исходных параметрах репозитория.

Эта переменная имеет область действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в качестве части номера сборки или тега управления версиями.
Сборка. репозиторий. LocalPath

Локальный путь на агенте, куда загружаются файлы исходного кода. Пример: c:\agent_work\1\s

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

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

Эта переменная является синонимом сборки. SourcesDirectory.

Build.Repository.Name Имя репозитория.

Эта переменная имеет область действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в качестве части номера сборки или тега управления версиями.
Сборка. репозиторий. поставщик Тип выбранного репозитория.
  • TfsGit: TfsGit
  • TfsVersionControl: TfsVersionControl
  • Git: Репозиторий Git, размещенный на внешнем сервере
  • Svn: Subversion (доступно в TFS 2015,4)
Эта переменная имеет область действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в качестве части номера сборки или тега управления версиями.
Сборка. репозиторий. TFVC. Workspace определяется, если репозиторий система управления версиями Team Foundation. Имя рабочей области TFVC , используемой агентом сборки.

Например, если Agent. BuildDirectory имеет значение c:\agent_work\12 , а Agent.ID — 8 , имя рабочей области может быть следующим: ws_12_8

Эта переменная имеет область действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в качестве части номера сборки или тега управления версиями.
Сборка. репозиторий. URI URL-адрес репозитория. Например:
  • Git https://fabrikamfiber/tfs/DefaultCollection/Scripts/_git/Scripts
  • TFVC https://fabrikamfiber/tfs/DefaultCollection/
Эта переменная имеет область действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в качестве части номера сборки или тега управления версиями.
Сборка. RequestedFor См. раздел "как устанавливаютсяпеременные удостоверений?".

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

Сборка. Рекуестедфорид См. раздел "как устанавливаютсяпеременные удостоверений?".
Build.SourceBranch Ветвь, в которой была поставлена сборка в очереди. Некоторые примеры.
  • Ветвь репозитория Git: refs/heads/master
  • Запрос на вытягивание репозитория Git: refs/pull/1/merge
  • Ветвь репозитория TFVC: $/teamproject/main
  • Запись с проверкой изменений в репозитории TFVC: Gated_2016-06-06_05.20.51.4369;username@live.com
  • Сборка набора отложенных изменений репозитория TFVC: myshelveset;username@live.com
При использовании этой переменной в формате номера сборки символы косой черты ( / ) заменяются символами подчеркивания _ .

Примечание. в TFVC при выполнении сборки с условным возвратом или создании набора отложенных изменений вручную эту переменную нельзя использовать в вашем формате номера сборки.
Сборка. Саурцебранчнаме Имя ветви, в которой была поставлена сборка.
  • Ветвь репозитория Git или запрос на вытягивание: последний сегмент пути в ссылке. Например, в refs/heads/master этом значении задано значение master . В refs/heads/feature/tools этом значении это значение равно tools .
  • Ветвь репозитория TFVC: последний сегмент пути в корневом каталоге сервера для рабочей области. Например, в $/teamproject/main этом значении main .
  • TFVCный возврат или сборка набора отложенных изменений репозитория с проверкой поименования — это имя набора отложенных изменений. Например, Gated_2016-06-06_05.20.51.4369;username@live.com или myshelveset;username@live.com.
Примечание. в TFVC при выполнении сборки с условным возвратом или создании набора отложенных изменений вручную эту переменную нельзя использовать в вашем формате номера сборки.
Сборка. SourcesDirectory

Локальный путь на агенте, куда загружаются файлы исходного кода. Пример: c:\agent_work\1\s

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

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

Эта переменная является синонимом Build. Repository. LocalPath.

Сборка. Саурцесдиректорихаш Примечание. Эта переменная доступна в TFS 2015 RTM, но не в TFS 2015,4.
Сборка. SourceVersion Последнее изменение управления версиями, включенное в эту сборку. Эта переменная имеет область действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в качестве части номера сборки или тега управления версиями.
Сборка. Саурцеверсионмессаже Комментарий к фиксации или набору изменений. Мы усекаете сообщение до первой строки или 200 символов, в зависимости от того, что короче.

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

Примечание. Эта переменная доступна в TFS 2015,4.

Сборка. StagingDirectory TFS 2015 RTM

Локальный путь на агенте можно использовать в качестве выходной папки для скомпилированных двоичных файлов. Например: C:\TfsData\Build_work\6c3842c6\staging.

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

TFS 2015,4

Локальный путь на агенте, в который копируются все артефакты перед отправкой в назначение. Пример: C:\TfsData\Agents\Agent-MACHINENAME_work\1\a

Этот каталог очищается перед каждой новой сборкой, поэтому вам не нужно очищать его самостоятельно.

Обычным способом использования этой папки является публикация артефактов сборки с помощью задач копирование файлов и Публикация артефактов сборки . см. Artifacts в Azure Pipelines.

В TFS 2015,4сборка. ArtifactStagingDirectory и сборка. StagingDirectory являются взаимозаменяемыми.

Все версии TFS 2015

Эта переменная имеет область действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в качестве части номера сборки или тега управления версиями.
Сборка. репозиторий. git. Субмодулечеккаут Значение, выбранное для подмодулей Checkout на вкладке репозиторий.

Эта переменная имеет область действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в качестве части номера сборки или тега управления версиями.
Сборка. Саурцетфвкшелвесет определяется, если репозиторий система управления версиями Team Foundation.

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

Примечание. Эта переменная дает значение, недопустимое для использования сборки в формате номера сборки.
Common. Тестресултсдиректори Локальный путь на агенте, где создаются результаты теста. Например: c:\agent_work\1\TestResults. Доступно в TFS 2015,4.

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

Системные переменные (TFS 2015)

ПеременнаяОписание
System. AccessToken Доступно в TFS 2015,4. Используйте маркер OAuth для доступа к REST API.

Эта переменная имеет область действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в качестве части номера сборки или тега управления версиями.
System. CollectionId идентификатор GUID коллекции TFS или Azure DevOps организации
System. DefaultWorkingDirectory

Локальный путь на агенте, куда загружаются файлы исходного кода. Пример: c:\agent_work\1\s

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

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

System. DefinitionId Идентификатор конвейера сборки.
System. HostType Задайте значение, build Если конвейер является сборкой, или release Если конвейер является выпуском.
System. PullRequest. PullRequestId Идентификатор запроса на вытягивание, вызвавшего эту сборку. Например: 17. (Эта переменная инициализируется только в том случае, если сборка запущена из-за того, что в ней затронута политика ветви.)
System. PullRequest. параметр sourcebranch Ветвь, проверяемая в запросе на вытягивание. Например: refs/heads/users/raisa/new-feature. (Эта переменная инициализируется только в том случае, если сборка запущена из-за того, что в ней затронута политика ветви.)
System. PullRequest. Саурцерепоситорюри URL-адрес репозитория, который содержит запрос на вытягивание. Например: http://our-server:8080/tfs/DefaultCollection/_git/OurProject. (эта переменная инициализируется только в том случае, если сборка запущена из-за Azure Repos Git, затронутой политикой ветви.)
System. PullRequest. Таржетбранч Ветвь, которая является целевым объектом запроса на вытягивание. Например: refs/heads/master. Эта переменная инициализируется только в том случае, если сборка запущена из-за того, что в ней затронута политика ветви.
System. Теамфаундатионколлектионури Универсальный код ресурса (URI) коллекции Team Foundation. Например: http://our-server:8080/tfs/DefaultCollection/.

Эта переменная имеет область действия агента. Его можно использовать в качестве переменной среды в скрипте и в качестве параметра в задаче сборки, но не в качестве части номера сборки или тега управления версиями.
System.TeamProject Имя проекта, который содержит эту сборку.
System. Теампрожектид ИДЕНТИФИКАТОР проекта, к которому принадлежит эта сборка.
TF_BUILD Задайте значение, True Если скрипт выполняется задачей сборки.

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

Как устанавливаются переменные удостоверений?

это значение зависит от того, что привело к сборке и относится к Azure Repos репозиториям.

При активации сборки... Затем значения Build. Куеуедби и Build. Куеуедбид основываются на... Затем значения Build. RequestedFor и Build. Рекуестедфорид основываются на...
В Git или TFVC триггерами непрерывной интеграции (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
Так как вы щелкнули кнопку " поставить сборку в очередь " Вы Вы

Azure Pipelines | Azure DevOps Server 2020 | Azure DevOps Server 2019 | Team Foundation Server 2018 — Team Foundation Server 2015

Примечание

В Microsoft Team Foundation Server (TFS) 2018 и предыдущих версий конвейеры сборки и выпуска называются определениями, выполнения называются сборками, подключения к службам называются конечными точками служб, этапы называются средами, а задания называются этапами.

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

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

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

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

Дополнительные сведения о работе с переменными.

Сборка. Очистка

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

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

System. AccessToken

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

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

steps:
  - bash: echo This script could use $SYSTEM_ACCESSTOKEN
    env:
      SYSTEM_ACCESSTOKEN: $(System.AccessToken)
  - powershell: | 
      Write-Host "This is a script that could use $env:SYSTEM_ACCESSTOKEN"
      Write-Host "$env:SYSTEM_ACCESSTOKEN = $(System.AccessToken)"
    env:
      SYSTEM_ACCESSTOKEN: $(System.AccessToken)

Можно настроить область по умолчанию для System.AccessToken использования System.AccessToken.

System. Debug

Чтобы получить более подробные журналы для отладки проблем конвейера, определите System.Debug и присвойте ему значение true .

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

  2. Выберите элемент Variables (Переменные).

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

    Set System Debug to true

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