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

Este guia descreve como habilitar o suporte à zona de disponibilidade para sua instância de Gerenciamento de API. O serviço de Gerenciamento de API 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, tornando-o resiliente a uma falha de zona.

Neste artigo, vamos guiá-lo pelas diferentes opções de migração da zona 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

  • Para configurar o Gerenciamento de API para redundância de zona, sua instância deve estar em uma das regiões do Azure com suporte à zona de disponibilidade.

  • Se você ainda não criou uma instância de serviço de Gerenciamento de API, consulte Criar uma instância de serviço de Gerenciamento de API. Selecione a camada de serviço Premium.

  • O serviço de Gerenciamento de API deve estar na camada Premium. Se não estiver, você pode atualizar para o nível Premium.

  • Se sua instância de Gerenciamento de API for implantada (injetada) em uma rede virtual do Azure (VNet), verifique a versão da plataforma de computação (stv1 ou stv2) que hospeda o serviço.

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 um Gerenciamento de API implantado em uma rede virtual externa ou interna para zonas de disponibilidade, um novo recurso de endereço IP público deve ser especificado. Em uma VNet 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.

  • Migrar para zonas de disponibilidade ou alterar a configuração da zona de disponibilidade acionará uma alteração de endereço IP público.

  • Ao habilitar zonas de disponibilidade em uma região, você configura várias unidades de escala de Gerenciamento de API que podem ser distribuídas uniformemente pelas zonas. Por exemplo, se você configurar 2 zonas, poderá configurar 2 unidades, 4 unidades ou outro múltiplo de 2 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.

Opção 1: Migrar o local existente da instância de Gerenciamento de API, não injetado na VNet

Use essa opção para migrar um local existente de sua instância de Gerenciamento de API para zonas de disponibilidade quando ela não for injetada (implantada) em uma rede virtual.

  1. No portal do Azure, navegue até o serviço de Gerenciamento de API.

  2. Selecione Locais no menu e, em seguida, selecione o local a ser migrado. O local deve suportar zonas de disponibilidade.

  3. Selecione o número de unidades de escala desejadas no local.

  4. Em 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 3 unidades, selecione 3 zonas para que cada zona hospede uma unidade.

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

    Screenshot of how to migrate existing location of API Management instance not injected in VNet.

Opção 2: Migrar o local existente da instância de Gerenciamento de API (plataforma stv1), injetada na VNet

Use essa opção para migrar um local existente de sua instância de Gerenciamento de API para zonas de disponibilidade quando ela estiver atualmente injetada (implantada) em uma rede virtual. As etapas a seguir são necessárias quando a instância de Gerenciamento de API está atualmente hospedada na plataforma stv1. A migração para zonas de disponibilidade também migrará a instância para a plataforma stv2.

  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, navegue até o serviço de Gerenciamento de API.

  3. Selecione Locais no menu e, em seguida, selecione o local a ser migrado. O local deve suportar zonas de disponibilidade.

  4. Selecione o número de unidades de escala desejadas no local.

  5. Em 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 3 unidades, selecione 3 zonas para que cada zona hospede uma unidade.

  6. Selecione a nova sub-rede e o novo endereço IP público no local.

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

    Screenshot of how to migrate existing location of API Management instance injected in VNet.

Opção 3: Migrar o local existente da instância de Gerenciamento de API (plataforma stv2), injetada na VNet

Use essa opção para migrar um local existente de sua instância de Gerenciamento de API para zonas de disponibilidade quando ela estiver atualmente injetada (implantada) em uma rede virtual. As etapas a seguir são usadas quando a instância de Gerenciamento de API já está hospedada na plataforma stv2.

  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, navegue até o serviço de Gerenciamento de API.

  3. Selecione Locais no menu e, em seguida, selecione o local a ser migrado. O local deve suportar zonas de disponibilidade.

  4. Selecione o número de unidades de escala desejadas no local.

  5. Em 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 3 unidades, selecione 3 zonas para que cada zona hospede uma unidade.

  6. Selecione o novo endereço IP público no local.

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

    Screenshot of how to migrate existing location of API Management instance (stv2 platform) injected in VNet.

Opção 4. Adicionar novo local para instância de Gerenciamento de API (com ou sem VNet) com zonas de disponibilidade

Use essa opção para adicionar um novo local à sua instância de Gerenciamento de API e habilitar as zonas de disponibilidade nesse local.

Se sua instância de Gerenciamento de API for implantada em uma rede virtual no local principal, certifique-se de configurar 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.

  1. No portal do Azure, navegue até o serviço de Gerenciamento de API.

  2. Selecione + Adicionar na barra superior para adicionar um novo local. O local deve suportar zonas de disponibilidade.

  3. Selecione o número de unidades de escala desejadas no local.

  4. Em 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 3 unidades, selecione 3 zonas para que cada zona hospede uma unidade.

  5. Se sua instância de Gerenciamento de API for implantada em uma rede virtual, selecione a rede virtual, a sub-rede e o endereço IP público disponíveis no local.

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

    Screenshot of how to add new location for API Management instance with or without VNet.

Próximos passos

Saiba mais sobre: