Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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
- Saiba como igrar usando o portal Azure.
- Saiba como migrar usando o PowerShell.
- Explore as práticas recomendadas para alta disponibilidade.