Gestione di istanze

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

Visualizza la documentazione di Apigee Edge.

Un'istanza è una macchina virtuale in cui vengono archiviati il progetto API e i servizi correlati. Le istanze corrispondono alle regioni. In genere, inizi con una singola istanza e aggiungine di nuove man mano che la tua organizzazione si espande in altre regioni. Questa sezione spiega come:

Crea una nuova istanza

Per creare una nuova istanza, puoi utilizzare l'API Instances o l'interfaccia utente di Apigee. Ogni istanza richiede:

  • la propria chiave di crittografia del disco per la rete. Apigee consiglia di creare anche un keyring separato per la nuova istanza. Per ulteriori informazioni, consulta Informazioni sulle chiavi di crittografia Apigee.
  • i propri intervalli CIDR /22 e /28 non sovrapposti per il peering di rete. Gli intervalli non possono essere condivisi tra le istanze.

Apigee nella console Cloud

Per creare una nuova istanza in Apigee nella console Cloud:

  1. Apri la UI di Apigee nella console Cloud nel browser.

  2. Seleziona Gestione > Istanze. Il riquadro Istanze mostra un elenco delle istanze esistenti.

  3. Fai clic su + Crea. Potrebbe verificarsi un ritardo mentre l'interfaccia utente determina se la tua organizzazione dispone dei diritti appropriati per creare una nuova istanza.

    Viene visualizzata la pagina Crea nuova istanza.

  4. Inserisci i dettagli della nuova istanza nei campi:
    Campo Obbligatorio Descrizione
    Runtime hosting location Obbligatorio Seleziona la regione in cui vuoi creare la nuova istanza. Non puoi creare una nuova istanza in una regione che ne ha già una. Per ulteriori informazioni su come lavorare con più regioni, consulta Utilizzare più regioni.
    Name Obbligatorio

    Inserisci l'ID della nuova istanza.

    Il valore predefinito è il nome della regione di hosting del runtime selezionata, ma puoi sostituirlo con un nome significativo a tua scelta, purché rispetti le regole di denominazione:

    • Lunghezza minima di 2.
    • Lunghezza massima di 32.
    • Utilizza solo lettere minuscole, numeri e trattini (seguendo il pattern /^[a-z0-9\-]+$/).
    • Deve iniziare con una lettera e non deve contenere cifre o trattini iniziali.
    • Deve terminare con un numero o una lettera e non deve avere trattini finali.
    • Deve essere univoco all'interno dell'organizzazione.
    IP range allocation Obbligatorio

    Specifica come vuoi allocare un intervallo IP. Scegli tra queste opzioni:

    • Automatico (consigliato): Apigee seleziona un intervallo CIDR disponibile con una dimensione del prefisso di /22. Non sono necessarie altre azioni da parte tua.
    • Personalizzato: nei casi d'uso avanzati, potrebbe essere necessario specificare esattamente quale intervallo IP vuoi che venga utilizzato da Apigee. In questi casi, devi specificare un intervallo IP personalizzato che deve avere una dimensione del prefisso di /22. L'intervallo deve essere disponibile nell'ambito di una connessione privata tra il tuo progetto e Apigee.
    Disk encryption key Obbligatorio

    In Chiave di crittografia del disco, scegli una chiave di crittografia gestita dal cliente. Se esiste già una chiave, puoi sceglierla. La procedura guidata elenca tutte le chiavi nella stessa posizione della regione di hosting del runtime in tutti i keyring. Se una chiave non esiste o se non vuoi utilizzare una chiave esistente, puoi crearne una nuova dalla procedura guidata. Per creare una chiave:

    1. Fai clic su Crea chiave.
    2. Seleziona un mazzo di chiavi o, se non esiste, attiva Crea mazzo di chiavi, inserisci un nome e scegli una posizione. I nomi dei keyring possono contenere lettere, numeri, trattini bassi (_) e trattini (-). Non è possibile rinominare o eliminare i keyring.
    3. Fai clic su Continua.
    4. Crea una chiave. Inserisci un nome e un livello di protezione. Tieni presente che i nomi delle chiavi possono contenere lettere, numeri, trattini bassi (_) e trattini (-). Non è possibile rinominare o eliminare le chiavi. Per il livello di protezione, Software è una buona scelta. Si tratta dello stesso valore predefinito utilizzato da Cloud KMS. Tuttavia, se vuoi, puoi modificarlo.
    5. Fai clic su Continua ed esamina le selezioni.
    6. Fai clic su Crea.
    7. Fai clic su Concede per concedere all'account di servizio l'autorizzazione per criptare/decriptare con la chiave selezionata.
    Environments Facoltativo

    Seleziona gli ambienti da collegare a questa istanza. A questo scopo, fai clic sull'elenco a discesa Ambienti e seleziona le caselle di controllo accanto agli ambienti da collegare. Puoi eseguire questa operazione per quanti ambienti vuoi. Quindi, fai clic su Ok.

    Tieni presente che tutti gli ambienti delle istanze vengono conteggiati ai fini del numero totale di ambienti che puoi allocare. Per saperne di più, consulta Informazioni su ambienti e gruppi di ambienti.

    L'aggiunta di ambienti durante la creazione di una nuova istanza è facoltativa. Se non li aggiungi subito, puoi utilizzare l'API di creazione degli allegati delle istanze o la UI per aggiungerli e rimuoverli in un secondo momento. Consulta Collegare o rimuovere un ambiente.
    Accepted projects Facoltativo Fai clic su Aggiungi progetto accettato per selezionare uno o più progetti Cloud. I progetti selezionati possono connettersi in modo privato al collegamento al servizio per la tua istanza. Per impostazione predefinita, il progetto associato alla tua organizzazione Apigee è incluso in questo elenco.
    Enable logging Facoltativo Fai clic sul pulsante di attivazione/disattivazione Abilita il logging per attivare i log di accesso in entrata di Cloud Logging per l'istanza. Questa funzionalità ti consente di visualizzare i log generati dai gateway di ingresso nella tua infrastruttura Apigee, ad esempio un bilanciatore del carico delle applicazioni esterno o un gateway Anthos, per aiutarti a risolvere i problemi relativi alle chiamate dell'API Apigee.

    Per ulteriori informazioni, consulta Generare log di accesso di Apigee
    Filter Facoltativo Seleziona un codice di risposta HTTP dalla casella codice di risposta da utilizzare come filtro per i log di accesso in entrata.

    Se vuoi includere tutti i log, indipendentemente dal codice di risposta HTTP, seleziona None (all HTTP responses).

    Per creare un filtro personalizzato, seleziona Custom e inserisci il filtro nel seguente formato:

    status_code > XX && status code <= YY

    Ad esempio:

    status_code >= 500 && status_code < 504

    Se la tua organizzazione non è in grado di creare una nuova istanza, contatta il team di vendita di Apigee.

  5. Fai clic su Crea.

    Apigee avvia un'operazione a lunga esecuzione che può richiedere almeno 20 minuti. Al termine, la nuova istanza verrà visualizzata nell'elenco delle istanze nell'interfaccia utente Istanze.

API Apigee

Se il provisioning di Apigee è stato eseguito senza il peering VPC, consulta Creare un'istanza di runtime nei passaggi di provisioning del peering non VPC.

Se è stato eseguito il provisioning di Apigee con il peering VPC, consulta Creare un'istanza di runtime nei passaggi di provisioning del peering VPC.

Collega o rimuovi ambienti da un'istanza

Quando crei un ambiente utilizzando l'interfaccia utente di Apigee nella console Google Cloud, hai la possibilità di assegnarlo a un'istanza esistente. Per ulteriori informazioni, consulta Creare un nuovo ambiente nell'interfaccia utente.

Se non hai collegato il tuo ambiente a un'istanza durante la creazione o vuoi rimuovere un ambiente da un'istanza, puoi seguire questi passaggi. Per ulteriori informazioni su ambienti e istanze, consulta Ambienti e istanze.

Per collegare o rimuovere un ambiente da un'istanza utilizzando Apigee nella console Cloud:

  1. Apri la UI di Apigee nella console Cloud nel browser.
  2. Seleziona Gestione > Istanze.

  3. Fai clic sull'istanza da modificare.

  4. Nella pagina Dettagli istanza, fai clic su Modifica.
  5. Nella pagina Modifica istanza, fai clic sul campo Ambienti (facoltativo) e seleziona l'ambiente da collegare all'istanza o deseleziona l'ambiente da rimuovere.
  6. Fai clic su OK.
  7. Fai clic su Salva per salvare le modifiche.

Oltre a utilizzare l'interfaccia utente, puoi anche collegare gli ambienti a un'istanza utilizzando l'API Create Instances Attachment. Per un esempio, consulta Creare un ambiente nella documentazione di provisioning della riga di comando.

Modificare l'elenco dei progetti accettati

Puoi aggiungere o rimuovere progetti dall'elenco Progetti accettati:

  1. Apri la UI di Apigee nella console Cloud nel browser.
  2. Seleziona Gestione > Istanze.

  3. Fai clic sull'istanza da modificare.

  4. Nella pagina Dettagli istanza, fai clic su Modifica.
  5. Nella sezione Progetti accettati della pagina Modifica istanza, fai clic sull'icona Elimina accanto a un progetto per rimuoverlo. Per aggiungere un progetto, fai clic su Aggiungi progetto accettato e inserisci l'ID del progetto da aggiungere.
  6. Fai clic su Salva per salvare le modifiche.

Attivare o disattivare i log di accesso in entrata per un'istanza

Dopo aver creato un'istanza, puoi attivare e disattivare i log di accesso in entrata di Cloud Logging per l'istanza:

  1. Apri la UI di Apigee nella console Cloud nel browser.
  2. Seleziona Gestione > Istanze.

  3. Fai clic sull'istanza da modificare.

  4. Nella pagina Dettagli istanza, fai clic su Modifica.
  5. nella pagina Modifica istanza, fai clic sul pulsante di attivazione/disattivazione Abilita il logging per disattivare la funzionalità.
  6. Fai clic su Salva per salvare le modifiche.

Elimina un'istanza

Puoi utilizzare l'interfaccia utente di Apigee nella console Cloud per eliminare un'istanza esistente, come descritto in questa sezione. In alternativa, puoi eliminare un'istanza utilizzando l'API Instances.

In una determinata regione Google Cloud può essere presente una sola istanza Apigee. Quando elimini un'istanza, questa viene rimossa completamente dalla regione. Vedi anche l'installazione multi-regione.

Avviso: quando elimini un'istanza, tutti i dati associati vengono persi. Questo passaggio non può essere annullato. Tieni presente, tuttavia, che se hai più istanze, ad esempio in un'installazione multiregione, i dati andranno persi solo se elimini tutte le istanze. Prima di eliminare l'ultima istanza, assicurati di estrarre e eseguire il backup di tutti i dati che non vuoi perdere.

I seguenti dati vengono archiviati in un'istanza Apigee e verranno eliminati se elimini l'istanza:

Tipo di dati Descrizione
Sistema di gestione delle chiavi (KMS) I dati KMS includono prodotti API, sviluppatori, app per sviluppatori, token OAuth (inclusi token di accesso, token di aggiornamento e codici di autorizzazione) e chiavi API. Utilizza il criterio AccessEntity o l'API Apigee correlata per recuperare i dati che vuoi salvare.
Mappa chiave-valore (KVM) Qualsiasi dato che può essere creato o gestito con i criteri KVM. Vedi Recupero delle KVM.
Quota Definizioni di quote, bucket e contatori.
Cache dell'ambiente Tutti i dati memorizzati nella cache.

Per eliminare un'istanza Apigee utilizzando l'interfaccia utente di Apigee nella console Cloud:

  1. Apri la UI di Apigee nella console Cloud nel browser.

  2. Seleziona Gestione > Istanze.

  3. Fai clic sull'istanza che vuoi eliminare.
  4. Nella pagina Dettagli istanza, fai clic su Elimina.