Passaggio 5: creazione di un gruppo di ambienti

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

In Apigee, i proxy API vengono sottoposti a deployment 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.

Crea un ambiente

Crea prima l'ambiente e poi il gruppo di ambienti. È possibile creare un ambiente utilizzando l'interfaccia utente di Apigee hybrid o tramite la riga di comando (CLI). Ti consigliamo di utilizzare la UI per questi passaggi per acquisire familiarità con l'interfaccia.

UI di Apigee hybrid

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

  1. Apri la UI di Apigee. Se è la prima volta che accedi, hybrid mostra una finestra di dialogo per il consenso. Se ti viene chiesto di scegliere tra più account, seleziona quello proprietario del progetto cloud che hai creato nel Passaggio 2: crea un progetto Google Cloud. Quindi, fai clic su Consenti.

    2. Il browser si apre nella pagina di destinazione principale dell'UI ibrida:

    La pagina di destinazione nell'interfaccia utente ibrida di Apigee, che consiste in un menu di navigazione a sinistra e grandi immagini che fungono da link.

  2. Assicurati che la tua organizzazione abilitata all'ibrido sia selezionata dall'elenco a discesa delle organizzazioni. Se non è selezionato, selezionalo dall'elenco a discesa, come mostrato nell'esempio seguente:

    Un elenco delle organizzazioni per cui è abilitata la modalità ibrida

  3. Fai clic su Amministratore > Ambienti > Panoramica.

    Il menu dell'interfaccia utente di Apigee hybrid che mostra Admin, Environments e Overview espansi

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

    La visualizzazione Ambienti, che è vuota (nessun ambiente)

  4. Fai clic su +Ambientazione.

    Viene visualizzata la finestra di dialogo Nuovo ambiente:

    La nuova finestra di dialogo dell'ambiente

  5. 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 del nome dell'ambiente, il nome visualizzato può includere lettere maiuscole e altri caratteri speciali.
    2. Nome ambiente (obbligatorio): il nome programmatico dell'ambiente, noto anche come ID ambiente.

      Ad esempio, "my-environment" o "test".

      Il nome visualizzato e il nome dell'ambiente possono essere diversi.

    3. Descrizione (facoltativo): informazioni aggiuntive sull'ambiente che vuoi aggiungere come promemoria dello 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:

    Messaggio di stato di provisioning in sospeso

    Dopo qualche istante, lo stato cambia in provisioned:

    È stato predisposto un nuovo ambiente. Messaggio

    Tuttavia, non hai ancora finito. È inoltre necessario aggiungere il nuovo ambiente al file overrides.yaml del runtime, ma prima bisogna installare il runtime, quindi non anticipiamo i tempi.

gcloud CLI

Per creare un ambiente con l'API Create environments, segui questi passaggi:

  1. Apri un terminale sul dispositivo che utilizzi per gestire Apigee.

  2. Nella riga di comando, recupera le 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 mostrato nell'esempio seguente:

    echo $TOKEN

    Dovrebbe essere visualizzato il token come stringa codificata.

    Per saperne di più, consulta la panoramica dello strumento a riga di comando gcloud.

  3. Creare variabili d'ambiente per gli elementi dell'ambiente. Nel comando utilizzerai la seguente variabile per crearla:
    • ENV_NAME (Necessario) è l'ID programmatico 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 identificativo e non potrà essere modificato dopo la creazione. 
      export ENV_NAME=environment_name
    • ENV_DISPLAY_NAME (Necessario) è il nome intuitivo del tuo 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 (Necessario) è 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) sono informazioni sull'ambiente che vuoi utilizzare come promemoria del suo scopo. Ad esempio, "Example environment for Apigee Hybrid instructions". 
      ENV_DESCRIPTION=description_text
  4. Invia una richiesta POST autenticata all'API Crea ambienti.

    L'esempio seguente mostra la struttura della richiesta che crea un ambiente, utilizzando il seguente comando:

    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"

    In 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 indicato dalla proprietà state nella risposta, Apigee ha iniziato a creare il nuovo ambiente, quindi il suo stato è IN_PROGRESS. Questo processo può richiedere diversi minuti.

Crea un gruppo di ambienti

Ora crea un gruppo di ambienti e assegnagli l'ambiente che hai appena creato. I gruppi di ambienti consentono di raggruppare gli ambienti e forniscono i nomi host per instradare i 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, vedi Informazioni sugli ambienti e sui gruppi di ambienti.

UI di Apigee hybrid

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

  1. Apri la UI di Apigee.

    2. Il tuo browser ti reindirizza alla pagina di destinazione principale dell'interfaccia utente ibrida.

  2. Assicurati che la tua organizzazione abilitata all'ibrido 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 visualizzazione Panoramica dei gruppi di ambienti, con i gruppi di ambienti creati:

    La visualizzazione Gruppi di ambienti, che mostra i gruppi creati

  4. Fai clic su + Gruppo di ambienti.

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

    Finestra di dialogo Aggiungi gruppo di ambienti che mostra il campo Nome vuoto

  5. Inserisci un nome e fai clic su Aggiungi.

  6. Tieni il puntatore sopra il gruppo di ambienti appena creato e poi 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. Se devi registrare un dominio, rivolgiti a un registrar di domini come Google Domains.

    7. Finestra Modifica gruppo di ambienti che mostra nessun ambiente assegnato

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

    9. Finestra di dialogo Aggiungi ambiente che elenca gli ambienti disponibili

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

gcloud CLI

Per creare un gruppo di ambienti utilizzando la riga di comando:

  1. Nella riga di comando, recupera le 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 mostrato nell'esempio seguente:

    echo $TOKEN

    Dovrebbe essere visualizzato il token come stringa codificata.

    Per saperne di più, consulta la panoramica dello strumento a riga di comando gcloud.

  2. Assicurati che la variabile di ambiente DOMAIN sia impostata 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. Deve trattarsi di un dominio a cui hai accesso amministrativo.

    Se non è già impostato, crealo con il dominio che intendi utilizzare per la tua 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 ambienti che vuoi utilizzare. Ad esempio: 
    export ENV_GROUP=environment-group-name
  5. Crea il gruppo di ambienti con il seguente comando: 
    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 seguente comando: 
    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 con l'installazione, consulta Installazione del runtime: prima di iniziare.