Migrar o Gerenciamento de API do Azure para o suporte à zona de disponibilidade

O serviço de Gerenciamento de API do Azure dá suporte à redundância de zona, que fornece resiliência e alta disponibilidade para uma instância de serviço em uma região específica do Azure. Com a redundância de zona, o gateway e o plano de controle da sua instância de Gerenciamento de API (API de gerenciamento, portal do desenvolvedor, configuração Git) são replicados entre datacenters em zonas fisicamente separadas, para que sejam resilientes a uma falha de zona.

Este artigo descreve quatro opções para migrar uma instância de Gerenciamento de API para zonas de disponibilidade. Para obter informações básicas sobre como configurar o Gerenciamento de API para alta disponibilidade, consulte Garantir disponibilidade e confiabilidade do Gerenciamento de API.

Pré-requisitos

Requisitos de tempo de inatividade

Não há requisitos de tempo de inatividade para nenhuma das opções de migração.

Considerações

  • As alterações podem demorar entre 15 a 45 minutos a aplicar. O gateway de Gerenciamento de API pode continuar a lidar com solicitações de API durante esse período.

  • Ao migrar uma instância de Gerenciamento de API implantada em uma rede virtual externa ou interna para zonas de disponibilidade, você deve especificar um novo recurso de endereço IP público. Em uma rede virtual interna, o endereço IP público é usado apenas para operações de gerenciamento, não para solicitações de API. Saiba mais sobre endereços IP do Gerenciamento de API.

  • A migração para zonas de disponibilidade ou a alteração da configuração das zonas de disponibilidade aciona uma alteração de endereço IP público e privado.

  • Ao habilitar zonas de disponibilidade em uma região, você configura unidades de escala de Gerenciamento de API que podem ser distribuídas uniformemente pelas zonas. Por exemplo, se você configurar duas zonas, poderá configurar duas unidades, quatro unidades ou outro múltiplo de duas unidades.

    A adição de unidades implica custos adicionais. Para obter detalhes, consulte Definição de preço do Gerenciamento de API.

  • Se você configurou o dimensionamento automático para sua instância de Gerenciamento de API no local principal, talvez seja necessário ajustar as configurações de dimensionamento automático depois de habilitar a redundância de zona. O número de unidades de gerenciamento de API em regras e limites de dimensionamento automático deve ser um múltiplo do número de zonas.

Local de gateway existente não injetado em uma rede virtual

Para migrar um local existente de sua instância de Gerenciamento de API para zonas de disponibilidade quando a instância não é injetada em uma rede virtual:

  1. No portal do Azure, vá para sua instância de Gerenciamento de API.

  2. No menu Implantação + infraestrutura, selecione Locais.

  3. Na caixa Local, selecione o local a ser migrado. O local deve suportar zonas de disponibilidade, conforme mencionado anteriormente nos pré-requisitos.

  4. Na caixa Unidades, selecione o número de unidades de escala desejado no local.

  5. Na caixa Zonas de disponibilidade, selecione uma ou mais zonas. O número de unidades selecionadas deve ser distribuído uniformemente pelas zonas de disponibilidade. Por exemplo, se você selecionou três unidades, selecione três zonas para que cada zona hospede uma unidade.

  6. Selecione Aplicar e, em seguida, selecione Guardar.

Captura de tela que mostra seleções para migrar um local existente da instância de Gerenciamento de API que não é injetada em uma rede virtual.

Local de gateway existente (plataforma stv1) injetado em uma rede virtual

Para migrar um local existente de sua instância de Gerenciamento de API para zonas de disponibilidade quando a instância estiver atualmente injetada em uma rede virtual e estiver hospedada na plataforma, use as stv1 etapas a seguir. A migração para zonas de disponibilidade também migra a instância para a stv2 plataforma.

  1. Crie uma nova sub-rede e um novo endereço IP público no local para migrar para zonas de disponibilidade. Os requisitos detalhados estão nas orientações de rede virtual.

  2. No portal do Azure, vá para sua instância de Gerenciamento de API.

  3. No menu Implantação + infraestrutura, selecione Locais.

  4. Na caixa Local, selecione o local a ser migrado. O local deve suportar zonas de disponibilidade, conforme mencionado anteriormente nos pré-requisitos.

  5. Na caixa Unidades, selecione o número de unidades de escala desejado no local.

  6. Na caixa Zonas de disponibilidade, selecione uma ou mais zonas. O número de unidades selecionadas deve ser distribuído uniformemente pelas zonas de disponibilidade. Por exemplo, se você selecionou três unidades, selecione três zonas para que cada zona hospede uma unidade.

  7. Nas respetivas caixas em Rede, selecione a nova sub-rede e o novo endereço IP público no local.

  8. Selecione Aplicar e, em seguida, selecione Guardar.

Captura de tela que mostra seleções para migrar um local existente de uma instância de Gerenciamento de API injetada em uma rede virtual.

Local de gateway existente (plataforma stv2) injetado em uma rede virtual

Para migrar um local existente de sua instância de Gerenciamento de API para zonas de disponibilidade quando a instância estiver atualmente injetada em uma rede virtual e já estiver hospedada stv2 na plataforma:

  1. Crie uma nova sub-rede e um novo endereço IP público no local para migrar para zonas de disponibilidade. Os requisitos detalhados estão nas orientações de rede virtual.

  2. No portal do Azure, vá para sua instância de Gerenciamento de API.

  3. No menu Implantação + infraestrutura, selecione Locais.

  4. Na caixa Local, selecione o local a ser migrado. O local deve suportar zonas de disponibilidade, conforme mencionado anteriormente nos pré-requisitos.

  5. Na caixa Unidades, selecione o número de unidades de escala desejado no local.

  6. Na caixa Zonas de disponibilidade, selecione uma ou mais zonas. O número de unidades selecionadas deve ser distribuído uniformemente pelas zonas de disponibilidade. Por exemplo, se você selecionou três unidades, selecione três zonas para que cada zona hospede uma unidade.

  7. Na caixa Endereço IP Público, selecione o novo endereço IP público no local.

  8. Selecione Aplicar e, em seguida, selecione Guardar.

Captura de tela que mostra seleções para migrar um local existente de uma instância de Gerenciamento de API (plataforma stv2) injetada em uma rede virtual.

Nova localização do gateway

Para adicionar um novo local à sua instância de Gerenciamento de API e habilitar zonas de disponibilidade nesse local:

  1. Se sua instância de Gerenciamento de API for implantada em uma rede virtual no local principal, configure uma rede virtual, uma sub-rede e um endereço IP público em qualquer novo local onde você planeja habilitar a redundância de zona.

  2. No portal do Azure, vá para sua instância de Gerenciamento de API.

  3. No menu Implantação + infraestrutura, selecione Locais.

  4. Selecione + Adicionar para adicionar um novo local. O local deve suportar zonas de disponibilidade, conforme mencionado anteriormente nos pré-requisitos.

  5. Na caixa Unidades, selecione o número de unidades de escala desejado no local.

  6. Na caixa Zonas de disponibilidade, selecione uma ou mais zonas. O número de unidades selecionadas deve ser distribuído uniformemente pelas zonas de disponibilidade. Por exemplo, se você selecionou três unidades, selecione três zonas para que cada zona hospede uma unidade.

  7. Se sua instância de Gerenciamento de API for implantada em uma rede virtual, use as caixas em Rede para selecionar a rede virtual, a sub-rede e o endereço IP público disponíveis no local.

  8. Selecione Adicionar e, em seguida, selecione Guardar.

Captura de tela que mostra seleções para adicionar um novo local para uma instância de Gerenciamento de API com ou sem uma rede virtual.