Condividi tramite

Eseguire la migrazione di un'istanza di Gestione API non inserita nella rete virtuale alla piattaforma di calcolo stv2

  • Articolo

SI APPLICA A: Sviluppatore | Basic | Standard | Premium

Questo articolo illustra la procedura per eseguire la migrazione di un'istanza di Gestione API ospitata nella piattaforma di calcolo stv1 sul posto alla piattaforma stv2 quando l'istanza non è inserita (distribuita) in una rete virtuale esterna o interna. Per questo scenario, eseguire la migrazione dell'istanza usando il portale di Azure o l'API REST Migrate to stv2. Scoprire se è necessario eseguire questa operazione.

Se è necessario eseguire la migrazione di un'istanza di Gestione API inserita nella rete virtuale ospitata nella piattaforma stv1, vedere Eseguire la migrazione di un'istanza di Gestione API inserita nella rete virtuale alla piattaforma stv2.

Importante

Il supporto per le istanze di Gestione API ospitate nella piattaforma stv1 verrà ritirato. In Azure globale, la data di ritiro è il 31 agosto 2024. In Azure per enti pubblici e in Azure gestito da 21Vianet (Azure in Cina), la data di ritiro è il 24 febbraio 2025. Se sono presenti istanze ospitate sulla piattaforma stv1, eseguirne la migrazione sulla piattaforma stv2 prima della data di ritiro per evitare interruzioni del servizio.

Attenzione

  • La migrazione dell'istanza di Gestione API alla nuova infrastruttura è un'operazione che richiede tempo.
  • A seconda del processo di migrazione, potrebbe verificarsi un tempo di inattività momentaneo durante la migrazione e potrebbe essere necessario aggiornare le dipendenze di rete dopo la migrazione per raggiungere l'istanza di Gestione API. Pianificare la migrazione di conseguenza.
  • La migrazione a stv2 non è reversibile.

Cosa accade durante la migrazione?

La migrazione della piattaforma Gestione API da stv1 a stv2 comporta l'aggiornamento del solo calcolo sottostante e non ha alcun impatto sulla configurazione del servizio o dell'API conservata nel livello di archiviazione. Per un'istanza non distribuita in una rete virtuale:

  • È possibile scegliere se l'indirizzo VIP dell'istanza cambierà o se l'indirizzo VIP originale verrà mantenuto.
  • Il processo di aggiornamento comporta la creazione di un nuovo calcolo in parallelo al calcolo precedente.
  • Lo stato di Gestione API nel portale sarà Aggiornamento in corso.
  • Se si sceglie di mantenere l'indirizzo VIP, la migrazione include un passaggio aggiuntivo per spostare l'indirizzo VIP dalla piattaforma di calcolo precedente alla nuova piattaforma di calcolo, durante il quale le API non risponderanno.
  • Azure gestisce il DNS dell'endpoint di gestione e gli aggiornamenti al nuovo calcolo immediatamente dopo il completamento della migrazione.
  • Il gateway predefinito e il DNS del portale puntano immediatamente alla nuova piattaforma di calcolo.
  • Se si sceglie che l'istanza di Gestione API riceva un nuovo indirizzo VIP, è necessario aggiornare le dipendenze di rete per usare il nuovo indirizzo VIP.

Prerequisiti

Eseguire la migrazione dell'istanza alla piattaforma stv2

Opzioni per l'indirizzo IP pubblico

È possibile scegliere se l'indirizzo IP virtuale di Gestione API cambierà o se l'indirizzo VIP originale verrà mantenuto.

  • Nuovo indirizzo IP virtuale: se si sceglie questa modalità, le richieste API rimangono reattive durante la migrazione. La configurazione dell'infrastruttura (ad esempio domini personalizzati, percorsi e certificati CA) verrà bloccata per 30 minuti. Dopo la migrazione, sarà necessario aggiornare eventuali dipendenze di rete, tra cui DNS, regole del firewall e reti virtuali in modo che usino il nuovo indirizzo VIP.

  • Mantieni l'indirizzo IP: se si mantiene l'indirizzo VIP, le richieste API non risponderanno per circa 15 minuti mentre viene eseguita la migrazione dell'indirizzo IP alla nuova infrastruttura. La configurazione dell'infrastruttura (ad esempio domini personalizzati, percorsi e certificati della CA) verrà bloccata per 45 minuti. Non sono necessarie altre configurazioni dopo la migrazione.

Indirizzo IP precreato per la migrazione

Per le istanze di Gestione API raggiungibili tramite un indirizzo IP pubblico, Gestione API precrea un indirizzo IP pubblico per il processo di migrazione. Trovare l'indirizzo IP precreato nell'output JSON delle proprietà della tua istanza di Gestione API. In customProperties, l'indirizzo IP precreato è il valore della proprietà Microsoft.WindowsAzure.ApiManagement.Stv2MigrationPreCreatedIps. Per una distribuzione multi-area, il valore è un elenco delimitato da virgole di indirizzi IP creati in precedenza.

Usare l'indirizzo IP precreato (o gli indirizzi) per gestire il processo di migrazione:

  • Quando si esegue la migrazione e si mantiene l'indirizzo VIP, l'indirizzo IP precreato viene assegnato temporaneamente alla nuova distribuzione stv2, prima che l'indirizzo IP originale venga assegnato alla distribuzione stv2. Ad esempio, se sono presenti regole del firewall che limitano l'accesso all'istanza di Gestione API, ad esempio è possibile aggiungere l'indirizzo IP precreato all'elenco consentiti per mantenere la continuità dell'accesso client durante la migrazione. Al termine della migrazione, è possibile rimuovere l'indirizzo IP precreato dall'elenco elementi consentiti.
  • Quando si esegue la migrazione e si genera un nuovo indirizzo VIP, l'indirizzo IP precreato viene assegnato alla nuova distribuzione stv2 durante la migrazione e viene mantenuto al termine della migrazione. Usare l'indirizzo IP precreato per aggiornare le dipendenze di rete, ad esempio le regole DNS e firewall, in modo che puntino al nuovo indirizzo IP.

Passaggi per la migrazione

  1. Nel portale di Azure accedere all'istanza di Gestione API.

  2. Nel menu a sinistra, in Impostazioni, selezionare Migrazione della piattaforma.

  3. Nella pagina Migrazione della piattaforma selezionare una delle due opzioni di migrazione:

    • Nuovo indirizzo IP virtuale. L'indirizzo VIP dell'istanza di Gestione API cambierà automaticamente. Non si verificherà alcun tempo di inattività per il servizio, ma dopo la migrazione, sarà necessario aggiornare eventuali dipendenze di rete, tra cui DNS, regole del firewall e reti virtuali in modo che usino il nuovo indirizzo VIP.

    • Mantieni l'indirizzo IP: l'indirizzo VIP dell'istanza di Gestione API non cambia. Si verificherà un tempo di inattività fino a 15 minuti per l'istanza.

      Screenshot della migrazione della piattaforma Gestione API nel portale.

  4. Esaminare le indicazioni per il processo di migrazione e preparare l'ambiente.

  5. Dopo aver completato i passaggi di preparazione, selezionare Ho letto e compreso l'impatto del processo di migrazione. Selezionare Esegui migrazione.

Verificare la migrazione

Per verificare che la migrazione abbia avuto esito positivo, quando lo stato passa a Online, controllare la versione della piattaforma dell'istanza di Gestione API. Al termine della migrazione, il valore è stv2 o stv2.1.

Eseguire il ripristino automatico se la migrazione non riesce

Se si verifica un errore durante il processo di migrazione, l'istanza verrà automaticamente ripristinata alla piattaforma stv1. Se la migrazione ha esito positivo (la versione della piattaforma dell'istanza viene visualizzata come stv2 o stv2.1 e lo stato come Online), non è possibile eseguire il rollback alla piattaforma stv1.

Per assistenza in caso di migrazione non riuscita, contattare il supporto tecnico di Azure.

Se occorre eseguire manualmente il rollback, è consigliabile distribuire una nuova istanza di stv2 affiancata all'istanza originale di Gestione API.

Aggiornare le dipendenze di rete

Dopo una migrazione corretta a un nuovo indirizzo VIP, aggiornare eventuali dipendenze di rete, tra cui DNS, regole del firewall e reti virtuali in modo che usino il nuovo indirizzo VIP.

Assistenza e supporto

Il supporto tecnico è a disposizione per assistere gli utenti nella migrazione alla piattaforma stv2 con interruzioni minime dei servizi.

In caso di domande, è possibile ottenere risposte rapide dagli esperti della community in Microsoft Q&A. Se hai un piano di supporto e ti serve supporto tecnico, crea una richiesta di supporto.

  1. Per il Riepilogo digitare una descrizione del problema, ad esempio "ritiro stv1".
  2. In Tipo di problema, selezionare Tecnico.
  3. In Sottoscrizione selezionare la propria sottoscrizione.
  4. In Servizio selezionare Servizi personali, quindi selezionare Servizio Gestione API.
  5. In Risorsa selezionare la risorsa di Azure per cui si sta creando una richiesta di supporto.
  6. Per Tipo di problema selezionare Amministrazione e gestione.
  7. Per Sottotipo del problema selezionare Aggiorna, Ridimensiona o Modifiche SKU.

Domande frequenti

  • Quali sono le informazioni necessarie per scegliere un percorso di migrazione?

    • Qual è la modalità di rete dell'istanza di Gestione API?
    • I domini personalizzati sono configurati?
    • È coinvolto un firewall?
    • Ci sono dipendenze note eseguite da upstream/downstream sugli indirizzi IP coinvolti?
    • Si tratta di una distribuzione in più aree?
    • È possibile modificare l'istanza esistente o è necessaria una configurazione parallela?
    • Può verificarsi un tempo di inattività?
    • La migrazione può essere eseguita in orario non lavorativo?

  • Quali sono i prerequisiti per la migrazione?

    Per le istanze non inserite dalla rete virtuale, non sono necessari prerequisiti. Se si esegue la migrazione mantenendo l'indirizzo IP pubblico, l'istanza di Gestione API non risponderà per circa 15 minuti. È possibile che non si verifichi alcun tempo di inattività se si sceglie l'opzione Nuovo indirizzo IP virtuale che rende disponibile Gestione API in un nuovo indirizzo IP. Le istanze configurate con un dominio personalizzato che usano un record A e/o hanno dipendenze di rete dall'indirizzo IP virtuale pubblico riscontreranno un tempo di inattività quando viene richiesto un nuovo indirizzo IP virtuale.

  • La migrazione causerà un tempo di inattività?

    Per le istanze non inserite nella rete virtuale, si verifica un tempo di inattività di circa 15 minuti solo se si sceglie di mantenere l'indirizzo IP originale. Non si verifica tuttavia alcun tempo di inattività se si esegue la migrazione con un nuovo indirizzo IP e non si hanno dipendenze di rete dal nuovo indirizzo IP. Le dipendenze di rete includono il nome di dominio personalizzato senza CNAME, l'elenco di indirizzi IP consentiti, le regole del firewall e le reti virtuali.

  • Possono verificarsi perdite di dati o della configurazione durante la migrazione?

    La migrazione da stv1 a stv2 comporta l'aggiornamento della sola piattaforma di calcolo, e il livello di archiviazione interno non viene modificato. Di conseguenza, durante il processo di migrazione tutte le configurazioni sono sicure. Ciò include l'identità gestita assegnata dal sistema, che se abilitata viene mantenuta.

  • Come verificare che la migrazione sia stata completata e completata correttamente?

    La migrazione viene considerata completata e riuscita quando lo stato nella pagina di panoramica è Online e la versione della piattaforma è stv2 o stv2.1. Verificare anche che lo stato della rete nel pannello rete sia verde per tutta la connettività necessaria.

  • È possibile eseguire la migrazione usando il portale?

    Sì, il pannello Migrazione della piattaforma nel portale di Azure illustra la migrazione per le istanze non inserite nella rete virtuale.

  • È possibile mantenere l'indirizzo IP dell'istanza?

    Sì, l'indirizzo IP può essere mantenuto, ma si verifica un tempo di inattività di circa 15 minuti.

  • Esiste un percorso di migrazione per il quale non è necessario modificare l'istanza esistente?

    Sì, è necessaria una migrazione side-by-side. Ciò significa che si crea una nuova istanza di Gestione API in parallelo con l'istanza corrente e si copia la configurazione nella nuova istanza.

  • Cosa accade se la migrazione non riesce?

    Se l'istanza di Gestione API non mostra stv2 o stv2.1 come versione della piattaforma e Online come stato dopo l'avvio della migrazione, probabilmente non è riuscita. Viene eseguito automaticamente il rollback del servizio all'istanza precedente e non vengono apportate modifiche. Se si verificano problemi, ad esempio se lo stato è Aggiornamento in corso per più di 2 ore, contattare il supporto tecnico di Azure.

  • Quali funzionalità non sono disponibili durante la migrazione?

    Per le istanze non inserite nella rete virtuale:

    • Se si è scelto di mantenere l'indirizzo IP originale: le richieste API non rispondono per circa 15 minuti mentre viene eseguita la migrazione dell'indirizzo IP alla nuova infrastruttura. La configurazione dell'infrastruttura (ad esempio domini personalizzati, percorsi e certificati CA) è bloccata per 45 minuti.
    • Se si è scelto di eseguire la migrazione a un nuovo indirizzo IP: le richieste API rimangono reattive durante la migrazione. La configurazione dell'infrastruttura (ad esempio domini personalizzati, percorsi e certificati CA) è bloccata per 30 minuti. Dopo la migrazione, sarà necessario aggiornare eventuali dipendenze di rete, tra cui DNS, regole del firewall e reti virtuali in modo che usino il nuovo indirizzo VIP.

  • Quanto tempo richiederà la migrazione?

    La durata prevista per l'intera migrazione è di circa 45 minuti. Come indicatore per verificare se la migrazione è già stata eseguita, si può controllare se lo stato dell'istanza è di nuovo Online e non In fase di aggiornamento. Se viene indicato Aggiornamento in corso per più di 2 ore, contattare il supporto tecnico di Azure.

  • Se necessario, è possibile eseguire il rollback della migrazione?

    Se si verifica un errore durante il processo di migrazione, l'istanza eseguirà automaticamente il rollback alla piattaforma stv1. Tuttavia, dopo la corretta migrazione del servizio, non sarà possibile eseguire il rollback alla piattaforma stv1.

  • Sono necessarie modifiche nelle zone DNS private/domini personalizzati?

    Per le istanze non inserite nella rete virtuale, non sono necessarie modifiche se l'indirizzo IP viene mantenuto. Se si è scelto un nuovo indirizzo IP, i domini personalizzati che fanno riferimento all'IP devono essere aggiornati.

  • L'istanza di stv1 viene distribuita in più aree di Azure. Come si esegue l'aggiornamento a stv2?

    Per un'istanza di Gestione API non inserita in una rete virtuale, seguire la procedura di migrazione usando il portale o l'interfaccia della riga di comando di Azure. Verrà eseguita la migrazione di tutte le aree in stv2.

  • Cosa occorre valutare per i gateway self-hosted?

    Non è necessario eseguire alcuna operazione nei gateway self-hosted. È sufficiente eseguire la migrazione delle istanze di Gestione API in esecuzione in Azure interessate dal ritiro della piattaforma stv1. Si noti che potrebbe essere presente un nuovo IP per l'endpoint di configurazione dell'istanza di Gestione API, perciò eventuali restrizioni di rete aggiunte all'IP devono essere aggiornate.

  • Qual è l’impatto della migrazione sul portale per sviluppatori?

    Non c'è alcun impatto sul portale per sviluppatori. Se vengono usati domini personalizzati, il record DNS deve essere aggiornato con l'indirizzo IP effettivo, dopo la migrazione. Tuttavia, se i domini predefiniti sono in uso, vengono aggiornati automaticamente al completamento della migrazione. Durante la migrazione non sono previsti tempi di inattività per il portale per sviluppatori.

  • Una volta eseguita la migrazione a stv2, ci sono impatti sui costi?

    Il modello di fatturazione rimane invariato per stv2 e non verranno addebitati costi aggiuntivi durante e dopo la migrazione.

  • Quali autorizzazioni di controllo degli accessi in base al ruolo sono necessarie per la migrazione da stv1 a stv2?

    L'utente/processo che esegue la migrazione deve avere accesso in scrittura all'istanza di Gestione API.

Contenuto correlato