Utilizzo dei gruppi di ambienti

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Questa sezione descrive come creare e modificare i gruppi di ambienti, inclusa l'aggiunta o la rimozione di ambienti o nomi host a un gruppo con Apigee. Per ulteriori informazioni su cos'è un gruppo di ambienti e sul suo funzionamento, consulta la sezione Panoramica dei gruppi di ambienti e di ambienti.

Creazione di gruppi di ambienti

Puoi creare nuovi gruppi di ambienti utilizzando l'UI di Apigee o l'API Apigee. Questa sezione descrive come eseguire entrambe le operazioni.

Quando crei per la prima volta un gruppo di ambienti, questo non contiene ambienti. Tuttavia, definisce un nome host predefinito: example.group-name. Per aggiungere ambienti a un gruppo di ambienti, consulta Aggiunta di ambienti a un gruppo di ambienti.

Utenti ibridi Apigee: ogni gruppo di ambienti che crei con un ambiente collegato deve essere incluso in tutti i file di override in cui viene utilizzato l'ambiente.

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 gruppo di ambienti 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, seleziona Gruppi di ambienti.
4. Fai clic su + Crea gruppo di ambienti.
5. Inserisci i seguenti valori:
   • Nome gruppo di ambienti: il nome del gruppo di ambienti. Il nome deve iniziare e terminare con un carattere alfanumerico. Può contenere fino a 63 caratteri costituiti da caratteri alfanumerici e trattini. Il nome deve essere diverso dal nome di qualsiasi gruppo di ambienti esistente nella tua organizzazione.

   • Hostames: un elenco di nomi host che possono essere utilizzati per chiamare i proxy. Ogni nome host deve essere su una riga separata.

     Nota: i nomi assegnati a un gruppo di ambienti devono essere univoci per quel gruppo: non possono essere utilizzati da altri gruppi di ambienti.

     Puoi anche fare clic su Configura il bilanciatore del carico di Google con questi domini. Nella console Cloud si apre la pagina Bilanciamento del carico, dove puoi configurare il bilanciamento del carico per i nomi host.

   • Ambienti: un elenco facoltativo di ambienti da includere nel gruppo di ambienti.
6. Fai clic su Crea.

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

Versione classica di Apigee

Per creare un nuovo gruppo di ambienti nella UI classica di Apigee:

1. Nell'interfaccia utente di Apigee, seleziona Amministratore > Ambienti > Gruppi.
2. Fai clic su +Gruppo di ambienti:

   

   Viene visualizzata la finestra di dialogo Aggiungi un gruppo di ambienti.

3. Inserisci un nome per il nuovo gruppo di ambienti:

   

   Il nome può contenere solo lettere minuscole, numeri e trattini. Inoltre, deve iniziare con una lettera, avere una lunghezza di almeno due caratteri e non può terminare con un trattino. I nomi validi includono my-env-group e prod2.

4. Fai clic su Aggiungi.

   Apigee crea un nuovo gruppo di ambienti. Questa operazione di solito è molto rapida.

   Se l'operazione è andata a buon fine, Apigee conferma che il gruppo è stato creato con un banner simile al seguente:

   

   Apigee assegna anche un nome host predefinito al nuovo gruppo.

5. (Facoltativo) Assegna nomi host aggiuntivi al nuovo gruppo facendo clic su per il gruppo in questione.

   Apigee visualizza il riquadro Dettagli gruppo di ambienti:

   

6. Aggiungi nomi host al campo Hostnames (Nomi host). Ogni nome host deve essere inserito su una riga separata.

7. Al termine, fai clic su Salva.

   Puoi aggiungere e rimuovere nomi host da questo elenco in qualsiasi momento utilizzando la stessa procedura.

API Apigee

Per creare un nuovo gruppo di ambienti utilizzando l'API Apigee, invia una richiesta POST all'API Create ambienti groups. Prima di chiamare l'API, assicurati di disporre di un token valido, come descritto in Ottenere un token di accesso per OAuth 2.0.

Il comando curl di esempio seguente mostra la sintassi per creare un nuovo gruppo:

curl -i $TOKEN -X POST \
  https://apigee.googleapis.com/v1/organizations/ORG_NAME/envgroups?name=new-group-name

Quando specifichi il nome del nuovo gruppo, devi utilizzare solo lettere minuscole, numeri e trattini (a-z, A-Z e -). Non puoi utilizzare lettere maiuscole o caratteri speciali diversi dai trattini. Inoltre, devi iniziare il nome con una lettera minuscola.

Se non specifichi parametri aggiuntivi, questo comando crea un nuovo gruppo senza nomi host assegnati.

Puoi anche assegnare nomi host quando crei il gruppo specificando un array nel corpo della richiesta.

L'esempio seguente crea un nuovo gruppo my-group e assegna tre nuovi nomi host al nuovo gruppo:

curl -i $TOKEN -X POST \
  https://apigee.googleapis.com/v1/organizations/org_name/envgroups?name=my-group \
  -d '{ \
    "hostnames": ["server1.mycompany.com", "server2.mycompany.com", "10.1.142.8"] \
  }'

Successivamente, potrai modificare i nomi host nell'elenco inviando una richiesta PATCH all'API Patch Environment Groups.

Aggiunta di ambienti a un gruppo di ambienti

Non è possibile accedere agli ambienti che non fanno parte di un gruppo perché non esiste un nome host associato. I nomi host sono definiti sul gruppo di ambienti, non sull'ambiente. Quando crei un ambiente utilizzando l'interfaccia utente di Apigee nella console Google Cloud, hai la possibilità di assegnare l'ambiente a un gruppo di ambienti esistente. Per maggiori informazioni, consulta la sezione Creazione di un nuovo ambiente nella UI.

Se non hai assegnato il tuo ambiente a un gruppo durante la creazione dell'ambiente, questa sezione descrive come aggiungere un ambiente non assegnato a un gruppo di ambienti utilizzando l'interfaccia utente Apigee o l'API 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 aggiungere un ambiente a un gruppo di ambienti in Apigee nella console Cloud:

1. Crea l'ambiente, come descritto in Creazione degli ambienti.
2. Nell'interfaccia utente di Apigee nella console Cloud, seleziona Gestione > Ambienti nel riquadro di navigazione a sinistra.
3. Nel riquadro Ambienti, seleziona Gruppi di ambienti.
4. Nella riga relativa al gruppo di ambienti, fai clic sul menu con tre puntini in Azioni e seleziona Modifica.
5. Nel riquadro Modifica gruppo di ambienti, in Ambienti (facoltativo), seleziona l'ambiente da aggiungere al gruppo di ambienti.
6. Fai clic su Update (Aggiorna).

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

Versione classica di Apigee

Per aggiungere un ambiente a un gruppo di ambienti nella UI classica di Apigee:

1. Crea l'ambiente, come descritto in Creazione degli ambienti.
2. Nell'interfaccia utente di Apigee, seleziona Amministratore > Ambienti > Gruppi.
3. Vai alla sezione Non assegnato per visualizzare un elenco di ambienti che non fanno parte di un gruppo di ambienti:

   

   Prendi nota di quali ambienti non sono assegnati quando vuoi assegnarli.

4. Fai clic su accanto al gruppo di ambienti a cui vuoi aggiungere gli ambienti.

   Il riquadro Dettagli gruppo di ambienti mostra:

   

5. Per aggiungere un nuovo ambiente a questo gruppo, fai clic su + nell'elenco Ambienti.

   Nel riquadro Aggiungi ambiente vengono visualizzati:

   

6. Seleziona l'ambiente che vuoi aggiungere al gruppo e fai clic su Aggiungi.

   Apigee aggiunge l'ambiente al gruppo.

API Apigee

Per aggiungere un nuovo ambiente a un gruppo di ambienti utilizzando l'API Apigee, invia una richiesta POST all'API Environment Group Linking, come illustrato nell'esempio seguente:

curl -H "Authorization: Bearer $TOKEN" -X POST
  "https://apigee.googleapis.com/v1/organizations/my-org/envgroups/test-group/attachments"
  -d '{
    "name": "my-attachment",
    "environment": "test"
  }'

Dove:

• L'impostazione $TOKEN è impostata sul token di accesso OAuth 2.0, come descritto in Ottenere un token di accesso OAuth 2.0.
• Il corpo della richiesta contiene il nome dell'allegato e il nome del nuovo ambiente.

Il corpo della richiesta contiene un'istanza di una risorsa EnvironmentGroupAttachment, che è un semplice wrapper attorno a un singolo ambiente.

Se l'esito è positivo, la risposta contiene i dettagli sul nuovo allegato, incluso il timestamp in cui è stato creato, ad esempio:

{
  "name": "my-attachment",
  "environment": "test"
  "createdAt": "42"
}

Rimozione di un ambiente da un gruppo di ambienti

Puoi rimuovere un ambiente da un gruppo di ambienti con l'UI di Apigee o l'API 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 rimuovere un ambiente da un gruppo di ambienti in Apigee nella console Cloud:

1. Nell'interfaccia utente di Apigee nella console Cloud, seleziona Gestione > Ambienti nel riquadro di navigazione a sinistra.
2. Nel riquadro Ambienti, seleziona Gruppi di ambienti.
3. Nella riga relativa al gruppo di ambienti, fai clic sul menu con tre puntini in Azioni e seleziona Modifica.
4. Nel riquadro Modifica gruppo di ambienti, in Ambienti (facoltativo), deseleziona l'ambiente che vuoi rimuovere dal gruppo di ambienti.
5. Fai clic su Update (Aggiorna).

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

Versione classica di Apigee

Per rimuovere un ambiente da un gruppo di ambienti nella UI classica di Apigee:

1. Nell'interfaccia utente di Apigee, seleziona Amministratore > Ambienti > Panoramica.
2. Seleziona l'ambiente che vuoi rimuovere.
3. Nel riquadro Gruppi, sposta il cursore alla fine della riga relativa al gruppo da cui vuoi rimuovere l'ambiente e fai clic su .

Nota: in alternativa, se stai visualizzando la pagina Gruppi di ambienti, puoi selezionare l'ambiente da rimuovere in qualsiasi riquadro in cui viene visualizzato per aprirlo nel riquadro Gruppi della pagina Ambienti.

API Apigee

Per rimuovere un ambiente da un gruppo di ambienti utilizzando l'API Apigee, utilizza il metodo delete nella risorsa EnvironmentGroupAttachment per eliminare il collegamento corrispondente all'ambiente.

Eliminazione di un gruppo di ambienti

Puoi eliminare un gruppo di ambienti utilizzando l'interfaccia utente di Apigee o l'API.

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 gruppo di ambienti in Apigee nella console Cloud:

1. Nell'interfaccia utente di Apigee nella console Cloud, seleziona Gestione > Ambienti nel riquadro di navigazione a sinistra.
2. Nel riquadro Ambienti, seleziona Gruppi di ambienti.
3. Nella riga relativa al gruppo di ambienti, 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

Per eliminare un gruppo di ambienti nella UI classica di Apigee:

1. Nell'interfaccia utente di Apigee, seleziona Amministratore > Ambienti > Gruppi.
2. Sposta il cursore sul riquadro del gruppo da eliminare.
3. Fai clic sull'icona .

API Apigee

Per eliminare un gruppo di ambienti utilizzando l'API Apigee, utilizza il metodo delete nella risorsa EnvironmentGroup.

Aggiunta di nomi host a un gruppo

Quando crei un gruppo, Apigee aggiunge il nome host predefinito example.GROUP_NAME. Puoi aggiungere i tuoi nomi host al gruppo utilizzando le istruzioni in questa sezione.

I nomi host che definisci in un gruppo di ambienti:

• Deve essere univoco in tutti i gruppi di ambienti di un'organizzazione; non possono essere utilizzati da più di un gruppo
• Non supportare caratteri jolly
• I percorsi di base devono essere univoci all'interno di un host (non due proxy possono avere lo stesso percorso di base all'interno di un host)

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 aggiungere un nome host a un gruppo di ambienti nella console Apigee nella console Cloud:

1. Nell'interfaccia utente di Apigee nella console Cloud, seleziona Gestione > Ambienti nel riquadro di navigazione a sinistra.
2. Nel riquadro Ambienti, seleziona Gruppi di ambienti.
3. Nella riga relativa al gruppo di ambienti, fai clic sul menu con tre puntini in Azioni e seleziona Modifica.
4. Nel riquadro Modifica gruppo di ambienti, in Nomi host, inserisci il nome del nome host che vuoi aggiungere al gruppo di ambienti.
5. Fai clic su Update (Aggiorna).

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

Versione classica di Apigee

Per aggiungere un nome host a un gruppo di ambienti nella UI classica di Apigee:

1. Nell'interfaccia utente di Apigee, seleziona Amministratore > Ambienti > Gruppi.

2. Passa il mouse sopra la scheda del gruppo e seleziona .

   Nel riquadro Dettagli gruppo di ambienti viene visualizzato:

   

3. Nel campo Hostnames (Nomi host), inserisci i nuovi host.
4. Fai clic su Salva per aggiungere i nuovi host al gruppo.

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

API Apigee

Per aggiungere nomi host a un gruppo di ambienti utilizzando l'API Apigee, invia una richiesta PATCH all'API Patch ambienti groups. Assicurati di impostare il parametro updateMask su hostnames e di specificare l'intero elenco di nomi host che vuoi: il valore di quel campo nella tua richiesta sostituisce l'elenco esistente.

Nell'esempio seguente vengono impostati i nomi host per l'ambiente di test:

curl -H "Authorization: Bearer $TOKEN" -X PATCH
  "https://apigee.googleapis.com/v1/organizations/my-org/envgroups/test-group?hostnames=updateMask"
  -d '{
    "name": "my-hostnames",
    "hostnames": [
      "test-1.example.com",
      "test-2.example.com",
      "test-3.example.com"
    ]
  }'

Dove:

• L'impostazione $TOKEN è impostata sul token di accesso OAuth 2.0, come descritto in Ottenere un token di accesso OAuth 2.0.
• Il payload della richiesta specifica un nome per l'array di collegamenti dei nomi host, più l'array di nomi stessi.

Se la richiesta ha esito positivo, la risposta contiene una risorsa per l'operazione.

Determinare se il bilanciatore del carico Cloud è configurato per un nome host

Puoi chiamare un proxy con il seguente comando:

curl -v https://YOUR_ENV_GROUP_HOSTNAME/myproxy

dove YOUR_ENV_GROUP_HOSTNAME è il nome host di un gruppo di ambienti che contiene l'ambiente in cui viene eseguito il deployment del proxy. A tale scopo, è necessario configurare il bilanciatore del carico Cloud per il nome host del gruppo di ambienti. Di solito, il bilanciatore del carico viene configurato al momento del provisioning iniziale di Apigee. Per determinare se il bilanciatore del carico è configurato per il nome host:

1. Nella visualizzazione Amministrazione > Ambienti > Gruppi, fai clic sull'icona di modifica a destra del gruppo di ambienti per il nome host.
2. Fai clic su Configura il bilanciatore del carico Google con questi domini. Si aprirà la pagina Bilanciamento del carico di Google Cloud Platform.

   

3. Fai clic sul nome del bilanciatore del carico nella colonna Nome. Se è stato eseguito il provisioning di Apigee con la procedura guidata di provisioning, il nome del bilanciatore del carico sarà apigee-proxy-url-map. Se non vedi questo nome, contatta l'amministratore di sistema della tua organizzazione che ha eseguito il provisioning di Apigee.

   Quando fai clic sul nome, viene visualizzata la pagina Dettagli del bilanciatore del carico:

   

4. Nella tabella Frontend, fai clic sui certificati SSL nella colonna Certificato e cerca un certificato SSL che corrisponda al nome host:
   • Se il Tipo di certificato è GESTITO, verifica se il campo Nomi host DNS del certificato corrisponde al nome host.
   • Se il certificato non è gestito, potrebbe essere necessario scaricarlo e verificare se il nome comune corrisponde al nome host.

Se non trovi il nome host in nessun certificato, contatta l'amministratore di sistema per ulteriore assistenza.