Pós-importação

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Depois que uma importação bem-sucedida for concluída, uma organização estará pronta para uso. No entanto, antes de disponibilizá-lo para todos os usuários, há várias tarefas comuns que você deve concluir. Confira a lista a seguir das tarefas mais típicas que devem ser concluídas após a importação, na ordem recomendada de execução.

Observação

Recomendamos que você use o Guia de Migração para progredir por meio de sua importação. O guia vincula-se à documentação técnica conforme necessário.

Com o lançamento do Azure DevOps Server 2019, o Serviço de Importação de Banco de Dados TFS foi renomeado para se tornar uma ferramenta de migração de dados para o Azure DevOps. Isso inclui tfsMigrator se tornando a ferramenta de migração de dados ou migrador para abreviar. Esse serviço ainda funciona exatamente da mesma forma que o antigo Serviço de Importação. Se você estiver em uma versão mais antiga do local com o TFS como a identidade visual, ainda poderá usar esse recurso para migrar para o Azure DevOps, desde que você atualize para uma das versões com suporte.

Imediatamente após a importação

Imediatamente após a organização ficar disponível, pegue uma pequena equipe e execute verificações pontuais na organização. Recomendamos que essa equipe seja composta pelos administradores da coleção de projetos. Essa não deve ser uma verificação detalhada, mas sim garantir que as principais peças de sua coleção sejam trazidas. O código-fonte foi importado? Você está vendo seu histórico de build? Todos os nossos caminhos de área ainda estão presentes? É melhor confirmar se esses artefatos estão presentes antes de abrir a organização para toda a sua base de usuários.

Depois de verificar a organização, considere se deseja renomeá-la. Renomear uma organização é uma operação simples, mas tem grandes impactos sobre os usuários que estão usando a organização no momento. Alguns exemplos são a quebra de conexões do Team Explore ou os indicadores não funcionam mais. Obter uma renomeação fora do caminho enquanto é apenas um pequeno grupo de usuários usando a organização permite que o restante dos usuários entre e configure suas conexões uma vez.

Configurar cobrança

Para pagar usuários ou serviços no Azure DevOps, como agentes de build e implantação hospedados, você precisa configurar a cobrança para sua organização. Se você importar mais de uma coleção, deverá garantir que todas as suas organizações estejam configuradas para cobrança com a mesma assinatura do Azure e que sua assinatura esteja habilitada para cobrança de várias organizações. Em seguida, você pode atribuir quantos usuários básicos precisar gratuitamente durante o mês do calendário no qual você executa a importação.

Gerenciar usuários e acesso

Sua organização inclui cinco usuários gratuitos com acesso Básico . O Básico inclui recursos como o controle de versão do Git e do Team Foundation, ferramentas para o planejamento Agile e equipes Java e muito mais. Além disso, você pode adicionar assinantes do Visual Studio gratuitamente — eles recebem recursos básicos mais outros recursos — com base no nível de assinatura. Além disso, você pode adicionar o Stakeholder gratuitamente, o que permite que eles tenham acesso parcial às ferramentas Agile, criem itens de trabalho e exibam listas de pendências e quadros.

À medida que os assinantes do Visual Studio entrarem na organização, eles são detectados automaticamente. Para todos os outros usuários, você precisa atribuir acesso pago. Tenha em mente que, se você automatizar o acesso usando regras de grupo, as regras só se aplicarão aos usuários existentes se você remover atribuições diretas, que foram aplicadas aos usuários durante a importação.

Alteração de comportamento — a partir de 13 de novembro de 2019, o comportamento de acesso padrão para importações será alterado. Anteriormente, todas as importações tentavam dar aos usuários um nível de acesso equivalente após a importação. Isso significa que os usuários que tinham o Basic receberam acesso Básico e outros usuários começaram com o acesso de Stakeholders . Depois que essa alteração acontecer, todos os usuários começarão com acesso gratuito aos stakeholders . Você continuará a ser capaz de atribuir acesso básico a todos os usuários que precisam dele sem custo, até o final do mês do calendário durante o qual a importação é executada. Se você tiver dúvidas ou preocupações sobre essa alteração, fique à vontade para entrar em contato conosco.

Compilações

Em seguida, você deseja configurar seus agentes de build. Como parte da migração, todos os pipelines de build foram trazidos, mas agentes e pools precisam ser reconfigurados em relação à nova organização. O Azure DevOps oferece a capacidade de usar um pool hospedado pela Microsoft de agentes de build que você pode usar ou você pode conectar seus agentes de build auto-hospedados. É importante observar que apenas um agente de build auto-hospedado está incluído gratuitamente. Depois disso, há uma taxa para ter mais agentes de build auto-hospedados. Para pagar por agentes de build hospedados pela Microsoft e auto-hospedados, você precisa vincular uma assinatura à sua organização. Consulte os seguintes recursos para obter detalhes sobre como executar esta tarefa:

Se você planeja usar seus agentes de build privados locais existentes, há mais uma etapa recomendada que precisa ser executada depois de registrá-los em sua nova organização. Limpar o cache garante que você não encontre problemas de build relacionados a ponteiros TFVC ou Git mais antigos para sua coleção local. Consulte atualizando caches em computadores cliente para obter detalhes sobre como realizar essa tarefa.

Gerenciamento de liberações

Se você usou Release Management em Azure DevOps Server, os pipelines de lançamento e os dados de histórico serão incluídos na sua importação. No entanto, como builds, você precisa reconfigurar seus agentes e pools em relação à nova organização.

Azure Artifacts

O Azure Artifacts está incluído com Azure DevOps Services para todos os usuários que receberam uma licença Básica. Não é necessário instalar uma extensão. Os dados do Azure Artifacts devem estar disponíveis após a importação.

Azure Boards

Se você tiver uma conexão existente do GitHub Enterprise Server associada à sua Azure DevOps Server, ela não funcionará conforme o esperado. As menções de item de trabalho, no GitHub, podem estar atrasadas ou nunca aparecer em Azure DevOps Services. Esse problema ocorre porque a URL de retorno de chamada associada ao GitHub não é mais válida.

Para resolver o problema, considere os seguintes itens:

  • Remova e recrie a conexão: remova e recrie a conexão com o repositório GitHub Enterprise Server. Siga a sequência de etapas fornecidas na documentaçãoConectar pelo Azure Boards.

  • Corrigir a URL do webhook: vá para a página de configurações do repositório do GitHub e edite a URL do webhook para apontar para a URL da organização Azure DevOps Services migrada:https://dev.azure.com/{OrganizationName}/_apis/work/events?api-version=5.2-preview

Notificar suas equipes

Depois que seus builds estiverem em execução e a assinatura de licença estiver configurada, recomendamos que você abra a organização para todos os usuários para validação. Em seguida, os usuários individuais podem garantir que todo o conteúdo esteja em vigor, eles tenham o nível de acesso certo e que possam efetuar pull de código. Certifique-se de apontar os usuários para nossa documentação sobre como se conectar a Azure DevOps Services de todos os nossos IDEs com suporte e o Team Explorer.

Os usuários do TFVC com workspaces locais precisam remapear seus workspaces em relação à nova organização e os usuários do Git precisam reconfigurar seus controles remotos para poder efetuar pull de código.

Se algo for relatado como ausente da organização migrada, entre em contato com AzureDevOpsImport@microsoft.com. Para outros problemas funcionais, entre em contato com o suporte ao cliente.