Passaggio 3: crea un gruppo di ambienti

Al momento stai visualizzando la versione 1.8 della documentazione di Apigee hybrid. This version is end of life. You should upgrade to a newer version. Per ulteriori informazioni, consulta Versioni supportate.

Version 1.8 (unsupported)

   Versioni supportate:

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

Versioni non supportate:

• v1.10                                      
• 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 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 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.

Interfaccia utente di Apigee

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

1. Apri l'interfaccia utente 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 che hai creato nel Passaggio 2: crea un progetto Google Cloud. Poi fai clic su Consenti.

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



2. Assicurati che la tua organizzazione 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 dall'elenco a discesa, l'interfaccia utente 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 +Ambientazione.

   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 facile da ricordare 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 ambiente può contenere solo lettere minuscole. lettere, numeri e trattini. Non puoi utilizzare lettere maiuscole o altri caratteri speciali. Inoltre, il Nome ambiente può essere fino a un massimo 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".
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 nuovo ambiente al file overrides.yaml del runtime, ma prima devi installare il runtime, quindi non anticipiamoci.

API Apigee

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, ottieni la tua autenticazione gcloud le credenziali utilizzando il comando seguente:

   Linux e MacOS

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

   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.

   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.

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

   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.

5. Verifica che l'ambiente sia stato creato correttamente:

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

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

   [
     "your-environment-name"
   ]

Crea un gruppo di ambienti

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

Interfaccia utente di Apigee

Per creare un gruppo di ambienti utilizzando l'interfaccia utente di Apigee:

1. Apri l'UI di Apigee.

Il browser accede alla pagina di destinazione principale dell'UI Apigee.

2. Assicurati che la tua organizzazione sia selezionata dall'elenco a discesa delle organizzazioni. Se non è selezionato, selezionalo dall'elenco a discesa.
3. Fai clic su Amministrazione > 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 premuto il cursore del mouse sul 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. Questo deve essere un dominio a cui hai accesso per la gestione. Il nome host può essere il dominio stesso, come example.com o 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.

API Apigee

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

1. 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

2. 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) 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 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.
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"

   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"
             }
           ]
         }
       

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 l'associazione del gruppo di ambienti sono andate a buon fine se il risultato mostra un valore hash univoco, come mostrato nell'output della risposta di esempio 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.