Ограничения именования и соглашения
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
- DefaultCollection
- LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9
- NUL
- PRN
- SERVER, SignalR
- Веб-сайт или веб-сайт
Дополнительные сведения о зарезервированных именах см. в разделе "Имена файлов", "Пути" и "Пространства имен".
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 гигабайта. |
| Тип ограничения | Ограничение |
|---|---|
| Размер файла | Не должно превышать максимальный размер: — Максимальный размер по умолчанию: 4096 килобайт. — абсолютный максимальный размер: 2 гигабайта. Дополнительные сведения см. в разделе "Изменение максимального размера вложений для рабочих элементов". |
Названия столбцов и пловцов
Ваша доска превращает невыполненную работу в интерактивную подвесную доску, обеспечивая визуальный поток работы. По мере того как работа выполняется от идеи до завершения, вы обновляете элементы на доске. Каждый столбец представляет рабочий этап, и каждая карточка представляет историю пользователя (синие карточки) или ошибку (красные карточки) на этом этапе работы.
Настройте доску, добавив, удалив или переименовав столбцы и дорожки. Столбцы поддерживают поток работы по доске. Пловцы позволяют управлять различными классами работы как горизонтальные полосы на борту.
Имена столбцов и пловцов должны соответствовать следующим ограничениям.
| Тип ограничения | Ограничение |
|---|---|
| Length | Не должно содержать более 256 символов Юникода. |
| Уникальность | — Имена столбцов не должны совпадать с любым другим именем столбца на доске. - Имена пловцов не должны совпадать с другими именами пловцов на доске. |
| Специальные символы | Не должен содержать символы элемента управления Юникода или суррогатные символы. |
Имена полей
Каждый тип рабочего элемента содержит один или несколько полей рабочего элемента. Эти поля определяют сведения, хранящиеся для рабочих элементов на основе типа рабочего элемента. Каждое поле рабочего элемента имеет связанное имя ссылки на поле. Имя ссылки на поле однозначно идентифицирует каждое поле и не может быть изменено после назначения. Дополнительные сведения о полях нестандартного рабочего элемента см. в разделе "Индекс поля рабочего элемента".
Имена полей рабочих элементов должны соответствовать следующим ограничениям.
| Тип ограничения | Ограничение |
|---|---|
| Length | Не должно содержать более 128 символов Юникода. |
| Уникальность | — Имена полей должны содержать по крайней мере один алфавитный символ. — не должен содержать один из следующих символов: . , ; ' : ~ \ / \ * ? " & % $ ! + = () [] {} <> - |.— не должен содержать начальные или конечные пробелы. — не должно содержать два или более последовательных пробелов. |
| Специальные символы | Должен быть уникальным в пределах организации или коллекции проектов. Имена полей рабочих элементов относятся к коллекции проектов. При переименовании имени поля измените его для всех рабочих элементов и WIT, определенных во всех проектах в коллекции. |
Имена ссылок на поля и переносимость
Язык определения типа рабочего элемента содержит концепцию имени ссылки на поле. Имена ссылок на поля помогают переносить определения между коллекциями проектов Team Foundation, а также разрешать интеграции, отличные от Майкрософт, находить и ссылаться на определенные поля. Эти имена глобально уникальны, так же как пространство имен в приложении платформа .NET Framework глобально уникально.
Пространство имен системы используется только для определения всех основных системных полей, которые являются обязательными для системных функций Team Foundation. Вы не можете создать собственное поле System.X, так как это может препятствовать функциональным возможностям.
Пространство имен Майкрософт используется для определения полей отслеживания рабочих элементов. Эти поля определяются в определении типа рабочего элемента шаблонов процессов.
Клиенты и партнеры могут создавать собственные пространства имен полей для пользовательских типов рабочих элементов. Описание системных полей и полей, определенных в шаблонах процессов по умолчанию, см. в разделе "Индекс полей рабочего элемента".
Внимание
- Имена ссылок на поля не могут быть переименованы. Если например, вы изменили имя поля "Title" на "Заголовок", имя ссылки на поле этого поля остается неизменным. Интеграции и внутренние представления полей должны использовать имя ссылки на поле вместо самого имени поля.
- Хотя вы можете создать собственное поле Microsoft.X, мы не рекомендуем это сделать, так как это может препятствовать функциональным возможностям или возможности мастера настройки компонентов успешно обновить проект после обновления.
Примеры имен ссылок на поля
В следующих примерах показаны допустимые имена ссылок на поля в различных пространствах имен. Клиенты и партнеры также могут определять собственные пространства имен для поддержки пользовательских типов рабочих элементов.
| Примеры пространства имен системы | Примеры пространства имен Майкрософт | Другие примеры пространства имен |
|---|---|---|
| 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.FixInPhase |
Текст справки по полю
Система отображает текст справки во время выполнения, чтобы помочь пользователям узнать, что ввести в поле. Текст справки ограничен определенным типом рабочего элемента в определенном проекте.
Для процесса наследования можно указать текст справки для поля в диалоговом окне "Изменение поля", вкладка "Определение" и "Описание". См. раздел "Добавление настраиваемого поля в тип рабочего элемента". Для локального XML-процесса можно указать текст справки с помощью HELPTEXT элемента. См . раздел "Добавление или изменение поля для отслеживания работы".
Добавляемый текст справки должен соответствовать следующим ограничениям.
| Тип ограничения | Ограничение |
|---|---|
| Length | Не должно содержать более 255 символов Юникода. |
Глобальные списки
Глобальный список — это набор значений элементов списка, которые можно использовать глобально во всех коллекциях проектов в экземпляре локального сервера Azure DevOps Server. Определяя типы рабочих элементов, можно найти, что некоторые поля рабочих элементов используют одинаковый набор разрешенных или предлагаемых значений. Глобальные списки позволяют определять эти значения один раз и совместно использовать их между несколькими типами рабочих элементов и проектами. Дополнительные сведения см. в разделе "Определение глобальных списков".
Глобальный список, определенный с помощью GLOBALLIST элемента, содержит один или несколько элементов списка, указанных LISTITEM с помощью элемента.
LISTITEM имена должны соответствовать следующим ограничениям.
| Тип ограничения | Ограничение |
|---|---|
| Length | — не должно содержать более 254 символов Юникода. - Не должно быть пустым. |
| Специальные символы | — не должно содержать начальные или конечные пробелы. — не должно содержать два последовательных пробела. — не должен содержать символы обратной косой черты \ . |
| Область | Так как глобальные списки доступны среди всех проектов, они не должны содержать элементы, определенные на уровне проекта, например определения учетной записи группы для конкретного проекта. |
Глобальные списки должны соответствовать следующим ограничениям.
| Тип ограничения | Ограничение |
|---|---|
| Число номенклатур | Не может быть пустым. Глобальный список должен содержать по крайней мере один LISTITEM элемент. |
| Уникальность | Не может быть пустым. Глобальный список должен содержать по крайней мере один LISTITEM элемент. |
Ссылочные имена типов и категорий
Определите имя ссылки при добавлении или создании типа ссылки или категории. Все имена ссылок могут содержать до 70 символов Юникода.
Определите имя ссылки с помощью буквенно-цифровых символов, символов подчеркивания и дефисов. Каждое имя ссылки должно содержать по крайней мере один период ., но не может отображаться в начале или конце имени. Имя ссылки не должно начинаться с числа или подчеркивания, и оно не может иметь несколько последовательных дефисов, например --.
| Тип ограничения | Ограничение |
|---|---|
| Length | Не должно содержать более 70 символов Юникода. |
| Уникальность | — Не должно совпадать с любым другим именем ссылки на поле в коллекции проектов. — Не должно совпадать с любым другим именем ссылки на поле после того, как эти имена обрабатываются компьютером, чтобы заменить все периоды . подчеркиванием _. Например, имена My.*Field* ссылок на поля и My.Field оба процесса будут обрабатываться как одно и то же имя: My__Field |
| Специальные символы | — не должен содержать дефисы -.— должен содержать по крайней мере один период ..— не должно начинаться или заканчиваться периодом ..— не должно начинаться с числаMust не начинаться с подчеркивания _. |
Теги рабочих элементов
Теги рабочих элементов соответствуют одной или двум фразам ключевых слов для фильтрации средств отслеживания работы, таких как невыполненные работы, доски и запросы или определение запросов. Дополнительные сведения см. в разделе "Добавление тегов рабочих элементов для классификации и фильтрации списков и досок".
Имена тегов должны соответствовать следующим ограничениям.
| Тип ограничения | Ограничение |
|---|---|
| Length | — не должно содержать более 400 символов Юникода. — не должно быть пустым или пустым. |
| Специальные символы | — не должен содержать символы разделителя: , или ;.— Не должен содержать символы элемента управления Юникода или форматирования, такие как канал строк, разделитель абзаца, возврат каретки или другие несовпадные суррогатные символы. |
| Область | Так как глобальные списки доступны среди всех проектов, они не должны содержать элементы, определенные на уровне проекта, например определения учетной записи группы для конкретного проекта. |
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.
Внимание
Хотя вы можете включить пробелы в имена репозитория, мы не рекомендуем это сделать.
| Тип ограничения | Ограничение |
|---|---|
| Length | Не должно содержать более 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) метка применяется к определенному набору исправлений. Вы можете присоединить метки к набору несвязанных файлов в элементе управления версиями, что позволяет извлекать файлы или действовать в качестве группы. В следующей таблице описываются ограничения, введенные в имена меток.
| Тип ограничения | Ограничение |
|---|---|
| Length | Не должно содержать более 64 символов Юникода. |
| Специальные символы | - Не удается завершиться пробелом ( ) или периодом ..— не должно содержать следующие печатные символы: \ / : * ? " < > ; @ |. |
Наборы полков TFVC
Наборы полок позволяют временно отложить пакет ожидающих изменений, а затем удалить ожидающие изменения из рабочей области. Позже вы можете восстановить изменения в наборе полок в рабочей области или поместить их в рабочую область другого пользователя.
Имена наборов полок должны соответствовать следующим ограничениям.
| Тип ограничения | Ограничение |
|---|---|
| Length | Не должно содержать более 64 символов Юникода. |
| Специальные символы | Не должно содержать следующие печатные символы: \ / : * ? " < > & ; |. |
Рабочие области TFVC
Рабочая область — это клиентская копия файлов и папок в элементе управления версиями Team Foundation (TFVC). При создании нескольких рабочих областей можно использовать разные версии одной папки управления версиями на клиентском компьютере. Создание и работа с рабочими областями предоставляет дополнительные сведения.
Имена рабочих областей должны соответствовать следующим ограничениям.
| Тип ограничения | Ограничение |
|---|---|
| Length | Не должно содержать более 64 символов Юникода. |
| Специальные символы | — не должен заканчиваться пробелом ( ).— не должно содержать следующие печатные символы: \ / : * ? " < > ; |. |
Имена компьютеров
Имя компьютера, в котором устанавливается Azure DevOps, связано с именем сервера. Операционная система и Active Directory накладывают определенные ограничения на имена компьютеров, как описано в следующих статьях:
названия организаций;
Внимание
При создании имени организации соблюдайте следующие рекомендации.
- Используйте только буквы из английского алфавита
- Запуск имени организации с буквой или номером
- Используйте буквы, цифры или дефисы после начального символа
- Убедитесь, что ваша организация не превышает 50 символов Юникода
- Заканчивается буквой или номером
Если вы используете любой из запрещенных символов, вы получите следующее сообщение об ошибке: VS850015: указанное имя не допускается использовать: {Название организации}.
Шаблоны процессов и процессов
Процесс определяет стандартные блоки системы отслеживания рабочих элементов и других подсистем, к которым вы имеете доступ после подключения к проекту.
Примечание.
Терминология: "процесс" и "шаблон процесса" относятся к взаимозависимому набору файлов, используемых для создания проекта. Дополнительные сведения см. в разделе "Сведения о процессах и шаблонах процессов", описывающих различия между тремя процессами по умолчанию, доступными для вас.
Процессы, определяемые или настраиваемые, должны соответствовать следующим ограничениям.
| Тип ограничения | Ограничение |
|---|---|
| Length | Не должно содержать более 256 символов Юникода. |
| Уникальность | — должен быть уникальным в Azure DevOps. — При отправке шаблона с тем же именем, что и существующий шаблон, существующий шаблон перезаписывается. |
| Размер файла шаблона процесса | Не должно превышать 2 ГБ (гигабайты). |
Коллекции проектов
Коллекция проектов определяет группу проектов и ресурсы, связанные с этими проектами. Она предоставляет упорядоченную структуру, которую можно использовать для определения и управления группой проектов, определенных для Azure DevOps Server.
Кроме того, имя коллекции является частью строка подключения, используемой для подключения участников команды к проектам. Назначенное по умолчанию значение соответствует DefaultCollection. Управление коллекциями проектов предоставляет дополнительные сведения.
Имена, назначенные коллекциям проектов, должны соответствовать следующим ограничениям.
| Тип ограничения | Ограничение |
|---|---|
| Length | Не должно содержать более 64 символов Юникода. |
| Уникальность | — не должно совпадать с любым другим именем коллекции в локальном развертывании. — Если развертывание включает продукты SharePoint или службы SQL Server Reporting Services, они не могут совпадать с именем и полным путем существующего сайта SharePoint, сервера отчетов или веб-сайта служб Reporting Services. |
| Зарезервированные имена | Не должно быть зарезервированным именем системы. |
| Специальные символы | — Имя не должно содержать непечатаемых символов Юникода или заменяемых символов. — не должно содержать следующие печатные символы: \ / : * ? " < > ; # $ * { } , + = [ ] |. — не должен содержать многоточие ... или двойной период ...- Не должно начинаться с подчеркивания _.— не должно начинаться или заканчиваться периодом .. |
Имена проектов
Проект устанавливает репозиторий для исходного кода и место для команд для планирования, отслеживания хода выполнения и совместной работы. Имя проекта является частью строка подключения, используемой для подключения участников команды к проектам.
Имена, назначенные создаваемым проектам, должны соответствовать следующим ограничениям.
| Тип ограничения | Ограничение |
|---|---|
| Length | Не должно содержать более 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 после первоначальной установки необходимо убедиться, что выполняются следующие условия: — учетная запись входит в группу служб сборки. — У учетной записи есть разрешения на чтение и запись временных папок и временную папку ASP.NET. — У учетной записи есть разрешение на полный доступ к каталогу сборки и расположению удаления. |
| Проблемы с брандмауэром | Если компьютер сборки включен, убедитесь, что программа tfsbuildservice находится в списке исключений. |
Типы сборки
Типы сборки настраивают условия, в которых создается одно решение или набор решений в проекте. Чтобы выполнить сборку, необходимо создать новый тип сборки или использовать существующий тип сборки.
Имена типов сборки должны соответствовать следующим ограничениям.
| Тип ограничения | Ограничение |
|---|---|
| Уникальность | Не должно совпадать с любым другим именем типа сборки в проекте. |
| Специальные символы | Не должен содержать следующий печатный символ: $ |
Качество сборки
Качество сборки позволяет подключить уровень качества или состояние завершения к завершенной сборке. Team Foundation Build также позволяет создавать новые значения для типа качества сборки. Ознакомьтесь со значением "Оценить качество завершенной сборки " для списка значений качества сборки по умолчанию.
Имена качества сборки должны соответствовать следующим ограничениям.
| Тип ограничения | Ограничение |
|---|---|
| Length | Не должно содержать более 256 символов Юникода. |
| Уникальность | Не должно совпадать с любым другим именем качества сборки на компьютере Team Foundation Build. |
Имена команд
Имена групп определяют группу отдельных лиц или групп, которые совместно работают в качестве команды в проекте. Участники группы используют это имя для подключения к команде или запроса к участникам, определенным для команды.
Имена команд должны соответствовать соглашениям, которые позволяют отображать их как часть допустимого URL-адреса. Каждое имя команды должно быть уникальным в рамках одного проекта. Однако нет ограничений на использование одного имени команды в разных проектах в коллекции проектов. Дополнительные сведения см. в разделе "Добавление другой команды" или иерархии команд.
Имена команд должны соответствовать следующим ограничениям.
| Тип ограничения | Ограничение |
|---|---|
| Length | Не должно содержать более 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 % |