Gerenciar coleções de projetos no Servidor de DevOps do Azure
Azure DevOps Server 2022 | Azure DevOps Server 2020 | Azure DevOps Server 2019
Quando o Servidor de DevOps do Azure hospeda vários projetos, você pode gerenciá-los de forma mais eficiente 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 cronograma de manutenção.
Um grupo de projetos é chamado de coleção de projetos. Quando você instala o Servidor de DevOps do Azure, 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 único banco de dados da coleção.
A ilustração a seguir mostra como os bancos de dados para coleções de projetos são integrados com a arquitetura lógica. Ao criar um projeto, você especifica a coleção que armazenará seus dados.
Exibir informações ou configurar o projeto existente
Se você não tiver sido adicionado como administrador do Servidor de DevOps do Azure, será adicionado agora.
Você deve ser membro do grupo Administradores local no servidor onde deseja abrir o console, e dos grupos Azure DevOps Server ou Team Foundation Administrators, ou sua permissão Editar Server-Level Informações deve ser definida como Permitir.
Entre no servidor de camada de aplicativo, abra oConsole de Administração e abra o nó Coleções de Projetos de Equipe.
Destaque o nome de uma coleção e revise as informações fornecidas nos vários separadores. Algumas guias só aparecem se o aplicativo correspondente tiver sido configurado.
Você pode executar as seguintes tarefas na guia correspondente.
Separador Tarefas Geral - Iniciar Recolha ou Parar Recolha: Iniciar ou parar 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 recolha for iniciada, somente Parar Recolha será exibido. Se a coleção for interrompida, somente Iniciar Coleção será exibida. Iniciar ou parar uma coleção pode demorar vários minutos a concluir. Talvez seja necessário escolher Atualizar para exibir a alteração no estado.
- Editar configurações: Edite a descrição ou configuração da coleção.
- Associação a Grupos: adicione ou remova utilizadores ou grupos como membros de uma coleção. Para saber mais, consulte Definir permissões de administrador para coleções de projetos.
- Administrar Segurança: Gerir as permissões de um grupo de coleção. Para saber mais, consulte a referência de permissões e grupos em .
Status - Exiba um registro de atividades ou execute novamente um trabalho.
Projetos - Exiba os projetos definidos para uma coleção e Excluir um projeto.
- Para saber mais sobre projetos, consulte Criar um projeto.
Configurar relatórios
A página de Relatórios só aparece quando você adicionou 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. Você deve especificar uma pasta existente se não tiver permissões para criar pastas nesse servidor.
- Para remover o local padrão das 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, analise Quais são os prós e contras da criação de várias coleções de projetos? conforme descrito mais adiante neste artigo.
Se você não foi adicionado como administrador, ser adicionado agora.
Você deve ser um membro do grupo Administradores local no servidor onde deseja abrir o console, e ou um membro do grupo dos Administradores do Team Foundation ou ter sua permissão Editar Server-Level Informações definida como Permitir.
No console de administração, abra a página Team Project Collections e escolha Create Collection.
Siga as orientações fornecidas pelo assistente Criar Coleção de Projetos de Equipe.
Para o Nome, especifique um nome único com no máximo 64 caracteres (quanto mais curto, melhor) e não inclua barras ou outros caracteres especiais listados em Restrições de nomenclatura.
Escolha Herança se quiser usar a interface do utilizador para personalizar a gestão de trabalho. Essa escolha depende do Serviço de Análise para dar suporte à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 é suportado, consulte Personalizar sua experiência de acompanhamento de trabalho.
O assistente permite a configuração dos seguintes recursos. Alguns recursos só podem ser configurados se o servidor de 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
Especifique o nome do servidor de camada de dados do Azure DevOps. Se desejar usar uma instância nomeada para hospedar o banco de dados para essa coleção de projetos, você também deverá especificar o nome da instância como no exemplo a seguir:
ServerName\InstanceName
Escolha Criar uma nova base de dados para esta coleção se quiser criar uma base de dados para a coleção. Essa opção requer que a conta de serviço usada pelo Visual Studio Team Foundation Background Job Agent 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.
SQL Server Reporting Services
Relatórios será exibido se tiverdes configurado o nível de aplicação para usar o SQL Server Reporting Services, caso contrário, ele será desativado. Para configurá-lo mais tarde, consulte Adicionar um servidor de relatório.
Revise 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 o Reporting Services.
A menos que restrições de segurança em sua infraestrutura de negócios impeçam 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 criada por um administrador para você no servidor que está executando o Reporting Services, expanda Configuração avançada , escolha Especifique um caminho para uma pasta existentee especifique o caminho relativo da pasta que foi criada para você.
Escolha Verificar caminhoe, se o caminho estiver correto, escolha Seguinte.
Processo de verificação
Em Verificações de Prontidão, reveja 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 para uma mensagem detalhada sobre o problema. Você deve corrigir todos os erros antes de poder continuar.
Depois que todas as verificações de preparação passarem, escolha Criar.
O processo de criação de uma coleção de projetos é iniciado.
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
No console de administração, realce o nome da coleção que você deseja excluir e escolha Desanexar Coleção.
Siga as orientações fornecidas pelo Assistente de Desanexar Coleção de Projetos da Equipe .
(Opcional) Na página Fornecer uma mensagem de serviço para a coleção de projetos, na Mensagem de Manutenção, especifique uma mensagem para os utilizadores que possam tentar se conectar a projetos dessa coleção.
Quando todas as verificações de preparação tiverem sido concluídas com êxito, escolha Desanexar.
Na página Monitorizar o progresso de desanexar a coleção de projetos na página, quando todos os processos estiverem concluídos, selecione Avançar.
(Opcional) Na página de revisão de informações suplementares desta coleção de projetos, observe o local do arquivo de log.
Excluir o banco de dados de coleta
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 coleta 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, consulte Eliminar um Banco de Dados.
A coleção de projetos não aparece mais na lista de coleções no console de administração.
Q & A
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 da criação de várias coleções de projetos?
Se seus esforços de desenvolvimento se beneficiarão 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: As vantagens de criar mais de uma coleção
Você pode separar melhor as necessidades operacionais para uma base de código ou outro agrupamento de projetos das necessidades operacionais para 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 aspetos de cada coleção separadamente de 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 coleta em momentos diferentes.
O agrupamento de projetos em mais de uma coleção oferece as seguintes vantagens:
Maior flexibilidade e escalabilidade na gestão e distribuição de bases de dados e recursos. Um grupo de projetos relacionados compartilha relatórios, itens de trabalho e orientação de processos, 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:
- Construa, ramifica, 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 coleta 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 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 coleções diferentes. 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 suportar 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.
R: 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.
P: Como os dados armazenados para diferentes coleções de equipe suportam a geração de relatórios?
R: Um único data warehouse relacional contém todos os dados relatáveis de todos os projetos definidos em todas as coleções de projetos para uma implantação do Azure DevOps. Os dados desse armazém são então processados e gravados no cubo OLAP. Como os dados são coletados em um único data warehouse, você pode gerar relatórios em várias coleções de projetos.
Para criar ou personalizar relatórios, deve-se adicionar contas de usuário à função TfsWarehouseDataReader. Os autores de relatórios 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 dimensiono a minha implementação com coleções?
A: Veja Mover uma coleção de projetos ou Dividir uma coleção de projetos.