Ограничения и соглашения об именовании

  • Мақала
  • Оқу үшін 21 минут

Azure DevOps Services | Azure DevOps Server 2022 г. - Azure DevOps Server 2019 г. | TFS 2018

Большинство компонентов в Azure DevOps должны соответствовать ограничениям и соглашениям об именовании. Ограничения помогают обеспечить согласованное взаимодействие с пользователем и обеспечить совместимость с другими приложениями.
Распространенные ограничения включают в себя не превышение длины символов для имени, отсутствие специальных символов и сохранение уникальности имен в наборе объектов.

Примечание

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

Общие рекомендации

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

Как и в других файлах операционной системы, также нельзя использовать управляющие символы в кодировке ASCII (ASCII 1-31) и заменяемые комбинации. Общие сведения об ограничениях операционной системы, применяемых к именам файлов, см. в разделе Именование файлов, путей и пространств имен.

Системные зарезервированные имена

Большинству назначенных имен следует избегать включения системных зарезервированных имен. Эти имена соответствуют:

  • AUX
  • COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10
  • CON
  • DefaultCollection
  • LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9
  • NUL
  • PRN
  • SERVER, SignalR
  • Веб-сайт или WEB

Дополнительные сведения о зарезервированных именах см. в разделе Имена файлов, пути и пространства имен.

Azure Artifacts

Универсальные пакеты должны соответствовать следующим ограничениям.

Тип ограничения

Ограничение

Имя пакета

  • Используются только строчные символы.
  • Должен начинаться и заканчиваться буквами или цифрами.
  • Должен содержать только буквы, цифры и не последовательные дефисы, символы подчеркивания или точки.

Версия пакета

  • Должен быть в нижнем регистре без метаданных сборки.

Azure Boards

Рабочие элементы используются для сбора информации для планирования и отслеживания проектов разработки программного обеспечения. С помощью рабочих элементов можно описывать работу, которую нужно выполнить, назначать ее, отслеживать состояние и координировать усилия команды. Различные типы рабочих элементов, например пользовательские истории, задачи, ошибки и проблемы, отслеживают различные типы информации. Дополнительные сведения см. в документации по Azure Boards.

Все объекты отслеживания рабочих элементов связаны с одним или несколькими именами. Большинство из них имеют понятные отображаемые имена, за исключением типов рабочих элементов и глобальных списков, которые связаны с именами ссылок. Понятное имя — это уникальный, видимый для пользователя идентификатор поля. Использование понятных имен обеспечивает согласованность между проектами и типами рабочих элементов в коллекции проектов. Система использует имя ссылки внутри системы, и вы не можете изменить его после его определения.

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

пути к области и пути итерации

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

Эти поля с несколькими узлами используют символы обратной косой черты (\) для обозначения иерархии узлов в древовидной структуре.

Имена, присваиваемые дочерним узлам этим полям, должны соответствовать следующим ограничениям.

Тип ограничения

Ограничение

Длина узла

  • Не должна превышать 255 символов

Зарезервированные имена

  • Не должно состоять из одной (.) или двух точек (..)
  • Не должно быть зарезервированным системой именем, таким как PRN, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, NUL, CON или AUX Дополнительные сведения о зарезервированных именах см. в разделе Имена файлов, пути и пространства имен.

Специальные символы для узлов

  • Не должны содержать управляющие символы Юникода
  • Не должен содержать один из следующих символов: \ / $ ? * : " & > < # % | +
  • Не должны содержать символы, запрещенные локальной файловой системой. Дополнительные сведения об ограничениях символов Windows см. в разделе Именование файлов, путей и пространств имен.

Длина пути

  • Не должно содержать более 4000 символов Юникода

Глубина пути иерархии

  • Не более 14 уровней в глубину

Вложения

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

Тип ограничения

Ограничение

Размер файла

  • Не должен превышать максимальный размер
  • Максимальный размер по умолчанию: 4096 килобайт
  • Абсолютный максимальный размер: 2 гигабайта

Имена столбцов доски и дорожки

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

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

Имена столбцов и дорожки должны соответствовать следующим ограничениям.

Тип ограничения

Ограничение

Длина

  • Не должна превышать 256 символов Юникода в длину

Уникальность

  • Имена столбцов не должны совпадать с именами других столбцов на канбан-доске
  • Названия дорожки не должны совпадать с другими названиями дорожки на канбан-доске

Специальные символы

  • Не должна содержать непечатаемых знаков Юникода или заменяемых символов.

Имена полей

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

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

Тип ограничения

Ограничение

Длина

  • Не должна превышать 128 символов Юникода в длину

Специальные символы

  • Имена полей должны содержать по крайней мере один буквенный символ
  • Не должен содержать один из следующих символов: .,;':~/*|?"& %$!+=()[]{}<>-`
  • Не должно содержать начальные или конечные пробелы
  • Не должно содержать последовательных пробелов

Область

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

Имена ссылок полей и переносимость

Язык определения типа рабочего элемента включает в себя концепцию ссылочного имени поля. Имена ссылок на поля помогают переносить определения между коллекциями проектов Team Foundation, а также разрешать сторонним интеграции находить определенные поля и ссылаться на ними. Эти имена являются глобально уникальными, подобно пространству имен в приложении .NET Framework.

Имена ссылок полей не подлежат переименованию. Если, например, вы изменили имя поля "Title" на "Header", имя ссылки на поле этого поля останется прежним. Интеграции и внутренние представления полей должны использовать имя ссылки поля, а не зависеть от самого имени поля.

Пространство имен System используется только для определения всех основных системных полей, которые являются обязательными для системных функций Team Foundation. Вы не можете создать собственное поле System.X, так как оно может помешать работе.

Пространство имен Microsoft служит для определения поля отслеживания рабочих элементов. Эти поля определяются в определении типа рабочего элемента шаблонов процессов. Вам не помешает создать собственное поле Microsoft.X. Однако мы не рекомендуем создавать собственное поле, так как это может помешать работе с функциональностью или возможности мастера настройки компонентов успешно обновить проект после обновления.

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

Описание системных полей и полей, определенных в шаблонах процессов по умолчанию, см. в разделе Индекс полей рабочих элементов.

Примеры имен ссылок полей

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

Примеры в пространстве имен System

Примеры в пространстве имен Microsoft

Другие примеры пространств имен

System.Id System.Title System.CreatedBy System.CreatedDate System.ChangedBy System.ChangedDate System.State System.Reason

Microsoft.VSTS.Build.FoundIn Microsoft.VSTS.Common.Activity Microsoft.VSTS.Common.Discipline Microsoft.VSTS.Common.Priority Microsoft.VSTS.CMMI.TaskType Microsoft.VSTS.TCM.AutomationStatus Microsoft.VSTS.TCM.TestSuiteType

Вымышленная компания Fabrikam Fibre может определить следующие настраиваемые поля рабочих элементов:

FabrikamFiber.Common.Severity FabrikamFiber.Common.Phase FabrikamFiber.RiskManagement.RiskType FabrikamFiber.RiskManagement.Resolution

Вымышленная компания по разработке программного обеспечения Contoso Corporation может определить следующие поля рабочих элементов:

Contoso.Common.BusinessPriority Contoso.Bug.FoundInPhase Contoso.Bug.FixInPhas

Текст справки по полю

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

Для процесса наследования можно указать текст справки для поля с помощью диалогового окна Изменение поля , вкладки Определение , Описание. См. статью Добавление настраиваемого поля в тип рабочего элемента. Для локального процесса XML текст справки указывается с помощью HELPTEXT элемента . См. раздел Добавление или изменение поля для отслеживания работы.

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

Тип ограничения

Ограничение

Длина

  • Не должна превышать 255 символов Юникода в длину

Глобальные списки

Глобальный список — это набор значений элементов списка, которые можно использовать глобально во всех коллекциях проектов в экземпляре локального Azure DevOps Server. При определении типов рабочих элементов может оказаться, что некоторые поля рабочих элементов используют один и тот же набор допустимых или предлагаемых значений. Глобальные списки позволяют определить эти значения один раз и совместно использовать их в нескольких типах рабочих элементов и проектах. Дополнительные сведения см. в разделе Определение глобальных списков.

Глобальный список, определенный GLOBALLIST с помощью элемента , содержит один или несколько элементов списка, указанных LISTITEM с помощью элемента .

LISTITEM Имена должны соответствовать следующим ограничениям.

Тип ограничения

Ограничение

Длина

  • Не должна превышать 254 символов Юникода в длину
  • Не должно быть пустым

Специальные символы

  • Не должно содержать начальные или конечные пробелы
  • Не должно содержать последовательных пробелов
  • Не должен содержать символы обратной косой черты ()

Область

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

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

Тип ограничения

Ограничение

Количество элементов

  • Не может быть пустым. Глобальный список должен содержать по крайней мере один LISTITEM элемент.

Уникальность

  • Не может быть пустым. Глобальный список должен содержать по крайней мере один LISTITEM элемент.

Определите имя ссылки при каждом добавлении или создании типа или категории ссылки. Все имена ссылок могут содержать до 70 символов Юникода.

Определите имя ссылки с помощью буквенно-цифровых символов, символов подчеркивания и дефисов. Каждое имя ссылки должно содержать как минимум одну точку (.), но точка не может присутствовать в начале или в конце имени. Имя ссылки не должно начинаться с числа или символа подчеркивания и не может содержать несколько последовательных дефисов, таких как (--).

Тип ограничения

Ограничение

Длина

  • Не должна превышать 70 символов Юникода в длину

Уникальность

  • Не должно совпадать ни с каким другим именем ссылки на поле в коллекции проектов
  • Не должно совпадать ни с каким другим именем ссылки на поле после того, как эти имена будут обработаны компьютером для замены всех точек (.) символами подчеркивания (_)
    Например, поля ссылаются на имена My.*Field* и My.Field будут обрабатываться компьютером как одно и то же имя: My__Field

Специальные символы

  • Не должно содержать дефисы (-)
  • Должно содержать как минимум одну точку (.)
  • Не должно начинаться или заканчиваться точкой (.)
  • Не должен начинаться с числаМесть не начинать с символа подчеркивания (_)

Теги (рабочие элементы)

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

Имена тегов должны соответствовать следующим ограничениям.

Тип ограничения

Ограничение

Длина

  • Не должен содержать более 400 символов, не может быть пустым или пустым.

Специальные символы

  • Не должен содержать символы-разделители: , или ;
  • Не должен содержать элементы управления Юникодом или символы форматирования, такие как канал строки, разделитель абзаца, возврат каретки или другие несовпадения суррогатных символов

Область

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

Azure Pipelines

Определения конвейера Azure должны соответствовать следующим ограничениям. Дополнительные сведения см. в документации по Azure Pipelines.

Тип ограничения

Ограничение

Имя задания

  • Должен содержать только буквенно-цифровые символы и '_'
  • Не должно начинаться с цифры
  • Должно быть уникальное имя
  • Не должен содержать ключевые слова, например "deployment"

Название этапа

  • Должен содержать только буквенно-цифровые символы и '_'
  • Не должно начинаться с цифры
  • Не должен содержать ключевые слова, например "deployment"

Выражения

  • Должен начинаться с a-Z или _AND, за которым следует a-Z, 0-9или _

Azure Repos (Git)

Каждый проект Azure DevOps может содержать несколько репозиториев Git. Имена, назначенные репозиториям Git, должны соответствовать следующим ограничениям. Дополнительные сведения см. в документации по Azure Repos Git. Дополнительные сведения об ограничениях именования для других элементов Git, таких как ветви и теги, см. в разделе Git check-ref-format.

Важно!

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

Тип ограничения

Ограничение

Длина

  • Не должна превышать 64 символов Юникода в длину

Уникальность

  • Не должно совпадать с именем любого другого репозитория Git в проекте

Специальные символы

  • Не должна содержать непечатаемых знаков Юникода или заменяемых символов.
  • Не должен содержать следующие печатные символы: / : \ ~ &amp; % ; @ &#39; &quot; ? &lt; &gt; | # $ * } { , + = [ ]
  • Не должно начинаться с символа нижнего подчеркивания (_)
  • Не должно начинаться или заканчиваться точкой (.)
  • Не должно быть системным зарезервированным именем

Azure Repos (TFVC)

Система управления версиями Team Foundation (TFVC) предоставляет центральный репозиторий для файлов и команд, необходимых для управления этими файлами в команде. Также предоставляет настраиваемые политики возвращения, ветвления, совмещения, включения в набор отложенные изменений, и многое другое. Дополнительные сведения см. в документации по Azure Repos TFVC.

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

На веб-портале и REST API некоторые операции имеют более ограниченную длину пути, чем Visual Studio и клиенты TF.exe. Эти операции включают в себя изменение, переименование и удаление, и выполняются, так как веб-портал или REST использует случайно созданную рабочую область для параллелизма при ожидании изменений.

Тип ограничения

Ограничение

Длина пути папки сервера системы управления версиями

  • Не должен содержать более 259 символов Юникода для одной папки или имени файла.
  • Не должен содержать более 388 символов Юникода для каталога
  • Не должен содержать более 399 символов Юникода для объединенного каталога и имени файла.

Длина пути локальных папок

  • Не должен содержать более 248 символов Юникода для каталога
  • Не должен содержать более 260 символов Юникода для объединенного каталога и имени файла.

Ограничения длины веб-портала и REST

  • Не должен содержать более 215 символов Юникода для объединенного имени проекта, каталога и имени файла.

TFVC-файлы

В системе управления версиями хранятся файлы множества различных типов. Настройка системы управления версиями Team Foundation на компьютере разработчика содержит сведения о добавлении существующих проектов или решений Visual Studio.

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

Тип ограничения

Ограничение

Файлы и папки

  • Имена не должны содержать следующие печатные символы: \ / : * ? " <> | ;
  • Папки не должны находиться за пределами сопоставленного каталога для активной рабочей области

Имена файлов

  • Не должно начинаться с $
  • Не должен содержать следующие печатные символы: \ / : * ? " <> | ;

Метки TFVC

В системе управления версиями Team Foundation (TFVC) метка — это имя, применяемое к определенному набору редакций. Вы можете прикрепить метки к набору несвязанных файлов в управлении версиями, что позволяет извлекать файлы или работать с ними как группа. В следующей таблице описаны ограничения для имен ярлыков.

Тип ограничения

Ограничение

Длина

  • Не должна превышать 64 символов Юникода в длину

Специальные символы

  • Не может заканчиваться пробелом ( ) или точкой (.)
  • Не должен содержать следующие печатные символы: \ / " : <> * ? @ | ;

Наборы полок TFVC

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

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

Тип ограничения

Ограничение

Длина

  • Не должна превышать 64 символов Юникода в длину

Специальные символы

  • Не должен содержать следующие печатные символы: \ / " : <> | * ? ;

Рабочие области TFVC

Рабочая область — это клиентская копия файлов и папок в системе управления версиями Team Foundation (TFVC). При создании нескольких рабочих областей на клиентском компьютере могут находиться различные версии одной и той же папки системы управления версиями. Дополнительные сведения см. в статье Создание рабочих областей и работа с ней.

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

Тип ограничения

Ограничение

Длина

  • Не должна превышать 64 символов Юникода в длину

Специальные символы

  • Не должен заканчиваться пробелом ( )
  • Не должен содержать следующие печатные символы: \ / " : <> | * ? ;

Имена компьютеров

Имя компьютера, на котором устанавливается Azure DevOps, связано с именем сервера. Операционная система и Active Directory накладывают определенные ограничения на имена компьютеров, как описано в следующих статьях:

Названия организаций

Важно!

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

Шаблоны процессов и процессов

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

Примечание

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

Процессы, которые вы определяете или настраиваете, должны соответствовать следующим ограничениям.

Тип ограничения

Ограничение

Длина

  • Не должна превышать 256 символов Юникода в длину

Уникальность

  • Должен быть уникальным в Azure DevOps
  • При отправке шаблона с тем же именем, что и у существующего шаблона, существующий шаблон перезаписывается.

Размер файла шаблона процесса

  • Не должно превышать 2 ГБ (гигабайт)

Коллекции проектов

Коллекция проектов определяет группу проектов и ресурсы, связанные с этими проектами. Она предоставляет упорядоченную структуру, которую можно использовать для определения группы проектов, определенных для Azure DevOps Server, и управления ею.

Кроме того, имя коллекции является частью строки подключения, используемой для подключения участников команды к проектам. Присвоение значения по умолчанию соответствует DefaultCollection. Дополнительные сведения см. в статье Управление коллекциями проектов.

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

Тип ограничения

Ограничение

Длина

  • Не должна превышать 64 символов Юникода в длину

Уникальность

  • Не должно совпадать с именем любой другой коллекции в локальном развертывании.
  • Если развертывание включает продукты SharePoint или SQL Server Reporting Services, они не могут совпадать с именем и полным путем к существующему сайту SharePoint, серверу отчетов или веб-сайту Reporting Services

Зарезервированные имена

Специальные символы

  • Не должна содержать непечатаемых символов Юникода или заменяемых символов.
  • Не должен содержать следующие печатные символы: / : \ ~ &amp; % ; @ &#39; &quot; ? &lt; &gt; | # $ * } { , + = [ ]
  • Не должна включать многоточие (...) или двойную точку (..).
  • Не должно начинаться с символа нижнего подчеркивания (_)
  • Не должно начинаться или заканчиваться точкой (.)

Имена проектов

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

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

Тип ограничения

Ограничение

Длина

  • Не должна превышать 64 символов Юникода в длину

Уникальность

  • Не должно совпадать с другими именами в коллекции проектов, веб-приложением SharePoint, поддерживающим коллекцию, или экземпляром SQL Server Reporting Services, поддерживающим коллекцию.

Зарезервированные имена

  • Не должно быть системным зарезервированным именем
  • Не должен быть одним из скрытых сегментов, используемых для фильтрации запросов IIS, таких как App_Browsers, App_code, App_Data, App_GlobalResources, App_LocalResources, App_Themes, App_WebResources, bin или web.config.

Специальные символы

  • Не должна содержать непечатаемых знаков Юникода или заменяемых символов.
  • Не должен содержать следующие печатные символы: / : \ ~ &amp; % ; @ &#39; &quot; ? &lt; &gt; | # $ * } { , + = [ ]
  • Не должно начинаться с символа нижнего подчеркивания (_)
  • Не должно начинаться или заканчиваться точкой (.)

Группы безопасности

Группы безопасности Azure DevOps позволяют применять определенные права или разрешения к группе пользователей.

Локальные группы могут состоять из учетных записей групп Active Directory, групп безопасности Azure DevOps, учетных записей пользователей Windows, учетных записей групп Windows или любого сочетания этих типов. Дополнительные сведения см. в статье Добавление пользователей или групп AD/Azure AD во встроенную группу безопасности.

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

Тип ограничения

Ограничение

Длина имени учетной записи группы безопасности

  • Не должна превышать 256 символов Юникода в длину

Уникальность

  • Учетные записи группы уровня проекта не должны совпадать с другими именами групп в том же проекте
  • Учетные записи группы уровня коллекции не должны соответствовать другим именам учетной записи группы в коллекции проектов

Резервированные имена групп

  • Не должен называться с помощью $NAMESPACE на уровне проекта или сервера.

Специальные символы

  • Не должен содержать следующие печатные символы: "/ \ [ ] : | <> + = ; ? *
  • Не должен содержать непечатаемые символы в диапазоне значений ASCII от 1 до 31
  • Имя не должно включать точки (.)
  • Имя не должно включать запятые (,)

построение Team Foundation

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

Сборка компьютера

Team Foundation Build — это отдельная установка Azure DevOps Server уровня приложений, уровня данных или клиента Visual Studio. Вы можете выбрать отдельный компьютер. В противном случае сборку можно установить параллельно на клиентском компьютере или на серверах.

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

Тип ограничения

Ограничение

Пространство на диске

  • Должно содержать достаточно места для сборки (недостаточное пространство приводит к сбою сборок)

Каталог построения

  • Должен быть локальным путем (например, C:\BuildDirectory).

Папка расположение перемещения

  • Должен быть UNC-путь (например, \server\share)

Разрешения расположения перемещения

Каждое построение помещается в новый каталог в каталог перемещения.

  • Учетная запись службы Team Foundation Server (например, Domain\TFSSERVICE) должна иметь разрешение на полный доступ к расположению удаления UNC.
  • Расположение удаления UNC должно быть общей папкой

Учетная запись службы построения Team Foundation

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

  • Учетная запись является членом группы "Службы сборки"
  • Учетная запись имеет разрешения на чтение и запись для временных папок и ASP.NET временной папки.
  • Учетная запись имеет разрешение на полный доступ к каталогу сборки и расположению удаления

Проблемы с брандмауэром

Если на компьютере сборки включен брандмауэр, убедитесь, что программа tfsbuildservice находится в списке исключений.

Типы сборки

Типы сборки настраивают условия, при которых создается одно решение или набор решений в проекте. Чтобы выполнить сборку, необходимо создать новый тип сборки или использовать существующий тип сборки.

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

Тип ограничения

Ограничение

Уникальность

  • Не должно совпадать с другими именами типа построения в проекте

Специальные символы

  • Не должен содержать следующий печатный символ: $

Качество сборки

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

Имена качества сборки должны соответствовать следующим ограничениям.

Тип ограничения

Ограничение

Длина

  • Не должна превышать 256 символов Юникода в длину

Уникальность

  • Не должно совпадать с именем любого другого качества сборки на компьютере сборки Team Foundation

Имена команд

Имена команд определяют группу отдельных лиц или групп, которые совместно работают в качестве команды в проекте. Участники команды используют это имя для подключения к команде или для запроса участников, определенных для команды.

Таким образом, имена команд должны соответствовать соглашениям, которые позволяют отображать их как часть допустимого URL-адреса. Имя каждой команды должно быть уникальным в пределах одного проекта. Однако нет ограничений на использование одного и того же имени команды в разных проектах в коллекции проектов. Добавление другой команды или иерархии команд предоставляет дополнительные сведения о работе с командами.

Имена команд должны соответствовать следующим ограничениям.

Тип ограничения

Ограничение

Длина

  • Не должна превышать 64 символов Юникода в длину

Уникальность

  • Не должны совпадать ни с каким другим именем в проекте.

Зарезервированные имена

Специальные символы

  • Не должна содержать непечатаемых знаков Юникода или заменяемых символов.
  • Не должен содержать следующие печатные символы: / : \ ~ &amp; % ; @ &#39; &quot; ? &lt; &gt; | # $ * } { , + = [ ]
  • Не должна включать многоточие (...) или двойную точку (..).
  • Не должно начинаться с символа нижнего подчеркивания (_)
  • Не должно начинаться или заканчиваться точкой (.)

Имена учетных записей пользователей

Учетные записи пользователей определяют пользователей, добавленных в проект или коллекцию проектов. Учетные записи пользователей могут соответствовать записям в Active Directory, Azure Active Directory, группе серверов Windows.

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

Тип ограничения

Ограничение

Длина имени учетной записи

  • Не должна превышать 256 символов Юникода в длину

Уникальность

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

Резервированные имена групп

  • Не должно быть присвоено имя с помощью $NAMESPACE на уровне проекта или сервера.

Специальные символы

  • Не должен содержать следующие печатные символы: "/ \ [ ] : | < > + = ; ? *
  • Не должны содержать непечатаемые символы в диапазоне значений ASCII от 1 до 31
  • Имя не должно включать точки (.)
  • Имя не должно включать запятые (,)
  • Имя не должно включать следующие категории Юникод: LineSeparator, ParagraphSeparator, Control, Format, OtherNotAssigned

Имена вики-страниц и файлов

Каждая вики-страница соответствует файлу в вики-репозитории Git. Имена, назначенные заголовку вики-страницы, должны соответствовать следующим ограничениям.

Тип ограничения Ограничение
Имя файла Полный путь к странице не должен превышать 235 символов.
Уникальность Заголовки страниц чувствительны к регистру и должны быть уникальными в вики-иерархии.
Специальные символы
  1. Не должна содержать непечатаемых знаков Юникода или заменяемых символов.
  2. Не должен содержать следующие печатные символы: / \ #
  3. Не должно начинаться или заканчиваться точкой (.)
Размер файла Не должно превышать максимум 18 МБ
Размер файла вложения Не должно превышать максимум 19 МБ

Специальные символы в заголовках вики-страниц

Вы можете указать заголовки страниц, содержащие один или несколько этих специальных символов : < > * ? | -. Например, файлу Markdown можно присвоить имя "Вопросы и ответы?" или "Руководство по настройке". Символы имеют следующие строки в кодировке URI:

Знак Закодированная строка
: %3A
< %3C
> %3E
* %2A
? %3F
| %7C
- %2D
" %22
Тип ограничения Ограничение
Имя файла Полный путь к странице не должен превышать 235 символов.
Уникальность Заголовки страниц чувствительны к регистру и должны быть уникальными в вики-иерархии.
Специальные символы
  1. Не должна содержать непечатаемых знаков Юникода или заменяемых символов.
  2. Не должен содержать следующие печатные символы: / : < \ * ? \ | - #
  3. Не должно начинаться или заканчиваться точкой (.)
  4. Заголовки страниц, добавленных в автономном режиме, не должны содержать пустого места.
Размер файла Не должно превышать максимум 18 МБ
Размер файла вложения Не должно превышать максимум 19 МБ