Ricreazione di un'istanza Apigee senza tempi di inattività

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

Visualizza la documentazione di Apigee Edge.

Questo documento spiega come ricreare un'istanza Apigee senza incorrere in 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 del protocollo internet (IP) sufficiente per consentire lo scalabilità dei carichi di lavoro Apigee per gestire l'aumento del traffico API e/o per consentirti 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 richiesto per il peering della tua rete VPC con Apigee e utilizza IP pubblici utilizzati privatamente (PUPI) per consentire ai carichi di lavoro di scalare 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, la tua istanza potrebbe smettere di ricevere aggiornamenti regolari, il che influirà sui servizi API.

Determinare la data di creazione di un'istanza

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

  1. Elenca i dettagli di 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 dopo questa data, non devi fare altro per quell'istanza.
    • Se un'istanza è stata creata prima del 25 gennaio 2022, ti consigliamo di sostituirla, come descritto in questo documento.

Informazioni sulla procedura di ricreazione

Per ricreare un'istanza con tempi di inattività pari a zero e senza perdita di dati, devi prima creare una nuova istanza in una nuova regione (espansa) e indirizzare il traffico API a questa nuova istanza. Quindi, puoi svuotare l'istanza esistente, eliminarla e ricrearla nella stessa regione di quella che hai eliminato.

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

Prerequisiti

Prima di iniziare i passaggi di ricreazione dell'istanza:

  • Devi avere familiarità con la modalità di creazione dell'istanza Apigee. I passaggi per ricreare l'istanza dipendono dalla 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 appropriato, il tentativo non andrà a buon fine e verrà visualizzato un errore di limite. In questo caso, contatta l'assistenza Apigee per ottenere un'eccezione temporanea per aumentare il limite della tua regione. Se hai già diritto a due o più regioni, ti consigliamo di contattarci per ottenere l'eccezione temporanea ed evitare di eseguire il workload di produzione con un'istanza ridotta durante il processo di ricreazione.
  • Per creare la nuova istanza, il progetto deve avere spazio per intervalli IP aggiuntivi di blocchi /22 e /28. Vedi anche Dimensionamento 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 il blocco /28 che Apigee utilizzerà oppure, se non scegli, 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 aver soddisfatto i prerequisiti.
  2. Scarica gli script da GitHub.
  3. Segui i passaggi descritti nel file README del repository Git per creare la nuova istanza.
  4. Riconfigura le connessioni in entrata e in uscita in modo che puntino alla nuova istanza Apigee. Consulta Informazioni sulle modifiche in uscita e Informazioni sulle modifiche in entrata.

Informazioni sulle modifiche in direzione nord

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

Gli script forniti riconfigurano il backend del bilanciatore del carico per te. Se il routing di rete dell'istanza è stato configurato con un gruppo di istanze gestite (MIG), uno script fornito ricrea il MIG che funge da proxy per il traffico verso l'endpoint Apigee e lo collega 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) per il 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 del nome host in nessun gruppo di ambienti associato alla vecchia istanza.

Modifiche in direzione sud

Il traffico in uscita si riferisce al traffico API da Apigee ai servizi di destinazione del proxy API.

Quando un'istanza viene eliminata e ricreata, tutti gli indirizzi IP NAT in uscita dedicati vengono rilasciati. Pertanto, devi prenotare e attivare nuovi indirizzi IP per il NAT e riconfigurare i firewall/l'inserimento nella lista consentita sugli endpoint di destinazione. Uno degli script forniti gestisce questa riconfigurazione NAT per te, se necessario.