Utilizzo degli ambienti

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Questa sezione descrive come creare, modificare ed eliminare ambienti con Apigee.

Informazioni sugli ambienti

Un ambiente è un'area isolata all'interno di un'organizzazione in cui è possibile creare ed deploy dei proxy API. Puoi creare un ambiente durante il provisioning e successivamente aggiungere altri ambienti alla tua organizzazione.

Ambienti e istanze

Ogni ambiente deve essere collegato ad almeno un'istanza Apigee. Un'istanza è una macchina virtuale specifica per regione. Se colleghi un ambiente a un'istanza, l'istanza viene caricata, sottoposta a deployment e gestisce i proxy per l'ambiente.

L'istanza o le istanze a cui è collegato un ambiente devono corrispondere alla regione o alle regioni con più traffico per l'ambiente. Puoi aggiungere l'ambiente a un'istanza o spostarlo in un'istanza diversa se più traffico si trova nella regione della nuova istanza.

Per impostare e modificare l'istanza dell'ambiente, vedi Collegamento o rimozione di un ambiente da un'istanza.

Nota: una volta collegati a un'istanza, gli ambienti con pagamento a consumo iniziano a essere soggetti ad addebiti. Potrebbero essere addebitati costi prima dell'inizio del traffico API. Per maggiori informazioni sui prezzi di pagamento a consumo, consulta i prezzi di esempio di pagamento a consumo.

Creazione di ambienti

Puoi creare un nuovo ambiente utilizzando l'interfaccia utente di Apigee o l'API Apigee, come descritto nelle sezioni seguenti. Prima di iniziare, è importante notare che Apigee e Apigee hybrid hanno dei limiti relativi al numero di ambienti e gruppi di ambienti che puoi creare per organizzazione e per regione. Per maggiori dettagli, vedi Limiti: ambiente e organizzazione.

Creazione di un nuovo ambiente nella UI

Nota: è disponibile una nuova versione dell'interfaccia utente di Apigee, integrata con la console Google Cloud. La nuova UI si chiama Apigee nella console Cloud. Le istruzioni nelle prime due schede di seguito spiegano come utilizzare Apigee nella console Cloud o Apigee versione classica.

Apigee nella console Cloud

Per creare un nuovo ambiente in Apigee nella console Cloud:

1. Apri la UI di Apigee nella console Cloud in un browser.
2. Seleziona Gestione > Ambienti nel riquadro di navigazione a sinistra.
3. Nel riquadro Ambienti, fai clic su + Crea ambiente.
4. Nel riquadro Crea un ambiente, inserisci quanto segue:
   • Seleziona il tipo di ambiente: se sei un cliente con pagamento a consumo, fai clic su Seleziona per scegliere il tipo di ambiente da creare: di base, intermedio o completo.

     La selezione del tipo di ambiente non si applica ai clienti con abbonamento e non viene visualizzata nella UI.

   • Nome: il nome dell'ambiente di pubblicità programmatica. Il nome non può essere modificato dopo la creazione.

     Il nome deve contenere da 2 a 32 caratteri, che possono essere lettere minuscole, numeri o trattini. Il nome deve iniziare con una lettera e non può terminare con un trattino. Il nome deve essere diverso da qualsiasi altro nome di ambiente nella tua organizzazione.

   • Nome visualizzato: il nome dell'ambiente visualizzato nella UI.
   • Descrizione: facoltativa. Una descrizione dell'ambiente.
   • Istanza: facoltativo. Seleziona l'istanza Apigee che caricherà, eseguirà il deployment e gestirà il traffico per l'ambiente.
   • Gruppo di ambienti: facoltativo. Seleziona una casella di controllo per aggiungere il nuovo ambiente a un gruppo di ambienti esistente. Fai clic su OK.
   • Tipo di deployment: scegli se vuoi eseguire il deployment di singoli proxy API o di un archivio dell'ambiente di configurazione dei proxy API. Per ulteriori informazioni, consulta Tipi di deployment supportati.
     Nota: il tipo di deployment utilizzato con questo ambiente non può essere modificato dopo la creazione dell'ambiente.
5. Fai clic su Crea.

Nota: questa operazione per creare l'ambiente può richiedere fino a cinque minuti se è specificato un collegamento all'istanza.

Al termine, il nuovo ambiente viene visualizzato nella tabella del riquadro Ambienti.

Versione classica di Apigee

Per creare un nuovo ambiente nella UI classica di Apigee:

1. Apri l'UI di Apigee in un browser.
2. Seleziona Amministrazione > Ambienti > Panoramica nel riquadro di navigazione a sinistra.

   La UI mostra un insieme di schede, ognuna delle quali rappresenta un ambiente esistente:

   

3. Fai clic su +AMBIENTE.

   Viene visualizzata la finestra di dialogo Nuovo ambiente:

   

4. Inserisci le informazioni seguenti nella finestra di dialogo Nuovo ambiente:
   1. Nome visualizzato: un nome descrittivo per l'ambiente utilizzato nella UI. Ad esempio, My Test Environment.

   2. Nome ambiente: il nome della pubblicità programmatica per l'ambiente. Il nome deve essere composto da lettere minuscole, numeri e trattini. Deve iniziare con una lettera minuscola e non può terminare con un trattino. Ad esempio, test.

      Una volta creato, il nome dell'ambiente non può essere modificato.

   3. Descrizione (facoltativa): informazioni aggiuntive sull'ambiente che vuoi aggiungere come promemoria.
   4. Tipo di deployment (anteprima): scegli se eseguire il deployment di singoli proxy API o di un archivio dell'ambiente di configurazione del proxy API. Per ulteriori informazioni, consulta Tipi di deployment supportati.
      Nota: il tipo di deployment utilizzato con questo ambiente non può essere modificato dopo la creazione dell'ambiente.

   Tutti i campi tranne Description sono obbligatori.

5. Fai clic su Ok.

   La scheda mostra lo stato Provisioning in attesa mentre Apigee crea il nuovo ambiente, come mostrato nell'esempio seguente:

   

   Potrebbe verificarsi un ritardo di diversi minuti prima che venga eseguito il provisioning del nuovo ambiente.

   Al termine, l'interfaccia utente di Apigee mostra il nuovo ambiente come una scheda con gli altri ambienti che hai creato:

   

Ogni nuovo ambiente deve essere collegato a un'istanza Apigee e a un gruppo di ambienti.

Se non hai collegato l'ambiente a un'istanza durante la creazione, puoi eseguire questo passaggio nell'interfaccia utente delle istanze o utilizzando l'API Instances Attaching. Per un esempio di come eseguire questa operazione utilizzando l'API, consulta Creazione di un ambiente nella documentazione sul provisioning della riga di comando.

Nota: una volta collegati a un'istanza, gli ambienti con pagamento a consumo iniziano a essere soggetti ad addebiti. Potrebbero essere addebitati costi prima dell'inizio del traffico API.

Per maggiori informazioni sui prezzi di pagamento a consumo in base all'utilizzo dei nodi, consulta l'articolo sui prezzi di esempio di pagamento a consumo.

Per maggiori informazioni sui prezzi di pagamento a consumo basati su attributi aggiornati, consulta la pagina Prezzi di esempio relativi al pagamento a consumo (attributi aggiornati).

Se non hai assegnato il nuovo ambiente a un gruppo durante la creazione, puoi seguire i passaggi descritti in Aggiungere ambienti a un gruppo di ambienti. Gli ambienti non assegnati ai gruppi non hanno nomi host che li rimandano, pertanto non sono accessibili. Per scoprire di più, consulta la sezione Creazione di gruppi di ambienti.

Se hai un'organizzazione Apigee con fatturazione con pagamento a consumo, ti consigliamo di abilitare il componente aggiuntivo di analisi delle API Apigee nel tuo nuovo ambiente. Per ulteriori informazioni, consulta Gestire il componente aggiuntivo di analisi delle API Apigee.

Creazione di un nuovo ambiente con l'API Apigee

Questa sezione descrive come creare un nuovo ambiente utilizzando l'API Apigee.

La maggior parte dei passaggi di questo processo attiva operazioni a lunga esecuzione che possono richiedere diversi minuti.

Per creare un nuovo ambiente con l'API Apigee:

1. Crea il nuovo ambiente con l'API per la creazione di ambienti.
2. Collega l'ambiente all'istanza di runtime utilizzando l'API Instances Linking.
   Nota: una volta collegati a un'istanza, gli ambienti con pagamento a consumo iniziano a essere soggetti ad addebiti. Potrebbero essere addebitati costi prima dell'inizio del traffico API.

   Per maggiori informazioni sui prezzi di pagamento a consumo in base all'utilizzo dei nodi, consulta l'articolo sui prezzi di esempio di pagamento a consumo.

   Per maggiori informazioni sui prezzi di pagamento a consumo basati su attributi aggiornati, consulta la pagina Prezzi di esempio relativi al pagamento a consumo (attributi aggiornati).

3. Crea un gruppo di ambienti, se non ne hai già uno. Per farlo, utilizza l'API per la creazione di gruppi di ambienti.
4. Collega il nuovo ambiente al gruppo di ambienti utilizzando l'API Environment Group Linking.

   Il collegamento di un ambiente al gruppo rende i proxy al suo interno instradabili tramite i nomi host nel gruppo.

Per informazioni dettagliate ed esempi sull'utilizzo delle API Apigee per creare e collegare nuovi ambienti, consulta Creazione di un ambiente nelle istruzioni per il provisioning della riga di comando.

Ambienti di modifica

Questa sezione descrive come modificare gli ambienti esistenti nell'interfaccia utente di Apigee e con l'API Apigee.

Modifica gli ambienti nell'interfaccia utente di Apigee

Puoi modificare le seguenti proprietà di un ambiente esistente nell'interfaccia utente di Apigee:

• Nome visualizzato: inserisci un nuovo nome visualizzato per l'ambiente.
• Descrizione: inserisci una nuova descrizione per l'ambiente.
• Gruppo di ambienti: deseleziona la casella di controllo selezionata in precedenza e seleziona quella relativa al nuovo gruppo di ambienti.

Nota: è disponibile una nuova versione dell'interfaccia utente di Apigee, integrata con la console Google Cloud. La nuova UI si chiama Apigee nella console Cloud. Le istruzioni nelle prime due schede di seguito spiegano come utilizzare Apigee nella console Cloud o Apigee versione classica.

Apigee nella console Cloud

Per modificare l'ambiente in Apigee nella console Cloud:

1. Apri la UI di Apigee nella console Cloud in un browser.
2. Seleziona Gestione > Ambienti nel riquadro di navigazione a sinistra.
3. Nella riga corrispondente all'ambiente che vuoi modificare, fai clic sul menu con tre puntini in Azioni e seleziona Modifica.
4. Nella finestra di dialogo Modifica ambiente, apporta le modifiche desiderate nei campi Nome visualizzato o Descrizione.
5. Nell'elenco Gruppo di ambienti, puoi deselezionare la casella di controllo selezionata in precedenza e selezionare quella relativa al nuovo gruppo di ambienti.
6. Fai clic su Update (Aggiorna) per salvare le modifiche.

Nota: il completamento di questa operazione potrebbe richiedere fino a cinque minuti.

Versione classica di Apigee

a modificare un ambiente nella UI classica di Apigee

1. Apri l'UI di Apigee in un browser.
2. Seleziona Ambienti.

3. Individua la scheda dell'ambiente da modificare.

   L'esempio seguente mostra le schede per quattro diversi ambienti:

   

4. Fai clic sul riquadro dell'ambiente.

   La UI di Apigee mostra i dettagli sull'ambiente nella visualizzazione Informazioni:

   

5. Fai clic su Modifica nella visualizzazione Informazioni.

   Viene visualizzata la finestra di dialogo Modifica ambiente:

   

6. Modifica i valori nei campi Nome visualizzato e Descrizione.
7. Fai clic su Salva.

Modifica gli ambienti con l'API Apigee

Per modificare un ambiente esistente con l'API Apigee, utilizza l'API Ottieni ambienti per ottenere l'elenco delle proprietà attuali che puoi modificare e l'API Update APIs per impostarle o modificarle.

Configurare il proxy di inoltro su un ambiente

Per configurare il proxy di inoltro, imposta il valore forwardProxyUri per l'ambiente utilizzando l'API dagli ambienti.

Importante: quando configuri il proxy di forwarding per le installazioni ibridi, utilizza la funzionalità di forwarding ibrido descritta in Configurare il proxy di forwarding per i proxy API anziché le istruzioni fornite qui.

Disattiva l'inoltro proxy per un proxy nell'ambiente

Se il traffico per un target specifico di un proxy API deve passare direttamente alla destinazione del backend, ignorando il proxy di inoltro, imposta la seguente proprietà in TargetEndpoint per eseguire l'override del proxy di inoltro HTTP:

<Property name="use.proxy">false</Property>

Per ulteriori informazioni sulla configurazione delle proprietà TargetEndpoint, incluso come configurare la connessione all'endpoint di destinazione, consulta la documentazione di riferimento sulle proprietà degli endpoint.

Imposta use.proxy su "true" per qualsiasi TargetEndpoint che vuoi passare tramite un proxy di inoltro HTTP:

<Property name="use.proxy">true</Property>

Eliminazione di ambienti

Prima di eliminare un ambiente, considera i seguenti punti chiave:

• Prima di eliminare un ambiente, devi eliminare tutte le mappe chiave-valore e le voci relative alle coppie chiave-valore. In caso contrario, se ricrei l'ambiente, le operazioni relative alle voci della mappa chiave-valore incontreranno discrepanze di crittografia/decrittografia.
• Quando elimini un ambiente con il componente aggiuntivo di analisi delle API Apigee abilitato, vengono eliminati anche i dati di analisi per l'ambiente. Se vuoi conservare i dati di analisi per qualsiasi ambiente, ti consigliamo di esportare e salvare i dati in un'altra posizione. Per saperne di più sul salvataggio dei dati, consulta Esportare i dati da Analytics. Per saperne di più sull'impatto dell'eliminazione dell'ambiente sui dati di analisi delle API Apigee, consulta Gestire i dati di analisi delle API Apigee

Eliminazione di un ambiente con la UI di Apigee

Nota: è disponibile una nuova versione dell'interfaccia utente di Apigee, integrata con la console Google Cloud. La nuova UI si chiama Apigee nella console Cloud. Le istruzioni nelle prime due schede di seguito spiegano come utilizzare Apigee nella console Cloud o Apigee versione classica.

Apigee nella console Cloud

Per eliminare un ambiente in Apigee nella console Cloud:

1. Apri la UI di Apigee nella console Cloud in un browser.
2. Seleziona Gestione > Ambienti nel riquadro di navigazione a sinistra.
3. Nella riga nell'ambiente che vuoi modificare, fai clic sul menu con tre puntini in Azioni e seleziona Elimina.

Nota: il completamento di questa operazione potrebbe richiedere fino a cinque minuti.

Versione classica di Apigee

1. Apri l'UI di Apigee in un browser.

2. Seleziona Amministratore > Ambienti > Panoramica.

   Apigee visualizza un set di schede, ciascuna delle quali rappresenta un ambiente all'interno della tua organizzazione Apigee.

3. Individua la scheda dell'ambiente che vuoi eliminare.

4. Fai clic sul menu dell'ambiente e seleziona Elimina.

   Apigee mostra una finestra di dialogo di conferma.

5. Fai clic su OK per eliminare l'ambiente.

   La scheda dell'ambiente nella UI mostra un'etichetta In attesa di eliminazione mentre Apigee elimina l'ambiente.

   Potrebbe volerci alcuni minuti prima che l'eliminazione venga completata.

Eliminazione di un ambiente con l'API Apigee

Per eliminare un ambiente, utilizza l'API Elimina ambienti.