Questa pagina è stata tradotta dall'API Cloud Translation.

Passaggio 6: creazione di un gruppo di ambienti

In questo passaggio, creerai un ambiente e un gruppo di ambienti.

In Apigee, il deployment dei proxy API viene eseguito in ambienti, che forniscono contesti isolati per i proxy. Gli ambienti sono organizzati in gruppi di ambienti, che forniscono nomi host per tutti i proxy di cui è stato eseguito il deployment negli ambienti all'interno del gruppo. Devi avere almeno un ambiente e almeno un gruppo di ambienti. Per saperne di più, consulta Informazioni sugli ambienti e sui gruppi di ambienti.

Autorizzazioni obbligatorie

Il creatore del gruppo di ambienti e ambienti deve avere almeno il ruolo di Amministratore organizzazione Apigee. Tuttavia, se sei il proprietario del progetto, hai automaticamente l'autorizzazione per creare un ambiente o un gruppo di ambienti. Tuttavia, se deleghi questa attività a un proprietario non proprietario del progetto, a quell'utente deve essere concesso il ruolo Amministratore organizzazione Apigee nel tuo progetto. Per informazioni sulla concessione dei ruoli, consulta Concessione, modifica e revoca dell'accesso alle risorse.

Creazione di un ambiente

Crea l'ambiente prima di creare il gruppo di ambienti. Puoi creare un ambiente utilizzando la UI ibrida di Apigee o l'interfaccia a riga di comando. Ti consigliamo di utilizzare l'interfaccia utente per questi passaggi per acquisire familiarità.

UI ibrida di Apigee

Per accedere alla UI ibrida e aggiungere un ambiente:

Apri l'UI di Apigee. Se è la prima volta che accedi, ibrido visualizza una finestra di dialogo per il consenso. Se ti viene chiesto di selezionare più di un account, scegli quello proprietario del progetto creato nel Passaggio 2: crea un progetto Google Cloud. Quindi, fai clic su Consenti.

Il browser apre la pagina di destinazione principale dell'interfaccia utente ibrida:

La pagina di destinazione nell'interfaccia utente ibrida di Apigee, composta dal riquadro di navigazione a sinistra e da immagini di grandi dimensioni come link.

Assicurati che l'organizzazione abilitata per gli ambienti ibridi sia selezionata dall'elenco a discesa dell'organizzazione. Se non è selezionata, selezionala dall'elenco a discesa, come illustrato nell'esempio seguente:

Nota: quando selezioni un'organizzazione abilitata per ibridi dall'elenco a discesa, la UI ibrida mostra il nome dell'organizzazione Apigee e il nome del progetto Google Cloud nell'intestazione. Il nome dell'organizzazione Apigee e il nome del progetto Google Cloud sono uguali.
Fai clic su Amministratore > Ambienti > Panoramica.

Viene visualizzata la visualizzazione Ambienti, senza (ancora) ambienti:
Fai clic su +Ambiente.
Viene visualizzata la finestra di dialogo Nuovo ambiente:
Inserisci le informazioni seguenti nella finestra di dialogo Nuovo ambiente:
1. Nome visualizzato (obbligatorio): un nome descrittivo per l'ambiente utilizzato nella UI. Ad esempio, "Il mio primo ambiente" o "test". A differenza del Nome ambiente, il Nome visualizzato può contenere lettere maiuscole e altri caratteri speciali.
2. Nome ambiente (obbligatorio): il nome programmatico dell'ambiente; noto anche come ID ambiente.
  Ad esempio, "mio-ambiente" o "test".
  
  Attenzione: il nome di un ambiente può contenere solo lettere minuscole, numeri e trattini. Non puoi utilizzare lettere maiuscole o altri caratteri speciali. Inoltre, il Nome ambiente può contenere fino a un massimo di 32 caratteri. Ad esempio: my-test-env o my-test-env-42.
  
  Il Nome visualizzato e il Nome ambiente possono essere diversi.
3. Descrizione (facoltativa): informazioni aggiuntive sull'ambiente che vuoi aggiungere come promemoria dello scopo dell'ambiente. Ad esempio, "Creata durante l'installazione iniziale".
Fai clic su Crea.
Apigee crea il nuovo ambiente e indica che è In attesa di provisioning:

In pochi istanti, lo stato diventa provisioning eseguito:

Tuttavia, non hai ancora terminato. Devi anche aggiungere il nuovo ambiente al file overrides.yaml del runtime, ma prima devi installare il runtime, quindi non andiamo avanti.

Interfaccia a riga di comando gcloud

Per creare un ambiente con l'API per la creazione di ambienti, segui questi passaggi:

Apri un terminale sul dispositivo che stai utilizzando per gestire Apigee.
Nella riga di comando, recupera le tue credenziali di autenticazione gcloud, come mostrato nell'esempio seguente:
```
TOKEN=$(gcloud auth print-access-token)
```
Per verificare che il token sia stato compilato, utilizza echo, come illustrato nell'esempio seguente:
```
echo $TOKEN
```
Il token dovrebbe essere visualizzato come stringa codificata.

Per maggiori informazioni, consulta la panoramica dello strumento a riga di comando gcloud.
Crea variabili di ambiente per gli elementi dell'ambiente. Utilizzerai la seguente variabile nel comando per crearla:
- ENV_NAME (Obbligatorio) è l'ID pubblicità programmatica per il tuo ambiente. Il nome dell'ambiente può contenere lettere minuscole, trattini e numeri e deve iniziare con una lettera minuscola. Questo nome verrà utilizzato come identificatore e non può essere modificato dopo la creazione
```
export ENV_NAME=environment_name
```
- ENV_DISPLAY_NAME (Obbligatorio) è il nome facile da usare dell'ambiente. Questo valore non deve essere necessariamente univoco e può includere spazi e caratteri speciali. Ad esempio, "Il mio ambiente di esempio".
```
ENV_DISPLAY_NAME=friendly_name
```
- ORG_NAME (Obbligatorio) è l'ID organizzazione. Assicurati di aver definito la variabile di ambiente ORG_NAME nel Passaggio 4: crea un'organizzazione:
```
echo $ORG_NAME
```
- ENV_DESCRIPTION (Facoltativo) contiene le informazioni sull'ambiente che vuoi utilizzare come promemoria del suo scopo. Ad esempio, "Ambiente di esempio per le istruzioni di Apigee Hybrid".
```
ENV_DESCRIPTION=description_text
```
Invia una richiesta POST autenticata all'API Createenvironment.
Nota: dopo aver creato un'organizzazione abilitata per ibrida, non puoi eliminarla, modificarne l'ID o cambiare il progetto Google Cloud associato alla tua organizzazione. Per modificare una di queste cose, contatta l'assistenza Apigee.

L'esempio seguente mostra la struttura della richiesta che crea un'organizzazione utilizzando il comando seguente:
```
curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json"   -d '{
    "name": "'"$ENV_NAME"'",
    "displayName": "'"$ENV_DISPLAY_NAME"'",
    "description": "'"$ENV_DESCRIPTION"'"
  }'   "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/environments"
```
Se la richiesta di creazione viene approvata, l'API Environments dovrebbe rispondere con un messaggio simile al seguente:
```
{
  "name": "organizations/hybrid-example/operations/c2aee040-7e79-4fd4-b0cf-79ca1b7098a8",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.apigee.v1.OperationMetadata",
    "operationType": "INSERT",
    "targetResourceName": "organizations/hybrid-example/environments/example-env",
    "state": "IN_PROGRESS"
  }
}
```
Come indica la proprietà state nella risposta, Apigee ha iniziato a creare il nuovo ambiente, quindi il suo stato è IN_PROGRESS. Questa procedura può richiedere diversi minuti.

Crea un gruppo di ambienti

Ora crea un gruppo di ambienti e assegnagli l'ambiente appena creato. I gruppi di ambienti ti consentono di raggruppare gli ambienti e di fornire i nomi host per il routing dei proxy di cui è stato eseguito il deployment negli ambienti all'interno del gruppo. Devi creare almeno un gruppo di ambienti a cui assegnare almeno un nome host. Per una panoramica dei gruppi di ambienti, consulta Informazioni sui gruppi di ambienti.

UI ibrida di Apigee

Per creare un gruppo di ambienti utilizzando l'interfaccia utente di Apigee, segui questi passaggi:

Apri l'UI di Apigee.

Il browser apre la pagina di destinazione principale dell'interfaccia utente ibrida.

Assicurati che l'organizzazione abilitata per gli ambienti ibridi sia selezionata dall'elenco a discesa dell'organizzazione. Se non è selezionata, selezionala dall'elenco a discesa.
Fai clic su Amministratore > Ambienti > Gruppi.
Viene visualizzata la visualizzazione Panoramica dei gruppi di ambienti, con qualsiasi gruppo di ambienti creato:
Fai clic su +Gruppo di ambienti.
Viene visualizzata la finestra di dialogo Aggiungi un gruppo di ambienti.
Inserisci un nome e fai clic su Aggiungi.
Tieni il puntatore sul gruppo di ambienti appena creato e fai clic su Modifica .

Aggiungi un nome host che verrà utilizzato da tutti i proxy di cui è stato eseguito il deployment in ambienti all'interno di questo gruppo. Questo è il dominio che hai utilizzato nel Passaggio 5: configura il DNS.

Finestra di modifica gruppo di ambienti che non mostra ambienti assegnati

Fai clic su Aggiungi (+).
Viene visualizzata la finestra di dialogo Aggiungi ambiente.

Aggiungi una finestra di dialogo di ambiente che elenca gli ambienti disponibili

Seleziona un ambiente dall'elenco e fai clic su Aggiungi.

Interfaccia a riga di comando gcloud

Per creare un gruppo di ambienti utilizzando la riga di comando, segui questi passaggi:

Nella riga di comando, recupera le tue credenziali di autenticazione gcloud, come mostrato nell'esempio seguente:
```
TOKEN=$(gcloud auth print-access-token)
```
Per verificare che il token sia stato compilato, utilizza echo, come illustrato nell'esempio seguente:
```
echo $TOKEN
```
Il token dovrebbe essere visualizzato come stringa codificata.

Per maggiori informazioni, consulta la panoramica dello strumento a riga di comando gcloud.
Assicurati di aver impostato la variabile di ambiente DOMAIN, come mostrato nell'esempio seguente:
```
echo $DOMAIN
```
Questo è il nome host che verrà utilizzato da tutti i proxy di cui è stato eseguito il deployment negli ambienti all'interno di questo gruppo. Usa lo stesso dominio che hai utilizzato nel Passaggio 5: configura il DNS.

Se non è impostato, crealo con il dominio che prevedi di utilizzare per l'installazione ibrida di Apigee. Ad esempio:
```
export DOMAIN=domain-name.com
```
Assicurati che la variabile di ambiente ENV_NAME sia impostata sull'ambiente appena creato nei passaggi precedenti. Ad esempio:
```
echo $ENV_NAME
```
Crea una variabile di ambiente per il nome del gruppo di ambiente che ti interessa. Ad esempio:
```
export ENV_GROUP=environment-group-name
```

Crea il gruppo di ambienti con il comando seguente:

curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" \
   -d '{
     "name": "'"$ENV_GROUP"'",
     "hostnames":["'"$DOMAIN"'"]
   }' \
   "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups"

Assegna l'ambiente al nuovo gruppo con il comando seguente:

curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" \
   -d '{
     "environment": "'"$ENV_NAME"'",
   }' \
   "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups/$ENV_GROUP/attachments"

Passaggio successivo

Per continuare l'installazione, consulta Installazione runtime: prima di iniziare.