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

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018

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

Примечание

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

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

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

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

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", имя ссылки на поле этого поля остается прежним. Интеграции и внутренние представления полей должны использовать имя ссылки поля, а не зависеть от самого имени поля.

Пространство имен системы используется только для определения всех основных системных полей, обязательных для системных функций 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.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 символов Юникода в длину

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

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

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

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

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

Ограничение


Длина

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

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

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

Область

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

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

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

Ограничение


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

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

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

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

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

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

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

Ограничение


Длина

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

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

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

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

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

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

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

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

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

Ограничение


Длина

  • Не должно содержать более 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 накладывают определенные ограничения на имена компьютеров, как описано в следующих статьях:

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

Важно!

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

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

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

Примечание

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

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

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

Ограничение


Длина

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

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

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

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

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

коллекции Project

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

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

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

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

Ограничение


Длина

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

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

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

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

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

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

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

имена Project

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

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

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

Ограничение


Длина

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

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

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

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

  • Не должно быть зарезервированным системой именем, таким как PRN, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM9, COM10, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, NUL, CON, AUX, SERVER, SignalR, DefaultCollection или Web
  • Не должен быть одним из скрытых сегментов, используемых для фильтрации запросов 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 символов Юникода в длину

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

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

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

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

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

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

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

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

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

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

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

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

Ограничение


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

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

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

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

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

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

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

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

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

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

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

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

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

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


Типы сборки

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

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

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

Ограничение


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

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

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

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

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

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

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

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

Ограничение


Длина

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

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

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

Имена команд

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

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

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

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

Ограничение


Длина

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

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

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

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

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

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

  • Не должна содержать непечатаемых знаков Юникода или заменяемых символов.
  • Не должен содержать следующие печатные символы: / : \ ~ &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 МБ