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 em um conjunto de objetos.
Observação
Para obter limites no número de itens que você pode definir, consulte Controle de trabalho, processo e limites de projeto.
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.
Tal 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 a nomes de arquivo, consulte Nomeando arquivos, caminhos e namespaces.
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
Os pacotes universais devem estar em conformidade com 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 do pacote | Deve ser minúsculo sem metadados de compilação. |
Azure Boards
Use itens de trabalho para capturar informações para planejar e acompanhar seus projetos de desenvolvimento de software. Com os itens de trabalho, você pode descrever o trabalho a ser feito, atribuir trabalho, controlar 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 sã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 associadas 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 depois que ele é 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 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 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 indicar a hierarquia de nós dentro da estrutura de árvore.
Os nomes atribuídos aos nós filho 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 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 aos itens de trabalho devem estar em conformidade com as seguintes restrições.
| 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 de anexo para itens de trabalho. |
Nomes de colunas e raias da placa
Seu quadro Kanban transforma seu backlog em um letreiro interativo, proporcionando 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 seus quadros Kanban 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 das 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 Kanban. - Os nomes das raias não devem ser iguais aos de qualquer outro nome de raia no quadro Kanban. |
| 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 campos de item de trabalho devem estar em conformidade com as seguintes restrições.
| 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 projeto. Os nomes de campo de item de trabalho têm como escopo a coleção de projeto. Se você renomear um nome de campo, alterá-lo para todos os itens de trabalho e WITs definidos em todos os projetos na 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 de terceiros 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 somente para definir todos os campos principais do sistema que são obrigatórios para 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 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 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. Os clientes e parceiros também podem definir seus próprios namespaces para oferecer 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 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 de 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, especifique o texto de ajuda usando o HELPTEXT elemento . Confira Adicionar ou modificar um campo para acompanhar o trabalho.
O texto de ajuda adicionado 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 projeto 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 entre vários tipos de item de trabalho e projetos. Para obter detalhes, consulte Definir listas globais.
Uma lista global, definida usando o elemento contém um ou mais itens de GLOBALLIST 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 qualquer outro nome de referência de campo dentro da coleção do projeto. - 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 ambos processariam como o mesmo nome: My__Field |
| Caracteres especiais | - Não deve conter hífens -.- Deve conter pelo menos um período ..- 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 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 marcas de item de trabalho para categorizar e filtrar listas e quadros.
Os nomes das marcas 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 controle Unicode ou caracteres de formato, como um feed 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 seguintes restrições.
| 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 de a-Z, 0-9ou _. |
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 seguintes restrições. Para saber mais, 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 ramificações 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)
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, prateleira e muitos outros recursos. Para saber mais, 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 de origem 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 pendentes 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ê adicionar ao controle de versão do Team Foundation devem estar em conformidade com as seguintes restrições.
| 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 $arquivo .- Não deve conter os seguintes caracteres imprimíveis: \ / : * ? " < > | ;. |
Etiquetas 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 de rótulo.
| 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 período ..- Não deve conter os seguintes caracteres imprimíveis: \ / : * ? " < > | ; @. |
Prateleiras TFVC
Os conjuntos de prateleiras 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 conjunto de prateleiras para seu espaço de trabalho ou colocá-las no espaço de trabalho de outro usuário.
Os nomes dos conjuntos de prateleiras 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 conter os seguintes caracteres imprimíveis: \ / : * ? " < > | ;. |
Espaços de trabalho do 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 de espaço 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 onde 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
- Usar 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, você receber a seguinte mensagem de erro: VS850015: O nome especificado não pode ser usado: {Nome da organização}.
Modelos de processo e processo
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.
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 seguintes restrições.
| 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 do 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 membros da equipe a projetos. O padrão atribuído corresponde a DefaultCollection. Gerenciar coleções de projeto fornece mais informações.
Os nomes atribuídos às coleções de projeto 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 do SharePoint, servidor de relatório ou site do Reporting Services existente. |
| 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 período ..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 membros da equipe a 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 qualquer outro nome na coleção de projetos, no aplicativo Web do SharePoint que dá suporte à coleção ou à instância do SQL Server Reporting Services que dá 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ções 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 mistura 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 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. |
| 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 período ..- Não deve incluir vírgulas ,. |
Compilação do Team Foundation
Team Foundation Build permite gerenciar todos os aspectos 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
Team Foundation Build é uma instalação separada da camada de aplicativo do Azure DevOps Server, camada de dados ou 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 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 recebimento | Deve ser um caminho UNC (por exemplo, \server\share). |
| Permissões de localização de descartar | 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 ao local de descarte UNC.- O local de descarte 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, verifique 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 ASP.NET pasta temporária. - A conta tem permissão de Controle Total para o diretório de compilação e local de descarte. |
| 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 criados. 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 restrições a seguir.
| Tipo de restrição | Restrição |
|---|---|
| Exclusividade | Não deve ser o mesmo que 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 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 |
|---|---|
| Length | Não deve conter mais de 256 caracteres Unicode. |
| Exclusividade | Não deve ser o mesmo que qualquer outro nome de qualidade de compilação no computador Team Foundation Build. |
Nomes das equipes
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 os 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 para usar o 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 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 período ..duplo.- Não deve começar com um sublinhado _.- Não deve iniciar ou terminar com um período .. |
Nomes de conta de usuário
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 Active Directory, ID do Microsoft Entra, 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. |
| 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 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ágina e arquivo Wiki
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 |
Artigos relacionados
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de