Ограничения именования и соглашения
Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019
Большинство компонентов в Azure DevOps должны соответствовать ограничениям именования и соглашениям. Ограничения помогают гарантировать согласованный пользовательский интерфейс и обеспечить совместимость с другими приложениями.
Распространенные ограничения включают не превышение длины символа для имени, не содержащего специальных символов, а также сохранение уникальности имен в наборе объектов.
Внимание
При использовании API, а не пользовательского интерфейса, API позволяет напрямую указать имя, включающее символы, которые могут быть ограничены в пользовательском интерфейсе.
Рекомендации
- Следуйте ограничениям пользовательского интерфейса, чтобы обеспечить согласованность и предотвратить непредвиденные проблемы.
- Проверьте имена программным способом и соответствующим образом обработайте все специальные символы.
Общие рекомендации
Ограничения длины в этой статье измеряются числом разрешенных символов Юникода. Суррогатные символы состоят из двух символов Юникода, которые считаются двумя символами в отношении ограничения длины. Дополнительные сведения см. в разделе "О Юникоде" и "Наборы символов".
Как и в других файлах операционной системы, символы управления ASCII (ASCII 1-31) и суррогатные сочетания также не допускаются. Общие сведения об ограничениях операционной системы, применяемых к именам файлов, см. статью Именование файлов, путей и пространств имен.
Примечание.
- Ограничения на количество элементов, которые можно определить, см. в разделе "Отслеживание работы", "Процесс" и "Ограничения проекта".
Зарезервированные системные имена
Избегайте использования системных зарезервированных имен, таких как в следующих примерах:
- AUX
- COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10
- CON
- Коллекция по умолчанию
- LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9
- NUL
- PRN
- SERVER, SignalR
- Веб или WEB
Дополнительные сведения о зарезервированных именах см. в разделе "Имена файлов", "Пути" и "Пространства имен".
Azure Artifacts
Универсальные пакеты должны соответствовать следующим ограничениям.
| Тип ограничения | Ограничение |
|---|---|
| Имя пакета | — должен быть строчными буквами. — должно начинаться и заканчиваться буквами или цифрами. — должен содержать только буквы, цифры и неконсекутивные дефисы, символы подчеркивания или точки. |
| Версия пакета | Должен быть буквами в строчном регистре без строительных метаданных. |
Azure Boards
Рабочие элементы используются для сбора сведений для планирования и отслеживания проектов разработки программного обеспечения. С помощью рабочих элементов можно описать работу, назначить работу, отслеживать состояние и координировать усилия в команде. Различные типы рабочих элементов, такие как истории пользователей, задачи, ошибки и проблемы, отслеживают различные типы информации. Для получения дополнительной информации смотрите документацию по Azure Boards.
Все объекты отслеживания рабочих элементов связаны с одним или несколькими именами. Большинство из них имеют понятные отображаемые имена, кроме типов рабочих элементов и глобальных списков, которые связаны с именами ссылок. Дружественное имя — это уникальный идентификатор, видимый пользователем для поля. Использование понятных имен обеспечивает согласованность между проектами и типами рабочих элементов в коллекции проектов. Система использует имя ссылки внутри системы, и его нельзя изменить после определения.
Существуют ограничения на несколько элементов, связанных с рабочими элементами, включая ссылочные и понятные имена, имена полей и размер вложений.
Пути областей и итераций
Два поля рабочего элемента, Area Path и Iteration Path, предоставляют иерархическую древовидную структуру для группировки работы. Области группируют рабочие элементы по продуктам, функциональным или тематическим областям. Пути итерации группируют рабочие элементы в спринты, вехи или временные периоды для работы над этими элементами.
Эти поля с несколькими узлами используют символы обратной косой черты \ для обозначения иерархии узлов в структуре дерева.
Имена, присваиваемые дочерним узлам этих полей, должны соответствовать следующим ограничениям.
| Тип ограничения | Ограничение |
|---|---|
| Длина узла | Не должно содержать более 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 гигабайта. |
| Тип ограничения | Ограничение |
|---|---|
| Размер файла | Не должно превышать максимальный размер: — Максимальный размер по умолчанию: 4096 килобайт. — абсолютный максимальный размер: 2 гигабайта. Дополнительные сведения см. в разделе "Изменение максимального размера вложений для рабочих элементов". |
Названия столбцов и дорожек
Ваша доска превращает невыполненную работу в интерактивную подвесную доску, обеспечивая визуальный поток работы. По мере того как работа выполняется от идеи до завершения, вы обновляете элементы на доске. Каждый столбец представляет рабочий этап, и каждая карточка представляет историю пользователя (синие карточки) или ошибку (красные карточки) на этом этапе работы.
Настройте доску, добавив, удалив или переименовав столбцы и секции. Столбцы поддерживают поток работы по доске. Полосы деятельности позволяют управлять разными классами работы в виде горизонтальных полос на доске.
Имена столбцов и дорожек должны соответствовать следующим ограничениям.
| Тип ограничения | Ограничение |
|---|---|
| Длина | Не должно содержать более 256 символов Юникода. |
| Уникальность | — Имена столбцов не должны совпадать с любым другим именем столбца на доске. - Имена пловцов не должны совпадать с другими именами пловцов на доске. |
| Специальные символы | Не должен содержать символы элемента управления Юникода или суррогатные символы. |
Имена полей
Каждый тип рабочего элемента содержит один или несколько полей рабочего элемента. Эти поля определяют сведения, хранящиеся для рабочих элементов на основе типа рабочего элемента. Каждое поле рабочего элемента имеет сопутствующее имя поля. Имя ссылки на поле однозначно идентифицирует каждое поле и не может быть изменено после назначения. Дополнительные сведения о полях нестандартного рабочего элемента см. в разделе "Индекс поля рабочего элемента".
Имена полей рабочих элементов должны соответствовать следующим ограничениям.
| Тип ограничения | Ограничение |
|---|---|
| Длина | Не должно содержать более 128 символов Юникода. |
| Уникальность | — Имена полей должны содержать по крайней мере один алфавитный символ. — не должен содержать один из следующих символов: . , ; ' : ~ \ / \ * ? " & % $ ! + = () [] {} <> - |— не должен содержать начальные или конечные пробелы. — не должно содержать два или более последовательных пробелов. |
| Специальные символы | Должен быть уникальным в пределах организации или коллекции проектов. Имена полей рабочих элементов привязаны к коллекции проектов. При переименовании имени поля измените его для всех рабочих элементов и WIT, определенных во всех проектах в коллекции. |
Имена ссылок полей и переносимость
Язык определения типа рабочего элемента включает концепцию ссылочного имени поля. Имена ссылок на поля способствуют переносу определений между коллекциями проектов Team Foundation, а также позволяют интеграциям сторонних разработчиков, не связанных с Microsoft, находить и ссылаться на определенные поля. Эти имена глобально уникальны, так же как пространство имен в приложении платформа .NET Framework глобально уникально.
Пространство имен системы используется только для определения всех основных системных полей, которые являются обязательными для системных функций Team Foundation. Вы не можете создать собственное поле System.X, так как это может препятствовать функциональным возможностям.
Пространство имен Microsoft используется для определения полей для отслеживания рабочих элементов. Эти поля определяются в определении типа рабочего элемента шаблонов процессов.
Клиенты и партнеры могут создавать собственные пространства имен полей для пользовательских типов рабочих элементов. Описание системных полей и полей, определенных в шаблонах процессов по умолчанию, см. в разделе "Индекс полей рабочего элемента".
Внимание
- Имена ссылок на поля не могут быть переименованы. Если например, вы изменили имя поля "Title" на "Заголовок", имя ссылки на поле этого поля остается неизменным. Интеграции и внутренние представления полей должны использовать имя ссылки на поле вместо самого имени поля.
- Хотя вы можете создать собственное поле Microsoft.X, мы не рекомендуем это сделать, так как это может препятствовать функциональным возможностям или возможности мастера настройки компонентов успешно обновить проект после обновления.
Примеры имен ссылок на поля
В следующих примерах показаны допустимые имена полей ссылок в различных пространствах имен. Клиенты и партнеры также могут определять собственные пространства имен для поддержки пользовательских типов рабочих элементов.
| Примеры пространства имен системы | Примеры пространства имен Майкрософт | Другие примеры пространства имен |
|---|---|---|
| System.Id, System.Название, System.Создано, System.ДатаСоздания, System.Изменено, System.ДатаИзменения, System.Состояние, System.Причина | 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.FixInPhase |
Текст справки по полю
Система отображает текст справки во время выполнения, чтобы помочь пользователям узнать, что ввести в поле. Текст справки ограничен определённым типом рабочего элемента в определённом проекте.
Для процесса наследования можно указать текст справки для поля в диалоговом окне "Изменение поля", вкладка "Определение", "Описание". См. раздел "Добавление настраиваемого поля в тип рабочего элемента". Для локального XML-процесса можно указать текст справки с помощью HELPTEXT элемента. См. Добавление или изменение поля для отслеживания работы.
Добавляемый текст справки должен соответствовать следующим ограничениям.
| Тип ограничения | Ограничение |
|---|---|
| Длина | Не должно содержать более 255 символов Юникода. |
Глобальные списки
Глобальный список — это набор значений элементов списка, которые можно использовать глобально во всех коллекциях проектов в экземпляре локального сервера Azure DevOps Server. Определяя типы рабочих элементов, можно найти, что некоторые поля рабочих элементов используют одинаковый набор разрешенных или предлагаемых значений. Глобальные списки позволяют определять эти значения один раз и совместно использовать их между несколькими типами рабочих элементов и проектами. Дополнительные сведения см. в разделе "Определение глобальных списков".
Глобальный список, определенный с помощью элемента GLOBALLIST, содержит один или несколько элементов списка, указанных с помощью элемента LISTITEM.
LISTITEM имена должны соответствовать следующим ограничениям.
| Тип ограничения | Ограничение |
|---|---|
| Длина | — не должно содержать более 254 символов Юникода. - Не должно быть пустым. |
| Специальные символы | — не должно содержать начальные или конечные пробелы. — не должно содержать два последовательных пробела. — не должен содержать символы обратной косой черты \ . |
| Область | Так как глобальные списки доступны среди всех проектов, они не должны содержать элементы, определенные на уровне проекта, например определения учетной записи группы для конкретного проекта. |
Глобальные списки должны соответствовать следующим ограничениям.
| Тип ограничения | Ограничение |
|---|---|
| Количество предметов | Не может быть пустым. Глобальный список должен содержать по крайней мере один LISTITEM элемент. |
| Уникальность | Не может быть пустым. Глобальный список должен содержать по крайней мере один LISTITEM элемент. |
Названия ссылок типов и категорий
Определите имя ссылки при добавлении или создании типа ссылки или категории. Все имена ссылок могут содержать до 70 символов Юникода.
Определите имя ссылки с помощью буквенно-цифровых символов, символов подчеркивания и дефисов. Каждое имя ссылки должно содержать по крайней мере одну точку ., но точка не может стоять в начале или конце имени. Имя ссылки не должно начинаться с числа или подчеркивания, и оно не может иметь несколько последовательных дефисов, например --.
| Тип ограничения | Ограничение |
|---|---|
| Длина | Не должно содержать более 70 символов Юникода. |
| Уникальность | — Не должно быть идентичным какому-либо другому имени поля в пределах коллекции проектов. — Не должно совпадать с любым другим именем ссылки на поле после того, как эти имена обрабатываются компьютером, чтобы заменить все периоды . подчеркиванием _. Например, ссылки на поля с именами My.*Field* и My.Field будут обрабатываться как одно и то же имя: My__Field |
| Специальные символы | — не должен содержать дефисы -.— должен содержать по крайней мере один период ..— не должно начинаться или заканчиваться периодом ..— Не должно начинаться с числа, не должно начинаться с подчеркивания _. |
Теги рабочих элементов
Теги рабочих элементов соответствуют одной или двум фразам ключевых слов для фильтрации средств отслеживания работы, таких как невыполненные работы, доски и запросы или определение запросов. Дополнительные сведения см. в разделе "Добавление тегов рабочих элементов для классификации и фильтрации списков и досок".
Имена тегов должны соответствовать следующим ограничениям.
| Тип ограничения | Ограничение |
|---|---|
| Длина | — не должно содержать более 400 символов Юникода. — не должно быть null или пустым. |
| Специальные символы | — не должен содержать символы разделителя: , или ;.— Не должен содержать символы элемента управления Юникода или форматирования, такие как канал строк, разделитель абзаца, возврат каретки или другие несовпадные суррогатные символы. |
| Область | Так как глобальные списки доступны среди всех проектов, они не должны содержать элементы, определенные на уровне проекта, например определения учетной записи группы для конкретного проекта. |
Azure Pipelines
Определения Azure Pipeline должны соответствовать следующим ограничениям.
| Тип ограничения | Ограничение |
|---|---|
| Имя задания | — должен содержать только буквенно-цифровые символы и '_'.— не должно начинаться с числа. — должно иметь уникальное имя. — Не должно содержать ключевые слова, например "развертывание". |
| Сценическое имя | — должен содержать только буквенно-цифровые символы и '_'.— не должно начинаться с числа. — Не должно содержать ключевые слова, например "развертывание". |
| Выражения | Должен начинаться с a-Z или _AND, за которым следует a-Z, 0-9или _. |
Дополнительные сведения доступны в документации по Azure Pipelines.
Azure Repos (Git)
Каждый проект Azure DevOps может содержать несколько репозиториев Git. Имена, назначенные репозиториям Git, должны соответствовать следующим ограничениям. Дополнительные сведения см. в документации по Azure Repos Git. Дополнительные сведения об ограничениях именования для других элементов Git, таких как ветви и теги, см. в разделе Git check-ref-format.
Внимание
Хотя вы можете включить пробелы в имена репозитория, мы не рекомендуем это сделать.
| Тип ограничения | Ограничение |
|---|---|
| Длина | Не должно содержать более 64 символов Юникода. |
| Уникальность | Не должно совпадать с любым другим именем репозитория Git в проекте. |
| Специальные символы | — Не должно содержать управляющих символов Юникода или суррогатных символов. — не должен содержать следующие печатные символы: \ / : * ? " < > ; # $ * { } , + = [ ] |- Не должно начинаться с подчеркивания _.— не должно начинаться или заканчиваться периодом ..— не должно быть зарезервированным системой именем. |
Azure Repos (TFVC)
Управление версиями Team Foundation (TFVC) предоставляет центральный репозиторий для файлов и команд, необходимых для управления этими файлами в команде. Она также предоставляет настраиваемые политики регистрации, ветвление, слияние, стеллажи и многие другие функции. Для получения дополнительной информации см. документацию по Azure Repos TFVC
Пути управления версиями должны соответствовать следующим ограничениям. См. также статью "Оптимизация рабочей области".
| Тип ограничения | Ограничение |
|---|---|
| Длина пути к папке системы контроля версий на сервере | — не должен содержать более 259 символов Юникода для одной папки или имени файла. — не должно содержать более 388 символов Юникода для каталога. — не должно содержать более 399 символов Юникода для объединенного каталога и имени файла. |
| Длина пути к локальной папке | — не должно содержать более 248 символов Юникода для каталога. — не должно содержать более 260 символов Юникода для объединенного каталога и имени файла. |
| Ограничения длины, специфичные для веб-портала и REST. | Не должно содержать более 215 символов Юникода для объединенного имени проекта, каталога и имени файла. |
На веб-портале и REST API некоторые операции имеют более строгие ограничения на длину пути, чем у клиентов Visual Studio и TF.exe. К этим операциям относятся изменение, переименование и удаление, и они происходят из-за того, что веб-портал или REST используют случайно созданную рабочую область для обеспечения параллельности при ожидании изменений.
Файлы TFVC
Система управления версиями хранит множество различных типов файлов. Настройка управления версиями Team Foundation на вашем компьютере разработки предоставляет информацию о добавлении существующих проектов или решений Visual Studio.
Файлы и папки, добавленные в элемент управления версиями Team Foundation, должны соответствовать следующим ограничениям.
| Тип ограничения | Ограничение |
|---|---|
| Файлы и папки | — Имена не должны содержать следующие печатные символы: \ / : * ? " < > ;— Папки не должны находиться вне назначенного каталога для активной рабочей области. |
| Имена файлов | - Не должно начинаться с $.— не должен содержать следующие печатные символы: \ / : * ? " < > ; | |
Метки TFVC
В элементе управления версиями Team Foundation (TFVC) метка применяется к определенному набору исправлений. Вы можете присоединить метки к набору несвязанных файлов в системе управления версиями, что позволяет извлекать файлы или обрабатывать их как группу. В следующей таблице описываются ограничения, введенные в имена меток.
| Тип ограничения | Ограничение |
|---|---|
| Длина | Не должно содержать более 64 символов Юникода. |
| Специальные символы | - Не удается завершиться пробелом ( ) или периодом ..— не должен содержать следующие печатные символы: \ / : * ? " < > ; @ | |
Полки TFVC
Наборы полок позволяют временно отложить в сторону пакет ожидающих изменений, и при желании удалить эти изменения из рабочей области. Позже вы можете восстановить изменения в shelveset в вашей рабочей области или поместить их в рабочую область другого пользователя.
Имена наборов полок должны соответствовать следующим ограничениям.
| Тип ограничения | Ограничение |
|---|---|
| Длина | Не должно содержать более 64 символов Юникода. |
| Специальные символы | Не должно содержать следующие печатные символы: \ / : * ? " < > & ; |. |
Рабочие области TFVC
Рабочая область — это клиентская копия файлов и папок в элементе управления версиями Team Foundation (TFVC). При создании нескольких рабочих областей можно использовать разные версии одной папки управления версиями на клиентском компьютере. Создание и работа с рабочими областями содержит более подробную информацию.
Имена рабочих областей должны соответствовать следующим ограничениям.
| Тип ограничения | Ограничение |
|---|---|
| Длина | Не должно содержать более 64 символов Юникода. |
| Специальные символы | — не должен заканчиваться пробелом ( ).— не должно содержать следующие печатные символы: \ / : * ? " < > ; |. |
Имена компьютеров
Имя компьютера, в котором устанавливается Azure DevOps, связано с именем сервера. Операционная система и Active Directory накладывают определенные ограничения на имена компьютеров, как описано в следующих статьях:
названия организаций;
Внимание
При создании имени организации соблюдайте следующие рекомендации.
- Используйте только буквы из английского алфавита
- Начните имя вашей организации с буквы или цифры.
- Используйте буквы, цифры или дефисы после начального символа
- Убедитесь, что ваша организация не превышает 50 символов Юникода
- Заканчивается буквой или номером
Если вы используете любой из запрещенных символов, вы получите следующее сообщение об ошибке: VS850015: указанное имя не допускается использовать: {Название организации}.
Процессы и шаблоны процессов
Процесс определяет стандартные блоки системы отслеживания рабочих элементов и других подсистем, к которым вы имеете доступ после подключения к проекту.
Примечание.
Терминология: "процесс" и "шаблон процесса" относятся к взаимозависимому набору файлов, используемых для создания проекта. Дополнительные сведения см. в разделе "Сведения о процессах и шаблонах процессов", описывающих различия между тремя процессами по умолчанию, доступными для вас.
Процессы, определяемые или настраиваемые, должны соответствовать следующим ограничениям.
| Тип ограничения | Ограничение |
|---|---|
| Длина | Не должно содержать более 256 символов Юникода. |
| Уникальность | — должен быть уникальным в Azure DevOps. — При отправке шаблона с тем же именем, что и существующий шаблон, существующий шаблон перезаписывается. |
| Размер файла шаблона процесса | Не должно превышать 2 ГБ (гигабайты). |
Коллекции проектов
Коллекция проектов определяет группу проектов и ресурсы, связанные с этими проектами. Она предоставляет упорядоченную структуру, которую можно использовать для определения и управления группой проектов, определенных для Azure DevOps Server.
Кроме того, имя коллекции является частью строки подключения, используемой для подключения участников команды к проектам. Назначенное по умолчанию значение соответствует DefaultCollection. Управление коллекциями проектов предоставляет дополнительные сведения.
Имена, назначенные коллекциям проектов, должны соответствовать следующим ограничениям.
| Тип ограничения | Ограничение |
|---|---|
| Длина | Не должно содержать более 64 символов Юникода. |
| Уникальность | — не должно совпадать с любым другим именем коллекции в локальном развертывании. — Если развертывание включает продукты SharePoint или службы SQL Server Reporting Services, они не могут совпадать с именем и полным путем существующего сайта SharePoint, сервера отчетов или веб-сайта служб Reporting Services. |
| Зарезервированные имена | Не должно быть зарезервированным системой именем. |
| Специальные символы | — Не должно содержать управляющих символов Юникода или суррогатных символов. — не должен содержать следующие печатные символы: \ / : * ? " < > ; # $ * { } , + = [ ] | — не должен содержать многоточие ... или двойной период ...- Начинаться не должно с подчеркивания _.— не должно начинаться или заканчиваться периодом .. |
Имена проектов
Проект устанавливает репозиторий для исходного кода и место для команд для планирования, отслеживания хода выполнения и совместной работы. Имя проекта является частью строки подключения, используемой для подключения участников команды к проекту.
Имена, назначенные создаваемым проектам, должны соответствовать следующим ограничениям.
| Тип ограничения | Ограничение |
|---|---|
| Длина | Не должно содержать более 64 символов Юникода. |
| Уникальность | Не должно совпадать с любым другим именем в коллекции проектов, веб-приложением SharePoint, поддерживающим коллекцию, или экземпляром служб SQL Server Reporting Services, поддерживающих коллекцию. |
| Имена резервов | — не должно быть зарезервированным именем системы. — Не должно быть одним из скрытых сегментов, используемых для фильтрации запросов IIS, таких как App_Browsers, App_code, App_Data, App_GlobalResources, App_LocalResources, App_Themes, App_WebResources, bin или web.config. |
| Специальные символы | — Имя не должно содержать непечатаемых символов Юникода или заменяемых символов. — не должен содержать следующие печатные символы: \ / : * ? " ' < > ; # $ * { } , + = [ ] | - Не должно начинаться с подчеркивания _.— не должно начинаться или заканчиваться периодом .. |
Группы безопасности
С помощью групп безопасности Azure DevOps можно применить определенные права или разрешения для группы пользователей.
Локальные группы могут состоять из учетных записей групп Active Directory, групп безопасности Azure DevOps, учетных записей пользователей Windows, учетных записей групп Windows или любой смеси этих типов. Дополнительные сведения см. в разделе "Добавление пользователей или групп Microsoft Entra" в встроенную группу безопасности.
Группы безопасности должны соответствовать следующим ограничениям.
| Тип ограничения | Ограничение |
|---|---|
| Длина имени учетной записи группы безопасности | Не должно содержать более 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 после первоначальной установки необходимо убедиться, что выполняются следующие условия: — учетная запись является членом группы «Build Services». — У учетной записи есть разрешения на чтение и запись временных папок и временную папку ASP.NET. — У учетной записи есть разрешение на полный доступ к каталогу сборки и расположению удаления. |
| Проблемы с брандмауэром | Если на компьютере сборки включен брандмауэр, убедитесь, что программа tfsbuildservice находится в списке исключений. |
Типы сборки
Типы сборки настраивают условия, в которых создается одно решение или набор решений в проекте. Чтобы выполнить сборку, необходимо создать новый тип сборки или использовать существующий тип сборки.
Имена типов сборки должны соответствовать следующим ограничениям.
| Тип ограничения | Ограничение |
|---|---|
| Уникальность | Не должно совпадать с любым другим именем типа сборки в проекте. |
| Специальные символы | Не должен содержать следующий печатный символ: $ |
Качество сборки
Качество сборки позволяет присвоить уровень качества или состояние завершения готовой сборке. Team Foundation Build также позволяет создавать новые значения для типа качества сборки. Ознакомьтесь с подразделом "Оцените качество завершенной сборки", чтобы увидеть список значений качества сборки по умолчанию.
Имена качества сборки должны соответствовать следующим ограничениям.
| Тип ограничения | Ограничение |
|---|---|
| Длина | Не должно содержать более 256 символов Юникода. |
| Уникальность | Не должно совпадать с другим наименованием качества сборки на компьютере Team Foundation Build. |
Имена команд
Имена групп определяют группу отдельных лиц или групп, которые совместно работают в качестве команды в проекте. Участники команды используют это имя для подключения к команде или поиска участников, указанных для команды.
Имена команд должны соответствовать соглашениям, которые позволяют отображать их как часть допустимого URL-адреса. Каждое имя команды должно быть уникальным в рамках одного проекта. Однако нет ограничений на использование одного имени команды в разных проектах в коллекции проектов. Дополнительные сведения см. в разделе "Добавление другой команды" или иерархии команд.
Имена команд должны соответствовать следующим ограничениям.
| Тип ограничения | Ограничение |
|---|---|
| Длина | Не должно содержать более 64 символов Юникода. |
| Уникальность | Не должно совпадать с любым другим именем в проекте. |
| Зарезервированные имена | Не должно быть зарезервированным именем системы. |
| Специальные символы | — Не должно содержать управляющих символов Юникода или суррогатных символов. — не должен содержать следующие печатные символы: \ / : * ? " < > ; # $ * { } , + = [ ] |— не должен содержать многоточие ... или двойной период ...- Не должно начинаться символом подчеркивания _.— не должно начинаться или заканчиваться периодом .. |
Имена учетных записей пользователей
Учетные записи пользователей идентифицируют людей, добавленных в проект или коллекцию проектов. Учетные записи пользователей могут соответствовать записям в Active Directory, идентификаторе Microsoft Entra, группе серверов Windows.
Учетные записи пользователей, добавляемые в организацию или коллекцию, должны соответствовать следующим ограничениям. Сведения о добавлении учетных записей пользователей в проект см. в разделе "Добавление пользователей в проект или команду".
| Тип ограничения | Ограничение |
|---|---|
| Длина имени учетной записи | Не должно содержать более 256 символов Юникода. |
| Уникальность | Не должно соответствовать какой-либо другой учетной записи пользователя, добавленной в коллекцию проектов. |
| Зарезервированные имена групп | Не должно быть названо как $NAMESPACE ни на уровне проекта, ни на уровне сервера. |
| Специальные символы | — не должно содержать следующие печатные символы: "/ \ [ ] : < > + = ; ? * |.. Не должно включать непечатываемые символы в диапазон значений ASCII 1-31. - Не должно заканчиваться на точку . или знак $ доллара.— не должно включать запятые ,.— Не должно включать следующие категории Юникода: LineSeparator, ParagraphSeparator, Control, Format, OtherNotAssigned. |
Вики-страницы и имена файлов
Каждая вики-страница соответствует файлу в репозитории Git вики. Имена, назначаемые заголовку вики-страницы, должны соответствовать следующим ограничениям.
| Тип ограничения | Ограничение |
|---|---|
| Имя файла | Полный путь к странице не должен превышать 235 символов. |
| Уникальность | Названия страниц учитывают регистр и должны быть уникальными в иерархии вики. |
| Специальные символы | — Имя не должно содержать непечатаемых символов Юникода или заменяемых символов. — не должен содержать следующие печатные символы: / \ #— не должно начинаться или заканчиваться периодом .. |
| Размер файла | Размер не должен превышать максимального значения в 18 МБ. |
| Размер вложенного файла | Размер не должен превышать максимальное значение в 19 МБ. |
Специальные символы в заголовках вики-страниц
Вы можете указать заголовки страницы, содержащие один или несколько этих специальных символов : < > * ? | -. Например, можно назвать файл Markdown как "Часто задаваемые вопросы" или "Руководство по настройке". Символы имеют следующие строки в кодировке URI:
| Символ | Закодированная строка |
|---|---|
: |
%3A |
< |
%3C |
> |
%3E |
* |
%2A |
? |
%3F |
| |
%7C |
- |
%2D |
" |
22 % |