Passaggio 3: crea 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ù, 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 l'UI di Apigee o l'API. Ti consigliamo di utilizzare l'interfaccia utente per questi passaggi per acquisire familiarità.

Interfaccia utente di Apigee

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

  1. 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 scegliere tra più account, scegli quello proprietario del progetto Google Cloud che stai utilizzando per installare Apigee hybrid. Quindi, fai clic su Consenti.

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

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

  2. Assicurati che la tua organizzazione sia selezionata dall'elenco a discesa dell'organizzazione. Se non è selezionata, selezionala dall'elenco a discesa, come illustrato nell'esempio seguente:

    Un elenco di organizzazioni abilitate per la modalità ibrida

  3. Fai clic su Amministratore > Ambienti > Panoramica.

    Il menu della UI di Apigee che mostra Amministratore, Ambienti e Panoramica espanso

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

  4. Fai clic su +Ambiente.

    Viene visualizzata la finestra di dialogo Nuovo ambiente:

    La finestra di dialogo Nuovo ambiente

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

      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".
  6. Mantieni gli altri valori predefiniti 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 per la creazione di 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 di gcloud utilizzando il seguente comando:

    Linux / MacOS 

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

    Per verificare che il token sia stato completato, utilizza echo, come illustrato 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 completato, utilizza echo, come illustrato nell'esempio seguente:

    echo %TOKEN%

    Il token dovrebbe essere visualizzato come stringa codificata.
  3. Crea la seguente variabile di ambiente:

    Linux / 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 e deve iniziare con una lettera minuscola. Questo nome verrà utilizzato come identificatore e non può essere modificato dopo la creazione dell'ambiente.
  4. 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"

    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.

  5. Controlla per verificare che l'ambiente sia stato creato correttamente: 
    curl -H "Authorization: Bearer $TOKEN" \
          "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/environments"

    Su una richiesta di creazione riuscita, l'API Environments risponde con un messaggio simile al seguente:

    [
  "your-environment-name"
]

Crea un gruppo di ambienti

Ora crea un gruppo di ambienti e assegnagli l'ambiente appena creato.

Interfaccia utente di Apigee

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

  1. Apri l'UI di Apigee.

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

  2. Assicurati che la tua organizzazione sia selezionata dall'elenco a discesa dell'organizzazione. Se non è selezionata, selezionala dall'elenco a discesa.
  3. Fai clic su Amministratore > Ambienti > Gruppi.

    Viene visualizzata la vista Panoramica dei gruppi di ambienti:

    Visualizzazione Gruppi di ambienti

  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 in cui il campo Nome è vuoto

  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 in 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, o può includere un sottodominio come my-proxies.example.com.

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

    7. Finestra di modifica gruppo di ambienti che non mostra ambienti assegnati

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

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

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

API Apigee

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

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

    Linux / MacOS 

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

    Windows 

    for /f "tokens=*" %a in ('gcloud auth print-access-token') do set TOKEN=%a
  2. Crea le seguenti variabili di ambiente:

    Linux / 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) Questo è il nome host utilizzato da tutti i proxy di cui è stato eseguito il deployment negli ambienti all'interno di questo gruppo. Deve essere un dominio che gestisci. L'indirizzo può essere il dominio stesso, ad esempio example.com, o può includere un sottodominio come my-proxies.example.com. Se non hai un dominio gestito, per ora 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 e deve iniziare con una lettera minuscola. Questo nome verrà utilizzato come identificatore e non può essere modificato dopo la creazione.
  3. 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"
  4. 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"
  5. 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"

    Su una richiesta di creazione riuscita, 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"
          }
        ]
      }
  6. 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 nell'output di risposta di esempio riportato di seguito:

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