Migração de Gateway do Azure ExpressRoute – Solução de problemas e práticas recomendadas

Resumo

Este artigo ajuda você a solucionar erros de migração do gateway do Azure ExpressRoute por etapa e a aplicar práticas recomendadas para reduzir falhas. Use-o para resolver problemas durante Validar, Preparar, Migrar e Confirmar ou Anular.

Práticas recomendadas para evitar erros de migração

Siga estas práticas recomendadas para minimizar erros durante o processo de migração do gateway:

  • Manter a integridade do recurso: verifique se todos os recursos permanecem em um estado bem-sucedido durante toda a migração. Evite executar atualizações em recursos relacionados durante o processo.

  • Evite atualizações de propriedade: não atualize propriedades como FastPath, peso da rota ou alternâncias de tráfego para conexões e gateways, pois essas atualizações podem causar falhas de recursos.

  • Migração sequencial de gateways: migre os gateways conectados ao mesmo circuito, um de cada vez. Não há suporte para migrações paralelas no mesmo circuito.

  • Evite alterações manuais: não crie manualmente, exclua, atualize ou redefina gateways ou suas conexões enquanto eles estiverem carregando ativamente o tráfego (estado de administrador habilitado) durante o processo de migração.

  • Verifique se há manutenção: não crie conexões com gateways em manutenção, pois essa operação falha. Você deve excluir todas as conexões com falha antes de tentar novamente.

Seguindo essas práticas, você pode reduzir a probabilidade de encontrar erros durante a migração.

Problemas comuns durante os estágios de migração e suas resoluções

A tabela a seguir descreve os problemas comuns encontrados durante cada estágio de migração e fornece estratégias para resolvê-los:

Estágio de Migração Questão Resolução
Validar Os recursos não estão em um estado bem-sucedido. Para resolver o problema, execute uma operação GET e SET nos recursos afetados.
Preparar Falha na criação de novos recursos. Repita a operação. Se as novas tentativas continuarem falhando, exclua os recursos recém-criados e tente a operação novamente.
Migrar Ambos os gateways permanecem habilitados após uma falha de migração. Redirecione o tráfego de volta para o gateway antigo e repita o processo de migração.
Confirmar O gateway antigo permanece habilitado e a etapa de confirmação falha. Tente novamente a etapa de migração. Depois que o gateway antigo for desabilitado com êxito, exclua o gateway antigo e seus recursos associados.
Abortar A limpeza de recursos falha durante a etapa de anulação. Redirecione o tráfego para o novo gateway e tente novamente a operação de aborto.

Mensagens de erro comuns

A tabela a seguir descreve mensagens de erro comuns encontradas durante o processo de migração, juntamente com suas causas e resoluções:

Cenários com suporte condicional

Esses cenários incluem soluções para evitar falhas e garantir uma migração bem-sucedida.

Nome do erro Message Resolução
Tamanho insuficiente da sub-rede do gateway A rede {vnetName} virtual não tem espaço suficiente para implantar outro gateway. Exclua e recrie o GatewaySubnet como um prefixo /27 ou mais curto (por exemplo, /26 ou /25). Para obter diretrizes, consulte Excluir e recriar uma sub-rede.
Modo de conexão herdado As conexões do ExpressRoute vinculadas ao gateway foram criadas antes de 2017 (modo legado). Exclua e recrie todas as conexões antes de iniciar a migração. Para ver as etapas detalhadas, consulte Converter conexões de gateway herdadas do ExpressRoute.
Circuito dedicado incompatível A migração de gateway não pode continuar devido a um HSM (Módulo de Segurança de Hardware) dedicado conectado à rede virtual. Para continuar com a migração, desaloque o HSM (Módulo de Segurança de Hardware) dedicado. Para obter etapas detalhadas de solução de problemas, consulte Solucionar problemas de HSM dedicado.
Recursos em estado de falha O estágio validado falhará se o gateway ou qualquer recurso conectado, como circuitos, conexões, IPs públicos, VNets ou GatewaySubnet, estiver em um estado de falha. Verifique se todos os recursos estão em um estado bem-sucedido antes de iniciar o processo de migração. Para obter mais informações, consulte Solução de problemas de estado de falha.
Limitação de SKU do gateway padrão Os gateways padrão devem ser atualizados para um SKU Standard antes da migração para garantir a resiliência da zona. Altere o SKU do gateway para Standard antes de prosseguir com a migração. Para obter mais informações, consulte Alterar o tamanho de uma SKU de gateway.
Restrição de configuração do FastPath Não há suporte para habilitar ou desabilitar o FastPath durante a migração. Verifique se o FastPath permanece em sua configuração original antes de prosseguir com a migração.
Restrição de alteração do peso da rota O ajuste do peso da rota durante a migração não é permitido. Reverta o peso da rota para seu valor original antes de continuar com o processo de migração.

Cenários sem suporte para evitar

A tabela a seguir descreve cenários sem suporte que podem causar falhas de migração e não têm resoluções disponíveis:

Nome do erro Message Motivo
Contagem máxima de gateway na VNet atingida A operação falhou para a rede {virtualNetworkName} virtual porque ela já contém o número máximo de gateways permitidos. Uma rede virtual não pode ter mais de dois gateways do ExpressRoute implantados.
Limite de conexão excedido O gateway existente possui {connectionCount} conexões, o que excede o limite de {circuitLimit} conexões para o novo tamanho {gatewaySize} do gateway. Você não pode migrar para um gateway com um limite de conexão menor do que o gateway existente. Não há suporte para o downgrade do tipo SKU.
Restrição do FastPath O ExpressRouteGatewayByPass não é compatível com gateways de tamanho {gatewaySize}. Gateways conectados a conexões habilitadas para FastPath só podem migrar para SKUs UltraPerf ou ERGW3AZ. Não há suporte para o downgrade do tipo SKU.
Autorização de circuito revogada A operação falhou para a rede {virtualNetworkName} virtual porque ela já contém o número máximo de gateways permitidos. Gateways conectados a circuitos com autorizações revogadas não podem continuar com a migração.

Próximas etapas