Compartilhar via


Suporte à migração do Gerenciamento de API do Azure para a zona de disponibilidade

O serviço de Gerenciamento de API oferece suporte a redundância de zona, que oferece 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 instância de Gerenciamento de API (API de Gerenciamento, portal do desenvolvedor, configuração de Git) são replicados em todos os data centers em zonas fisicamente separadas, o que o torna resiliente 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 sobre como configurar o Gerenciamento de API para alta disponibilidade, consulte Garantir a disponibilidade e a 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 levar entre 15 a 45 minutos para serem aplicadas. O gateway de Gerenciamento de API pode continuar a tratar solicitações de API durante esse tempo.

  • 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. Com 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 os endereços IP do Gerenciamento de API.

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

  • Ao habilitar zonas de disponibilidade em uma região, você configura unidades de escala de Gerenciamento de API que podem ser distribuídas uniformemente entre as 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 gera custos adicionais. Para obter detalhes, consulte Preços do Gerenciamento de API.

  • Se você configurou o dimensionamento automático para sua instância de Gerenciamento de API no local primário, 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 do gateway existente não injetado em uma rede virtual

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 em uma rede virtual:

  1. Vá até a sua instância de Gerenciamento de API do Azure no portal do Azure.

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

  3. Na caixa Localização, selecione o local a ser migrado. O local deve dar suporte a zonas de disponibilidade, conforme mencionado anteriormente nos pré-requisitos.

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

  5. Na caixa Zonas de disponibilidade, selecione uma ou mais zonas. O número de unidades selecionadas deve ser distribuído uniformemente entre as 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 depois em Salvar.

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

Local do gateway existente (plataforma stv1) injetada em uma rede virtual

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

  1. Crie uma sub-rede e um endereço IP público no local a fim de migrar para zonas de disponibilidade. Os requisitos em detalhes estão nas diretrizes de rede virtual.

  2. Vá até a sua instância de Gerenciamento de API do Azure no portal do Azure.

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

  4. Na caixa Localização, selecione o local a ser migrado. O local deve dar suporte a zonas de disponibilidade, conforme mencionado anteriormente nos pré-requisitos.

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

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

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

  8. Selecione Aplicar e depois em Salvar.

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

Local do gateway existente (plataforma stv2) injetada em uma rede virtual

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

  1. Crie uma sub-rede e um endereço IP público no local a fim de migrar para zonas de disponibilidade. Os requisitos em detalhes estão nas diretrizes de rede virtual.

  2. Vá até a sua instância de Gerenciamento de API do Azure no portal do Azure.

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

  4. Na caixa Localização, selecione o local a ser migrado. O local deve dar suporte a zonas de disponibilidade, conforme mencionado anteriormente nos pré-requisitos.

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

  6. Na caixa Zonas de disponibilidade, selecione uma ou mais zonas. O número de unidades selecionadas deve ser distribuído uniformemente entre as 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 depois em Salvar.

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.

Novo local do gateway

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

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

  2. Vá até a sua instância de Gerenciamento de API do Azure no portal do Azure.

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

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

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

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

  7. Se a sua instância de Gestão de API for implementada numa rede virtual, utilize as caixas em Rede para selecionar a rede virtual, a sub-rede e o endereço IP público que estão disponíveis no local.

  8. Selecione Adicionar e, depois, Salvar.

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