Compartilhar via

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

Este artigo fornece uma visão geral dos códigos de erro associados aos fluxos de trabalho de migração de gateway, juntamente com suas causas e resoluções. Problemas que geralmente ocorrem durante cada estágio do processo de migração: 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: evite atualizar 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 gateway: 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: evite criar manualmente, excluir, atualizar ou redefinir 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: evite criar conexões com gateways que passam por manutenção, pois essa operação falha. Todas as conexões com falha devem ser excluídas antes de tentar novamente.

Ao aderir a 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.
Anular** 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 interrupção.

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 Mensagem 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 obter etapas detalhadas, confira Converter conexões herdadas do gateway 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 com 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 Redimensionar 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 à modificaçã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 resultar em falhas de migração e não têm resoluções disponíveis:

Nome do erro Mensagem 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 tem {connectionCount} conexões, o que excede o limite de {circuitLimit} conexões para o novo tamanho {gatewaySize} do gateway. Migrar para um gateway com um limite de conexão menor do que o gateway existente não é permitido. O downgrade do tipo de SKU não é suportado.
Restrição do FastPath O ExpressRouteGatewayByPass não tem suporte para o tamanho {gatewaySize} do gateway. Gateways conectados a conexões habilitadas para FastPath só podem migrar para SKUs UltraPerf ou ERGW3AZ. O downgrade do tipo de SKU não é suportado.
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

  • Last updated on