Restrições e convenções de nomenclatura
Azure DevOps Services | 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 de 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.
Práticas recomendadas:
- Siga as restrições da interface do usuário para manter a consistência e evitar problemas não intencionais.
- Valide nomes programaticamente e lide com 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 em relação à restrição de comprimento. Para obter mais informações, consulte Sobre Unicode e conjuntos de caracteres.
Assim como acontece com outros arquivos do sistema operacional, caracteres de controle 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 aos nomes de arquivo, consulte Nomeando arquivos, caminhos e namespaces.
Observação
- Para obter limites no número de itens que você pode definir, consulte Acompanhamento de trabalho, processo e limites de projeto.
Nomes reservados do sistema
Evite usar nomes reservados do sistema, como os exemplos a seguir:
- 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 arquivo, caminhos e namespaces.
Azure Artifacts
As embalagens universais devem estar em conformidade com as seguintes restrições.
| Tipo de restrição | Restrição |
|---|---|
| Nome do pacote | - Deve ser minúsculo. - Deve começar e terminar com letras ou números. - Deve conter apenas letras, números e traços, sublinhados ou pontos não consecutivos. |
| Versão do 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 acompanhamento 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 ao 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 depois de 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 do anexo.
Caminhos de área e iteração
Dois campos de item de trabalho, Caminho da Área e Caminho da Iteração, fornecem uma hierarquia de estrutura de árvore para agrupar o trabalho. Os caminhos de área agrupam itens de trabalho por produto, funcional ou área de recursos. 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 da árvore.
Os nomes que você atribui aos nós filhos para 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 em um período . 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 Nomenclatura de arquivos, caminhos e namespaces. |
| Comprimento do caminho | Não deve conter mais de 4.000 caracteres Unicode. |
| Profundidade da hierarquia do caminho | Deve ter menos de 14 níveis de profundidade. |
Anexos
Os arquivos anexados a itens de trabalho devem estar em conformidade com as restrições a seguir.
| Tipo de restrição | Restrição |
|---|---|
| Tamanho do arquivo | 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 arquivo | 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 do anexo para itens de trabalho. |
Nomes de colunas e raias do quadro
Seu quadro transforma seu backlog em uma placa interativa, fornecendo um fluxo visual de trabalho. À medida que o trabalho progride da ideia para a 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 seu quadro 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 pistas horizontais no tabuleiro.
Os nomes das colunas e raias devem estar em conformidade com as seguintes restrições.
| Tipo de restrição | Restrição |
|---|---|
| Length | Não deve conter mais de 256 caracteres Unicode. |
| Exclusividade | - Os nomes das colunas não devem ser iguais a qualquer outro nome de coluna no quadro. - Os nomes das raias não devem ser iguais a qualquer outro nome de raia no quadro. |
| Caracteres 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 depois de 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 de campo de item de trabalho devem estar em conformidade com as restrições a seguir.
| Tipo de restrição | Restrição |
|---|---|
| Length | Não deve conter mais de 128 caracteres Unicode. |
| Exclusividade | - 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. |
| Caracteres 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. Os nomes de referência de campo podem ajudá-lo a portar definições entre coleções de projetos do Team Foundation e também permitir que integrações que não são da Microsoft localizem e se refiram 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 isso pode impedir a funcionalidade.
O namespace da Microsoft é usado para definir campos de acompanhamento 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. As integrações e representações internas de campos devem usar o nome de referência do campo em vez de depender do próprio nome do campo.
- Embora você possa criar seu próprio campo Microsoft.X, não recomendamos que você faça isso, 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 de 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 de 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 por meio 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, você especifica o texto de ajuda usando o HELPTEXT elemento. Consulte Adicionar ou modificar um campo para acompanhamento de trabalho.
O texto de ajuda que você adiciona deve estar em conformidade com as restrições a seguir.
| Tipo de restrição | Restrição |
|---|---|
| Length | 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 Azure DevOps Server 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 que você defina esses valores uma vez e os compartilhe entre 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 estar em conformidade com as seguintes restrições.
| Tipo de restrição | Restrição |
|---|---|
| Length | - Não deve conter mais de 254 caracteres Unicode. - Não deve estar vazio. |
| Caracteres 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. |
| Escopo | 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. |
| Exclusividade | Não pode estar vazio. A lista global deve conter pelo menos um LISTITEM elemento. |
Tipo de link e nomes de referência de categoria
Defina um nome de referência sempre que adicionar ou criar um tipo de link ou categoria. Todos os nomes de referência podem ter até 70 caracteres Unicode.
Defina um nome de referência usando caracteres alfanuméricos, caracteres de sublinhado 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ífens consecutivos, como --.
| Tipo de restrição | Restrição |
|---|---|
| Length | Não deve conter mais de 70 caracteres Unicode. |
| Exclusividade | - Não deve ser idêntico a nenhum outro nome de referência de campo dentro da coleção de projetos. - Não deve ser idêntico a nenhum outro nome de referência de campo depois que esses nomes forem processados pelo computador para substituir todos os pontos . por sublinhados _. Por exemplo, os nomes My.*Field* de referência de campo e My.Field processariam como o mesmo nome: My__Field |
| Caracteres especiais | - Não deve conter hífens -.- Deve conter pelo menos um ponto ..- Não deve iniciar ou terminar com um período ..- Não deve começar com um númeroNão deve começar com um sublinhado _. |
Marcas de item de trabalho
As marcas de item de trabalho correspondem a uma ou duas frases-chave para filtrar ferramentas de acompanhamento de trabalho, como listas de pendências, quadros e consultas ou definir consultas. Para obter mais informações, consulte Adicionar marcas 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 |
|---|---|
| Length | - Não deve conter mais de 400 caracteres Unicode. - Não deve ser nulo ou vazio. |
| Caracteres 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. |
| Escopo | 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. |
Azure Pipelines
As definições do Azure Pipeline devem estar em conformidade com as restrições a seguir.
| Tipo de restrição | Restrição |
|---|---|
| Nome do trabalho | - Deve conter apenas caracteres alfanuméricos e '_'.- Não deve começar com um número. - Deve ter um nome exclusivo. - Não deve conter palavras-chave, por exemplo: "implantação". |
| Nome do estágio | - 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 por a-Z, 0-9, ou _. |
Para obter mais informações, confira 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 restrições a seguir. Para obter mais informações, consulte a documentação do Git do Azure Repos. Para obter mais informações sobre restrições de nomenclatura para outros itens do Git, como branches e tags, consulte git check-ref-format.
Importante
Embora você possa incluir espaços em nomes de repositório, não recomendamos que você faça isso.
| Tipo de restrição | Restrição |
|---|---|
| Length | Não deve conter mais de 64 caracteres Unicode. |
| Exclusividade | Não deve ser idêntico a nenhum outro nome de repositório Git no projeto. |
| Caracteres especiais | – Não deve conter caracteres de controle Unicode ou caracteres alternativos. - Não deve conter os seguintes caracteres imprimíveis: \ / : * ? " < > ; # $ * { } , + = [ ] |.- Não deve começar com um sublinhado _.- Não deve iniciar ou terminar com um período ..- Não deve ser um nome reservado do sistema. |
Azure Repos (TFVC)
O TFVC (controle de versão do Team Foundation) 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, mesclagem, prateleiras e muitos outros recursos. Para obter mais informações, consulte a documentação do TFVC do Azure Repos
Os caminhos de controle de versão devem estar em conformidade com as restrições a seguir. 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 e nome de arquivo combinados. |
| 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 e nome de arquivo combinados. |
| 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 os clientes TF.exe. 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 aguardam 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 seu computador de desenvolvimento fornece detalhes sobre como adicionar projetos ou soluções existentes do Visual Studio.
Os arquivos e pastas que você adiciona ao controle de versão do Team Foundation devem estar em conformidade com as restrições a seguir.
| Tipo de restrição | Restrição |
|---|---|
| Arquivos 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 arquivo | - Não deve começar com um $.- Não deve conter os seguintes caracteres imprimíveis: \ / : * ? " < > ; |. |
Rótulos TFVC
No TFVC (controle de versão do Team Foundation), 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 |
|---|---|
| Length | Não deve conter mais de 64 caracteres Unicode. |
| Caracteres especiais | - Não pode terminar com um espaço ( ) ou ponto ..- Não deve conter os seguintes caracteres imprimíveis: \ / : * ? " < > ; @ |. |
Racks particulares TFVC
Os check-ins particulares 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. Posteriormente, você pode restaurar as alterações em um check-in particular em seu workspace ou colocá-las no workspace de outro usuário.
Os nomes de check-in particular devem estar em conformidade com as restrições a seguir.
| Tipo de restrição | Restrição |
|---|---|
| Length | Não deve conter mais de 64 caracteres Unicode. |
| Caracteres especiais | Não deve conter os seguintes caracteres imprimíveis: \ / : * ? " < > & ; |. |
Espaços de trabalho do TFVC
Um workspace é uma cópia do lado do cliente dos arquivos e pastas no TFVC (controle de versão do Team Foundation). 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 |
|---|---|
| Length | Não deve conter mais de 64 caracteres Unicode. |
| Caracteres 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 em que você instala o Azure DevOps está associado ao nome do servidor. O sistema operacional e o Active Directory impõem certas restrições aos nomes de computador, conforme descrito nestes artigos:
Nomes de 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ífens 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, receberá a seguinte mensagem de erro: VS850015: O nome especificado não pode ser usado: {Nome da organização}.
Processo e modelos de processo
Um processo define os blocos de construção do sistema de rastreamento de item de trabalho e outros subsistemas aos quais você tem acesso depois de se conectar a um projeto.
Observação
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 |
|---|---|
| Length | Não deve conter mais de 256 caracteres Unicode. |
| Exclusividade | - 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 Azure DevOps Server.
Além disso, o nome da coleção faz parte da cadeia de conexão usada para conectar membros da equipe a projetos. O padrão atribuído corresponde a DefaultCollection. Gerenciar coleções de projetos fornece mais informações.
Os nomes atribuídos a coleções de projetos devem estar em conformidade com as restrições a seguir.
| Tipo de restrição | Restrição |
|---|---|
| Length | Não deve conter mais de 64 caracteres Unicode. |
| Exclusividade | - Não deve ser idêntico a nenhum 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. |
| Caracteres especiais | – Não deve conter caracteres de controle Unicode ou caracteres alternativos. - Não deve conter os seguintes caracteres imprimíveis: \ / : * ? " < > ; # $ * { } , + = [ ] |. - Não deve conter reticências ... ou ponto ..duplo.- Não deve começar com um sublinhado _.- Não deve iniciar ou terminar com um período .. |
Nomes de 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 |
|---|---|
| Length | Não deve conter mais de 64 caracteres Unicode. |
| Exclusividade | Não deve ser idêntico a nenhum outro nome na coleção de projetos, no aplicativo Web do SharePoint que oferece suporte à coleção ou à instância do SQL Server Reporting Services que oferece suporte à coleção. |
| Nomes de reservas | - Não deve ser um nome reservado do sistema. - Não deve ser um dos segmentos ocultos usados para filtragem de solicitação do IIS, como App_Browsers, App_code, App_Data, App_GlobalResources, App_LocalResources, App_Themes, App_WebResources, bin ou web.config. |
| Caracteres especiais | – Não deve conter caracteres de controle Unicode ou caracteres alternativos. - Não deve conter os seguintes caracteres imprimíveis: \ / : * ? " < > ; # $ * { } , + = [ ] |. - Não deve começar com um sublinhado _.- Não deve iniciar 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 Active Directory, grupos de segurança do Azure DevOps, contas de usuário do Windows, contas de grupo do Windows ou qualquer combinação desses tipos. Para obter mais informações, consulte Adicionar usuários ou grupos do Active Directory/Microsoft Entra a um grupo de segurança interno.
Os grupos de segurança devem estar em conformidade com as restrições a seguir.
| 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. |
| Exclusividade | - 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 da coleção não devem corresponder a nenhum outro nome de uma conta de grupo na coleção do projeto. |
| Nomes de grupos reservados | Não deve ser nomeado com um $NAMESPACE no nível do projeto ou do servidor. |
| Caracteres especiais | – Não deve conter caracteres de controle Unicode ou caracteres alternativos. - 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 a 31. - Não deve terminar em um ponto ..- Não deve incluir vírgulas ,. |
Compilação do Team Foundation
O Team Foundation Build permite que você gerencie todos os aspectos do processo de compilação em um único computador. Usando o Team Foundation Build, você pode sincronizar as fontes, 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.
Computador de compilação
O Team Foundation Build é uma instalação separada da camada de aplicativo, da camada de dados ou do cliente do Visual Studio Azure DevOps Server. 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 restrições a seguir.
| Tipo de restrição | Restrição |
|---|---|
| Espaço em Disco | Deve conter espaço suficiente para a compilação (espaço insuficiente leva a compilações com falha). |
| Diretório de compilação | 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 soltar | Cada compilação gerada é colocada em um novo diretório na pasta suspensa. - A conta do Serviço do Team Foundation Server (por exemplo, Domain\TFSSERVICE) deve ter acesso de permissão de Controle Total ao local de recebimento UNC.- O local de lançamento UNC deve ser uma pasta compartilhada. |
| Conta do Serviço Team Foundation Build | Se você alterar a conta do Serviço TFS após a instalação inicial, deverá verificar se 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 o local de soltar. |
| 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 é criado. Para realizar 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 restrições a seguir.
| Tipo de restrição | Restrição |
|---|---|
| Exclusividade | Não deve ser igual a qualquer outro nome de tipo de compilação no projeto. |
| Caracteres especiais | Não deve conter o seguinte caractere imprimível: $. |
Qualidade de construção
A qualidade da compilação permite anexar um nível de qualidade ou estado de conclusão a uma compilação concluída. O Team Foundation Build também permite criar 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 restrições a seguir.
| Tipo de restrição | Restrição |
|---|---|
| Length | Não deve conter mais de 256 caracteres Unicode. |
| Exclusividade | Não deve ser igual a qualquer outro nome de Qualidade de Compilação no computador do Team Foundation Build. |
Nomes de equipes
Os nomes das equipes 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 consultar membros definidos para uma equipe.
Os nomes das equipes precisam estar em conformidade com as convenções que permitem que eles sejam renderizados como parte de um URL válido. Cada nome de equipe deve ser exclusivo em um único projeto. No entanto, não há restrições ao uso do mesmo nome de equipe em projetos diferentes em uma coleção de projetos. Para obter mais informações, consulte Adicionar outra equipe ou uma hierarquia de equipes.
Os nomes das equipes devem estar em conformidade com as seguintes restrições.
| Tipo de restrição | Restrição |
|---|---|
| Length | Não deve conter mais de 64 caracteres Unicode. |
| Exclusividade | Não deve ser idêntico a nenhum outro nome no projeto. |
| Nomes reservados | Não deve ser um nome reservado do sistema. |
| Caracteres especiais | – Não deve conter caracteres de controle Unicode ou caracteres alternativos. - Não deve conter os seguintes caracteres imprimíveis: \ / : * ? " < > ; # $ * { } , + = [ ] |.- Não deve conter reticências ... ou ponto ..duplo.- Não deve começar com um sublinhado _.- Não deve iniciar ou terminar com um período .. |
Nomes de contas de usuário
As contas de usuário identificam pessoas adicionadas a um projeto ou coleção de projetos. As contas de usuário podem corresponder a entradas no Active Directory, ID do Microsoft Entra, grupo de servidores do Windows.
As contas de usuário que você adiciona a uma organização ou coleção devem estar em conformidade com as restrições a seguir. 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. |
| Exclusividade | 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. |
| Caracteres 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 a 31. - Não deve terminar em um ponto . ou um cifrão $.- Não deve incluir vírgulas ,.- Não deve incluir as seguintes categorias Unicode: LineSeparator, ParagraphSeparator, Control, Format, OtherNotAssigned. |
Página wiki e nomes de arquivos
Cada página wiki corresponde a um arquivo no repositório Git wiki. Os nomes atribuídos a um título de página wiki devem estar em conformidade com as restrições a seguir.
| Tipo de restrição | Restrição |
|---|---|
| Nome do arquivo | O caminho de página totalmente qualificado não deve exceder 235 caracteres. |
| Exclusividade | Os títulos de página diferenciam maiúsculas de minúsculas e devem ser exclusivos dentro da hierarquia wiki. |
| Caracteres especiais | – Não deve conter caracteres de controle Unicode ou caracteres alternativos. - Não deve conter os seguintes caracteres imprimíveis: / \ #.- Não deve iniciar ou terminar com um período .. |
| Tamanho do arquivo | – Não deve exceder o máximo de 18 MB. |
| – Tamanho do arquivo de anexo | Não deve exceder o máximo de 19 MB. |
Caracteres especiais em títulos de página wiki
Você pode especificar títulos de página que contêm um ou mais desses caracteres : < > * ? | -especiais. Por exemplo, você pode nomear um arquivo Markdown como "Perguntas frequentes?" ou "Guia de configuração". Os caracteres têm as seguintes cadeias de caracteres codificadas em URI:
| Caractere | Cadeia de caracteres codificada |
|---|---|
: |
%3A |
< |
%3C |
> |
%3E |
* |
%2A |
? |
%3F |
| |
%7C |
- |
%2D |
" |
%22 |