Gestione di istanze

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

Visualizza documentazione di Apigee Edge.

Un'istanza è un'istanza in cui sono archiviati il tuo progetto API e i relativi servizi. Le istanze corrispondono alle regioni. In genere, si inizia con una singola istanza e si aggiungono nuove istanze man mano che l'organizzazione si espande. in più regioni. In questa sezione viene spiegato come:

Crea una nuova istanza

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

  • la propria chiave di crittografia del disco per la rete. Apigee ti consiglia e un keyring separato per la nuova istanza. Per ulteriori informazioni, vedi 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 l'UI di Apigee nella console Cloud nel tuo browser.

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

  3. Fai clic su + Crea. Potrebbe verificarsi un ritardo mentre la UI stabilisce 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 un nuovo in una regione in cui è già presente un'istanza. Per ulteriori informazioni sul lavoro con più regioni, consulta la sezione Utilizzo di più regioni.
    Name Obbligatorio

    Inserisci l'ID della nuova istanza.

    Il valore predefinito è il nome dell'hosting del runtime regione selezionata, ma puoi sostituirla con qualsiasi nome significativo tu voglia, purché vengano rispettate le regole di denominazione:

    • Lunghezza minima di 2 caratteri.
    • Lunghezza massima di 32 caratteri.
    • Utilizza solo lettere minuscole, numeri e trattini (che seguono lo schema /^[a-z0-9\-]+$/).
    • Deve iniziare con una lettera; non contenga cifre iniziali o trattini.
    • Deve terminare con un numero o una lettera; non contenga trattini finali.
    • Deve essere univoco nella tua organizzazione.
    IP range allocation Obbligatorio

    Specifica come allocare un intervallo IP. Scegli una delle seguenti opzioni:

    • Automatico (consigliato): Apigee seleziona un intervallo CIDR disponibile con una dimensioni del prefisso pari a /22. Non sono richieste ulteriori azioni da parte tua.
    • Personalizzato: nei casi d'uso avanzati, potresti dover specificare esattamente Intervallo IP che vuoi che Apigee utilizzi. In questi casi, devi specificare un intervallo IP personalizzato, con una dimensione del prefisso pari a /22. La deve essere disponibile come parte 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 una chiave esiste già, puoi sceglilo. La procedura guidata elenca tutte le chiavi nella stessa località della regione che ospita il runtime in tutti i keyring. Se una chiave non o se non vuoi utilizzare una chiave esistente, puoi creare una nuova chiave dalla procedura guidata. Per creare una chiave:

    1. Fai clic su Crea chiave.
    2. Seleziona un keyring oppure, se non ne esiste uno, abilita Crea keyring e inserisci il nome del keyring e scegli la posizione del keyring. I nomi dei keyring possono contenere lettere, numeri trattini bassi (_) e trattini (-). I keyring non possono essere rinominati o eliminati.
    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 (-). Chiavi non possono essere rinominati o eliminati. Per il livello di protezione, il software è un buon scelta. Si tratta dello stesso valore predefinito utilizzato da Cloud KMS. ma puoi modificarlo desiderato.
    5. Fai clic su Continua e rivedi le selezioni.
    6. Fai clic su Crea.
    7. Fai clic su Concedi per concedere all'account di servizio l'autorizzazione per criptare/decriptare con la chiave selezionata.
    Environments Facoltativo

    Seleziona gli ambienti che vuoi collegare a questa istanza. Per farlo, fai clic sul Ambienti e seleziona le caselle di controllo accanto gli ambienti che vuoi collegare. Puoi farlo per tutti gli ambienti che vuoi. Quindi, fai clic su OK.

    Tieni presente che tutte le istanze ambienti nel conteggio totale che puoi allocare. Per ulteriori informazioni, vedi Informazioni sugli ambienti e sui gruppi di ambienti.

    L'aggiunta di ambienti quando crei una nuova istanza è facoltativa. Se non li aggiungi Ora puoi utilizzare l'API InstancesAttach Create o la UI per aggiungere e rimuovere in seguito. Vedi Collegare o rimuovere un ambiente.
    Accepted projects Facoltativo Fai clic su Aggiungi progetto accettato per selezionare uno o più progetti Cloud. La i progetti selezionati possono connettersi privatamente al collegamento al servizio per la tua istanza. Per impostazione predefinita, il progetto associato alla tua organizzazione Apigee è incluso in dall'elenco di lettura.
    Enable logging Facoltativo Fai clic sul pulsante di attivazione/disattivazione Abilita il logging per abilitare i log di accesso in entrata di Cloud Logging per l'istanza. Questa funzionalità consente di visualizzare i log generati dai gateway in entrata nella tua infrastruttura Apigee, ad esempio un bilanciatore del carico delle applicazioni esterno o un gateway Anthos per la risoluzione dei problemi delle chiamate API Apigee.

    Per saperne di più, consulta Logging dei log di accesso di Apigee
    Filter Facoltativo Seleziona un codice di risposta HTTP dalla casella Codice di risposta per agire da 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 può creare una nuova istanza, contatta il team di vendita Apigee.

  5. Fai clic su Crea.

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

API Apigee

Se è stato eseguito il provisioning di Apigee senza peering VPC, vedi Creare un'istanza di runtime nella procedura di provisioning del peering non VPC.

Se è stato eseguito il provisioning di Apigee con il peering VPC, consulta la sezione Creare un'istanza di runtime nella procedura di provisioning del peering VPC.

Collega o rimuovi ambienti da un'istanza

Quando crei un ambiente utilizzando la UI di Apigee nella console Google Cloud, puoi scegliere di assegnare a un'istanza esistente. Per ulteriori informazioni, vedi Creazione di un nuovo ambiente nella UI.

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

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

  1. Apri l'UI di Apigee nella console Cloud nel tuo browser.
  2. Seleziona Gestione &gt; Istanze.

  3. Fai clic sull'istanza che vuoi 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 in cui collega l'istanza 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 la UI, puoi anche collegare gli ambienti a un'istanza utilizzando API di creazione degli allegati delle istanze. Per un esempio, vedi Crea un ambiente nella documentazione sul provisioning della riga di comando.

Modifica l'elenco di progetti accettati

Puoi aggiungere o rimuovere progetti dall'elenco Progetti accettati:

  1. Apri l'UI di Apigee nella console Cloud nel tuo browser.
  2. Seleziona Gestione &gt; Istanze.

  3. Fai clic sull'istanza che vuoi 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.

Abilita o disabilita i log di accesso in entrata per un'istanza

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

  1. Apri l'UI di Apigee nella console Cloud nel tuo browser.
  2. Seleziona Gestione &gt; Istanze.

  3. Fai clic sull'istanza che vuoi 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 disabilitare la funzionalità.
  6. Fai clic su Salva per salvare le modifiche.

Elimina un'istanza

Puoi utilizzare l'UI 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 di Google Cloud può essere presente una sola istanza Apigee. Quando elimini un'istanza, viene completamente rimosso dalla sua regione. Vedi anche installazione in più regioni.

Avviso: quando elimini un'istanza, tutti i dati associati con quell'istanza viene persa. Questo passaggio non può essere annullato. Tieni presente, tuttavia, che se disponi in più istanze, ad esempio in un'installazione multiregionale, i dati andranno persi se elimini tutte le istanze. Prima di eliminare l'ultima istanza, assicurati di estrarre ed eseguire il backup dei dati che non vuoi perdere.

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

Tipo di dati Descrizione
Sistema di gestione delle chiavi (KMS) I dati del 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 le norme AccessEntity o la relativa API Apigee per per recuperare i dati che vuoi salvare.
Mappa valori chiave (KVM) Tutti i dati che possono essere creati o gestiti con i criteri KVM. Consulta Recupero delle KVM.
Quota Definizioni di quota, bucket e contatori.
Cache dell'ambiente Tutti i dati memorizzati nella cache.

Per eliminare un'istanza Apigee utilizzando la UI di Apigee nella console Cloud:

  1. Apri l'UI di Apigee nella console Cloud nel tuo browser.

  2. Seleziona Gestione > Istanze.

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