Gerenciar coleções de projetos em Azure DevOps Server

Artigo
04/03/2024

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

Quando seu 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 usam esses projetos são armazenados no banco de dados único 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, especifique a coleção que armazenará seus dados.

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

Exibir informações ou configurar o projeto existente

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

Você deve ser membro do grupo administradores local no servidor em que deseja abrir o console e um membro do grupo Azure DevOps Server ou Administradores do Team Foundation ou sua permissão Editar informações de Server-Level deve ser definido como Permitir.
Entre no servidor da camada de aplicativo, abra o Console de Administração e abra o nó Coleções de Projetos de Equipe .

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

Você pode executar as tarefas a seguir na guia correspondente.

Tab	Tarefas
Geral	Iniciar Coleção ou Parar Coleção: inicie ou interrompa 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 coleção for iniciada, somente Stop Collection será exibido. Se a coleção for interrompida, somente Iniciar Coleção será exibida. Iniciar ou parar uma coleção pode levar vários minutos para ser concluída. 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. Associação de Grupo: adicione ou remova usuários ou grupos como membros de uma coleção. Para saber mais, confira 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, confira Referência de permissões e grupos.
Status	Exiba um log de atividades ou execute novamente um trabalho.
Projetos	Exiba os projetos definidos para uma coleção e Exclua um projeto. Para saber mais sobre projetos, consulte Criar um projeto.

Configurar relatórios

A página Relatórios só é exibida quando você adiciona um servidor de relatório ao Azure DevOps. Escolha esta página para executar as seguintes tarefas:

Configure o servidor de relatório para uso pela coleção.
Quando você edita o local da pasta padrão, a operação falhará se você digitar o caminho de uma pasta que não existe no servidor e você não tiver permissão para criar uma pasta nesse servidor. Se você não tem permissões para criar pastas no servidor, você deve especificar uma pasta existente.
Para remover o local padrão para subpastas de relatório, escolha Limpar Configuração.
A remoção da configuração remove a funcionalidade de relatório para todos os projetos existentes e futuros na coleção.

Criar uma coleção de projetos

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

Se você não tiver sido adicionado como administrador, será adicionado agora.

Você deve ser um membro do grupo administradores local no servidor em que deseja abrir o console e um membro do grupo Administradores do Team Foundation ou sua permissão Editar informações Server-Level deve ser definido como Permitir.
No console de administração, abra a página Coleções de Projetos de Equipe e escolha Criar Coleção.
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.

Escolha Herança se quiser usar a interface do usuário para personalizar o acompanhamento de trabalho. Essa escolha depende do Serviço de Análise para dar suporte às suas necessidades de relatório.

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 o witadmin para listar, importar, exportar e modificar um processo para um projeto. Para os modelos de processo herdados, você só pode usar o witadmin para listar e exportar informações do processo. Para obter uma visão geral dos modelos de processo e o que tem suporte, consulte Personalizar sua experiência de acompanhamento de trabalho.

O assistente dá suporte à configuração dos recursos a seguir. 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 de SQL Server

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 desta coleção de projetos, também deverá especificar o nome da instância como no exemplo a seguir:

Servername\Instancename
Escolha Criar um novo banco de dados para essa coleção se quiser criar um banco de dados para a coleção. Essa opção exige 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 esse 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 exige que exista um banco de dados vazio na instância de SQL Server nomeada e você tenha permissões de gravação.

SQL Server Reporting Services

Os relatórios serão exibidos se você tiver configurado a camada de aplicativo para usar SQL Server Reporting Services, caso contrário, ele será desabilitado. Para configurá-lo mais tarde, consulte Adicionar um servidor de relatório.
Examine as informações do servidor e da pasta que hospedará relatórios e escolha Avançar. Essa opção exige que sua conta de usuário tenha permissões para criar uma pasta no servidor que está executando Reporting Services.

A menos que as restrições de segurança na sua infraestrutura do negócio evitar a criação automática de uma pasta como parte do assistente, você deve usar a opção padrão para criar uma pasta.
Se você precisar usar uma pasta que um administrador criou para você no servidor que está executando Reporting Services, expanda Configuração avançada, escolha Especificar um caminho para uma pasta existente e especifique o caminho relativo da pasta que foi criada para você.

Escolha Verificar Caminho e, se o caminho estiver correto, escolha Avançar.

Processo de verificação

Em Verificações de Preparação, examine o status das verificações.

Um indicador de erro sublinhado azul aparece ao lado de qualquer configuração que contenha um erro. Você pode escolher o indicador de 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.
O processo de criação de uma coleção de projetos é iniciado.

Depois que o assistente for concluído, 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 de coleção.

Desanexar a coleção

No console de administração, realce o nome da coleção que você deseja excluir e escolha Desanexar Coleção.
Siga as diretrizes fornecidas pelo Assistente de Coleção de Projetos de Equipe de Desanexar.

(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 nesta coleção.
Quando todas as verificações de preparação tiverem sido concluídas com êxito, escolha Desanexar.

Na página Monitorar a coleção de projetos desanexar o progresso , quando todos os processos forem concluídos, escolha Avançar.
(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

Abra SQL Server Management Studio, conecte-se à instância do Mecanismo de Banco de Dados 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: Há uma ferramenta de linha de comando para gerenciar coleções?

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

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

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

R: 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 para outro agrupamento. Como os dados para cada coleção são armazenados em seu próprio banco de dados, é possível independentemente gerenciar muitos aspectos de cada coleção separadamente das outras coleções em sua implantação. Por exemplo, você pode parar e iniciar cada coleção individualmente. Portanto, você pode agendar operações de manutenção para cada coleção em momentos diferentes.

Agrupar projetos em mais de uma coleção fornece 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, as equipes e os administradores podem executar as seguintes tarefas:
- Criar, ramificar, mesclar e iterar uma base de código autônoma de acordo com as necessidades dos projetos dentro da coleção. 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 para uma implantação diferente do Azure DevOps.
- Reatribua recursos para atender melhor às demandas dos projetos à medida que aumentam de tamanho ao longo do tempo.
Maior segurança operacional. Como cada coleção tem seu próprio conjunto de usuários e permissões, isolar bases de código diferentes pode ser isolado em coleções diferentes. Os administradores podem adicionar usuários somente à coleção que contém o projeto ou projetos pertencentes a essa base de código específica.
Maior capacidade para dar 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 diferentes processos de fluxo de trabalho em coleções diferentes, você só expõe essas personalizações necessárias para esses projetos em uma coleção.

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

A main 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.
O Teams não pode vincular itens de trabalho entre coleções.
O Teams não pode ramificar ou mesclar código entre coleções.
O Teams não pode criar consultas entre coleções.

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

Um: 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.

P: Como os dados armazenados para diferentes coleções de equipe dão suporte a relatórios?

Um: Um único data warehouse relacional contém todos os dados reportáveis de todos os projetos definidos em todas as coleções de projetos para uma implantação do Azure DevOps. Em seguida, os dados desse warehouse são processados e gravados no cubo OLAP. Como os dados são coletados em um único data warehouse, você pode relatar em várias coleções de projetos.

Para criar ou personalizar relatórios, você deve adicionar contas de usuário à função TfsWarehouseDataReader. Os autores de relatório precisam de acesso de leitura ao data warehouse relacional e ao cubo do Analysis Services. Essas contas podem exibir dados de todos os projetos de equipe hospedados em todas as coleções de projetos na implantação do Azure DevOps. Não há como limitar o acesso a um projeto ou coleção.

P: Como fazer dimensionar minha implantação com coleções?

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