Questa pagina è stata tradotta dall'API Cloud Translation.

Passaggio 3: crea un gruppo di ambienti

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

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

Creazione di un ambiente

Crea prima l'ambiente prima di creare il gruppo di ambienti. Puoi creare un ambiente utilizzando l'interfaccia utente di Apigee o l'API. Ti consigliamo di utilizzare l'interfaccia utente per questi passaggi per acquisire familiarità con l'argomento.

Apigee nella console Cloud

Per creare un nuovo ambiente in Apigee nella console Cloud:

Apri la UI di Apigee nella console Cloud in un browser.
Seleziona Gestione > Ambienti nel riquadro di navigazione a sinistra riquadro.
Nel riquadro Ambienti, fai clic su + Crea ambiente.
Nel riquadro Crea un ambiente, inserisci quanto segue:
- Nome: il nome dell'ambiente programmatico. 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 in dell'organizzazione.
- Nome visualizzato: il nome dell'ambiente visualizzato nell'interfaccia utente.
- Descrizione: facoltativa. Una descrizione dell'ambiente.
- Istanza: lascia vuoto il campo Istanza. Le istanze non si applicano alle installazioni ibride di Apigee.
- Gruppo di ambienti: per il momento lascia vuoto il campo Gruppo di ambienti. Nella procedura successiva creerai un gruppo di ambienti.
- Tipo di deployment: per la maggior parte delle installazioni ibride di Apigee, seleziona l'opzione per eseguire il deployment di proxy API individuali. Se vuoi, puoi eseguire il deployment di un archivio dell'ambiente di configurazione del 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.
Fai clic su Crea.

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

Interfaccia utente Apigee classica

Per accedere all'interfaccia utente e aggiungere un ambiente, segui questi passaggi:

Apri l'UI di Apigee. Se è la prima volta che accedi, il formato ibrido mostra una finestra di dialogo per il consenso. Se ti viene chiesto di selezionare uno o più account, scegli quello proprietario del progetto Google Cloud che stai utilizzando per installare Apigee hybrid. Poi fai clic su Consenti.

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

La pagina di destinazione in Apigee
UI, che consiste nella navigazione a sinistra e immagini di grandi dimensioni che sono link.

Assicurati che la tua organizzazione sia selezionata dall'elenco a discesa delle organizzazioni. Se non è selezionata, selezionala dall'elenco a discesa, come mostrato nell'esempio seguente:
Fai clic su Amministrazione > Ambienti > Panoramica.

Viene visualizzata la visualizzazione Ambienti, senza ambienti (ancora):
Fai clic su +Ambiente.
Viene visualizzata la finestra di dialogo Nuovo ambiente:
Inserisci le seguenti informazioni nella finestra di dialogo Nuovo ambiente:
1. Nome visualizzato (obbligatorio): un nome descrittivo per l'ambiente utilizzato nell'interfaccia utente. Ad esempio, "Il mio primo ambiente". o "test". A differenza dell'ambiente [Nome di persona], il Nome visualizzato può includere lettere maiuscole e altri caratteri speciali caratteri.
2. Nome ambiente (obbligatorio): il nome programmatico dell'ambiente, noto anche come ID ambiente.
  Ad esempio, "mio-ambiente" o "test".
  
  Attenzione: un nome dell'ambiente può contenere solo lettere minuscole, numeri e trattini. Non puoi utilizzare lettere maiuscole o altri caratteri speciali. Inoltre, il nome dell'ambiente può avere una lunghezza massima di 32 caratteri. Ad esempio: my-test-env o my-test-env-42.
  
  Il nome visualizzato e il nome dell'ambiente possono essere diversi.
3. Descrizione (facoltativa): informazioni aggiuntive sull'ambiente che vuoi aggiungere come promemoria dello scopo dell'ambiente. Ad esempio, "Created durante l'installazione iniziale".
Mantieni le altre impostazioni predefinite e fai clic su Crea.
Apigee crea il nuovo ambiente.

Ora devi creare un gruppo di ambienti e aggiungere il nuovo ambiente al gruppo.

API Apigee

Per creare un ambiente con l'API Create environments, svolgi i seguenti passaggi:

Apri un terminale sul dispositivo che stai utilizzando per gestire Apigee.
Nella riga di comando, recupera le credenziali di autenticazione gcloud utilizzando il seguente comando:
Linux e MacOS
```
export TOKEN=$(gcloud auth print-access-token)
```
Per verificare che il token sia stato compilato, usa echo come nell'esempio seguente:
```
echo $TOKEN
```
Il token dovrebbe essere visualizzato come stringa codificata.
Windows
```
for /f "tokens=*" %a in ('gcloud auth print-access-token') do set TOKEN=%a
```
Per verificare che il token sia stato inserito, utilizza echo, come illustrato nell'esempio seguente:
```
echo %TOKEN%
```
Il token dovrebbe essere visualizzato come stringa codificata.
Crea la seguente variabile di ambiente:
Linux e MacOS
```
export ENV_NAME="YOUR_ENV_NAME"
```
Windows
```
set ENV_NAME="YOUR_ENV_NAME"
```
Dove:
- ENV_NAME (Obbligatorio) Il nome dell'ambiente può contenere lettere minuscole, trattini e numeri. deve iniziare con una lettera minuscola. Questo nome verrà utilizzato come identificatore e non può essere modificato dopo la creazione dell'ambiente.

Chiama la seguente API Apigee:

curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json"   -d '{
    "name": "'"$ENV_NAME"'"
  }'   "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/environments"

A una richiesta di creazione riuscita, l'API Environments deve rispondere con un messaggio simile a:

{
  "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 indicato dalla proprietà state nella risposta, Apigee ha iniziato a creare il nuovo ambiente, quindi il suo stato è IN_PROGRESS.

Verifica che l'ambiente sia stato creato correttamente:
```
curl -H "Authorization: Bearer $TOKEN" \
          "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/environments"
```
In caso di richiesta di creazione andata a buon fine, l'API Environments risponde con un messaggio simile al seguente:
```
[
  "your-environment-name"
]
```

Creare un gruppo di ambienti

Ora crea un gruppo di ambienti e assegnalo all'ambiente appena creato.

Apigee nella console Cloud

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

Apri l'interfaccia utente di Apigee nella console Cloud in un browser.
Seleziona Gestione > Ambienti nel riquadro di navigazione a sinistra riquadro.
Nel riquadro Ambienti, seleziona Gruppi di ambienti.
Fai clic su + Crea gruppo di ambienti.
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.
- Hostame: 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 il gruppo: non possono essere utilizzati da altri gruppi di ambienti.
  
  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 in gruppo di ambienti.
Fai clic su Crea.

UI classica di Apigee

Per creare un gruppo di ambienti utilizzando la UI di Apigee, segui questi passaggi:

Apri l'UI di Apigee.

Il browser accede alla pagina di destinazione principale della UI di Apigee.

Assicurati che la tua organizzazione sia selezionata dall'elenco a discesa delle organizzazioni. Se non è selezionato, selezionalo dall'elenco a discesa.
Fai clic su Amministratore > Ambienti > Gruppi.
Viene visualizzata la visualizzazione Panoramica gruppi di ambienti:
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 ambiente appena creato e fai clic su Modifica .

Aggiungi un nome host che verrà utilizzato da tutti i proxy di cui è stato eseguito il deployment negli ambienti all'interno di questo gruppo. Deve trattarsi di un dominio a cui hai accesso amministrativo. Il nome host può essere il dominio stesso, come example.com, oppure può includere un sottodominio come my-proxies.example.com.

Se devi registrare un dominio, rivolgiti a un registrar di dominio come Google Domains.

Facoltativamente, puoi configurare un bilanciatore del carico per il dominio. Per scoprire di più sul caricamento bilanciatori del carico, vedi Cloud Load Balancing Panoramica.
Fai clic su Aggiungi (+) nella casella Ambienti.
Viene visualizzata la finestra di dialogo Aggiungi ambiente.
Seleziona un ambiente dall'elenco e fai clic su Aggiungi.
Fai clic su Salva.

API Apigee

Per creare un gruppo di ambienti utilizzando l'API Apigee:

Nella riga di comando, ottieni la tua autenticazione gcloud le credenziali utilizzando il comando seguente:
Linux e MacOS
```
TOKEN=$(gcloud auth print-access-token)
```
Windows
```
for /f "tokens=*" %a in ('gcloud auth print-access-token') do set TOKEN=%a
```
Crea le seguenti variabili di ambiente:
Linux e MacOS
```
export DOMAIN="YOUR_DOMAIN"
export ENV_GROUP="YOUR_ENVIRONMENT_GROUP"
```
Windows
```
 data-terminal-prefix=">">set ENV_GROUP="YOUR_ENVIRONMENT_GROUP"
 data-terminal-prefix=">">set DOMAIN="YOUR_DOMAIN"
```
Dove:
- DOMAIN (Obbligatorio) Si tratta del nome host utilizzato da tutti i proxy di cui è stato eseguito il deployment in ambienti all'interno di questo gruppo. Deve trattarsi di un dominio che gestisci. L'indirizzo può essere il dominio stesso, ad esempio example.com, oppure può includere un sottodominio, ad esempio my-proxies.example.com. Se non hai un dominio gestito, per il momento puoi inserire un segnaposto. Puoi modificare l'indirizzo del dominio in un secondo momento.
- ENV_GROUP (Obbligatorio) Il nome dell'ambiente può contenere lettere minuscole, trattini e numeri. deve iniziare con una lettera minuscola. Questo nome verrà utilizzato come identificatore e non può essere modificato dopo la creazione.

Crea il gruppo di ambienti:

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:

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"

Verifica se il gruppo di ambienti è stato creato correttamente con il seguente comando CURL:

curl -H "Authorization: Bearer $TOKEN" \
  "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups"

In caso di richiesta di creazione andata a buon fine, l'API Environments Group risponde con un messaggio simile al seguente:

      {
        "environmentGroups": [
          {
            "name": "your_envgroup_hybrid",
            "hostnames": [
              "apigee.hybrid.com"
            ],
            "createdAt": "1677826235324",
            "lastModifiedAt": "1677826235324",
            "state": "ACTIVE"
          }
        ]
      }

Recupera gli allegati più recenti per il gruppo di ambienti appena creato utilizzando il seguente comando CURL:

curl -H "Authorization: Bearer $TOKEN" \
  "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups/$ENV_GROUP/attachments"

La creazione e il collegamento del gruppo di ambienti sono riusciti se il risultato mostra un valore hash univoco, come mostrato nel seguente esempio di output di risposta:


        {
          "environmentGroupAttachments": [
            {
              "name": "c27046d1-b83e-4cba-xxxx-caaa660b2bd6",
              "environment": "your_envtest_hybrid",
              "createdAt": "1677826263567",
              "environmentGroupId": "your_envgroup_hybrid"
            }
          ]
        }

Passaggio successivo

Per continuare l'installazione, vai a Parte 2: configurazione del runtime ibrido.

Passaggio 3: crea un gruppo di ambienti

Creazione di un ambiente

Apigee nella console Cloud

Interfaccia utente Apigee classica

API Apigee

Linux e MacOS

Windows

Linux e MacOS

Windows

Creare un gruppo di ambienti

Apigee nella console Cloud

UI classica di Apigee

API Apigee

Linux e MacOS

Windows

Linux e MacOS

Windows

Passaggio successivo