Partilhar via

Migração do 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 normalmente ocorrem durante cada etapa do processo de migração: Validar, Preparar, Migrar e Confirmar ou Abortar.

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 dos recursos: garanta que todos os recursos permaneçam 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, espessura de rota ou alternância de tráfego para conexões e gateways, pois essas atualizações podem causar falhas de recursos.

  • Migração de gateway sequencial: migre 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, excluir, atualizar ou redefinir manualmente gateways ou suas conexões enquanto eles estiverem ativamente carregando tráfego (estado de administrador habilitado) durante o processo de migração.

  • Verifique a manutenção: evite criar conexões com gateways em manutenção, pois essa operação falha. Quaisquer 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 as fases de migração e suas resoluções

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

Fase de migração Questão Resolução
Validação Os recursos não estão num estado bem-sucedido. Para resolver o problema, execute uma operação GET e SET nos recursos afetados.
Preparação A criação de novos recursos falha. Repita a operação. Se as novas tentativas continuarem a falhar, 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 tente novamente o processo de migração.
Confirmar O gateway antigo permanece habilitado e a etapa de confirmação falha. Repita a etapa de migração. Quando o gateway antigo for desativado 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 anulaçã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
O tamanho sub-rede do gateway é insuficiente 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 orientações, consulte Excluir e recriar uma sub-rede.
Modo de conexão herdado As conexões 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 passos detalhados, consulte Converter as ligações de gateway de ExpressRoute herdadas.
Circuito dedicado incompatível A migração de gateway não pode prosseguir devido a um HSM (Hardware Security Module) dedicado conectado à rede virtual. Para prosseguir com a migração, desaloque o Módulo de Segurança de Hardware (HSM) 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 Solucionar problemas de estado de falha.
Limitação de SKU de gateway padrão Os gateways padrão devem ser atualizados para uma SKU padrão antes da migração para garantir a resiliência da zona. Altere a 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 de modificação do peso da rota Não é permitido ajustar o peso da rota durante a migração. Reverta o peso da rota para seu valor original antes de continuar com o processo de migração.

Cenários sem suporte a serem evitados

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 já contém o número máximo de gateways permitidos. Uma rede virtual não pode ter mais de dois gateways ExpressRoute implementados.
Limite de conexão excedido O gateway existente tem {connectionCount} conexões, que excedem o limite de {circuitLimit} conexões para o novo tamanho do gateway {gatewaySize}. A migração para um gateway com um limite de conexão menor do que o gateway existente não é permitida. Não há suporte para o downgrade do tipo de SKU.
Restrição do FastPath ExpressRouteGatewayByPass não é suportado para o tamanho do gateway {gatewaySize}. Os gateways conectados a conexões com FastPath ativado só podem migrar para SKUs denominados UltraPerf ou ERGW3AZ. Não há suporte para o downgrade do tipo de SKU.
Autorização de circuito revogada A operação falhou para a rede {virtualNetworkName} virtual porque já contém o número máximo de gateways permitidos. Os gateways conectados a circuitos com autorizações revogadas não podem prosseguir com a migração.

Próximos passos

  • Last updated on