Compartilhar via


Gerenciar coleções de projetos em Azure DevOps Server

Azure DevOps Server |Azure DevOps Server |Azure DevOps Server 2022 | Azure DevOps Server 2020

Quando Azure DevOps Server hospeda vários projetos, você pode gerenciá-los com mais eficiência agrupando-os e atribuindo os mesmos recursos a eles. Por exemplo, você pode agrupar projetos que tenham requisitos ou objetivos semelhantes, como todos os projetos que acessam uma base de código específica. Em seguida, você pode gerenciar o grupo de projetos de equipe como um recurso autônomo com seus próprios grupos de usuários, recursos de servidor e agendamento de manutenção.

Um grupo de projetos é chamado de coleção de projetos. Quando você instala Azure DevOps Server, uma coleção padrão é criada para conter todos os projetos. Ao criar uma coleção, você especifica os recursos lógicos e físicos que os projetos dentro dessa coleção podem usar. Todos os artefatos e dados que esses projetos usam são armazenados no banco de dados individual da coleção.

A ilustração a seguir mostra como os bancos de dados para coleções de projetos são integrados à arquitetura lógica. Ao criar um projeto, você especifica a coleção que armazenará seus dados.

Exemplo: possível localização de bancos de dados de coleção

Exibir informações ou configurar projetos existentes

  1. Se você não tiver sido adicionado como administrador Azure DevOps Server, seja adicionado agora.

    Você deve ser membro do grupo de Administradores locais no servidor onde deseja abrir o console e, além disso, membro do grupo do Azure DevOps Server ou dos Administradores do Team Foundation, ou a sua permissão Editar Informações em Nível de Servidor deve estar configurada como Permitir.

  2. Acesse o servidor de camada de aplicação, abra o Console de Administração e abra o nó Coleções de Projetos de Equipes.

    Captura de tela da Console de Administração, nó Coleções de Projetos de Equipe, Azure DevOps Server 2022.

  3. Realce o nome de uma coleção e revise as informações fornecidas nas várias abas. Algumas guias só aparecem se o aplicativo correspondente tiver sido configurado.

    Você pode executar as seguintes tarefas na guia correspondente.

    Tabulação Tarefas
    Geral
    • Iniciar Coleta ou Parar Coleta: Inicie ou pare uma coleção. Os projetos ficam indisponíveis quando você interrompe uma coleção. Normalmente, você interrompe uma coleção para dar suporte a operações de manutenção, como mover ou dividir uma coleção.
    • Se a coleta estiver iniciada, somente Parar Coleta é exibido. Se a coleta for interrompida, somente Iniciar Coleta será exibido. Iniciar ou interromper uma coleta pode levar vários minutos para ser concluído. Talvez seja necessário escolher Atualizar para exibir a alteração no estado.
    • Editar configurações: edite a descrição ou a configuração da coleção.
    • Membros do Grupo: Adicione ou remova usuários ou grupos como parte de uma coleção. Para saber mais, consulte Definir permissões de administrador para coleções de projetos.
    • Administrar Segurança: Gerencie as permissões de um grupo de coleção. Para saber mais, consulte a Referência de Permissões e Grupos.
    Status
    • Exibir um log de atividades ou executar novamente um trabalho.
    Projetos

Criar uma coleção de projetos

Antes de criar uma coleção de projetos, examine Quais são os prós e contras de criar várias coleções de projetos? conforme descrito posteriormente neste artigo.

  1. Se você não foi adicionado como administrador, seja adicionado agora.

    Você deve ser membro do grupo Administradores local no servidor em que deseja abrir o console e ser membro do grupo Administradores do Team Foundation, ou sua permissão Editar Informações em Nível de Servidor deve ser definida como Permitir.

  2. No console de administração, abra a página Coleções de Projetos de Equipe e escolha Criar Coleção.

  3. Siga as diretrizes fornecidas pelo assistente Criar Coleção de Projetos de Equipe.

    Para o Nome, especifique um nome exclusivo com no máximo 64 caracteres (quanto menor, melhor) e não especifique barras ou outros caracteres especiais listados em Restrições de nomenclatura.

    Caixa de diálogo de Criar coleção, Azure DevOps Server 2022, com a opção Herança selecionada.

  1. Escolha Herança se quiser usar a interface do usuário para personalizar o acompanhamento de trabalho. Essa opção depende do Serviço de Análise para atender às suas necessidades de relatórios.

    Escolha XML se quiser usar arquivos de definição XML para personalizar o acompanhamento de trabalho.

    Observação

    Para o modelo de processo XML local, você pode usar witadmin para listar, importar, exportar e modificar um processo para um projeto. Para os modelos de processo herdados, você só pode usar witadmin para listar e exportar informações do processo. Para obter uma visão geral dos modelos de processo e do que é compatível, consulte Personalizar sua experiência de acompanhamento de trabalho.

O assistente auxilia na configuração dos seguintes recursos. Alguns recursos só poderão ser configurados se o servidor da camada de aplicativo que hospeda a coleção tiver sido configurado anteriormente para dar suporte ao aplicativo correspondente.

Camada de Dados ou instância do SQL Server

  1. Especifique o nome do servidor da camada de dados do Azure DevOps. Se você quiser usar uma instância nomeada para hospedar o banco de dados para essa coleção de projetos, também deverá especificar o nome da instância como no exemplo a seguir:

    Nome do servidor\Nome da instância

  2. Escolha Criar um novo banco de dados para esta coleção se quiser criar um banco de dados para a coleção. Essa opção requer que a conta de serviço usada pelo Agente de Trabalho em Segundo Plano do Visual Studio Team Foundation tenha permissões para criar um banco de dados na instância do SQL Server.

    Ou escolha Usar este banco de dados existente se quiser usar um banco de dados que já existe e especifique o nome do banco de dados. Essa opção requer que exista um banco de dados vazio na instância nomeada do SQL Server e que você tenha permissões de gravação.

Processo de verificação

  1. Em Verificações de prontidão, revise o status das verificações.

    Um indicador de erro sublinhado em azul aparece ao lado de qualquer configuração que contenha um erro. Você pode escolher o indicador para uma mensagem detalhada sobre o problema. Você deve resolver todos os erros antes de continuar.

    Depois que todas as verificações de preparação forem aprovadas, escolha Criar.

  2. O processo de criação de uma coleção de projetos é iniciado.

    Captura de tela da caixa de diálogo Criar Coleção de Projetos de Equipe mostrando que o processo de criação foi bem-sucedido.

    Depois que o assistente terminar, escolha Fechar.

Desanexar ou excluir uma coleção de projetos

Você desanexa uma coleção de projetos quando deseja executar uma operação de manutenção, como mover ou dividir uma coleção. As equipes não podem acessar projetos ou código-fonte quando você desanexa a coleção.

Você exclui uma coleção quando não precisa mais dos dados armazenados nos projetos definidos na coleção. As três etapas para excluir uma coleção são (1) desanexar a coleção e (2) excluir o banco de dados da coleção.

Desanexar a coleção

  1. No console de administração, realce o nome da coleção que você deseja excluir e escolha Desanexar coleção.

  2. Siga as diretrizes fornecidas pelo Assistente de Desanexação de Coleção de Projetos da Equipe.

    (Opcional) Na página Fornecer uma mensagem de manutenção para a coleção de projetos, em Mensagem de Manutenção, especifique uma mensagem para os usuários que podem tentar se conectar a projetos nessa coleção.

  3. Quando todas as verificações de preparação forem concluídas com êxito, escolha Desanexar.

    Na página Monitorar o progresso de desanexação da coleção de projetos, quando todos os processos forem concluídos, escolha Avançar.

  4. (Opcional) Na página Revisar informações complementares para esta coleção de projetos, observe o local do arquivo de log.

Excluir o banco de dados de coleção

  1. Abra o SQL Server Management Studio, conecte-se à instância do Mecanismo de Banco de Dados do SQL Server que hospeda o banco de dados de coleção e expanda a instância.

    Realce o nome do banco de dados de coleção (por padrão, TFS_CollectionName) e exclua o banco de dados.

    Para obter mais informações, veja Excluir um banco de dados.

A coleção de projetos não aparece mais na lista de coleções no console de administração.

Perguntas e Respostas

P: Existe uma ferramenta de linha de comando para gerenciar coleções?

R: Você pode usar o comando TFSConfig Collection para anexar, desanexar, excluir ou clonar uma coleção de projetos.

P: Quais são os prós e contras de criar várias coleções de projetos?

Se seus esforços de desenvolvimento se beneficiarem da capacidade de ramificar e mesclar código ou se você precisar consultar o status de itens de trabalho relacionados ao mesmo código, consolide seus projetos na mesma coleção de projetos.

A: Vantagens para criar mais de uma coleção

Você pode separar melhor as necessidades operacionais de uma base de código ou outro agrupamento de projetos das necessidades operacionais de outro agrupamento. Como os dados de cada coleção são armazenados em seu próprio banco de dados, você pode gerenciar de forma independente muitos aspectos de cada coleção separadamente de outras coleções em sua implantação. Por exemplo, você pode parar e iniciar cada coleta individualmente. Portanto, você pode programar operações de manutenção para cada coleta em momentos diferentes.

Agrupar projetos em mais de uma coleção oferece as seguintes vantagens:

  • Maior flexibilidade e escalabilidade no gerenciamento e distribuição de bancos de dados e recursos. Um grupo de projetos relacionados compartilha relatórios, itens de trabalho e diretrizes de processo, bem como uma base de código.

    Ao criar um banco de dados para cada coleção, equipes e administradores podem executar as seguintes tarefas:

    • Crie, ramifique, mescle e itere uma base de código autônoma de acordo com as necessidades dos projetos dentro da coleção. As dependências de código fora da coleção podem ser gerenciadas formalmente.
    • Faça backup e restaure os dados de cada coleção independentemente de outras coleções.
    • Armazene todos os bancos de dados de coleção em uma única instância do SQL Server ou distribua os bancos de dados em uma ou mais instâncias.
    • Desanexe uma coleção, faça backup dela e restaure-a em uma implantação diferente do Azure DevOps.
    • Reatribua recursos para melhor atender às demandas dos projetos à medida que eles aumentam de tamanho ao longo do tempo.
  • Aumento da segurança operacional. Como cada coleção tem seu próprio conjunto de usuários e permissões, o isolamento de diferentes bases de código pode ser isolado em diferentes coleções. Os administradores podem adicionar usuários somente à coleção que contém o projeto ou projetos que pertencem a essa base de código específica.

  • Maior capacidade de oferecer suporte a processos de fluxo de trabalho personalizados. Cada coleção gerencia modelos de processo, tipos de item de trabalho, tipos de link, listas globais e campos de item de trabalho separados de outras coleções. Ao separar projetos que têm processos de fluxo de trabalho diferentes em coleções diferentes, você expõe apenas as personalizações necessárias para esses projetos dentro de uma coleção.

A: Desvantagens de criar mais de uma coleção

A principal desvantagem de criar mais de uma coleção de projetos é que você aumenta a complexidade da implantação do Azure DevOps.

  • Você deve fazer backup e restaurar o banco de dados para cada coleção, e outras tarefas de gerenciamento e manutenção também aumentam proporcionalmente ao número de coleções que você tem. Por exemplo, você deve gerenciar o conjunto de usuários e permissões para cada coleção de projetos individualmente.
  • As equipes não podem vincular itens de trabalho entre coleções.
  • As equipes não podem ramificar ou mesclar código entre coleções.
  • As equipes não podem criar consultas entre coleções.

P: Quais recursos são gerenciados no nível da coleção?

R: Cada projeto pertence a uma coleção. Para saber mais sobre como gerenciar uma coleção, consulte Introdução ao gerenciamento de sua organização ou coleção de projetos.

Q: Como posso escalonar minha implantação usando coleções?

R: Consulte Mover uma coleção de projetos ou Dividir uma coleção de projetos.