Dividir uma coleção de projetos
Azure DevOps Server 2022 | Azure DevOps Server 2020 | Azure DevOps Server 2019
À medida que sua empresa muda, talvez você queira dividir uma única coleção de projetos em várias coleções de projetos. Por exemplo:
Você deseja que os projetos em uma coleção alinhem-se com as unidades de negócio na sua organização, e os projetos na coleção agora são de propriedade de unidades separadas.
Você atualizou de uma versão anterior do Azure DevOps Server, tem apenas uma coleção e deseja organizar seus projetos em coleções separadas por motivos de segurança ou alinhamento de negócios.
Você deseja alterar a propriedade de alguns dos projetos na coleção para um escritório remoto que tenha sua própria implantação de Azure DevOps Server. Esse cenário requer que você primeiro divida uma coleção e então mova uma das coleções resultantes para a implantação do escritório remoto.
Observação
Os procedimentos neste artigo dão suporte apenas à divisão de uma coleção de projetos. Para mover uma coleção depois de dividi-la, consulte Mover uma coleção de projetos.
Para dividir uma coleção de projetos, siga estas etapas:
Preparar para dividir a coleção
Dividir a coleção
Configurar as coleções divididas
Antes de começar
Verifique se você é um administrador nos servidores e em SQL Server e Azure DevOps Server. Se você não for um administrador, será adicionado como um.
1-a. Desanexar a coleção
Primeiro desanexe a coleção da implantação de Azure DevOps Server em que ela está em execução. Desanexar uma coleção interrompe todos os trabalhos e serviços, bem como o próprio banco de dados de coleção. Além disso, o processo de desanexação copia os dados específicos da coleção do banco de dados de configuração e os salva como parte do banco de dados de coleção de projetos.
Desanexar uma coleção de projetos
Abra o console de administração do Azure DevOps no servidor que hospeda a coleção a ser dividida.
Selecione Coleções de Projetos e, na lista de coleções, selecione a coleção a ser dividida.
Neste exemplo, o administrador escolhe TestProjects.
Dica
O nome padrão de uma coleção de projetos é DefaultCollection. Se você estiver dividindo esse banco de dados, certifique-se de dar à segunda coleção um nome diferente, pois essa é a opção padrão na conexão.
Na guia Geral , selecione Parar Coleta.
A caixa de diálogo Motivo do Status da Coleção de Projetos é aberta. O texto inserido será exibido aos usuários. Selecione Parar e aguarde até que a coleção pare. Quando ele for interrompido, sua status será exibida como Offline.
Na guia Geral , selecione Desanexar Coleção.
O Assistente para Desanexar Coleção de Projetos é aberto.
(Opcional) Na página Fornecer uma mensagem de manutenção para a coleção de projetos , em Mensagem de Manutenção, forneça uma mensagem para os usuários que podem tentar se conectar a projetos nesta coleção.
Na página Examinar configurações que serão usadas para desanexar a coleção de projetos , examine os detalhes. Para alterar as configurações, selecione Anterior. Se estiverem corretos, selecione Verificar.
Quando todas as verificações de preparação forem concluídas com êxito, selecione Desanexar.
Na página Monitorar a coleção de projetos desanexar o progresso , quando todos os processos forem concluídos, selecione Avançar.
(Opcional) Na página Examinar informações complementares para esta coleção de projetos , selecione ou anote o local do arquivo de log e feche o assistente.
A coleção de projetos não aparece mais na lista de coleções no console de administração.
1-b. Realizar o backup do banco de dados da coleção
Depois de desanexar a coleção, é preciso fazer um backup do banco de dados antes de restaurar uma cópia no servidor com um nome diferente. Essa cópia se tornará o banco de dados para a parte da coleção original que você deseja dividir em outra coleção. Para executar essa tarefa, use as ferramentas fornecidas com SQL Server.
Fazer backup de um banco de dados de coleção
Para obter informações sobre como fazer backup e restaurar manualmente bancos de dados individuais, consulte Fazer backup e restaurar bancos de dados no SQL Server e Criar um agendamento e um plano de backup. Selecione a versão do SQL Server que corresponde à sua implantação.
Importante
Se a sua implantação original usou as edições Enterprise ou Datacenter do SQL Server e se você quiser restaurar os bancos de dados que deseja dividir em um servidor executando a edição Standard, use um conjunto de backup feito com a compactação do SQL Server desabilitada. A menos que desative a compactação de dados, você não poderá restaurar com êxito os bancos de dados da edição Enterprise ou Datacenter em um servidor que está executando a edição Standard. Para desativar a compactação, siga as etapas em Desabilitar SQL Server compactação de dados em bancos de dados do Azure DevOps.
2-a. Restaurar o banco de dados da coleção
Ao dividir uma coleção, você deve restaurar o backup do banco de dados de coleção para uma instância de SQL Server configurada para dar suporte à implantação de Azure DevOps Server. Ao restaurar o banco de dados, é preciso atribuir um nome diferente daquele do banco de dados da coleção original.
Dica
As etapas a seguir fornecem uma visão geral de como restaurar um banco de dados de coleção de projetos no SQL Server 2012 usando SQL Server Management Studio. Para obter mais informações sobre como fazer backup e restaurar manualmente bancos de dados individuais, consulte Fazer backup e restaurar bancos de dados no SQL Server. Selecione a versão do SQL Server que corresponde à sua implantação.
Restaurar o banco de dados de coleção com um novo nome
Abra SQL Server Management Studio e conecte-se à instância que hospeda o banco de dados da coleção de projetos a ser dividida.
Em Pesquisador de Objetos, expanda Bancos de Dados, abra o submenu do banco de dados a ser dividido e, em seguida, selecioneTarefas, restaurar e, em seguida, selecione Banco de dados.
A janela Restaurar Banco de Dados é aberta na página Geral .
Em Origem, verifique se o banco de dados da coleção de projetos foi escolhido. Em Destino, forneça um nome para a cópia do banco de dados. Mantenha o prefixo Tfs_ e adicione um nome distinto. Normalmente, esse nome é o nome da coleção de projetos divididos. No Plano de restauração, verifique se os conjuntos de backup a serem restaurados são os que você deseja restaurar. Para verificar se esses são conjuntos válidos, selecione Verificar Mídia de Backup e, em Selecionar uma página, selecioneOpções.
Em Opções de restauração, deixe todas as caixas marcar em branco. Verifique se o estado de recuperação está definido como RESTORE WITH RECOVERY. No Backup da Parte Final do Log, desmarque a caixa Sair do banco de dados de origem no estado de restauração marcar e selecione OK.
Dica
Se a operação de restauração falhar com uma mensagem de erro indicando que o banco de dados está em uso e não pode ser substituído, talvez seja necessário configurar manualmente todos os nomes de arquivo lógico para refletir o novo nome do banco de dados. Em Selecionar uma página, selecioneArquivos, selecione o botão de reticências ao lado de cada arquivo que está sendo restaurado e verifique se os nomes dos arquivos refletem o novo nome do banco de dados, não o antigo. Então tente realizar a restauração novamente.
2-b. Anexar o banco de dados da coleção original
Depois de restaurar o banco de dados com um nome diferente, reanexe o banco de dados da coleção original à implantação de Azure DevOps Server.
Anexar a coleção
Abra o console de administração do Azure DevOps.
Selecione Coleções de Projetos e, em seguida, selecione Anexar Coleção.
O Assistente para Anexar Coleção de Projetos é aberto.
Na página Selecionar o banco de dados da coleção de projetos a ser anexado, em SQL Server Instância, forneça o nome do servidor e a instância que hospeda o banco de dados de coleção, se ele ainda não estiver listado.
Na lista Bancos de dados , selecione o banco de dados de coleção a ser anexado.
Na página Inserir informações da coleção de projetos , forneça um nome para a coleção em Nome se ainda não houver um. Como essa é a coleção original, você pode selecionar para deixar o nome como era antes. Em Descrição, opcionalmente, forneça uma descrição da coleção.
Na página Examinar configurações que serão usadas para anexar a coleção de projetos , examine as informações.
Para alterar as configurações, selecione Anterior. Se todas as configurações estiverem corretas, selecione Verificar.
Quando todas as verificações de preparação forem concluídas com êxito, selecione Anexar.
Na página Monitorar o andamento da anexação da coleção de projetos , quando todos os processos forem concluídos, selecione Avançar.
(Opcional) Na página Examinar informações complementares para esta coleção de projetos , selecione ou anote o local do arquivo de log e feche o assistente.
A coleção de projetos aparece na lista de coleções no console de administração. Se o estado da coleção estiver listado comoOnline, você deverá interrompê-lo antes de continuar. Selecione a coleção na lista e, na guia Geral , selecione Parar Coleção.
2-c. Anexar o banco de dados da coleção renomeado
Depois de anexar o banco de dados de coleção original, você deve anexar a coleção renomeada à implantação de Azure DevOps Server. Quando essa coleção tiver sido anexada, ela permanecerá parada. Você não conseguirá iniciá-la até que todos os projetos duplicados tenham sido removidos.
Anexar o banco de dados da coleção renomeado
Abra o console de administração do Azure DevOps.
Selecione Coleções de Projetos e, em seguida, selecione Anexar Coleção para abrir o assistente.
Na página Selecionar o banco de dados da coleção de projetos a ser anexado, em SQL Server Instância, forneça o nome do servidor e a instância que hospeda o banco de dados de coleção renomeado, se ele ainda não estiver listado.
Na lista Bancos de dados , selecione o banco de dados de coleção renomeado.
Na página Inserir informações da coleção de projetos , insira um nome para a coleção renomeada em Nome que difere do nome do nome original da coleção. Isso deve corresponder ao nome que você deu ao banco de dados renomeado, sem o prefixo Tfs_.
(Opcional) Em Descrição, insira uma descrição da coleção.
Na página Examinar configurações que serão usadas para anexar a coleção de projetos , examine as informações. Para alterar as configurações, selecione Anterior. Se todas as configurações estiverem corretas, selecione Verificar.
Quando todas as verificações de preparação forem concluídas com êxito, selecione Anexar.
Na página Monitorar o andamento da anexação da coleção de projetos , quando todos os processos forem concluídos, selecione Avançar.
(Opcional) Na página Examinar informações complementares para esta coleção de projetos , selecione ou anote o local do arquivo de log e feche o assistente.
O nome da coleção aparece na lista de coleções no console de administração e sua status deve ser exibida como Offline.
Para garantir que ambas as coleções sejam anexadas com IDs únicos, no console de administração, acesse Logs de evento e abra os arquivos de log para ambas as operações de anexar coleção. Os GUIDs para CollectionProperties não devem corresponder.
No caso improvável de os GUIDs CollectionProperties corresponderem, altere a ID para uma ID exclusiva antes de continuar executando o comando Coleção TFSConfig na segunda coleção com o parâmetro /clone.
2-d. Exclua projetos nas coleções divididas
Agora que você tem duas cópias da coleção anexadas a Azure DevOps Server, exclua cada projeto da coleção original ou da coleção renomeada para que nenhum projeto permaneça em ambas as coleções.
Importante
Um projeto não pode estar em mais de uma coleção. Até você excluir todos os projetos duplicados entre as coleções divididas, não poderá iniciar a coleção renomeada.
Excluir projetos das coleções
Abra o console de administração do Azure DevOps.
Selecione Coleções de Projetos e, na lista de coleções, selecione a coleção de projeto original que você parou para dividi-la.
Na guia Projetos , na lista de projetos, selecione um projeto a ser excluído da coleção e selecione Excluir.
Dica
É possível selecionar mais de um projeto para excluir por vez.
Selecione a caixa Excluir dados do workspace marcar, deixe a caixa Excluir artefatos externos marcar desmarcada e selecione Excluir.
Se a caixa Excluir artefatos externos marcar não estiver desmarcada e seu projeto estiver configurado para usar o Lab Management, as máquinas virtuais e os modelos associados ao projeto serão excluídos do System Center Virtual Machine Manager. Eles não estarão mais disponíveis para o projeto na coleção renomeada. (Observe que o Lab Management foi preterido para o TFS 2017 e versões posteriores.)
Quando terminar de excluir os projetos que você não deseja hospedar na coleção de projetos original, selecione a coleção de projetos renomeada na lista de coleções. Em seguida, na guia Projetos , exclua os projetos indesejados da nova coleção.
Repita as etapas nesta seção até que ambas as coleções contenham um conjunto de projetos exclusivos.
2-e. Iniciar as coleções de projetos
Depois de excluir projetos, reinicie ambas as coleções.
Iniciar uma coleção de projetos
Abra o console de administração do Azure DevOps.
Selecione Coleções de Projetos e, na lista de coleções, selecione a coleção que você parou para dividi-la.
Na guia Geral , selecione Iniciar Coleção.
Repita a etapa 2 para a coleção anexada com um novo nome.
3-a. Configurar usuários e grupos para as coleções divididas
Você pode ignorar este procedimento se ambas as coleções divididas forem permanecer no mesmo domínio e você desejar permitir acesso dos administradores da coleção original a ambas as coleções.
Depois de dividir uma coleção, atualize os grupos de permissão para ambas as coleções com os usuários e grupos que administrarão essas coleções. Para obter mais informações, consulte Definir permissões de administrador para coleções de projetos.
3-b. Configurar usuários e grupos para projetos
Você pode ignorar este procedimento se as coleções divididas forem permanecer no mesmo domínio e você desejar permitir acesso dos usuários dos projetos da coleção original a ambas as coleções.
Depois de configurar os administradores para ambas as coleções, você ou esses administradores devem configurar acesso para usuários e grupos aos projetos em cada coleção. Dependendo da implantação, talvez você também precise configurar permissões para esses usuários no Reporting Services. Para obter mais informações, consulte Adicionar usuários a projetos ou equipes.
Perguntas e Respostas
P: Minha implantação usa relatório. Há alguma etapa adicional que eu preciso realizar ao dividir coleções?
Um: Sim, você precisará dividir os relatórios depois de concluir a exclusão de projetos para que ambas as coleções tenham um conjunto exclusivo de projetos. Também será necessário recompilar o data warehouse.
Depois de excluir projetos, mova os relatórios que a coleção dividida usa para uma pasta diferente e exclua-os da pasta original.
Importante
As pastas de relatório existem em ambos os locais. Mova todos os relatório adequadamente antes de excluir quaisquer pastas de relatório.
Dividir relatórios em pastas separadas
- No Report Manager, mova os relatórios que oferecem suporte à coleção dividida para as pastas adequadas para essa coleção. Para obter mais informações, consulte Página Mover Itens.
Depois de dividir os relatórios e iniciar ambas as coleções, recompile o warehouse para o Azure DevOps e o banco de dados do Analysis Services. Realize esta etapa para garantir que os relatórios e painéis funcionem corretamente para a implantação depois de dividir a coleção e que não ocorram conflitos com outras coleções na implantação.
Recompilar o data warehouse e o banco de dados do Analysis Services
Abra o console de administração do Azure DevOps.
Na barra de navegação, selecione Relatórios.
Em Relatórios, selecione Iniciar Recompilação.
Na caixa de diálogo Recompilar os Bancos de Dados do Warehouse e do Analysis Services , selecione OK.
Observação
Os depósitos continuarão sendo recompilados e os dados continuarão sendo preenchidos novamente após a ação de Iniciar recompilação ser concluída. Dependendo do tamanho da implantação e da quantidade de dados, todo o processo pode levar várias horas para ser concluído.