Condividi tramite

Eseguire la migrazione di un'istanza di Gestione API non inserita nella 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 sulla stv1 piattaforma di calcolo sul posto alla stv2 piattaforma quando l'istanza non viene 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 di migrazione a stv2. Scoprire se è necessario eseguire questa operazione.

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

Importante

Il supporto per le istanze di Gestione API ospitate nella stv1 piattaforma viene 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 28 febbraio 2025. Se sono presenti istanze ospitate nella stv1 piattaforma, eseguirne la migrazione alla stv2 piattaforma 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à temporaneo 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 viene mantenuto.
  • Il processo di aggiornamento comporta la creazione di un nuovo calcolo in parallelo al calcolo precedente.
  • Lo stato Gestione API nel portale verrà aggiornato.
  • Se si sceglie di mantenere l'indirizzo VIP, la migrazione include un passaggio aggiuntivo per spostare l'indirizzo VIP dal calcolo precedente al nuovo 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 al nuovo calcolo.
  • Se si sceglie di fare in modo 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

È possibile scegliere se l'indirizzo IP virtuale di Gestione API cambierà o se l'indirizzo VIP originale viene 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.

  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 verrà modificato automaticamente. Il servizio non avrà tempi di inattività, ma dopo la migrazione sarà necessario aggiornare tutte le dipendenze di rete, tra cui DNS, regole del firewall e reti virtuali per usare il nuovo indirizzo VIP.

    • Mantieni indirizzo IP: l'indirizzo VIP dell'istanza di Gestione API non cambierà. L'istanza avrà tempi di inattività fino a 15 minuti.

      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 aver completato la migrazione a un nuovo indirizzo VIP, aggiornare tutte le dipendenze di rete, tra cui DNS, regole del firewall e reti virtuali per usare 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. Potrebbe non verificarsi un tempo di inattività se si sceglie l'opzione Nuovo indirizzo IP virtuale che rende Gestione API disponibile in un nuovo INDIRIZZO IP. Le istanze configurate con un dominio personalizzato usando un record A e/o con dipendenze di rete dall'indirizzo IP virtuale pubblico avranno un tempo di inattività quando viene richiesto un nuovo indirizzo IP virtuale.

  • La migrazione causerà un tempo di inattività?

    Per le istanze non inserite dalla rete virtuale, si verifica un tempo di inattività di circa 15 minuti solo se si sceglie di mantenere l'indirizzo IP originale. Tuttavia, non si verifica 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 nome di dominio personalizzato senza CNAME, elenco indirizzi IP consentiti, regole del firewall e 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 completa e completata quando lo stato nella pagina di panoramica legge Online insieme alla versione della piattaforma che 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 nelle guide portale di Azure alla 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 per più di 2 ore, contattare supporto tecnico di Azure.

  • Quali funzionalità non sono disponibili durante la migrazione?

    Per le istanze non inserite dalla 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 è indicato l'aggiornamento per più di 2 ore, contattare 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 personalizzate/domini privati?

    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 Gestione API che non si inserisce 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 a 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 richiede l'accesso in scrittura all'istanza di Gestione API.

Contenuto correlato