Compartilhar via

Pré-requisitos completos para migração

  • Artigo

À medida que você passa para a segunda fase de migração para o Azure DevOps Services com a Ferramenta de Migração de Dados do Azure DevOps, você deve concluir os pré-requisitos para transferir seus dados para a nuvem. Se sua organização já atender a esses pré-requisitos, você poderá ignorar essa fase completamente.

Diagrama destacando o estágio de pré-requisitos em etapas sequenciais.

Atualizar o Servidor do Azure DevOps

A ferramenta de migração de dados para o Azure DevOps oferece suporte às duas versões mais recentes do Azure DevOps Server em um determinado momento. Os lançamentos incluem atualizações e lançamentos principais.

Pode levar até 2 a 3 semanas depois que uma nova versão RTW do Azure DevOps Server for lançada para que o suporte à migração esteja online para essa versão. Considere essa possibilidade quando você optar por atualizar logo após uma nova versão do Servidor rtw do Azure DevOps.

A Ferramenta de Migração de Dados não oferece suporte à migração de candidatos à versão (RC) do Azure DevOps Server. Se você estiver planejando migrar seu banco de dados de coleção para o Azure DevOps Services usando esse serviço, é importante que você não atualize seu banco de dados de produção para uma versão RC. Se você atualizar, deverá aguardar e atualizar para a versão para a Web (RTW) quando ela estiver disponível. Ou restaure uma cópia de backup do banco de dados de uma versão anterior do Servidor do Azure DevOps para migrar. Você não pode fazer downgrade para uma versão anterior do Azure DevOps, mas deve reverter usando um backup do banco de dados nessa versão.

A cadência de versão normal para novas versões do Servidor do Azure DevOps é uma vez a cada três ou quatro meses. O que significa que o suporte para uma determinada versão do Servidor do Azure DevOps para migração para o Azure DevOps Services deve durar entre seis e oito meses. É importante garantir que seu plano leve em consideração essa janela de suporte para evitar ter que realizar uma atualização repentina para migrar.

Implementar o Microsoft Entra ID

Certifique-se de que sua equipe tenha uma instância funcional do Microsoft Entra ID para autenticar membros na organização do Azure DevOps Services. No Azure DevOps Services, a autenticação do usuário depende de um locatário do Microsoft Entra ID, assim como a autenticação do usuário do Azure DevOps Server depende do Active Directory. Durante a fase de execução de teste (link), você verifica um arquivo de log de mapa de identidade para fazer a correspondência entre as organizações do Active Directory local e as organizações do Microsoft Entra ID. Esse arquivo não é usado pelo serviço de migração. Essa ação garante visibilidade do histórico individual, preservação de permissões de segurança e acesso a configurações pessoais.

Dica

  • Recomendamos que você use o mesmo locatário do Microsoft Entra ID que outros serviços da Microsoft Cloud. Se sua empresa já tiver a ID do Microsoft Entra, ignore esta etapa.
  • Embora as contas da Microsoft (MSAs) funcionem para autenticação no Azure DevOps Services, elas não podem ser associadas durante a migração de banco de dados do Azure DevOps Server.

Sincronizar identidades e grupos com o Microsoft Entra ID Connect

Sincronize seu Active Directory local com a ID do Microsoft Entra, para que os membros da equipe possam usar as mesmas credenciais para autenticar. Além disso, os administradores do Azure DevOps Services podem usar seus grupos do Active Directory para definir permissões em sua organização.

Para configurar a sincronização, execute as seguintes etapas:

  1. Utilize a tecnologia do Microsoft Entra ID Connect .
  2. Para configurar o Microsoft Entra ID Connect com seu ambiente local, colabore com seu departamento de TI, o DevOps Partner, o Microsoft Premier Support ou o Microsoft Consulting Services.

Para obter mais informações sobre como configurar o Microsoft Entra ID Connect, consulte Microsoft Entra Connect Sync.

Além disso, explore como você pode configurar o Azure DevOps Services para usar a ID do Microsoft Entra visitando esta página. Embora as etapas nesse artigo não se alinhem exatamente com a migração de banco de dados do Team Foundation Server, ela serve como informações de referência valiosas. A Ferramenta de Migração de Dados estabelece a conexão com o locatário do Microsoft Entra ID durante a criação de sua organização no Azure DevOps Services, no início do processo de migração.

Nota

DirSync foi uma tecnologia predecessora do Microsoft Entra ID Connect. Atualize para o Microsoft Entra ID Connect se você estiver usando DirSync.

Baixar a Ferramenta de Migração de Dados do Azure DevOps

A maior parte do trabalho durante a migração para o Azure DevOps Services é tratada pela Ferramenta de Migração de Dados. A ferramenta é usada com as seguintes etapas de alto nível:

  1. Valide uma coleção de projetos de equipe.
  2. Gere os arquivos usados para personalizar a migração.
  3. Migração de fila de um banco de dados do Azure DevOps Server para o Azure DevOps Services.

Tem os seguintes itens:

  • Função TFSEXECROLE no SQL Server.
  • Permissões para se conectar aos bancos de dados de configuração e de coleção do Servidor do Azure DevOps.
  • Um vínculo estabelecido entre sua organização do Azure DevOps Services e seu tenant do Microsoft Entra ID.

Baixar a ferramenta

  1. Faça o download da versão mais recente da Ferramenta de Migração de Dados.
  2. Copie o arquivo zip para uma das camadas de aplicativo do Servidor do Azure DevOps.
  3. Descompacte o arquivo. Você também pode executar a ferramenta de um computador diferente sem o Servidor do Azure DevOps instalado, se ela puder se conectar ao banco de dados de configuração da instância do Servidor do Azure DevOps. 1.Abra uma janela prompt de comando no servidor e vá para o diretório onde a Ferramenta de Migração de Dados está armazenada.
  4. Examine o conteúdo da ajuda da ferramenta:
    1. Para exibir a ajuda e as diretrizes de nível superior, execute o seguinte comando:
      Migrator /help
    2. Exiba o texto de ajuda para o comando de validação: Migrator validate /help Em sua primeira validação de uma coleção, mantenha-a simples. Seu comando deve ter a seguinte estrutura: Migrator validate /collection:{collection URL} /tenantDomainName:{name} /region:{region}
  5. Substitua {name} pelo nome do locatário do Microsoft Entra. Por exemplo, para executar no DefaultCollection e no locatário fabrikam, o comando seria assim: Migrator validate /collection:[^1^][4] (http://localhost:8080/DefaultCollection) /tenantDomainName:fabrikam.OnMicrosoft.com /region:{region} Se você precisar executar a ferramenta de um computador diferente do Servidor de DevOps do Azure, use o parâmetro /connectionString.

Próximas etapas

Validar e preparar-se para a migração