Eseguire la migrazione di Gestione API di Azure al supporto delle zone di disponibilità

Questa guida descrive come abilitare il supporto delle zone di disponibilità per l'istanza di Gestione API. Il servizio di Gestione API supporta la Ridondanza della Zona che offre resilienza e disponibilità elevata a un'istanza del servizio in un'area di Azure specifica. Con la ridondanza della zona, il gateway e il piano di controllo dell'istanza di Gestione API (API di gestione, portale per sviluppatori, configurazione Git) vengono replicati tra i data center in zone separate fisicamente, rendendo l’istanza resiliente a un errore di zona.

In questo articolo verranno illustrate le diverse opzioni previste per la migrazione delle zone di disponibilità. Per informazioni generali su come configurare la Gestione API per la disponibilità elevata, vedere Garantire la disponibilità e l'affidabilità di Gestione API.

Prerequisiti

Requisiti del tempo di inattività

Non sono previsti requisiti di tempo di inattività per nessuna delle opzioni di migrazione.

Considerazioni

  • L'applicazione delle modifiche può richiedere da 15 a 45 minuti. Il gateway di Gestione API può continuare a gestire le richieste API durante questo periodo.

  • Quando viene eseguita la migrazione di una gestione API distribuita in una rete virtuale esterna o interna verso le zone di disponibilità, è necessario specificare una nuova risorsa di IP pubblico. In una rete virtuale interna, l'IP pubblico viene usato solo per le operazioni di gestione, non per le richieste API. Altre informazioni sugli Indirizzi IP di Gestione API.

  • La migrazione alle zone di disponibilità o la modifica della configurazione delle zone di disponibilità attiverà una modifica dell’IP pubblico.

  • Quando si abilitano le zone di disponibilità in un'area, è possibile configurare una serie di unità di scala di Gestione API che possono essere distribuite uniformemente tra le zone. Ad esempio, se si configurano 2 zone, è possibile configurare 2 unità, 4 unità o un altro multiplo di 2 unità. Per l'aggiunta di unità sono previsti costi aggiuntivi. Per i dettagli, vedere Prezzi di Gestione API.

  • Se è stata configurata la scalabilità automatica per l'istanza di Gestione API nella posizione primaria, potrebbe essere necessario modificare le impostazioni di scalabilità automatica dopo aver abilitato la ridondanza della zona. Il numero delle unità di Gestione API nelle regole e nei limiti di scalabilità automatica deve essere un multiplo del numero delle zone.

Opzione 1: eseguire la migrazione della posizione esistente dell'istanza di Gestione API, non inserita nella rete virtuale

Usare questa opzione per eseguire la migrazione di una posizione esistente dell'istanza di Gestione API alle zone di disponibilità quando l’istanza non viene inserita (distribuita) in una rete virtuale.

  1. Nel portale di Azure accedere al servizio di Gestione API.

  2. Selezionare Posizioni nel menu e quindi selezionare la posizione di cui eseguire la migrazione. La posizione deve supportare le zone di disponibilità.

  3. Selezionare il numero di Unità di scala desiderato nella posizione.

  4. In Zone di disponibilità selezionare una o più zone. Il numero di unità selezionate deve essere distribuito uniformemente tra le zone di disponibilità. Ad esempio, se sono state selezionate 3 unità, selezionare 3 zone in modo che ogni zona ospiti un'unità.

  5. Selezionare Applica, quindi selezionare Salva.

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

Opzione 2: eseguire la migrazione della posizione esistente dell'istanza di Gestione API (piattaforma stv1), inserita nella rete virtuale

Usare questa opzione per eseguire la migrazione di una posizione esistente dell'istanza di Gestione API alle zone di disponibilità quando l’istanza è attualmente inserita (distribuita) in una rete virtuale. Quando l'istanza di Gestione API è ospitata nella piattaforma stv1, è necessario seguire i passaggi seguenti. L’esecuzione della migrazione verso le zone di disponibilità prevede che venga eseguita la migrazione anche dell'istanza alla piattaforma stv2.

  1. Creare una nuova subnet e un nuovo IP pubblico nella posizione di cui eseguire la migrazione alle zone di disponibilità. I requisiti dettagliati sono disponibili nel materiale sussidiario sulle reti virtuali.

  2. Nel portale di Azure accedere al servizio di Gestione API.

  3. Selezionare Posizioni nel menu e quindi selezionare la posizione di cui eseguire la migrazione. La posizione deve supportare le zone di disponibilità.

  4. Selezionare il numero di Unità di scala desiderato nella posizione.

  5. In Zone di disponibilità selezionare una o più zone. Il numero di unità selezionate deve essere distribuito uniformemente tra le zone di disponibilità. Ad esempio, se sono state selezionate 3 unità, selezionare 3 zone in modo che ogni zona ospiti un'unità.

  6. Selezionare la nuova subnet e il nuovo IP pubblico nella posizione.

  7. Selezionare Applica, quindi selezionare Salva.

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

Opzione 3: eseguire la migrazione della posizione esistente dell'istanza di Gestione API (piattaforma stv2), inserita nella rete virtuale

Usare questa opzione per eseguire la migrazione di una posizione esistente dell'istanza di Gestione API alle zone di disponibilità quando l’istanza è attualmente inserita (distribuita) in una rete virtuale. Attenersi ai seguenti passaggi quando l'istanza di Gestione API è già ospitata nella piattaforma stv2.

  1. Creare una nuova subnet e un nuovo IP pubblico nella posizione di cui eseguire la migrazione alle zone di disponibilità. I requisiti dettagliati sono disponibili nel materiale sussidiario sulle reti virtuali.

  2. Nel portale di Azure accedere al servizio di Gestione API.

  3. Selezionare Posizioni nel menu e quindi selezionare la posizione di cui eseguire la migrazione. La posizione deve supportare le zone di disponibilità.

  4. Selezionare il numero di Unità di scala desiderato nella posizione.

  5. In Zone di disponibilità selezionare una o più zone. Il numero di unità selezionate deve essere distribuito uniformemente tra le zone di disponibilità. Ad esempio, se sono state selezionate 3 unità, selezionare 3 zone in modo che ogni zona ospiti un'unità.

  6. Selezionare il nuovo IP pubblico nella posizione.

  7. Selezionare Applica, quindi selezionare Salva.

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

Opzione 4. Aggiungere una nuova posizione per l'istanza di Gestione API (con o senza rete virtuale) con zone di disponibilità

Usare questa opzione per aggiungere una nuova posizione all'istanza di Gestione API e abilitare le zone di disponibilità in tale posizione.

Se l'istanza di Gestione API viene distribuita in una rete virtuale nella posizione primaria, assicurarsi di configurare una rete virtuale, una subnet e un IP pubblico in tutte le nuove posizioni in cui si prevede di abilitare la ridondanza della zona.

  1. Nel portale di Azure accedere al servizio di Gestione API.

  2. Selezionare + Aggiungi nella barra superiore per aggiungere una nuova posizione. La posizione deve supportare le zone di disponibilità.

  3. Selezionare il numero di Unità di scala desiderato nella posizione.

  4. In Zone di disponibilità selezionare una o più zone. Il numero di unità selezionate deve essere distribuito uniformemente tra le zone di disponibilità. Ad esempio, se sono state selezionate 3 unità, selezionare 3 zone in modo che ogni zona ospiti un'unità.

  5. Se l'istanza di Gestione API viene distribuita in una rete virtuale, selezionare la rete virtuale, la subnet e l'IP pubblico disponibili nella posizione.

  6. Seleziona Aggiungi e quindi Salva.

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

Passaggi successivi

Altre informazioni su: