Restrictions et conventions de nommage
Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019
La plupart des composants d’Azure DevOps doivent respecter les restrictions et conventions de nommage. Les restrictions permettent de garantir une expérience utilisateur cohérente et de garantir la compatibilité avec d’autres applications.
Les restrictions courantes incluent le fait de ne pas dépasser la longueur des caractères d’un nom, de ne pas contenir de caractères spéciaux et de maintenir l’unicité des noms au sein d’un jeu d’objets.
Important
Lorsque vous utilisez l’API, plutôt que l’interface utilisateur, l’API vous permet de spécifier directement un nom, qui inclut des caractères qui peuvent être limités dans l’interface utilisateur.
Meilleures pratiques :
- Suivez les restrictions de l’interface utilisateur pour maintenir la cohérence et empêcher les problèmes inattendus.
- Validez les noms par programmation et gérez les caractères spéciaux de manière appropriée.
Considérations d’ordre général
Les restrictions de longueur de cet article sont mesurées par le nombre de caractères Unicode autorisés. Les caractères de substitution sont composés de deux caractères Unicode, qui comptent comme deux caractères par rapport à la restriction de longueur. Pour plus d’informations, consultez À propos d’Unicode et des jeux de caractères.
Comme pour les autres fichiers du système d’exploitation, les caractères de contrôle ASCII (ASCII 1-31) et les combinaisons de substitution ne sont pas non plus autorisés. Pour obtenir des informations générales sur les restrictions du système d’exploitation appliquées aux noms de fichiers, consultez Noms de fichiers, chemins et espaces de noms.
Remarque
- Pour connaître les limites du nombre d’éléments que vous pouvez définir, consultez suivi du travail, processus et limites de projet.
Noms réservés système
Évitez d’utiliser des noms réservés système, comme les exemples suivants :
- AUX
- COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10
- CON
- DefaultCollection
- LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9
- NUL
- PRN
- SERVER, SignalR
- Web ou WEB
Pour plus d’informations sur les noms réservés, consultez Noms de fichiers, chemins d’accès et espaces de noms.
Azure Artifacts
Les packages universels doivent être conformes aux restrictions suivantes.
| Type de restriction | Restriction |
|---|---|
| Nom du package | - Doit être minuscule. - Doit commencer et se terminer par des lettres ou des chiffres. - Doit contenir uniquement des lettres, des chiffres et des tirets non décocutifs, un trait de soulignement ou des points. |
| Version du package | Doit être en minuscules sans métadonnées de build. |
Azure Boards
Vous utilisez des éléments de travail pour capturer des informations pour planifier et suivre vos projets de développement logiciel. Avec les éléments de travail, vous pouvez décrire le travail à effectuer, affecter le travail, suivre l’état et coordonner les efforts au sein de votre équipe. Différents types d’éléments de travail, tels que les récits utilisateur, les tâches, les bogues et les problèmes, effectuent le suivi de différents types d’informations. Pour plus d’informations, consultez la documentation d’Azure Boards.
Tous les objets de suivi des éléments de travail sont associés à un ou plusieurs noms. La plupart ont des noms d’affichage conviviaux, à l’exception des types d’éléments de travail et des listes globales, qui sont associés aux noms de référence. Un nom convivial est un identificateur unique visible par l’utilisateur pour un champ. L’utilisation de noms conviviaux garantit la cohérence entre les projets et les types d’éléments de travail dans une collection de projets. Le système utilise le nom de référence en interne et vous ne pouvez pas le modifier une fois défini.
Il existe des restrictions sur plusieurs éléments associés à des éléments de travail, notamment des noms de référence et conviviaux, des noms de champs et une taille de pièce jointe.
Chemins d'accès d'itération et de zone
Deux champs d’élément de travail, chemin d’accès à la zone et chemin d’itération fournissent une hiérarchie de structure d’arborescence pour le travail de regroupement. Les chemins d’accès de zone regroupent les éléments de travail par produit, fonctionnel ou zone de fonctionnalité. Les chemins d’itération regroupent les éléments de travail en sprints, jalons ou périodes pour traiter ces éléments de travail.
Ces champs à plusieurs nœuds utilisent les caractères de barre oblique \ inverse pour indiquer la hiérarchie des nœuds au sein de l’arborescence.
Les noms que vous affectez aux nœuds enfants à ces champs doivent être conformes aux restrictions suivantes.
| Type de restriction | Restriction |
|---|---|
| Longueur de nœud | Ne doit pas contenir plus de 255 caractères. |
| Noms réservés | - Ne doit pas se composer uniquement d’une période . ou de deux périodes ...- Ne doit pas être un nom réservé par le système, tel que PRN, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10, LPT1, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, NUL, CON ou AUX. Pour plus d’informations sur les noms réservés, consultez Noms de fichiers, chemins et espaces de noms. |
| Caractères spéciaux pour les nœuds | - Ne doit pas contenir de caractères de contrôle Unicode. - Ne doit contenir aucun des caractères suivants : \ / : * ? " < > | # $ & * +.- Ne doit pas contenir de caractères interdits par le système de fichiers local. Pour plus d’informations sur les restrictions de caractères Windows, consultez Nommer des fichiers, des chemins d’accès et des espaces de noms. |
| Longueur des chemins d'accès | Ne doit pas contenir plus de 4 000 caractères Unicode. |
| Profondeur de la hiérarchie des chemins d'accès | Doit être inférieur à 14 niveaux de profondeur. |
Documents joints
Les fichiers attachés aux éléments de travail doivent être conformes aux restrictions suivantes.
| Type de restriction | Restriction |
|---|---|
| Taille du fichier | Ne doit pas dépasser la taille maximale : - Taille maximale par défaut : 4 096 kilo-octets. - Taille maximale absolue : 2 gigaoctets. |
| Type de restriction | Restriction |
|---|---|
| Taille du fichier | Ne doit pas dépasser la taille maximale : - Taille maximale par défaut : 4 096 kilo-octets. - Taille maximale absolue : 2 gigaoctets. Pour plus d’informations, consultez Modifier la taille maximale des pièces jointes pour les éléments de travail. |
Noms des colonnes et des couloirs de bord
Votre carte transforme votre backlog en un signboard interactif, fournissant un flux visuel de travail. À mesure que le travail progresse de l’état de concept à sa réalisation, vous mettez à jour les éléments sur le tableau. Chaque colonne représente une étape du travail, et chaque carte représente un récit utilisateur (cartes bleues) ou un bogue (cartes rouges) à cette étape du travail.
Personnalisez votre carte en ajoutant, en supprimant ou en renommant des colonnes et des couloirs. Les colonnes prennent en charge le flux de travail sur l’ensemble du tableau. Les couloirs de bain vous permettent de gérer différentes classes de travail en tant que voies horizontales sur la carte.
Les noms des colonnes et des couloirs doivent être conformes aux restrictions suivantes.
| Type de restriction | Restriction |
|---|---|
| Longueur | Ne doit pas contenir plus de 256 caractères Unicode. |
| Unicité | - Les noms de colonnes ne doivent pas être identiques à n’importe quel autre nom de colonne sur la carte. - Les noms des couloirs ne doivent pas être identiques à n’importe quel autre nom de couloir à bord. |
| Caractères spéciaux | Ne doit pas contenir de caractères de contrôle Unicode ou de substitution. |
Noms de champs
Chaque type d’élément de travail contient un ou plusieurs champs d’élément de travail. Ces champs définissent les informations stockées pour les éléments de travail en fonction du type d’élément de travail. Chaque champ d’élément de travail a un nom de référence de champ associé. Le nom de référence de champ identifie de manière unique chaque champ et ne peut pas être modifié une fois affecté. Pour plus d’informations sur les champs d’élément de travail obsolètes, consultez l’index du champ Élément de travail.
Les noms de champs d’élément de travail doivent être conformes aux restrictions suivantes.
| Type de restriction | Restriction |
|---|---|
| Longueur | Ne doit pas contenir plus de 128 caractères Unicode. |
| Unicité | - Les noms de champs doivent contenir au moins un caractère alphabétique. - Ne doit contenir aucun des caractères suivants : . , ; ' : ~ \ / \ * ? " & % $ ! + = () [] {} <> - |.- Ne doit pas contenir d’espaces de début ou de fin. - Ne doit pas contenir deux espaces consécutifs ou plus. |
| Caractères spéciaux | Doit être unique au sein de l’organisation ou de la collection de projets. Les noms de champs d’élément de travail sont limités à la collection de projets. Si vous renommez un nom de champ, vous le modifiez pour tous les éléments de travail et les wiT définis dans tous les projets de la collection. |
Noms de référence de champ et portabilité
Le langage de définition de type d’élément de travail inclut le concept d’un nom de référence de champ. Les noms de référence de champs peuvent vous aider à porter des définitions entre les collections de projets Team Foundation et également pour permettre aux intégrations non-Microsoft de rechercher et de faire référence à des champs spécifiques. Ces noms sont globalement uniques, tout comme un espace de noms dans l’application .NET Framework est globalement unique.
L’espace de noms système est utilisé uniquement pour définir tous les champs système principaux obligatoires pour les fonctions système Team Foundation. Vous ne pouvez pas créer votre propre champ System.X, car il peut entraver les fonctionnalités.
L’espace de noms Microsoft est utilisé pour définir les champs de suivi des éléments de travail. Ces champs sont définis dans une définition de type d’élément de travail des modèles de processus.
Les clients et les partenaires peuvent créer leurs propres espaces de noms de champs pour les types d’éléments de travail personnalisés. Pour obtenir des descriptions des champs système et des champs définis dans les modèles de processus par défaut, consultez Index des champs d’élément de travail.
Important
- Les noms de référence de champ ne peuvent pas être renommés. Si, par exemple, vous avez modifié le nom du champ « Titre » en « En-tête », le nom de référence de champ de ce champ reste le même. Les intégrations et les représentations internes des champs doivent utiliser le nom de référence de champ au lieu de dépendre du nom de champ lui-même.
- Bien que vous puissiez créer votre propre champ Microsoft.X, nous vous déconseillons de le faire, car il peut entraver les fonctionnalités ou la possibilité pour l’Assistant Configurer des fonctionnalités de mettre à jour un projet après une mise à niveau.
Exemples de noms de référence de champ
Les exemples suivants montrent des noms de référence de champ valides, dans différents espaces de noms. Les clients et les partenaires peuvent également définir leurs propres espaces de noms pour prendre en charge leurs types d’éléments de travail personnalisés.
| Exemples d’espaces de noms système | Exemples d’espaces de noms Microsoft | Autres exemples d’espaces de noms |
|---|---|---|
| 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 | La société fictive, Fabrikam Fiber, peut définir les champs d’élément de travail personnalisés suivants : FabrikamFiber.Common.Severity, FabrikamFiber.Common.Phase, FabrikamFiber.RiskManagement.RiskType, FabrikamFiber.RiskManagement.Resolution La société logicielle fictive Contoso Corporation peut définir les champs d’élément de travail suivants : Contoso.Common.BusinessPriority, Contoso.Bug.FoundInPhase, Contoso.Bug.FixInPhase |
Texte d’aide sur le champ
Le système affiche le texte d’aide au moment de l’exécution pour aider les utilisateurs à savoir quoi entrer dans le champ. Le texte d’aide est limité à un type d’élément de travail spécifique dans un projet spécifique.
Pour le processus d’héritage, vous spécifiez le texte d’aide d’un champ dans la boîte de dialogue Modifier le champ , l’onglet Définition , Description. Voir Ajouter un champ personnalisé à un type d’élément de travail. Pour le processus XML local, vous spécifiez du texte d’aide à l’aide de l’élément HELPTEXT . Consultez Ajouter ou modifier un champ pour le suivi du travail.
Le texte d’aide que vous ajoutez doit être conforme aux restrictions suivantes.
| Type de restriction | Restriction |
|---|---|
| Longueur | Ne doit pas contenir plus de 255 caractères Unicode. |
Listes globales
Une liste globale est un ensemble de valeurs d’élément de liste que vous pouvez utiliser globalement dans toutes les collections de projets au sein d’une instance d’un serveur Azure DevOps local. Lorsque vous définissez des types d’éléments de travail, vous pouvez constater que certains champs d’élément de travail partagent le même ensemble de valeurs autorisées ou suggérées. Les listes globales vous permettent de définir ces valeurs une seule fois et de les partager entre plusieurs types d’éléments de travail et projets. Pour plus d’informations, consultez Définir des listes globales.
Une liste globale, définie à l’aide de l’élément GLOBALLIST contient un ou plusieurs éléments de liste, spécifiés à l’aide de l’élément LISTITEM .
LISTITEM les noms doivent être conformes aux restrictions suivantes.
| Type de restriction | Restriction |
|---|---|
| Longueur | - Ne doit pas contenir plus de 254 caractères Unicode. - Ne doit pas être vide. |
| Caractères spéciaux | - Ne doit pas contenir d’espace blanc de début ou de fin. - Ne doit pas contenir deux espaces consécutifs. - Ne doit pas contenir de caractères de barre oblique \ inverse. |
| Étendue | Étant donné que les listes globales sont disponibles parmi tous les projets, elles ne doivent pas contenir d’éléments définis au niveau du projet, tels que les définitions de compte de groupe spécifiques au projet. |
Les listes globales doivent être conformes aux restrictions suivantes.
| Type de restriction | Restriction |
|---|---|
| Nombre d’articles | Impossible d’être vide. La liste globale doit contenir au moins un LISTITEM élément. |
| Unicité | Impossible d’être vide. La liste globale doit contenir au moins un LISTITEM élément. |
Noms de référence de type de lien et de catégorie
Définissez un nom de référence chaque fois que vous ajoutez ou créez un type de lien ou une catégorie. Tous les noms de référence peuvent comporter jusqu’à 70 caractères Unicode.
Définissez un nom de référence à l’aide de caractères alphanumériques, de caractères de trait de soulignement et de caractères de trait d’union. Chaque nom de référence doit contenir au moins un point ., mais aucun point ne peut apparaître au début ou à la fin d’un nom. Un nom de référence ne doit pas commencer par un nombre ou un trait de soulignement, et il ne peut pas avoir plusieurs traits d’union consécutifs, tels que --.
| Type de restriction | Restriction |
|---|---|
| Longueur | Ne doit pas contenir plus de 70 caractères Unicode. |
| Unicité | - Ne doit pas être identique à un autre nom de référence de champ dans la collection de projets. - Ne doit pas être identique à un autre nom de référence de champ après que ces noms sont traités par l’ordinateur pour remplacer toutes les périodes par des traits . _de soulignement. Par exemple, les noms My.*Field* de référence de champ et My.Field traiteraient tous les deux comme le même nom : My__Field |
| Caractères spéciaux | - Ne doit pas contenir de traits d’union -.- Doit contenir au moins une période ..- Ne doit pas commencer ou se terminer par un point ..- Ne doit pas commencer par un nombreMust ne pas commencer par un trait de soulignement _. |
Étiquettes d’élément de travail
Les balises d’élément de travail correspondent à une ou deux expressions de mots clés pour filtrer les outils de suivi du travail tels que les backlogs, les tableaux et les requêtes ou définir des requêtes. Pour plus d’informations, consultez Ajouter des balises d’élément de travail pour catégoriser et filtrer des listes et des tableaux.
Les noms de balise doivent être conformes aux restrictions suivantes.
| Type de restriction | Restriction |
|---|---|
| Longueur | - Ne doit pas contenir plus de 400 caractères Unicode. - Ne doit pas être null ou vide. |
| Caractères spéciaux | - Ne doit pas contenir de caractères de séparation : , ou ;.- Ne doit pas contenir de caractères de contrôle ou de format Unicode, tels qu’un flux de ligne, un séparateur de paragraphe, un retour chariot ou d’autres caractères de substitution incompatibles. |
| Étendue | Étant donné que les listes globales sont disponibles parmi tous les projets, elles ne doivent pas contenir d’éléments définis au niveau du projet, tels que les définitions de compte de groupe spécifiques au projet. |
Azure Pipelines
Les définitions d’Azure Pipeline doivent être conformes aux restrictions suivantes.
| Type de restriction | Restriction |
|---|---|
| Nom du travail | - Doit contenir uniquement des caractères alphanumériques et '_'.- Ne doit pas commencer par un nombre. - Doit avoir un nom unique. - Ne doit pas contenir de mots clés, par exemple : « déploiement ». |
| Nom de l’étape | - Doit contenir uniquement des caractères alphanumériques et '_'.- Ne doit pas commencer par un nombre. - Ne doit pas contenir de mots clés, par exemple : « déploiement ». |
| Expressions | Doit commencer par a-Z ou _AND, suivi par a-Z, 0-9ou _. |
Pour plus d’informations, consultez la documentation Azure Pipelines.
Azure Repos (Git)
Chaque projet Azure DevOps peut contenir plusieurs référentiels Git. Les noms que vous affectez aux référentiels Git doivent être conformes aux restrictions suivantes. Pour plus d’informations, consultez la documentation Git d’Azure Repos. Pour plus d’informations sur les restrictions d’affectation de noms pour d’autres éléments Git tels que les branches et les balises, consultez git check-ref-format.
Important
Bien que vous puissiez inclure des espaces dans des noms de dépôt, nous vous déconseillons de le faire.
| Type de restriction | Restriction |
|---|---|
| Longueur | Ne doit pas contenir plus de 64 caractères Unicode. |
| Unicité | Ne doit pas être identique à un autre nom de dépôt Git dans le projet. |
| Caractères spéciaux | - Ne doit pas contenir de caractères de contrôle Unicode ou de caractères de substitution. - Ne doit pas contenir les caractères imprimables suivants : \ / : * ? " < > ; # $ * { } , + = [ ] |.- Ne doit pas commencer par un trait de soulignement _.- Ne doit pas commencer ou se terminer par un point ..- Ne doit pas être un nom réservé système. |
Azure Repos (TFVC)
Team Foundation Version Control (TFVC) fournit un référentiel central pour les fichiers et les commandes nécessaires pour gérer ces fichiers dans une équipe. Il fournit également des stratégies d’archivage personnalisables, des branchements, des fusions, des sauvegardes et de nombreuses autres fonctionnalités. Pour plus d’informations, consultez la documentation AZURE Repos TFVC
Les chemins de contrôle de version doivent être conformes aux restrictions suivantes. Consultez également Optimiser votre espace de travail.
| Type de restriction | Restriction |
|---|---|
| Longueur du chemin du dossier du contrôle de code source du serveur | - Ne doit pas contenir plus de 259 caractères Unicode pour un seul dossier ou nom de fichier. - Ne doit pas contenir plus de 388 caractères Unicode pour un répertoire. - Ne doit pas contenir plus de 399 caractères Unicode pour un répertoire combiné et un nom de fichier. |
| Longueur du chemin d’accès au dossier local | - Ne doit pas contenir plus de 248 caractères Unicode pour un répertoire. - Ne doit pas contenir plus de 260 caractères Unicode pour un répertoire combiné et un nom de fichier. |
| Restrictions de longueur propres au portail web et rest | Ne doit pas contenir plus de 215 caractères Unicode pour un nom de projet, un répertoire et un nom de fichier combinés. |
Dans le portail web et l’API REST, certaines opérations ont une longueur de chemin plus restrictive que Visual Studio et TF.exe clients. Ces opérations incluent La modification, le renommage et la suppression, et se produisent, car le portail web/REST utilise un espace de travail généré de manière aléatoire pour la concurrence lors de l’attente des modifications.
Fichiers TFVC
Le système de contrôle de version stocke de nombreux types de fichiers différents. Configurer le contrôle de version Team Foundation sur votre machine de développement fournit des détails sur l’ajout de projets ou de solutions Visual Studio existants.
Les fichiers et dossiers que vous ajoutez au contrôle de version Team Foundation doivent être conformes aux restrictions suivantes.
| Type de restriction | Restriction |
|---|---|
| Fichiers et dossiers | - Les noms ne doivent pas contenir les caractères imprimables suivants : \ / : * ? " < > ;.- Les dossiers ne doivent pas se trouver en dehors du répertoire mappé de l’espace de travail actif. |
| Noms de fichiers | - Ne doit pas commencer par un $.- Ne doit pas contenir les caractères imprimables suivants : \ / : * ? " < > ; |. |
Étiquettes TFVC
Dans le contrôle de version Team Foundation (TFVC), une étiquette est un nom appliqué à un ensemble spécifique de révisions. Vous pouvez joindre des étiquettes à un ensemble de fichiers non liés dans le contrôle de version, ce qui vous permet de récupérer les fichiers ou d’agir sur eux en tant que groupe. Le tableau suivant décrit les restrictions mises sur les noms d’étiquettes.
| Type de restriction | Restriction |
|---|---|
| Longueur | Ne doit pas contenir plus de 64 caractères Unicode. |
| Caractères spéciaux | - Impossible de se terminer par un espace ou un point ( ) ..- Ne doit pas contenir les caractères imprimables suivants : \ / : * ? " < > ; @ |. |
Ensembles de rayons TFVC
Les ensembles de rayons vous permettent de mettre de côté temporairement un lot de modifications en attente, puis, en tant qu’option, de supprimer les modifications en attente de votre espace de travail. Plus tard, vous pouvez restaurer les modifications d’un ensemble de rayons dans votre espace de travail ou les placer dans l’espace de travail d’un autre utilisateur.
Les noms d’ensembles de rayons doivent être conformes aux restrictions suivantes.
| Type de restriction | Restriction |
|---|---|
| Longueur | Ne doit pas contenir plus de 64 caractères Unicode. |
| Caractères spéciaux | Ne doit pas contenir les caractères imprimables suivants : \ / : * ? " < > & ; |. |
Espaces de travail TFVC
Un espace de travail est une copie côté client des fichiers et dossiers dans le contrôle de version team Foundation (TFVC). Lorsque vous créez plusieurs espaces de travail, vous pouvez avoir différentes versions du même dossier de contrôle de version sur un ordinateur client. Créer et utiliser des espaces de travail fournit plus de détails.
Les noms d’espace de travail doivent être conformes aux restrictions suivantes.
| Type de restriction | Restriction |
|---|---|
| Longueur | Ne doit pas contenir plus de 64 caractères Unicode. |
| Caractères spéciaux | - Ne doit pas se terminer par un espace ( ).- Ne doit pas contenir les caractères imprimables suivants : \ / : * ? " < > ; |. |
Noms des ordinateurs
Le nom de l’ordinateur où vous installez Azure DevOps est associé au nom du serveur. Le système d’exploitation et Active Directory imposent certaines restrictions sur les noms d’ordinateurs, comme décrit dans les articles suivants :
Noms d’organisation
Important
Respectez les instructions suivantes lorsque vous créez un nom d’organisation.
- Utiliser uniquement des lettres de l’alphabet anglais
- Démarrer le nom de votre organisation avec une lettre ou un numéro
- Utilisez des lettres, des chiffres ou des traits d’union après le caractère initial
- Vérifiez que votre organisation ne dépasse pas 50 caractères Unicode
- Fin avec une lettre ou un nombre
Si vous utilisez l’un des caractères non autorisés, vous obtenez le message d’erreur suivant : VS850015 : le nom spécifié n’est pas autorisé à être utilisé : {Nom de l’organisation}.
Processus et modèles de processus
Un processus définit les blocs de construction du système de suivi des éléments de travail et d’autres sous-systèmes auxquels vous avez accès après la connexion à un projet.
Remarque
Terminologie : les deux « processus » et « modèle de processus » font référence à un ensemble interdépendant de fichiers utilisés pour créer un projet. Pour plus d’informations, consultez À propos des processus et des modèles de processus, qui décrivent les différences entre les trois processus par défaut disponibles.
Les processus que vous définissez ou personnalisez doivent respecter les restrictions suivantes.
| Type de restriction | Restriction |
|---|---|
| Longueur | Ne doit pas contenir plus de 256 caractères Unicode. |
| Unicité | - Doit être unique dans Azure DevOps. - Si vous chargez un modèle portant le même nom qu’un modèle existant, le modèle existant est remplacé. |
| Taille du fichier de modèle de processus | Ne doit pas dépasser 2 Go (gigaoctets). |
Collections de projets
Une collection de projets identifie un groupe de projets et les ressources associées à ces projets. Il fournit une structure d’organisation que vous pouvez utiliser pour définir et contrôler un groupe de projets définis pour un serveur Azure DevOps.
En outre, le nom de la collection fait partie de la chaîne de connexion utilisée pour connecter les membres de l’équipe aux projets. La valeur par défaut affectée correspond à DefaultCollection. Gérer les collections de projets fournit plus d’informations.
Les noms que vous attribuez aux collections de projets doivent être conformes aux restrictions suivantes.
| Type de restriction | Restriction |
|---|---|
| Longueur | Ne doit pas contenir plus de 64 caractères Unicode. |
| Unicité | - Ne doit pas être identique à un autre nom de collection dans votre déploiement local. - Si votre déploiement inclut des produits SharePoint ou SQL Server Reporting Services, ils ne peuvent pas être identiques au nom et au chemin complet d’un site SharePoint, d’un serveur de rapports ou d’un site web Reporting Services existant. |
| Noms réservés | Ne doit pas être un nom réservé système. |
| Caractères spéciaux | - Ne doit pas contenir de caractères de contrôle Unicode ou de caractères de substitution. - Ne doit pas contenir les caractères imprimables suivants : \ / : * ? " < > ; # $ * { } , + = [ ] |. - Ne doit pas contenir de points de suspension ... ou de période ..double.- Ne doit pas commencer par un trait de soulignement _.- Ne doit pas commencer ou se terminer par un point .. |
Noms de projets
Un projet établit un référentiel pour le code source et un emplacement pour que les équipes planifient, suivent la progression et collaborent. Le nom du projet fait partie de la chaîne de connexion utilisée pour connecter les membres de l’équipe aux projets.
Les noms que vous attribuez aux projets que vous créez doivent respecter les restrictions suivantes.
| Type de restriction | Restriction |
|---|---|
| Longueur | Ne doit pas contenir plus de 64 caractères Unicode. |
| Unicité | Ne doit pas être identique à un autre nom dans la collection de projets, à l’application Web SharePoint qui prend en charge la collection ou à l’instance de SQL Server Reporting Services qui prend en charge la collection. |
| Noms de réserve | - Ne doit pas être un nom réservé système. - Ne doit pas être l’un des segments masqués utilisés pour le filtrage des requêtes IIS comme App_Browsers, App_code, App_Data, App_GlobalResources, App_LocalResources, App_Themes, App_WebResources, bin ou web.config. |
| Caractères spéciaux | - Ne doit pas contenir de caractères de contrôle Unicode ou de caractères de substitution. - Ne doit pas contenir les caractères imprimables suivants : \ / : * ? " < > ; # $ * { } , + = [ ] |. - Ne doit pas commencer par un trait de soulignement _.- Ne doit pas commencer ou se terminer par un point .. |
Groupes de sécurité
Avec les groupes de sécurité Azure DevOps, vous pouvez appliquer certains droits ou autorisations à un groupe d’utilisateurs.
Les groupes locaux peuvent être constitués de comptes de groupe Active Directory, de groupes de sécurité Azure DevOps, de comptes d’utilisateurs Windows, de comptes de groupe Windows ou d’un mélange de ces types. Pour plus d’informations, consultez Ajouter Active Directory / Microsoft Entra utilisateurs ou groupes à un groupe de sécurité intégré.
Les groupes de sécurité doivent se conformer aux restrictions suivantes.
| Type de restriction | Restriction |
|---|---|
| Longueur du nom du compte de groupe de sécurité | Ne doit pas contenir plus de 256 caractères Unicode. |
| Unicité | - Les comptes de groupe au niveau du projet ne doivent pas correspondre à un autre nom de groupe dans le même projet. - Les comptes de groupe au niveau de la collection ne doivent correspondre à aucun autre nom d’un compte de groupe dans la collection de projets. |
| Noms de groupes réservés | Ne doit pas être nommé avec un $NAMESPACE au niveau du projet ou du serveur. |
| Caractères spéciaux | - Ne doit pas contenir de caractères de contrôle Unicode ou de caractères de substitution. - Ne doit pas contenir les caractères imprimables suivants : / \ [ ] : < > + = ; ? * |. - Ne doit pas inclure de caractères non imprimables dans la plage de valeurs ASCII comprise entre 1 et 31. - Ne doit pas se terminer par une période ..- Ne doit pas inclure de virgules ,. |
Team Foundation Build
Team Foundation Build vous permet de gérer tous les aspects du processus de génération sur un seul ordinateur. En utilisant Team Foundation Build, vous pouvez synchroniser les sources, compiler l’application, exécuter des tests unitaires associés, effectuer une analyse du code, publier des builds sur un serveur de fichiers et publier des rapports de build.
Générer un ordinateur
Team Foundation Build est une installation distincte du niveau d’application Azure DevOps Server, de la couche Données ou du client Visual Studio. Vous pouvez choisir un ordinateur distinct. Sinon, vous pouvez installer la build côte à côte sur l’ordinateur client ou sur les serveurs.
Votre ordinateur de build local doit être conforme aux restrictions suivantes.
| Type de restriction | Restriction |
|---|---|
| Espace disque | Doit contenir suffisamment d’espace pour la build (un espace insuffisant entraîne l’échec des builds). |
| Répertoire de build | Doit être un chemin d’accès local (par exemple, C:\BuildDirectory). |
| Supprimer le répertoire d’emplacement | Doit être un chemin UNC (par exemple, \server\share). |
| Supprimer les autorisations d’emplacement | Chaque build générée est placée dans un nouveau répertoire dans le dossier de suppression. - Le compte service Team Foundation Server (par exemple) Domain\TFSSERVICEdoit disposer d’un accès d’autorisation Contrôle total à l’emplacement de suppression UNC.- L’emplacement de suppression UNC doit être un dossier partagé. |
| Compte Team Foundation Build Service | Si vous modifiez le compte de service TFS après l’installation initiale, vous devez vous assurer que les conditions suivantes sont remplies : - Le compte est membre du groupe Build Services. - Le compte dispose d’autorisations en lecture/écriture dans les dossiers temporaires et le ASP.NET dossier temporaire. - Le compte dispose de l’autorisation Contrôle total sur le répertoire de build et l’emplacement de suppression. |
| Problèmes liés au pare-feu | Si l’ordinateur de build est activé, vérifiez que le programme, tfsbuildservice, figure dans la liste des exceptions. |
Types de build
Les types de build configurent les conditions dans lesquelles une solution unique ou un ensemble de solutions dans un projet sont générées. Pour effectuer une build, vous devez créer un nouveau type de build ou utiliser un type de build existant.
Les noms de types de build doivent être conformes aux restrictions suivantes.
| Type de restriction | Restriction |
|---|---|
| Unicité | Ne doit pas être identique à un autre nom de type de build dans le projet. |
| Caractères spéciaux | Ne doit pas contenir le caractère imprimable suivant : $. |
Qualité de la build
La qualité de la build vous permet d’attacher un niveau de qualité ou un état d’achèvement à une build terminée. Team Foundation Build vous permet également de créer de nouvelles valeurs pour le type de qualité de build. Consultez Évaluer la qualité d’une build terminée pour obtenir la liste des valeurs de qualité de build par défaut.
Les noms de qualité de build doivent être conformes aux restrictions suivantes.
| Type de restriction | Restriction |
|---|---|
| Longueur | Ne doit pas contenir plus de 256 caractères Unicode. |
| Unicité | Ne doit pas être identique à n’importe quel autre nom de qualité de build dans l’ordinateur Team Foundation Build. |
Noms d’équipe
Les noms d’équipe identifient un groupe d’individus ou de groupes qui collaborent collectivement en tant qu’équipe dans un projet. Les membres de l’équipe utilisent ce nom pour se connecter à l’équipe ou pour interroger les membres définis pour une équipe.
Les noms d’équipe doivent être conformes aux conventions qui leur permettent d’être restituées dans le cadre d’une URL valide. Chaque nom d’équipe doit être unique au sein d’un seul projet. Toutefois, il n’existe aucune restriction sur l’utilisation du même nom d’équipe dans différents projets au sein d’une collection de projets. Pour plus d’informations, consultez Ajouter une autre équipe ou une hiérarchie d’équipes.
Les noms d’équipe doivent être conformes aux restrictions suivantes.
| Type de restriction | Restriction |
|---|---|
| Longueur | Ne doit pas contenir plus de 64 caractères Unicode. |
| Unicité | Ne doit pas être identique à un autre nom dans le projet. |
| Noms réservés | Ne doit pas être un nom réservé système. |
| Caractères spéciaux | - Ne doit pas contenir de caractères de contrôle Unicode ou de caractères de substitution. - Ne doit pas contenir les caractères imprimables suivants : \ / : * ? " < > ; # $ * { } , + = [ ] |.- Ne doit pas contenir de points de suspension ... ou de période ..double.- Ne doit pas commencer par un trait de soulignement _.- Ne doit pas commencer ou se terminer par un point .. |
Noms de compte d’utilisateur
Les comptes d’utilisateur identifient les personnes ajoutées à un projet ou à une collection de projets. Les comptes d’utilisateur peuvent correspondre aux entrées dans Active Directory, l’ID Microsoft Entra, le groupe de serveurs Windows.
Les comptes d’utilisateur que vous ajoutez à une organisation ou à une collection doivent être conformes aux restrictions suivantes. Pour ajouter des comptes d’utilisateur à un projet, consultez Ajouter des utilisateurs à un projet ou une équipe.
| Type de restriction | Restriction |
|---|---|
| Longueur du nom du compte | Ne doit pas contenir plus de 256 caractères Unicode. |
| Unicité | Ne doit correspondre à aucun autre compte d’utilisateur ajouté à la collection de projets. |
| Noms de groupes réservés | Ne doit pas être nommé avec un $NAMESPACE projet ou au niveau du serveur. |
| Caractères spéciaux | - Ne doit pas inclure les caractères imprimables suivants : "/ \ [ ] : < > + = ; ? * |.- Ne doit pas inclure de caractères non imprimables dans la plage de valeurs ASCII comprise entre 1 et 31. - Ne doit pas se terminer par une période . ou un signe $dollar.- Ne doit pas inclure de virgules ,.- Ne doit pas inclure les catégories Unicode suivantes : LineSeparator, ParagraphSeparator, Control, Format, OtherNotAssigned. |
Noms de pages et de fichiers Wiki
Chaque page wiki correspond à un fichier dans le dépôt Git wiki. Les noms que vous affectez au titre d’une page wiki doivent être conformes aux restrictions suivantes.
| Type de restriction | Restriction |
|---|---|
| Nom de fichier | Le chemin complet de la page ne doit pas dépasser 235 caractères. |
| Unicité | Les titres de page respectent la casse et doivent être uniques au sein de la hiérarchie du wiki. |
| Caractères spéciaux | - Ne doit pas contenir de caractères de contrôle Unicode ou de caractères de substitution. - Ne doit pas contenir les caractères imprimables suivants : / \ #.- Ne doit pas commencer ou se terminer par un point .. |
| Taille du fichier | Ne doit pas dépasser le maximum de 18 Mo. |
| Taille du fichier de pièce jointe | Ne doit pas dépasser le maximum de 19 Mo. |
Caractères spéciaux dans les titres des pages Wiki
Vous pouvez spécifier des titres de page qui contiennent un ou plusieurs de ces caractères : < > * ? | -spéciaux . Par exemple, vous pouvez nommer un fichier Markdown « FAQ » ou « Guide de configuration ». Les caractères ont les chaînes encodées d’URI suivantes :
| Caractère | Chaîne encodée |
|---|---|
: |
%3A |
< |
%3C |
> |
%3E |
* |
%2A |
? |
%3F |
| |
%7C |
- |
%2D |
" |
%22 |