Ricreazione di un'istanza Apigee senza tempi di inattività

Questa pagina si applica ad Apigee, ma non ad Apigee ibrido.

Visualizza la documentazione di Apigee Edge.

Questo documento spiega come ricreare un'istanza Apigee senza comportare tempi di inattività della gestione delle API o perdita di dati.

Introduzione

Le istanze Apigee create prima del 25 gennaio 2022 non dispongono di spazio di indirizzi IP (Internet Protocol) sufficiente per consentire la scalabilità dei carichi di lavoro Apigee per gestire l'aumento del traffico API e/o consentire di aggiungere più di 10 ambienti a un'istanza.

Il 24 gennaio 2022, Apigee ha introdotto un miglioramento per risolvere questo problema. Il miglioramento riduce l'intervallo IP necessario per il peering della tua rete VPC con Apigee e utilizza IP pubblici utilizzati privatamente (PUPI) per consentire la scalabilità dei carichi di lavoro fino a limiti più elevati.

Che cosa devi fare

Se hai un'istanza Apigee creata prima del 25 gennaio 2022, Apigee consiglia di sostituirla con una nuova istanza, come spiegato in questo documento. Se non ricrei l'istanza precedente, potresti riscontrare problemi di scalabilità e il numero di ambienti che puoi aggiungere a un'istanza continuerà a essere limitato a 10. Inoltre, l'istanza potrebbe smettere di ricevere aggiornamenti regolari, con un impatto sui servizi API.

Determinare la data di creazione di un'istanza

Per determinare la data di creazione di un'istanza Apigee:

  1. Elenco dettagli per tutte le istanze Apigee nella tua organizzazione: 
    AUTH="Authorization: Bearer $(gcloud auth print-access-token)"

curl -i -X GET -H "$AUTH" \
"https://apigee.googleapis.com/v1/organizations/PROJECT_ID/instances"

    Dove:

    • AUTH è l'intestazione di autenticazione con un token di connessione. Assicurati che il progetto predefinito per gcloud sia impostato su PROJECT_ID.
    • PROJECT_ID è l'ID progetto Cloud che hai creato durante il provisioning di Apigee.

    Esempio di output: 

    {
  "instances": [
    {
      "name": "us-west1",
      "location": "us-west1",
      "host": "10.117.200.2",
      "port": "443",
      "createdAt": "1642698826000",
      "lastModifiedAt": "1655745226000",
      "diskEncryptionKeyName": "projects/myproject/locations/us-west1/keyRings/my-key-ring/cryptoKeys/my-key",
      "state": "ACTIVE",
      "peeringCidrRange": "SLASH_22",
      "runtimeVersion": "1-8-0-apigee-33",
      "ipRange": "10.117.200.0/22,10.81.174.192/28",
      "consumerAcceptList": [
        "myproject"
      ],
      "serviceAttachment": "projects/z11f28c6f3104980e-tp/regions/us-west1/serviceAttachments/apigee-us-west1-lbko"
    }
  ]
}
  2. Per ogni istanza, controlla il valore del campo createdAt decodificando il timestamp Unix per ottenere la data.
    • Se un'istanza è stata creata il 25 gennaio 2022 o in una data successiva, non devi fare altro per questa istanza.
    • Se un'istanza è stata creata prima del 25 gennaio 2022, ti consigliamo di sostituirla, come spiegato in questo documento.

Informazioni sulla procedura di svago

Per ricreare un'istanza senza tempi di inattività e nessuna perdita di dati, devi prima creare una nuova istanza in una nuova regione (espansa) e indirizzare il traffico API alla nuova istanza. Quindi, puoi svuotare l'istanza esistente, eliminarla e ricrearla nella stessa regione di quella eliminata.

Apigee ha fornito un insieme di script che eseguono tutti i passaggi necessari per ricreare e configurare un'istanza. Forniremo un link agli script più avanti in questo documento.

Prerequisiti

Prima di iniziare i passaggi di ricreazione dell'istanza:

  • Innanzitutto, devi sapere come è stata creata l'istanza Apigee. I passaggi per ricreare l'istanza dipendono dalla tua conoscenza dei dettagli sulla configurazione dell'istanza originale.
  • Devi avere il diritto di eseguire il provisioning di Apigee in almeno due regioni. Se non hai la certezza di disporre di diritti sufficienti, segui i passaggi per creare un'istanza in una nuova regione. Se non disponi del diritto corretto, il tentativo non andrà a buon fine con un errore relativo ai limiti. In questo caso, contatta l'assistenza Apigee per ottenere un'eccezione temporanea per aumentare il limite per la regione. Se hai già diritto per due o più regioni, ti consigliamo di contattarci per ottenere l'eccezione temporanea al fine di evitare di eseguire il carico di lavoro di produzione con un'istanza ridotta durante il processo di nuova creazione.
  • Devi avere spazio nel progetto per gli intervalli IP aggiuntivi di blocchi /22 e /28 in modo da creare la nuova istanza. Vedi anche Ridimensionamento della rete. Puoi rilasciare questi intervalli quando la regione aggiuntiva viene eliminata al termine della ricreazione dell'istanza. Tieni presente che il blocco /22 è configurabile da te. Puoi scegliere quale blocco /28 utilizzerà Apigee oppure, se non scegli, il blocco viene assegnato automaticamente da Apigee da qualsiasi blocco disponibile.

Ricreazione dell'istanza

Apigee ha fornito un insieme di script che eseguono tutti i passaggi necessari per ricreare un'istanza.

  1. Assicurati di soddisfare i prerequisiti.
  2. Scarica gli script da GitHub.
  3. Segui i passaggi nel file README del repository Git per creare la nuova istanza.
  4. Riconfigura le connessioni verso nord e sud in modo che puntino alla nuova istanza Apigee. Vedi Informazioni sulle modifiche in direzione nord e Informazioni sulle modifiche in direzione sud.

Informazioni sui cambiamenti nella direzione nord

Il limite nord si riferisce al traffico API da client esterni o interni ad Apigee attraverso un bilanciatore del carico. Quando un'istanza viene eliminata e ricreata, l'indirizzo IP in direzione nord e l'ID di collegamento al servizio Private Service Connect (PSC) dell'istanza cambieranno per la nuova istanza.

Gli script forniti riconfigurano il backend del bilanciatore del carico. Se il routing di rete dell'istanza è stato configurato con un gruppo di istanze gestite, uno script fornito ricrea il gruppo di istanze gestite che inoltra il traffico all'endpoint Apigee e collega il gruppo di istanze gestite come backend al servizio di backend esistente. Se il routing è stato configurato con Private Service Connect (PSC), uno script ricrea il gruppo di endpoint di rete (NEG) al collegamento dell'endpoint di servizio di Apigee e collega il nuovo NEG come backend al servizio di backend esistente.

Tieni presente che non dovrai modificare i record dei nomi host in alcun gruppo di ambienti associato alla vecchia istanza.

Modifiche in direzione sud

Il margine a sud si riferisce al traffico API da Apigee ai servizi di destinazione del proxy API.

Quando un'istanza viene eliminata e ricreata, verranno rilasciati tutti gli indirizzi IP NAT dedicati verso sud. Devi quindi prenotare e attivare nuovi indirizzi IP per il NAT e riconfigurare i firewall o la lista consentita sugli endpoint di destinazione. Uno degli script forniti gestisce questa riconfigurazione NAT automaticamente, se necessario.