Passaggio 6: creazione di 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 nomi host per tutti dei proxy distribuiti negli ambienti all'interno del gruppo. Devi avere almeno un ambiente almeno un gruppo di ambienti. Per ulteriori informazioni, vedi Informazioni sugli ambienti e sui gruppi di ambienti.

Autorizzazioni obbligatorie

Il creatore del gruppo di ambienti e di ambiente deve avere almeno Apigee Amministratore dell'organizzazione. Tuttavia, se sei il proprietario del progetto, avrai automaticamente autorizzazione necessaria per creare un ambiente o un gruppo di ambienti. Tuttavia, se deleghi questa attività a un non è un 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 tramite la UI ibrida Apigee o l'interfaccia a riga di comando. Ti consigliamo di utilizzare l'interfaccia utente per questi passaggi per acquisire familiarità con l'argomento.

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, il formato 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.

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

    La pagina di destinazione in Apigee UI ibrida, composta da un sistema di navigazione a sinistra e da immagini di grandi dimensioni sotto forma di link.

  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:

    Un elenco di organizzazioni con tecnologia ibrida

  3. Fai clic su Amministratore > Ambienti > Panoramica.

    Menu della UI ibrida di Apigee con espansione in Amministratore, Ambienti e Panoramica

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

    La vista Ambienti, che è vuota (nessun ambiente)

  4. Fai clic su +Ambiente.

    Viene visualizzata la finestra di dialogo Nuovo ambiente:

    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 dell'ambiente [Nome di persona], il Nome visualizzato può includere lettere maiuscole e altri caratteri speciali caratteri.
    2. Nome ambiente (obbligatorio): il nome della pubblicità programmatica per l'ambiente. noto anche come ID ambiente.

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

      Il Nome visualizzato e il Nome ambiente possono essere diverso.

    3. Descrizione (facoltativa): informazioni aggiuntive sull'ambiente che che vuoi aggiungere come promemoria dello scopo dell'ambiente. Ad esempio, "Created durante l'installazione iniziale".
  6. Fai clic su Crea.

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

    Stato provisioning in attesa messaggio

    Dopo qualche istante, diventa provisioning effettuato:

    Nuovi messaggio di stato di provisioning dell'ambiente

    Tuttavia, non hai ancora terminato. Devi inoltre aggiungere il nuovo ambiente il 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 Crea ambienti di servizio, 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, 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

    Il token dovrebbe essere visualizzato come stringa codificata.

    Per ulteriori informazioni, vedi Panoramica dello strumento a riga di comando gcloud.

  3. Crea variabili di ambiente per gli elementi dell'ambiente. Utilizzerai la seguente variabile in il comando per crearlo:
    • ENV_NAME (Obbligatorio) è l'ID pubblicità programmatica per il tuo completamente gestito di Google Cloud. 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 
      export ENV_NAME=environment_name
    • ENV_DISPLAY_NAME (Obbligatorio) è il nome semplice da usare del tuo 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 hai definito la variabile di ambiente ORG_NAME da Passaggio 4: crea un'organizzazione: 
      echo $ORG_NAME
    • ENV_DESCRIPTION (Facoltativo) contiene informazioni su dell'ambiente di rete che vuoi utilizzare come promemoria del suo scopo. Ad esempio, "Esempio per le istruzioni di Apigee Hybrid". 
      ENV_DESCRIPTION=description_text
  4. Invia una richiesta POST autenticata all'API Create ambienti.

    L'esempio seguente mostra la struttura di richieste che crea un'organizzazione 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"

    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 indica la proprietà state nella risposta, Apigee ha iniziato a creare il nuovo ambiente, quindi il suo stato è IN_PROGRESS. Questa procedura può richiedere diverse 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 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 e devi assegnare almeno un nome host al gruppo. Per una panoramica dei gruppi di ambienti, vedi Informazioni sui gruppi di ambienti.

UI ibrida Apigee

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

  1. Apri l'UI di Apigee.

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

    La vista Gruppi di ambienti, che mostra tutti i gruppi creati

  4. Fai clic su + Gruppo di ambienti.

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

    La 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 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. Questo è il dominio che utilizzavi Passaggio 5: configura il DNS.

    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 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, 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

    Il token dovrebbe essere visualizzato come stringa codificata.

    Per ulteriori informazioni, vedi Panoramica dello strumento a riga di comando gcloud.

  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 per gli utilizzi odierni. Usa lo stesso dominio che hai utilizzato 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
  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 environmnet che desideri. 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"

Passaggio successivo

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