Dividir uma coleção de projetos

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

À medida que sua empresa muda, convém 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 se alinhem com as unidades de negócios em sua organização, e os projetos na coleção agora pertencem a 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 do Azure DevOps Server. Esse cenário requer que você primeiro divida uma coleção e, em seguida, mova uma das coleções resultantes para a implantação do escritório remoto.

  Observação

  Os procedimentos neste artigo suportam apenas a 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:

1. Prepare-se para dividir a coleção

   1. Desanexar a coleção
   2. Fazer backup do banco de dados de coleta

2. Divida a coleção

   1. Restaurar o banco de dados de coleta com um nome diferente
   2. Anexar o banco de dados de coleção original
   3. Anexar o banco de dados de coleção renomeado
   4. Excluir projetos das coleções divididas
   5. Iniciar as coleções

3. Configurar as coleções divididas

   1. Configurar usuários e grupos para as coleções de projetos divididos
   2. Configurar usuários e grupos para projetos nas coleções

Antes de começar

Certifique-se de que você é um administrador nos servidores e no SQL Server e no Azure DevOps Server. Se você não for um administrador, solicite ser adicionado como um.

1-A. Desanexar a coleção

Primeiro, desanexe a coleção da implantação do Servidor de DevOps do Azure no qual ela está sendo executada. Desanexar uma coleção interrompe todos os trabalhos e serviços, bem como o próprio banco de dados de coleta. Além disso, o processo de desanexar copia os dados específicos da coleção do banco de dados de configuração e os salva como parte do banco de dados da coleção de projetos.

Desanexar uma coleção de projetos

1. Abra o console de administração do Azure DevOps no servidor que hospeda a coleção a ser dividida.

2. Selecione Coleções de projeto e, na lista de coleções, selecione a coleção a ser dividida.

   Neste exemplo, o administrador escolhe TestProjects.

   

   Sugestão

   O nome padrão para 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.

3. Na guia Geral , selecione Parar coleta.

   

   A caixa de diálogo Motivo do Status da Coleção do Projeto é aberta. O texto inserido será exibido para seus usuários. Selecione Parar e aguarde até que a coleção pare. Quando for interrompido, seu status será exibido como Offline.

4. Na guia Geral, selecione Desanexar Coleção.

   O Assistente para Desanexar Coleção de Projetos abre-se.

   

5. (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 utilizadores que possam tentar ligar-se a projetos nesta coleção.

6. Na página de revisão das configurações que serão usadas para destacar a coleção de projetos , revise os detalhes. Para alterar as configurações, selecione Anterior . Se estiverem corretas, selecione Verificar.

7. Quando todas as verificações de preparação tiverem sido concluídas com êxito, selecione Desanexar.

8. Na página Monitorizar o progresso da desanexação da coleção de projetos, quando todos os processos tiverem sido concluídos, selecione Avançar.

9. (Opcional) Na página Revisar informações suplementares 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. Fazer backup do banco de dados de coleta

Depois de desanexar a coleção, você deve fazer backup de seu banco de dados antes de restaurar uma cópia para o 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 o 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 plano de backup. Certifique-se de selecionar a versão do SQL Server que corresponde à sua implantação.

  Importante

  Se sua implantação original usava as edições Enterprise ou Datacenter do SQL Server e você deseja restaurar o banco de dados que deseja dividir em um servidor que executa a edição Standard, você deve usar um conjunto de backup que foi feito com a compactação do SQL Server desabilitada. A menos que desative a compactação de dados, não será possível restaurar com êxito os bancos de dados Enterprise ou Datacenter edition para um servidor que executa a edição Standard. Para desativar a compactação, siga as etapas em Desabilitar a compactação de dados do SQL Server em bancos de dados do Azure DevOps .

2-a. Restaurar o banco de dados de coleta

Ao dividir uma coleção, você deve restaurar o backup do banco de dados de coleção para uma instância do SQL Server configurada para dar suporte à implantação do Servidor de DevOps do Azure. Ao restaurar o banco de dados, você deve dar a ele um nome diferente do nome do banco de dados de coleção original.

Sugestão

As etapas abaixo fornecem uma visão geral de como restaurar um banco de dados de coleção de projetos no SQL Server 2012 usando o 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. Certifique-se de selecionar a versão do SQL Server que corresponde à sua implantação.

Restaurar o banco de dados de coleta com um novo nome

1. Abra o SQL Server Management Studio e conecte-se à instância que hospeda o banco de dados para que a coleção de projetos seja dividida.

2. No Pesquisador de Objetos, expanda Bancos de Dados, abra o submenu do banco de dados a ser dividido e selecione Tarefas, Restaurar e Banco de Dados.

   A janela Restaurar banco de dados é aberta na página Geral .

   

3. Em Source, certifique-se de que o banco de dados de 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, este nome é o nome da coleção de projetos divididos. Em Plano de restauração, certifique-se de que os conjuntos de backup a serem restaurados são aqueles para os quais você deseja restaurar. Para se certificar de que estes são conjuntos válidos, selecione Verificar Multimédia de Cópia de Segurança e, em seguida, em Selecionar uma página, selecione Opções.

4. Em Opções de restauração, deixe todas as caixas de seleção em branco. Certifique-se de que o estado de recuperação está definido como RESTORE WITH RECOVERY. Em Tail-Log Backup, desmarque a caixa de seleção Deixar o banco de dados de origem no estado de restauração e selecione OK.

   Sugestão

   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ógicos para refletir o novo nome do banco de dados. Em Selecione uma página, selecione Arquivos, 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. Em seguida, tente a operação de restauração novamente.

2-b. Anexar o banco de dados de coleção original

Depois de restaurar o banco de dados com um nome diferente, reanexe o banco de dados de coleção original à implantação do Servidor de DevOps do Azure.

Anexar a coleção

1. Abra o console de administração do Azure DevOps.

2. Selecione Coleções de Projetos e, em seguida, selecione Anexar Coleção .

   O Assistente para Anexar Coleção de Projetos é aberto.

3. Na página Selecione o banco de dados de coleção de projetos para anexar, na Instância do SQL Server, em , forneça o nome do servidor e a instância que hospeda o banco de dados de coleção, se ainda não estiver listado.

4. Na lista Bancos de dados , selecione o banco de dados de coleção a ser anexado.

   

5. Na página Insira as informações da coleção do projeto, forneça um nome para a coleção em Nome, se ainda não estiver presente. Como esta é a coleção original, você pode optar por deixar o nome igual ao anterior. Em Descrição, opcionalmente, forneça uma descrição da coleção.

6. Na página de Revisão de configurações que serão usadas para anexar a coleção de projetos, reveja as informações.

7. Para alterar as configurações, selecione Anterior . Se todas as configurações estiverem corretas, selecione Verificar.

8. Quando todas as verificações de preparação tiverem sido concluídas com êxito, selecione Anexar.

9. Na página Monitorizar o progresso de anexação da coleção de projetos, quando todos os processos tiverem sido concluídos, selecione Avançar.

10. (Opcional) Na página Rever informações suplementares para esta coleção de projeto, selecione ou anote o local do arquivo de log e feche o assistente.

11. A coleção de projetos aparece na lista de coleções no console de administração. Se o estado de coleta 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 de coleção renomeado

Depois de anexar o banco de dados de coleção original, você deve anexar a coleção renomeada à implantação do Servidor de DevOps do Azure. Quando esta coleção é anexada, ela permanecerá parada. Você não poderá iniciá-lo até que todos os projetos duplicados tenham sido removidos.

Anexar o banco de dados de coleção renomeado

1. Abra o console de administração do Azure DevOps.

2. Selecione Coleções de Projetos e, em seguida, selecione Anexar Coleção para abrir o assistente.

3. Na página Selecione o banco de dados de coleção de projetos a ser anexado , em Instância do SQL Server, 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.

4. Na lista Bancos de dados , selecione o banco de dados de coleção renomeado.

5. Na página Insira as informações da coleção do projeto , insira um nome para a coleção renomeada em Nome que seja diferente 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_.

   

6. (Opcional) Em Descrição, insira uma descrição da coleção.

7. Na página de Revisão de configurações que serão usadas para anexar a coleção de projetos, reveja as informações. Para alterar as configurações, selecione Anterior . Se todas as configurações estiverem corretas, selecione Verificar.

8. Quando todas as verificações de preparação tiverem sido concluídas com êxito, selecione Anexar.

9. Na página Monitorizar o progresso de anexação da coleção de projetos, quando todos os processos tiverem sido concluídos, selecione Avançar.

10. (Opcional) Na página Revisar informações suplementares para esta coleção de projetos , selecione ou anote o local do arquivo de log e feche o assistente.

11. O nome da coleção aparece na lista de coleções no console de administração e seu status deve ser exibido como Offline.

    

12. Para garantir que ambas as coleções tenham IDs exclusivos anexados, no console de administração, aceda a Logs de Eventos e abra os ficheiros de log para ambas as operações de anexação das coleções. Os GUIDs para CollectionProperties não devem corresponder. No caso improvável de os GUIDs CollectionProperties coincidirem, altere o ID para um ID único antes de prosseguir ao executar o comando TFSConfig Collection na segunda coleção com o parâmetro /clone.

2-d. Excluir projetos nas coleções divididas

Agora que você tem duas cópias da coleção anexadas ao Servidor de DevOps do Azure, deve excluir 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 existir em mais de uma coleção. Até excluir todos os projetos duplicados entre as coleções divididas, você não poderá iniciar a coleção renomeada.

Excluir projetos das coleções

1. Abra o console de administração do Azure DevOps.

2. Selecione Coleções de projetos e, na lista de coleções, selecione a coleção de projetos original que você parou para dividi-la.

3. Na guia Projetos , na lista de projetos, selecione um projeto a ser excluído da coleção e selecione Excluir.

   Sugestão

   Você pode selecionar mais de um projeto para excluir ao mesmo tempo.

   

4. Marque a caixa de seleção Excluir dados do espaço de trabalho , deixe a caixa de seleção Excluir artefatos externos desmarcada e selecione Excluir.

   Se a caixa de seleção Excluir artefatos externos 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.)

5. Quando terminar de excluir os projetos que 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.

   

6. 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

1. Abra o console de administração do Azure DevOps.

2. Selecione Coleções de projetos e, na lista de coleções, selecione a coleção que você parou para dividi-la.

3. Na guia Geral , selecione Iniciar coleção.

4. 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 permanecerem no mesmo domínio e você quiser permitir o acesso dos administradores da coleção original a ambas as coleções.

Depois de dividir uma coleção, você deve atualizar os grupos de permissão para ambas as coleções com 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 permanecerem no mesmo domínio e você quiser permitir o acesso dos usuários de projetos na coleção original a ambas as coleções.

Depois de configurar os administradores para ambas as coleções, você ou esses administradores devem configurar o acesso de usuários e grupos aos projetos em cada coleção. Dependendo da sua implantação, você também pode precisar 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órios. Há alguma etapa adicional que eu precise tomar ao dividir coleções?

Um: Sim, você precisará dividir relatórios depois de terminar de excluir projetos para que ambas as coleções tenham um conjunto exclusivo de projetos. Você também precisará reconstruir seu data warehouse.

Depois de excluir projetos, mova os relatórios que a coleção dividida usa para uma pasta diferente e, em seguida, exclua-os da pasta original.

Importante

As pastas de relatório existem em ambos os locais. Certifique-se de mover todos os relatórios adequadamente antes de excluir qualquer pasta de relatório.

Dividir relatórios em pastas separadas

1. No Gerenciador de Relatórios, mova os relatórios que dão suporte à coleção dividida para as pastas apropriadas 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, reconstrua o armazém de dados para o Azure DevOps e a base de dados para o Analysis Services. Você deve executar 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.

Reconstruir o data warehouse e o banco de dados do Analysis Services

1. Abra o console de administração do Azure DevOps.

2. Na barra de navegação, selecione Reporting.

3. Em Relatórios, selecione Iniciar Reconstrução.

4. Na caixa de diálogo Reconstruir o armazém e as bases de dados do Analysis Services, selecione OK.

   Observação

   Os armazéns continuarão a ser reconstruídos e os dados continuarão a ser preenchidos novamente após a ação Iniciar reconstrução. Dependendo do tamanho da sua implantação e da quantidade de dados, todo o processo pode levar várias horas para ser concluído.