Utilizzo degli ambienti

Questa pagina si applica a Apigee e Apigee ibridi.

Visualizza 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 puoi crea ed eseguire il deployment dei proxy API. L'utente crea un durante il provisioning e potrai aggiungere in un secondo momento altri ambienti dell'organizzazione.

Ambienti e istanze

Ogni ambiente deve essere collegato ad almeno un'istanza Apigee. Un è una macchina virtuale specifica per la regione. Se colleghi un ambiente a un'istanza, carica l'istanza, esegue il 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 la maggior parte del traffico per l'ambiente. Puoi aggiungere l'ambiente a un'istanza o spostarlo 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 agli ambienti con pagamento a consumo gli ambienti con pagamento a consumo iniziano a essere addebitati per eseguire un'istanza. Potrebbero essere addebitati costi prima dell'inizio del traffico API. Per ulteriori informazioni informazioni sui prezzi di pagamento a consumo, vedi Prezzi di esempio con pagamento a consumo.

Creazione di ambienti

Puoi creare un nuovo ambiente utilizzando la UI di Apigee o l'API Apigee, come descritto nelle sezioni seguenti. Prima di iniziare, è importante notare che Apigee e Apigee hybrid hanno limiti al numero di ambienti e gruppi di ambienti che puoi possono essere create 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 della UI di Apigee, integrata con la console Google Cloud. La nuova UI si chiama Apigee nella console Cloud. La le istruzioni nelle prime due schede spiegano come utilizzare Apigee nella console Cloud o nella versione classica di Apigee.

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 riquadro.
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 che preferisci da creare: Base, Intermedio o Completo.

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

   • Nome: il nome dell'ambiente programmatico. Il Nome non può essere modificato dopo la sua 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 in dell'organizzazione.

   • Nome visualizzato: il nome dell'ambiente visualizzato nell'interfaccia utente.
   • Descrizione: facoltativa. Una descrizione dell'ambiente.
   • Istanza: facoltativo. Seleziona l'istanza Apigee che eseguirà il caricamento, il deployment e la gestione del 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 del tuo ambiente di configurazione proxy API. Per ulteriori informazioni, consulta Tipi di deployment supportati.
     Nota: il tipo di deployment utilizzato in questo ambiente non può essere modificato dopo la creazione dell'ambiente.
5. Fai clic su Crea.

Nota: questa operazione di creazione dell'ambiente può richiedere fino a cinque minuti se viene specificato un collegamento all'istanza.

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

Versione classica di Apigee

Per creare un nuovo ambiente nella UI classica di Apigee:

1. Apri la UI di Apigee in un browser.
2. Seleziona Amministratore > 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 seguenti informazioni nella finestra di dialogo Nuovo ambiente:
   .
   1. Nome visualizzato: un nome semplice per l'ambiente utilizzato nella nell'interfaccia utente. Ad esempio, My Test Environment.

   2. Nome ambiente: il nome programmatico dell'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.

      Non è possibile modificare il nome dell'ambiente dopo la creazione.

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

   Tutti i campi tranne Descrizione sono obbligatori.

5. Fai clic su OK.

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

   

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

   Al termine, la UI di Apigee visualizza il nuovo ambiente come una scheda con 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 il tuo ambiente a un'istanza durante la creazione, puoi eseguire questo passaggio nella UI Istanze oppure utilizzando l'API InstancesAttachment Create. Per un esempio di come eseguire questa operazione utilizzando l'API, consulta Crea una nella documentazione sul provisioning della riga di comando.

Nota: una volta collegati agli ambienti con pagamento a consumo gli ambienti con pagamento a consumo iniziano a essere addebitati per eseguire un'istanza. Potrebbero essere addebitati costi prima dell'inizio del traffico API.

Per ulteriori informazioni sui prezzi di pagamento a consumo basati su attributi aggiornati, consulta Prezzi di esempio con pagamento a consumo (attributi aggiornati).

Se non hai assegnato il nuovo ambiente a un gruppo durante la creazione, puoi seguire i passaggi in Aggiunta di ambienti a un gruppo di ambienti. Gli ambienti non assegnati ai gruppi non hanno nomi host che rimandano ai gruppi e, di conseguenza, non sono accessibili. Per ulteriori informazioni consulta la sezione Creare gruppi di ambienti.

Se hai un'organizzazione Apigee con fatturazione a consumo, potresti voler abilitare l'analisi dell'API Apigee nel nuovo ambiente. Per saperne di più, consulta Gestire il componente aggiuntivo di analisi dell'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 Create ambienti.
2. Collega l'ambiente all'istanza di runtime utilizzando l'API Instances Linking.
   Nota: una volta collegati agli ambienti con pagamento a consumo gli ambienti con pagamento a consumo iniziano a essere addebitati per eseguire un'istanza. Potrebbero essere addebitati costi prima dell'inizio del traffico API.

   Per ulteriori informazioni sui prezzi di pagamento a consumo basati su attributi aggiornati, consulta Prezzi di esempio con pagamento a consumo (attributi aggiornati).

3. Crea un gruppo di ambienti, se non ne hai già uno. A questo scopo, utilizza API Crea gruppi di ambienti.
4. Collega il nuovo ambiente al gruppo di ambienti utilizzando l'API per i collegamenti del gruppo di ambienti.

   Quando colleghi un ambiente al gruppo, i proxy in quell'ambiente instradabile tramite i nomi host nel gruppo.

Per informazioni dettagliate ed esempi sull'utilizzo delle API Apigee per creare e collegare nuovi ambienti, consulta la sezione Creare nelle istruzioni di provisioning dalla riga di comando.

Modifica degli ambienti

Questa sezione descrive come modificare gli ambienti esistenti nella UI di Apigee e con l'API Apigee.

Modifica ambienti nella UI di Apigee

Puoi modificare le seguenti proprietà di un ambiente esistente nella 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 la casella di controllo per il nuovo gruppo di ambienti.

Nota: è disponibile nuova versione della UI di Apigee, integrata con la console Google Cloud. La nuova UI si chiama Apigee nella console Cloud. La le istruzioni nelle prime due schede spiegano come utilizzare Apigee nella console Cloud o nella versione classica di Apigee.

Apigee nella console Cloud

Per modificare l'ambiente nella console Apigee in Cloud:

1. Apri la pagina Apigee nella console.

   Vai ad Apigee

2. Seleziona il progetto con gli ambienti che vuoi aggiornare.
3. Seleziona Gestione > Ambienti nel riquadro di navigazione a sinistra.
4. Nella riga dell'ambiente che vuoi modificare, fai clic sul menu con tre puntini sotto Azioni e seleziona Modifica. Viene visualizzata la finestra di dialogo Modifica ambiente.
5. Seleziona il tipo di ambiente: se sei un cliente con pagamento a consumo, scegli un'opzione in Seleziona il tipo di ambiente per e modificare il tipo di ambiente. Le opzioni includono Base, Intermedio o Completo.

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

6. Puoi apportare eventuali modifiche richieste nei campi Nome visualizzato o Descrizione.
7. Nella casella di riepilogo Gruppo di ambienti, puoi deselezionare la casella di controllo selezionata in precedenza e selezionarla. la casella di controllo per il nuovo gruppo di ambienti.
8. 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

Per 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 che vuoi modificare.

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

   

4. Fai clic sul riquadro dell'ambiente.

   La UI di Apigee mostra i dettagli dell'ambiente nella vista Informazioni:

   

5. Fai clic su Modifica nella visualizzazione Informazioni.

   Viene visualizzata la finestra di dialogo Modifica ambiente:

   

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

Modifica ambienti con l'API Apigee

Per modificare un ambiente esistente con l'API Apigee, utilizza l'API Get regalo per ottenere l'elenco delle proprietà correnti che puoi modificare e l'API Update Subscriptions in impostarle o modificarle.

Configurare il proxy di inoltro in un ambiente

Per configurare forwarding proxy, imposta il valore forwardProxyUri per l'ambiente utilizzando API Environments.

Importante: durante la configurazione del proxy di inoltro per ibrido utilizzare la funzionalità di proxy in avanti ibrido descritta in Configurare il proxy di inoltro per i proxy API piuttosto che le istruzioni qui fornite.

Disabilita il forwarding del proxy per un proxy nell'ambiente

Se il traffico di una la destinazione specifica di un proxy API deve andare direttamente alla destinazione del backend, bypassando il quindi imposta la seguente proprietà in TargetEndpoint per eseguire l'override del proxy HTTP proxy:

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

Per ulteriori informazioni sull'impostazione delle proprietà TargetEndpoint, incluso come configurare la connessione all'endpoint di destinazione. Consulta Riferimento alle proprietà degli endpoint.

Imposta use.proxy su "true" per qualsiasi TargetEndpoint che vuoi 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 e le voci coppie chiave-valore. In caso contrario, se ricrei l'ambiente, le operazioni di immissione della mappa dei valori chiave riscontreranno discrepanze di crittografia/decrittografia.
• Quando elimini un ambiente con la funzionalità di analisi delle API Apigee abilitato, vengono eliminati anche i dati di analisi per l'ambiente. Se desideri conservare di analisi per qualsiasi ambiente, ti consigliamo di esportare e salvare i tuoi dati in un'altra posizione. Per ulteriori informazioni sul salvataggio dei dati, vedi Esportazione dei dati da Analytics. Per scoprire di più sull'impatto dell'eliminazione dell'ambiente sull'analisi dell'API Apigee consulta Gestire i dati di analisi dell'API Apigee

Eliminazione di un ambiente con la UI Apigee

Nota: è disponibile una nuova versione della UI di Apigee, integrata con la console Google Cloud. La nuova UI è chiamata Apigee nella console Cloud. La le istruzioni nelle prime due schede spiegano come utilizzare Apigee nella console Cloud o nella versione classica di Apigee.

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 dell'ambiente che vuoi modificare, fai clic sul menu con tre puntini sotto 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 una serie di schede, ciascuna delle quali rappresenta un ambiente all'interno del tuo nella piattaforma Apigee.

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

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

   Apigee visualizza una finestra di dialogo di conferma.

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

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

   Potrebbe verificarsi un ritardo di diversi minuti prima che l'eliminazione venga completata.

Eliminazione di un ambiente con l'API Apigee

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