Compartilhar via

Pré-requisitos de migração completos

À medida que você passa para a segunda fase de migração para Azure DevOps Services com a Ferramenta de Migração de Dados 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 Azure DevOps Server

A Ferramenta de Migração de Dados para Azure DevOps dá suporte às 2 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 é 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 rtw Azure DevOps Server versão.

A Ferramenta de Migração de Dados não dá suporte à migração de versões release candidates do Azure DevOps Server. Se você estiver planejando migrar seu banco de dados de coleção para 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 de Azure DevOps Server anterior 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 de Azure DevOps Server é uma vez a cada três ou quatro meses. O que significa que o suporte para uma determinada versão do Azure DevOps Server para migração para 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 Microsoft Entra ID

Verifique se sua equipe possui um inquilino Microsoft Entra ID funcional para autenticar membros em sua organização do Azure DevOps Services. No Azure DevOps Services, a autenticação de usuário depende de um locatário Microsoft Entra ID, assim como a autenticação de 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 corresponder suas instâncias do Active Directory local com instâncias 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.

Tip

  • Recomendamos que você use o mesmo locatário do Microsoft Entra ID que outros serviços da Microsoft Cloud. Se sua empresa já tiver Microsoft Entra ID, ignore esta etapa.
  • Embora as contas Microsoft (MSAs) funcionem para a autenticação nos serviços do Azure DevOps, elas não podem ser mapeadas durante a migração do banco de dados do Azure DevOps Server.
  • Se o locatário Microsoft Entra tiver a Restrict organization creation policy habilitada, qualquer operação de importação de dados usando a Ferramenta de Migração de Azure DevOps falhará, a menos que o usuário importador seja explicitamente adicionado à lista de permissões. Para garantir uma importação bem-sucedida:
    • Adicione temporariamente o usuário importador à lista de permissões.
    • O usuário adicionado à lista de permissões deve corresponder ao AccountOwner especificado no arquivo import.json usado para a migração.
    • Para obter detalhes sobre como configurar a lista de permissões, consulte Restringir a criação da organização.

Sincronizar identidades e grupos com Microsoft Entra ID Connect

Sincronize sua Active Directory local com Microsoft Entra ID, 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 de Active Directory para definir permissões em sua organização.

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

  1. Utilize a tecnologia Microsoft Entra ID Connect.
  2. Para configurar o Microsoft Entra ID Connect com seu ambiente local, colabore com o departamento de TI, o DevOps Partner, o Microsoft Premier Support ou 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 Azure DevOps Services para usar Microsoft Entra ID visitando esta página. Embora as etapas nesse artigo não se alinhem exatamente com sua migração de banco de dados Azure DevOps Server, ela serve como informações de referência valiosas. A Ferramenta de Migração de Dados estabelece o link com seu locatário do Microsoft Entra ID ao criar a organização no Azure DevOps Services, no início do processo de migração.

Note

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

Baixar Azure DevOps Ferramenta de Migração de Dados

A maior parte do trabalho durante a migração para 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 Azure DevOps Server para 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 Azure DevOps Server.
  • Um vínculo estabelecido entre sua organização do Azure DevOps Services e o 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 de suas camadas de aplicativo Azure DevOps Server.
  3. Descompacte o arquivo. Você também pode executar a ferramenta de um computador diferente sem Azure DevOps Server instalada, se ela puder se conectar ao banco de dados de configuração da instância Azure DevOps Server. 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 precisar executar a ferramenta de um computador diferente do Azure DevOps Server, use o parâmetro /connectionString.

Próxima etapa

Validar e preparar-se para a migração

Conteúdo relacionado

  • Last updated on