Passaggio 5: creazione di un gruppo di ambienti

Stai visualizzando la versione 1.7 della documentazione di Apigee hybrid. This version is end of life. You should upgrade to a newer version. Per maggiori informazioni, vedi Versioni supportate.

Version 1.7 (unsupported)

Versioni supportate:

• v1.12 (più recente)                        
• v1.11                         
• v1.10                                        
• Elenco delle versioni supportate

Versioni non supportate:

• v1.9                                         
• v1.8                                         
• v1.7                                         
• v1.6                                         
• v1.5                                         
• v1.4                                         
• v1.3                                         
• v1.2                                         
• v1.1                                         

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 i proxy. Gli ambienti sono organizzati in gruppi di ambienti, che forniscono i 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ù, vedi Informazioni sugli ambienti e sui gruppi di ambienti.

Creazione di un ambiente

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

UI ibrida Apigee

Per accedere alla UI ibrida e aggiungere un ambiente, segui questi passaggi:

1. Apri l'UI di Apigee. Se è la prima volta che accedi, ibrido mostra una finestra di dialogo per il consenso. Se ti viene chiesto di selezionare da più account, scegli quello proprietario del progetto che hai 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:



2. Assicurati che la tua organizzazione con abilitazione ibrida sia selezionata dall'elenco a discesa delle organizzazioni. Se non è selezionato, selezionalo dall'elenco a discesa, come illustrato nell'esempio seguente:

   

   Nota: quando selezioni un'organizzazione con opzione ibrida 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.
3. Fai clic su Amministratore > Ambienti > Panoramica.

   

   Viene visualizzata la vista Ambienti, senza ambienti (ancora):

   

4. Fai clic su +Ambiente.

   Viene visualizzata la finestra di dialogo Nuovo ambiente:

   

5. Inserisci le seguenti informazioni nella finestra di dialogo Nuovo ambiente:
   1. Nome visualizzato (obbligatorio): un nome semplice per l'ambiente utilizzato nell'interfaccia utente. Ad esempio, "Il mio primo ambiente" o "test". A differenza del Nome ambiente, il Nome visualizzato può includere caratteri maiuscoli e altri caratteri speciali.
   2. Nome ambiente (obbligatorio): il nome della pubblicità programmatica per l'ambiente, noto anche come ID ambiente.

      Ad esempio, "mio-ambiente" o "test".

      Attenzione:un nome 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 32 caratteri. Ad esempio: my-test-env o my-test-env-42.

      Il Nome visualizzato e il Nome ambiente possono essere diversi.

   3. (Facoltativo) Descrizione: ulteriori informazioni sull'ambiente che vuoi aggiungere per ricordare lo scopo dell'ambiente. Ad esempio, "Creato durante l'installazione iniziale".
6. Fai clic su Crea.

   Apigee crea il nuovo ambiente e indica che è In attesa di provisioning:

   

   Dopo qualche istante, diventa provisioning effettuato:

   

   Tuttavia, non hai ancora terminato. Devi anche aggiungere il tuo 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 Create ambienti, segui questi passaggi:

1. Apri un terminale sul dispositivo che stai utilizzando per gestire Apigee.

2. 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, utilizza echo, come mostrato 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 compilato, utilizza echo, come mostrato nell'esempio seguente:

   echo %TOKEN%

   Il token dovrebbe essere visualizzato come stringa codificata.

3. Assicurati di aver definito le variabili di ambiente necessarie con i seguenti comandi:

   echo ${PROJECT_ID}
   echo ${ENV_NAME}
   echo ${ENV_DISPLAY_NAME}
   echo ${ORG_NAME}
   echo ${ENV_DESCRIPTION}

   Se necessario, crea o ridefinisci le seguenti variabili di ambiente per gli elementi dell'ambiente. Per crearlo, utilizzerai la seguente variabile nel comando:

   • 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 semplice dell'ambiente. Questo valore non deve essere 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 informazioni sull'ambiente che vuoi utilizzare per ricordarne lo scopo. Ad esempio, "Ambiente di esempio per le istruzioni di Apigee Hybrid".

     ENV_DESCRIPTION=description_text

4. Invia una richiesta POST autenticata all'API Create ambienti.
   Nota: dopo aver creato un'organizzazione con abilitazione ibrida, non puoi eliminare l'organizzazione, modificarne l'ID né cambiare il progetto Google Cloud associato alla tua organizzazione. Per modificare una qualsiasi di queste cose, contatta l'assistenza Apigee.

   L'esempio seguente mostra la struttura della richiesta che crea un ambiente 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"

   A una richiesta di creazione riuscita, 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 assegna al gruppo l'ambiente appena creato. I gruppi di ambienti consentono di raggruppare gli ambienti e 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 e assegnare almeno un nome host al gruppo. Per una panoramica dei gruppi di ambienti, consulta Informazioni sugli ambienti e sui gruppi di ambienti.

Nota: ogni gruppo di ambienti creato con un ambiente collegato deve essere incluso in tutti i file di override in cui viene utilizzato l'ambiente.

UI ibrida Apigee

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

1. Apri l'UI di Apigee.

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

2. Assicurati che la tua organizzazione con abilitazione ibrida sia selezionata dall'elenco a discesa delle organizzazioni. Se non è selezionato, selezionalo dall'elenco a discesa.
3. Fai clic su Amministratore > Ambienti > Gruppi.

   Viene visualizzata la vista Panoramica dei gruppi di ambienti, con tutti i gruppi di ambienti creati:

   

4. Fai clic su + Gruppo di ambienti.

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

   

5. Inserisci un nome e fai clic su Aggiungi.

6. 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 negli ambienti all'interno di questo gruppo. Deve essere un dominio a cui hai accesso per la gestione. Il nome host può essere il dominio stesso, ad esempio example.com, oppure può includere un sottodominio come my-proxies.example.com.

   Se hai bisogno di registrare un dominio, consulta un registrar di domini come Google Domains.



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



9. 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:

1. Nella riga di comando, recupera le credenziali di autenticazione gcloud utilizzando il seguente comando:

   Linux e MacOS

   TOKEN=$(gcloud auth print-access-token)

   Windows

   for /f "tokens=*" %a in ('gcloud auth print-access-token') do set TOKEN=%a

2. Assicurati di avere impostato la variabile di ambiente DOMAIN come illustrato 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. Deve trattarsi di un dominio a cui hai accesso per la gestione. Il nome host può essere il dominio stesso, ad esempio example.com, oppure può includere un sottodominio come my-proxies.example.com.

   Se non è impostato, crealo con il dominio che prevedi di utilizzare per l'installazione ibrida di Apigee. Ad esempio:

   export DOMAIN=domain-name.com

3. Assicurati che la variabile di ambiente ENV_NAME sia impostata sull'ambiente che hai appena creato nei passaggi precedenti. Ad esempio:

   echo $ENV_NAME

4. Crea una variabile di ambiente per il nome del gruppo di ambiente che vuoi utilizzare. Ad esempio:

   export ENV_GROUP=environment-group-name

5. 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"
       

6. 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"
       

Congratulazioni.

Ora che hai creato un account e un progetto Google Cloud, eseguito il provisioning di un'organizzazione, abilitato le API necessarie e creato un nuovo ambiente e un nuovo gruppo di ambienti, puoi installare e configurare il runtime ibrido Apigee.

Passaggio successivo

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