Restrições e convenções de nomenclatura
Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019
A maioria dos componentes no Azure DevOps deve seguir restrições e convenções de nomenclatura. As restrições ajudam a garantir uma experiência de usuário consistente e fornecem compatibilidade com outros aplicativos.
As restrições comuns incluem não exceder o comprimento de caracteres para um nome, não conter caracteres especiais e manter a exclusividade dos nomes dentro de um conjunto de objetos.
Importante
Ao usar a API, em vez da interface do usuário (UI), a API permite que você especifique diretamente um nome, que inclui caracteres que podem ser restritos na interface do usuário.
Melhores práticas:
- Siga as restrições da interface do usuário para manter a consistência e evitar problemas não intencionais.
- Valide nomes programaticamente e manipule quaisquer caracteres especiais adequadamente.
Considerações gerais
As restrições de comprimento neste artigo são medidas pelo número de caracteres Unicode permitidos. Os caracteres substitutos são compostos por dois caracteres Unicode, que contam como dois caracteres contra a restrição de comprimento. Para obter mais informações, consulte Sobre Unicode e conjuntos de caracteres.
Tal como acontece com outros ficheiros do sistema operativo, caracteres de controlo ASCII (ASCII 1-31) e combinações substitutas também não são permitidos. Para obter informações gerais sobre as restrições do sistema operacional aplicadas a nomes de arquivo, consulte Nomenclatura de arquivos, caminhos e namespaces.
Nota
- Para obter limites no número de itens que você pode definir, consulte Limites de controle de trabalho, processo e projeto.
Nomes reservados do sistema
Evite usar nomes reservados do sistema, como os seguintes exemplos:
- AUX
- COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10
- CON
- DefaultCollection
- LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9
- NUL
- PRN
- SERVIDOR, SignalR
- Web ou WEB
Para obter mais informações sobre nomes reservados, consulte Nomes de arquivos, caminhos e namespaces.
Artefactos do Azure
As embalagens universais devem respeitar as seguintes restrições:
| Tipo de restrição | Restrição |
|---|---|
| Nome do pacote | - Deve ser minúscula. - Deve começar e terminar com letras ou números. - Deve conter apenas letras, números e traços não consecutivos, sublinhado ou pontos. |
| Versão de pacote | Deve ser minúsculo sem metadados de compilação. |
Azure Boards
Você usa itens de trabalho para capturar informações para planejar e acompanhar seus projetos de desenvolvimento de software. Com itens de trabalho, você pode descrever o trabalho a ser feito, atribuir trabalho, acompanhar o status e coordenar esforços dentro de sua equipe. Diferentes tipos de itens de trabalho, como histórias de usuários, tarefas, bugs e problemas, rastreiam diferentes tipos de informações. Para obter mais informações, consulte a documentação do Azure Boards.
Todos os objetos de controle de item de trabalho estão associados a um ou mais nomes. A maioria tem nomes de exibição amigáveis, exceto tipos de item de trabalho e listas globais, que estão associados a nomes de referência. Um nome amigável é um identificador exclusivo e visível pelo usuário para um campo. O uso de nomes amigáveis garante a consistência entre projetos e tipos de item de trabalho em uma coleção de projetos. O sistema usa o nome de referência internamente e você não pode alterá-lo uma vez definido.
Há restrições em vários elementos associados a itens de trabalho, incluindo nomes de referência e amigáveis, nomes de campo e tamanho de anexo.
Caminhos de área e iteração
Dois campos de item de trabalho, Caminho de Área e Caminho de Iteração, fornecem uma hierarquia de estrutura de árvore para o trabalho de agrupamento. Os caminhos de área agrupam itens de trabalho por produto, funcional ou área de recurso. Os caminhos de iteração agrupam itens de trabalho em sprints, marcos ou períodos de tempo para abordar esses itens de trabalho.
Esses campos de vários nós usam os caracteres de barra invertida \ para denotar a hierarquia de nós dentro da estrutura de árvore.
Os nomes atribuídos aos nós filhos a esses campos devem estar em conformidade com as restrições a seguir.
| Tipo de restrição | Restrição |
|---|---|
| Comprimento do nó | Não deve conter mais de 255 caracteres. |
| Nomes reservados | - Não deve consistir apenas num ou dois períodos . ...- Não deve ser um nome reservado ao sistema, como PRN, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, NUL, CON ou AUX. Para obter mais informações sobre nomes reservados, consulte Nomes de arquivos, caminhos e namespaces. |
| Caracteres especiais para nós | - Não deve conter caracteres de controle Unicode. - Não deve conter nenhum dos seguintes caracteres: \ / : * ? " < > | # $ & * +.- Não deve conter caracteres proibidos pelo sistema de arquivos local. Para obter mais informações sobre restrições de caracteres do Windows, consulte Nomeando arquivos, caminhos e namespaces. |
| Comprimento do caminho | Não deve conter mais de 4.000 caracteres Unicode. |
| Profundidade da hierarquia de caminho | Deve ter menos de 14 níveis de profundidade. |
Anexos
Os arquivos anexados aos itens de trabalho devem estar em conformidade com as seguintes restrições.
| Tipo de restrição | Restrição |
|---|---|
| Tamanho do ficheiro | Não deve exceder o tamanho máximo: - Tamanho máximo padrão: 4.096 kilobytes. - Tamanho máximo absoluto: 2 gigabytes. |
| Tipo de restrição | Restrição |
|---|---|
| Tamanho do ficheiro | Não deve exceder o tamanho máximo: - Tamanho máximo padrão: 4.096 kilobytes. - Tamanho máximo absoluto: 2 gigabytes. Para obter mais informações, consulte Alterar o tamanho máximo de anexo para itens de trabalho. |
Colunas de pranchas e nomes de raias
Seu quadro transforma sua lista de pendências em uma placa interativa, proporcionando um fluxo visual de trabalho. À medida que o trabalho progride da ideia à conclusão, você atualiza os itens no quadro. Cada coluna representa uma etapa de trabalho, e cada cartão representa uma história de usuário (cartões azuis) ou um bug (cartões vermelhos) nessa etapa do trabalho.
Personalize sua prancha adicionando, removendo ou renomeando colunas e raias. As colunas suportam o fluxo de trabalho em toda a linha. As raias permitem que você gerencie diferentes classes de trabalho como faixas horizontais no tabuleiro.
Os nomes das colunas e raias devem estar em conformidade com as seguintes restrições.
| Tipo de restrição | Restrição |
|---|---|
| Duração | Não deve conter mais de 256 caracteres Unicode. |
| Singularidade | - Os nomes das colunas não devem ser iguais aos de qualquer outro nome de coluna no quadro. - Os nomes das raias não devem ser iguais aos de qualquer outro nome de raia na prancha. |
| Carateres especiais | Não deve conter caracteres de controle Unicode ou caracteres substitutos. |
Nomes de campo
Cada tipo de item de trabalho contém um ou mais campos de item de trabalho. Esses campos definem as informações armazenadas para itens de trabalho com base no tipo de item de trabalho. Cada campo de item de trabalho tem um nome de referência de campo associado. O nome de referência do campo identifica exclusivamente cada campo e não pode ser alterado uma vez atribuído. Para obter mais informações sobre campos de item de trabalho prontos para uso, consulte Índice de campo de item de trabalho.
Os nomes dos campos de item de trabalho devem estar em conformidade com as seguintes restrições.
| Tipo de restrição | Restrição |
|---|---|
| Duração | Não deve conter mais de 128 caracteres Unicode. |
| Singularidade | - Os nomes dos campos devem conter pelo menos um caractere alfabético. - Não deve conter nenhum dos seguintes caracteres: . , ; ' : ~ \ / \ * ? " & % $ ! + = () [] {} <> - |.- Não deve conter espaços à esquerda ou à direita. - Não deve conter dois ou mais espaços consecutivos. |
| Carateres especiais | Deve ser exclusivo dentro da organização ou coleção de projetos. Os nomes de campo de item de trabalho têm como escopo a coleção de projetos. Se você renomear um nome de campo, alterá-lo para todos os itens de trabalho e WITs definidos em todos os projetos da coleção. |
Nomes de referência de campo e portabilidade
A linguagem de definição de tipo de item de trabalho inclui o conceito de um nome de referência de campo. Nomes de referência de campo podem ajudá-lo a portar definições entre coleções de projeto Team Foundation e também para permitir integrações não-Microsoft para localizar e fazer referência a campos específicos. Esses nomes são globalmente exclusivos, assim como um namespace no aplicativo .NET Framework é globalmente exclusivo.
O namespace System é usado apenas para definir todos os campos principais do sistema que são obrigatórios para as funções do sistema Team Foundation. Você não pode criar seu próprio campo System.X porque ele pode impedir a funcionalidade.
O namespace da Microsoft é usado para definir campos de controle de item de trabalho. Esses campos são definidos em uma definição de tipo de item de trabalho dos modelos de processo.
Clientes e parceiros podem criar seus próprios namespaces de campo para tipos de item de trabalho personalizados. Para obter descrições de campos do sistema e campos definidos nos modelos de processo padrão, consulte Índice de campos de item de trabalho.
Importante
- Os nomes de referência de campo não podem ser renomeados. Se, por exemplo, você alterou o nome do campo "Título" para "Cabeçalho", o nome de referência do campo desse campo permanecerá o mesmo. Integrações e representações internas de campos devem usar o nome de referência de campo em vez de depender do nome do campo em si.
- Embora você possa criar seu próprio campo Microsoft.X, não recomendamos que o faça, pois isso pode impedir a funcionalidade ou a capacidade do assistente Configurar Recursos de atualizar com êxito um projeto após uma atualização.
Exemplos de nomes de referência de campo
Os exemplos a seguir mostram nomes de referência de campo válidos, em vários namespaces. Clientes e parceiros também podem definir seus próprios namespaces para dar suporte a seus tipos de item de trabalho personalizados.
| Exemplos de namespace do sistema | Exemplos de namespace da Microsoft | Outros exemplos de namespace |
|---|---|---|
| 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 | A empresa fictícia, Fabrikam Fiber, pode definir os seguintes campos de item de trabalho personalizados: FabrikamFiber.Common.Severity, FabrikamFiber.Common.Phase, FabrikamFiber.RiskManagement.RiskType, FabrikamFiber.RiskManagement.Resolution A empresa de software fictícia Contoso Corporation pode definir os seguintes campos de item de trabalho: Contoso.Common.BusinessPriority, Contoso.Bug.FoundInPhase, Contoso.Bug.FixInPhase |
Texto de ajuda do campo
O sistema exibe o texto de ajuda em tempo de execução para ajudar os usuários a saber o que inserir no campo. O texto da Ajuda tem como escopo um tipo de item de trabalho específico em um projeto específico.
Para o processo de herança, especifique o texto de ajuda para um campo através da caixa de diálogo Editar campo , guia Definição , Descrição. Consulte Adicionar um campo personalizado a um tipo de item de trabalho. Para o processo XML local, especifique o texto de ajuda usando o HELPTEXT elemento . Consulte Adicionar ou modificar um campo para acompanhamento de trabalho.
O texto de ajuda adicionado deve estar em conformidade com as restrições a seguir.
| Tipo de restrição | Restrição |
|---|---|
| Duração | Não deve conter mais de 255 caracteres Unicode. |
Listas globais
Uma lista global é um conjunto de valores de item de lista que você pode usar globalmente em todas as coleções de projetos em uma instância de um Servidor de DevOps do Azure local. Ao definir tipos de item de trabalho, você pode descobrir que alguns campos de item de trabalho compartilham o mesmo conjunto de valores permitidos ou sugeridos. As listas globais permitem definir esses valores uma vez e compartilhá-los em vários tipos de item de trabalho e projetos. Para obter detalhes, consulte Definir listas globais.
Uma lista global, definida usando o GLOBALLIST elemento contém um ou mais itens de lista, especificados usando o LISTITEM elemento .
LISTITEM Os nomes devem respeitar as seguintes restrições:
| Tipo de restrição | Restrição |
|---|---|
| Duração | - Não deve conter mais de 254 caracteres Unicode. - Não deve estar vazio. |
| Carateres especiais | - Não deve conter espaço em branco à esquerda ou à direita. - Não deve conter dois espaços consecutivos. - Não deve conter caracteres de barra \ invertida. |
| Âmbito | Como as listas globais estão disponíveis entre todos os projetos, elas não devem conter elementos definidos no nível do projeto, como definições de conta de grupo específicas do projeto. |
As listas globais devem estar em conformidade com as seguintes restrições.
| Tipo de restrição | Restrição |
|---|---|
| Número de itens | Não pode estar vazio. A lista global deve conter pelo menos um LISTITEM elemento. |
| Singularidade | Não pode estar vazio. A lista global deve conter pelo menos um LISTITEM elemento. |
Nomes de referência de tipo de link e categoria
Defina um nome de referência sempre que adicionar ou criar um tipo ou categoria de link. Todos os nomes de referência podem ter até 70 caracteres Unicode.
Defina um nome de referência usando caracteres alfanuméricos, caracteres sublinhados e caracteres de hífen. Cada nome de referência deve conter pelo menos um ponto ., mas nenhum ponto pode aparecer no início ou no final de um nome. Um nome de referência não deve começar com um número ou um sublinhado e não pode ter vários hífenes consecutivos, como --.
| Tipo de restrição | Restrição |
|---|---|
| Duração | Não deve conter mais de 70 caracteres Unicode. |
| Singularidade | - Não deve ser idêntico a qualquer outro nome de referência de campo dentro da coleção do projeto. - Não deve ser idêntico a qualquer outro nome de referência de campo depois que esses nomes são processados pelo computador para substituir todos os períodos . por sublinhados _. Por exemplo, os nomes My.*Field* de referência de campo e My.Field ambos seriam processados como o mesmo nome: My__Field |
| Carateres especiais | - Não deve conter hífenes -.- Deve conter pelo menos um período ..- Não deve começar ou terminar com um período ..- Não deve começar com um númeroNão deve começar com um sublinhado _. |
Etiquetas de itens de trabalho
As tags de item de trabalho correspondem a uma ou duas frases de palavra-chave para filtrar ferramentas de controle de trabalho, como listas de pendências, quadros e consultas ou definir consultas. Para obter mais informações, consulte Adicionar tags de item de trabalho para categorizar e filtrar listas e quadros.
Os nomes das tags devem estar em conformidade com as seguintes restrições.
| Tipo de restrição | Restrição |
|---|---|
| Duração | - Não deve conter mais de 400 caracteres Unicode. - Não deve ser nulo ou vazio. |
| Carateres especiais | - Não deve conter caracteres separadores: , ou ;.- Não deve conter caracteres de controle ou formato Unicode, como alimentação de linha, separador de parágrafo, retorno de carro ou outros caracteres substitutos incompatíveis. |
| Âmbito | Como as listas globais estão disponíveis entre todos os projetos, elas não devem conter elementos definidos no nível do projeto, como definições de conta de grupo específicas do projeto. |
Pipelines do Azure
As definições do Pipeline do Azure devem estar em conformidade com as seguintes restrições.
| Tipo de restrição | Restrição |
|---|---|
| Nome da tarefa | - Deve conter apenas caracteres alfanuméricos e '_'.- Não deve começar com um número. - Deve ter um nome único. - Não deve conter palavras-chave, por exemplo: "implantação". |
| Nome da fase | - Deve conter apenas caracteres alfanuméricos e '_'.- Não deve começar com um número. - Não deve conter palavras-chave, por exemplo: "implantação". |
| Expressões | Deve começar com a-Z ou _AND, seguido de a-Z, 0-9ou _. |
Para obter mais informações, consulte a documentação do Azure Pipelines.
Azure Repos (Git)
Cada projeto do Azure DevOps pode conter vários repositórios Git. Os nomes atribuídos aos repositórios Git devem estar em conformidade com as seguintes restrições. Para obter mais informações, consulte a documentação do Azure Repos Git. Para obter mais informações sobre restrições de nomenclatura para outros itens do Git, como ramificações e tags, consulte git check-ref-format.
Importante
Embora você possa incluir espaços nos nomes dos repositórios, não recomendamos que o faça.
| Tipo de restrição | Restrição |
|---|---|
| Duração | Não deve conter mais de 64 caracteres Unicode. |
| Singularidade | Não deve ser idêntico a qualquer outro nome de repositório Git no projeto. |
| Carateres especiais | - Não pode conter carateres de controlo Unicode ou carateres de substituição. - Não deve conter os seguintes caracteres imprimíveis: \ / : * ? " < > ; # $ * { } , + = [ ] |.- Não deve começar com um sublinhado _.- Não deve começar ou terminar com um período ..- Não deve ser um nome reservado do sistema. |
Azure Repos (TFVC)
O controle de versão do Team Foundation (TFVC) fornece um repositório central para arquivos e os comandos necessários para gerenciar esses arquivos em uma equipe. Ele também fornece políticas de check-in personalizáveis, ramificação, fusão, prateleiras e muitos outros recursos. Para obter mais informações, consulte a documentação do Azure Repos TFVC
Os caminhos de controle de versão devem estar em conformidade com as seguintes restrições. Consulte também Otimizar seu espaço de trabalho.
| Tipo de restrição | Restrição |
|---|---|
| Comprimento do caminho da pasta de controle do código-fonte do servidor | - Não deve conter mais de 259 caracteres Unicode para uma única pasta ou nome de arquivo. - Não deve conter mais de 388 caracteres Unicode para um diretório. - Não deve conter mais de 399 caracteres Unicode para um diretório combinado e nome de arquivo. |
| Comprimento do caminho da pasta local | - Não deve conter mais de 248 caracteres Unicode para um diretório. - Não deve conter mais de 260 caracteres Unicode para um diretório combinado e nome de arquivo. |
| Portal da Web e restrições de comprimento específicas do REST | Não deve conter mais de 215 caracteres Unicode para um nome de projeto, diretório e nome de arquivo combinados. |
No portal da Web e na API REST, determinadas operações têm um comprimento de caminho mais restritivo do que o Visual Studio e TF.exe clientes. Essas operações incluem Editar, Renomear e Excluir e ocorrem porque o portal da Web/REST usa um espaço de trabalho gerado aleatoriamente para simultaneidade quando aguarda as alterações.
Arquivos TFVC
O sistema de controle de versão armazena muitos tipos diferentes de arquivos. Configurar o controle de versão do Team Foundation em sua máquina de desenvolvimento fornece detalhes sobre como adicionar projetos ou soluções existentes do Visual Studio.
Arquivos e pastas que você adiciona ao controle de versão do Team Foundation devem estar em conformidade com as seguintes restrições.
| Tipo de restrição | Restrição |
|---|---|
| Ficheiros e pastas | - Os nomes não devem conter os seguintes caracteres imprimíveis: \ / : * ? " < > ;.- As pastas não devem estar fora do diretório mapeado para o espaço de trabalho ativo. |
| Nomes de ficheiros | - Não deve começar com um $.- Não deve conter os seguintes caracteres imprimíveis: \ / : * ? " < > ; |. |
Rótulos TFVC
No controle de versão do Team Foundation (TFVC), um rótulo é um nome aplicado a um conjunto específico de revisões. Você pode anexar rótulos a um conjunto de arquivos não relacionados no controle de versão, o que permite recuperar os arquivos ou agir sobre eles como um grupo. A tabela a seguir descreve as restrições colocadas nos nomes dos rótulos.
| Tipo de restrição | Restrição |
|---|---|
| Duração | Não deve conter mais de 64 caracteres Unicode. |
| Carateres especiais | - Não pode terminar com um espaço ( ) ou ponto ..- Não deve conter os seguintes caracteres imprimíveis: \ / : * ? " < > ; @ |. |
Prateleiras TFVC
Os Shelvesets permitem que você reserve temporariamente um lote de alterações pendentes e, em seguida, como opção, remova as alterações pendentes do seu espaço de trabalho. Mais tarde, você pode restaurar as alterações em um conjunto de prateleiras para seu espaço de trabalho ou colocá-las no espaço de trabalho de outro usuário.
Os nomes de prateleiras devem estar em conformidade com as seguintes restrições.
| Tipo de restrição | Restrição |
|---|---|
| Duração | Não deve conter mais de 64 caracteres Unicode. |
| Carateres especiais | Não deve conter os seguintes caracteres imprimíveis: \ / : * ? " < > & ; |. |
Espaços de trabalho TFVC
Um espaço de trabalho é uma cópia do lado do cliente dos arquivos e pastas no controle de versão do Team Foundation (TFVC). Ao criar vários espaços de trabalho, você pode ter versões diferentes da mesma pasta de controle de versão em um computador cliente. Criar e trabalhar com espaços de trabalho fornece mais detalhes.
Os nomes dos espaços de trabalho devem estar em conformidade com as seguintes restrições.
| Tipo de restrição | Restrição |
|---|---|
| Duração | Não deve conter mais de 64 caracteres Unicode. |
| Carateres especiais | - Não deve terminar com um espaço ( ).- Não deve conter os seguintes caracteres imprimíveis: \ / : * ? " < > ; |. |
Nomes de computadores
O nome do computador onde você instala o Azure DevOps está associado ao nome do servidor. Tanto o sistema operacional quanto o Ative Directory impõem certas restrições aos nomes de computadores, conforme descrito nestes artigos:
Nomes da organização
Importante
Siga as diretrizes a seguir ao criar um nome de organização.
- Use apenas letras do alfabeto inglês
- Inicie o nome da sua organização com uma letra ou número
- Use letras, números ou hífenes após o caractere inicial
- Certifique-se de que sua organização não exceda 50 caracteres Unicode
- Terminar com uma letra ou número
Se você usar qualquer um dos caracteres não permitidos, você receberá a seguinte mensagem de erro: VS850015: O nome especificado não pode ser usado: {Nome da organização}.
Modelos de processos e processos
Um processo define os blocos de construção do sistema de controle de item de trabalho e outros subsistemas aos quais você tem acesso depois de se conectar a um projeto.
Nota
Terminologia: Tanto "processo" quanto "modelo de processo" referem-se a um conjunto interdependente de arquivos usados para criar um projeto. Para obter mais informações, consulte Sobre processos e modelos de processo, que descreve as diferenças entre os três processos padrão disponíveis para você.
Os processos que você define ou personaliza devem estar em conformidade com as restrições a seguir.
| Tipo de restrição | Restrição |
|---|---|
| Duração | Não deve conter mais de 256 caracteres Unicode. |
| Singularidade | - Deve ser exclusivo no Azure DevOps. - Se você carregar um modelo com o mesmo nome de um modelo existente, o modelo existente será substituído. |
| Tamanho do arquivo de modelo de processo | Não deve exceder 2 GB (gigabytes). |
Coleções de projetos
Uma coleção de projetos identifica um grupo de projetos e os recursos associados a esses projetos. Ele fornece uma estrutura de organização que você pode usar para definir e controlar um grupo de projetos definidos para um Servidor de DevOps do Azure.
Além disso, o nome da coleção faz parte da cadeia de conexão usada para conectar os membros da equipe aos projetos. O padrão atribuído corresponde a DefaultCollection. Gerenciar coleções de projetos fornece mais informações.
Os nomes atribuídos às coleções de projetos devem estar em conformidade com as restrições a seguir.
| Tipo de restrição | Restrição |
|---|---|
| Duração | Não deve conter mais de 64 caracteres Unicode. |
| Singularidade | - Não deve ser idêntico a qualquer outro nome de coleção em sua implantação local. - Se sua implantação incluir Produtos do SharePoint ou SQL Server Reporting Services, eles não poderão ser idênticos ao nome e ao caminho completo de um site existente do SharePoint, servidor de relatório ou site do Reporting Services. |
| Nomes reservados | Não deve ser um nome reservado do sistema. |
| Carateres especiais | - Não pode conter carateres de controlo Unicode ou carateres de substituição. - Não deve conter os seguintes caracteres imprimíveis: \ / : * ? " < > ; # $ * { } , + = [ ] |. - Não deve conter reticências ... ou períodos duplos ...- Não deve começar com um sublinhado _.- Não deve começar ou terminar com um período .. |
Nomes dos projetos
Um projeto estabelece um repositório para o código-fonte e um local para as equipes planejarem, acompanharem o progresso e colaborarem. O nome do projeto faz parte da cadeia de conexão usada para conectar os membros da equipe aos projetos.
Os nomes atribuídos aos projetos criados devem estar em conformidade com as restrições a seguir.
| Tipo de restrição | Restrição |
|---|---|
| Duração | Não deve conter mais de 64 caracteres Unicode. |
| Singularidade | Não deve ser idêntico a qualquer outro nome na coleção de projetos, ao aplicativo Web do SharePoint que dá suporte à coleção ou à instância do SQL Server Reporting Services que dá suporte à coleção. |
| Nomes das reservas | - Não deve ser um nome reservado do sistema. - Não deve ser um dos segmentos ocultos usados para filtragem de solicitações do IIS, como App_Browsers, App_code, App_Data, App_GlobalResources, App_LocalResources, App_Themes, App_WebResources, bin ou web.config. |
| Carateres especiais | - Não pode conter carateres de controlo Unicode ou carateres de substituição. - Não deve conter os seguintes caracteres imprimíveis: \ / : * ? " < > ; # $ * { } , + = [ ] |. - Não deve começar com um sublinhado _.- Não deve começar ou terminar com um período .. |
Grupos de segurança
Com os grupos de segurança do Azure DevOps, você pode aplicar determinados direitos ou permissões a um grupo de usuários.
Os grupos locais podem consistir em contas de grupo do Ative Directory, grupos de segurança do Azure DevOps, contas de usuário do Windows, contas de grupo do Windows ou qualquer mistura desses tipos. Para obter mais informações, consulte Adicionar usuários ou grupos do Ative Directory / Microsoft Entra a um grupo de segurança interno.
Os grupos de segurança devem respeitar as seguintes restrições.
| Tipo de restrição | Restrição |
|---|---|
| Comprimento do nome da conta do grupo de segurança | Não deve conter mais de 256 caracteres Unicode. |
| Singularidade | - As contas de grupo no nível do projeto não devem corresponder a nenhum outro nome de grupo no mesmo projeto. - As contas de grupo no nível de coleção não devem corresponder a nenhum outro nome de uma conta de grupo na coleção de projetos. |
| Nomes de grupos reservados | Não deve ser nomeado com um $NAMESPACE no nível do projeto ou do servidor. |
| Carateres especiais | - Não pode conter carateres de controlo Unicode ou carateres de substituição. - Não deve conter os seguintes caracteres imprimíveis: / \ [ ] : < > + = ; ? * |. - Não deve incluir caracteres não imprimíveis no intervalo de valores ASCII de 1-31. - Não deve terminar em um período ..- Não deve incluir vírgulas ,. |
Construção do Team Foundation
Team Foundation Build permite gerenciar todos os aspetos do processo de compilação em um único computador. Usando Team Foundation Build, você pode sincronizar os códigos-fonte, compilar o aplicativo, executar testes de unidade associados, executar análise de código, liberar compilações em um servidor de arquivos e publicar relatórios de compilação.
Construir computador
O Team Foundation Build é uma instalação separada da camada de aplicativo do Azure DevOps Server, da camada de dados ou do cliente do Visual Studio. Você pode escolher um computador separado. Caso contrário, você pode instalar a compilação lado a lado no computador cliente ou nos servidores.
Seu computador de compilação local deve estar em conformidade com as seguintes restrições.
| Tipo de restrição | Restrição |
|---|---|
| Espaço em disco | Deve conter espaço suficiente para a construção (espaço insuficiente leva a construções com falha). |
| Construir diretório | Deve ser um caminho local (por exemplo, C:\BuildDirectory). |
| Diretório de local de descarte | Deve ser um caminho UNC (por exemplo, \server\share). |
| Permissões de local de descarte | Cada compilação gerada é colocada em um novo diretório na pasta drop. - A conta de serviço do Team Foundation Server (por exemplo, Domain\TFSSERVICE) deve ter acesso de permissão de Controle Total para o local de descarte UNC.- O local de entrega UNC deve ser uma pasta compartilhada. |
| Conta do Serviço Team Foundation Build | Se você alterar a conta de serviço do TFS após a instalação inicial, você deve certificar-se de que as seguintes condições são verdadeiras: - A conta é membro do grupo Build Services. - A conta tem permissões de leitura/gravação para as pastas temporárias e a pasta temporária ASP.NET. - A conta tem permissão de Controle Total para o diretório de compilação e local de queda. |
| Problemas de firewall | Se o computador de compilação estiver habilitado para firewall, verifique se o programa, tfsbuildservice, está na lista de exceções. |
Tipos de compilação
Os tipos de compilação configuram as condições sob as quais uma única solução ou um conjunto de soluções em um projeto são construídos. Para conduzir uma compilação, você deve criar um novo tipo de compilação ou usar um tipo de compilação existente.
Os nomes de tipo de compilação devem estar em conformidade com as seguintes restrições.
| Tipo de restrição | Restrição |
|---|---|
| Singularidade | Não deve ser o mesmo que qualquer outro nome de tipo de compilação no projeto. |
| Carateres especiais | Não deve conter o seguinte caractere imprimível: $. |
Qualidade de construção
A qualidade de compilação permite anexar um nível de qualidade ou estado de conclusão a uma compilação concluída. Team Foundation Build também permite que você crie novos valores para o tipo de qualidade de compilação. Consulte Classificar a qualidade de uma compilação concluída para obter uma lista dos valores de qualidade de compilação padrão.
Os nomes de qualidade de compilação devem estar em conformidade com as seguintes restrições.
| Tipo de restrição | Restrição |
|---|---|
| Duração | Não deve conter mais de 256 caracteres Unicode. |
| Singularidade | Não deve ser o mesmo que qualquer outro nome de qualidade de compilação no computador Team Foundation Build. |
Nomes das equipas
Os nomes de equipe identificam um grupo de indivíduos ou grupos que trabalham coletivamente juntos como uma equipe em um projeto. Os membros da equipe usam esse nome para se conectar à equipe ou para consultar membros definidos para uma equipe.
Os nomes de equipe devem estar em conformidade com as convenções que permitem que eles sejam renderizados como parte de uma URL válida. Cada nome de equipe deve ser exclusivo dentro de um único projeto. No entanto, não há restrições sobre o uso do mesmo nome de equipe em projetos diferentes dentro de uma coleção de projetos. Para obter mais informações, consulte Adicionar outra equipe ou uma hierarquia de equipes.
Os nomes das equipas devem estar em conformidade com as seguintes restrições.
| Tipo de restrição | Restrição |
|---|---|
| Duração | Não deve conter mais de 64 caracteres Unicode. |
| Singularidade | Não deve ser idêntico a qualquer outro nome no projeto. |
| Nomes reservados | Não deve ser um nome reservado do sistema. |
| Carateres especiais | - Não pode conter carateres de controlo Unicode ou carateres de substituição. - Não deve conter os seguintes caracteres imprimíveis: \ / : * ? " < > ; # $ * { } , + = [ ] |.- Não deve conter reticências ... ou períodos duplos ...- Não deve começar com um sublinhado _.- Não deve começar ou terminar com um período .. |
Nomes de contas de utilizador
As contas de usuário identificam as pessoas adicionadas a um projeto ou coleção de projetos. As contas de usuário podem corresponder a entradas no Ative Directory, Microsoft Entra ID, grupo de servidores do Windows.
As contas de usuário adicionadas a uma organização ou coleção devem estar em conformidade com as seguintes restrições. Para adicionar contas de usuário a um projeto, consulte Adicionar usuários a um projeto ou equipe.
| Tipo de restrição | Restrição |
|---|---|
| Comprimento do nome da conta | Não deve conter mais de 256 caracteres Unicode. |
| Singularidade | Não deve corresponder a nenhuma outra conta de usuário adicionada à coleção de projetos. |
| Nomes de grupos reservados | Não deve ser nomeado com um $NAMESPACE no nível do projeto ou do servidor. |
| Carateres especiais | - Não deve incluir os seguintes caracteres imprimíveis: "/ \ [ ] : < > + = ; ? * |.- Não deve incluir caracteres não imprimíveis no intervalo de valores ASCII de 1-31. - Não deve terminar em um período . ou um cifrão $.- Não deve incluir vírgulas ,.- Não deve incluir as seguintes categorias Unicode: LineSeparator, ParagraphSeparator, Control, Format, OtherNotAssigned. |
Nomes de páginas e ficheiros Wiki
Cada página wiki corresponde a um ficheiro no repositório Git de wikis. Os nomes que atribuir a um título de página wiki têm de estar em conformidade com as seguintes restrições.
| Tipo de restrição | Restrição |
|---|---|
| Nome de ficheiro | O caminho de página completamente qualificado não deve exceder 235 carateres. |
| Singularidade | Os títulos das páginas são sensíveis às maiúsculas e minúsculas e têm de ser exclusivos na hierarquia de wikis. |
| Carateres especiais | - Não pode conter carateres de controlo Unicode ou carateres de substituição. - Não deve conter os seguintes caracteres imprimíveis: / \ #.- Não deve começar ou terminar com um período .. |
| Tamanho dos ficheiros | Não pode exceder o máximo de 18 MB. |
| Tamanho do ficheiro de anexo | Não pode exceder o máximo de 19 MB. |
Caracteres especiais nos títulos das páginas Wiki
Você pode especificar títulos de página que contenham um ou mais desses caracteres : < > * ? | -especiais. Por exemplo, você pode nomear um arquivo Markdown como "FAQ?" ou "Guia de configuração". Os caracteres têm as seguintes cadeias de caracteres codificadas por URI:
| Caráter | Cadeia de caracteres codificada |
|---|---|
: |
%3A |
< |
%3C |
> |
%3E |
* |
%2A |
? |
%3F |
| |
%7C |
- |
%2D |
" |
22% |