Utilizzo dei gruppi di ambienti

Apigee nella console Cloud

Per creare un nuovo gruppo di ambienti in Apigee nella console Cloud:

1. Apri l'interfaccia utente 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 quanto segue:
   • Nome gruppo di ambienti: un nome per il gruppo di ambienti. Il nome deve iniziare e terminare con un carattere alfanumerico. Può contenere fino a 63 caratteri composti da caratteri alfanumerici e trattini. Il nome deve essere diverso da qualsiasi nome di gruppo di ambienti esistente nella tua organizzazione.

   • Nomi host: un elenco di nomi host che possono essere utilizzati per chiamare i proxy. Ogni nome host deve essere inserito in una riga distinta.

     Puoi anche fare clic su Configura il bilanciatore del carico Google con questi domini. Si apre la pagina Bilanciamento del carico nella console Cloud, 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.

Apigee classica

Per creare un nuovo gruppo di ambienti nell'interfaccia utente Apigee classica:

1. Nell'interfaccia utente di Apigee, seleziona Amministrazione > 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 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. In genere si tratta di un'operazione molto rapida.

   In caso di operazione riuscita, 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 altri nomi host al nuovo gruppo facendo clic su create per il gruppo.

   Apigee mostra il riquadro Dettagli gruppo di ambienti:

   

6. Aggiungi i nomi host al campo Nomi host. Ogni nome host deve essere inserito in una riga distinta.

7. Al termine, fai clic su Salva.

   Puoi aggiungere e rimuovere i 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 environment groups. Prima di chiamare l'API, assicurati di disporre di un token valido, come descritto in Ottenere un token di accesso OAuth 2.0.

Il seguente comando curl di esempio 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, il nome deve iniziare con una lettera minuscola.

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

Puoi anche assegnare i nomi host quando crei il gruppo specificandoli come 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"] \
  }'

In un secondo momento puoi modificare i nomi host nell'elenco inviando una richiesta PATCH all'API Patch environment groups.

Apigee nella console Cloud

Per aggiungere un ambiente a un gruppo di ambienti nella console Apigee in Cloud:

1. Crea l'ambiente, come descritto in Creazione di 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 del 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 Aggiorna.

Apigee classica

Per aggiungere un ambiente a un gruppo di ambienti nell'interfaccia utente Apigee classica:

1. Crea l'ambiente, come descritto in Creazione di ambienti.
2. Nell'interfaccia utente di Apigee, seleziona Amministrazione > Ambienti > Gruppi.
3. In Non assegnati è riportato un elenco di ambienti che non fanno parte di un gruppo di ambienti:

   

   Prendi nota degli ambienti non assegnati come vuoi assegnarli.

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

   Nel riquadro Dettagli gruppo di ambienti vengono visualizzati:

   

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

   Viene visualizzato il riquadro Aggiungi ambiente:

   

6. Seleziona l'ambiente da 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 di allegato del gruppo di ambienti, come mostrato 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:

• $TOKEN sia impostato sul tuo 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 per un singolo ambiente.

In caso di esito positivo, la risposta contiene i dettagli del nuovo allegato, incluso il timestamp della sua creazione, ad esempio:

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

Apigee nella console Cloud

Per rimuovere un ambiente da un gruppo di ambienti nella console Apigee in 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 del 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 Aggiorna.

Apigee classica

Per rimuovere un ambiente da un gruppo di ambienti nell'interfaccia utente Apigee classica:

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

API Apigee

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

Apigee nella console Cloud

Per eliminare un gruppo di ambienti nella console Apigee in 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 del gruppo di ambienti, fai clic sul menu con tre puntini in Azioni e seleziona Elimina.

Apigee classica

Per eliminare un gruppo di ambienti nell'interfaccia utente Apigee classica:

1. Nell'interfaccia utente di Apigee, seleziona Amministrazione > Ambienti > Gruppi.
2. Sposta il cursore nel riquadro del gruppo che vuoi 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.

Apigee nella console Cloud

Per aggiungere un nome host a un gruppo di ambienti nella console Apigee in 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 del 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 dell'host che vuoi aggiungere al gruppo di ambienti.
5. Fai clic su Aggiorna.

Apigee classica

Per aggiungere un nome host a un gruppo di ambienti nell'interfaccia utente Apigee classica:

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

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

   Viene visualizzato il riquadro Dettagli gruppo di ambienti:

   

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

API Apigee

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

L'esempio seguente imposta 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:

• $TOKEN sia impostato sul tuo 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 allegati del nome host, oltre all'array dei nomi stessi.

Se la richiesta è andata a buon fine, la risposta contiene una risorsa Operation.