Prima di iniziare
I passaggi descritti in questa procedura di installazione ibrida vengono eseguiti con uno o più dei seguenti elementi:
- Console Google Cloud
- UI ibrida Apigee
-
Riga di comando
gcloud
Variabili di ambiente
I passaggi eseguiti utilizzando la riga di comando utilizzano le variabili di ambiente create dall'utente. Se la finestra del terminale è disconnessa, le variabili di ambiente non vengono salvate.
Le variabili di ambiente utilizzate in queste procedure sono le seguenti:
Linux e MacOS
export PROJECT_ID="your_project_id"
export ORG_NAME=$PROJECT_ID
export ORG_DISPLAY_NAME="org_friendly_name"
export ORGANIZATION_DESCRIPTION="org_description_text"
export ANALYTICS_REGION="analytics_region"
export RUNTIMETYPE=HYBRID
export ENV_NAME="environment_name"
export ENV_DISPLAY_NAME="env_friendly_name"
export ENV_DESCRIPTION="env_description_text"
export DOMAIN="example.com"
export ENV_GROUP="environment-group-name"
export CLUSTER_NAME="cluster_name"
export CLUSTER_LOCATION="cluster_region"
I contenuti del nome della variabile che contengono spazi devono essere racchiusi tra virgolette doppie. Ad esempio:
export ORGANIZATION_DESCRIPTION="My example organization number 1"
Windows
set PROJECT_ID="your_project_id"
set ORG_NAME=$PROJECT_ID
set ORG_DISPLAY_NAME="org_friendly_name"
set ORGANIZATION_DESCRIPTION="org_description_text"
set ANALYTICS_REGION="analytics_region"
set RUNTIMETYPE=HYBRID
set ENV_NAME="environment_name"
set ENV_DISPLAY_NAME="env_friendly_name"
set ENV_DESCRIPTION="env_description_text"
set DOMAIN="example.com"
set ENV_GROUP="environment-group-name"
set CLUSTER_NAME="cluster_name"
set CLUSTER_LOCATION="cluster_region"
I contenuti del nome della variabile che contengono spazi devono essere racchiusi tra virgolette doppie. Ad esempio:
set ORGANIZATION_DESCRIPTION="My example organization number 1"
Token delle credenziali di autorizzazione
Il token delle credenziali di autorizzazione gcloud
scade dopo 20 minuti. Se non completi tutti i passaggi entro questo periodo di tempo, devi recuperare di nuovo le credenziali
di autorizzazione. Ad esempio:
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
Altre variabili di ambiente
Ti verrà chiesto di aggiungere altre variabili di ambiente nella procedura di questa guida e potresti volerle aggiungere allo script. Ad esempio:
- LONG_RUNNING_OPERATION_ID: l'UUID dell'operazione asincrona a lunga esecuzione che fa parte del processo di creazione dell'organizzazione.
- APIGEECTL_HOME: il percorso della directory in cui installi l'utilità
apigeectl
.
Panoramica della procedura
Questa sezione fornisce una panoramica delle attività che devi svolgere per configurare la UI ibrida e i servizi Google Cloud.
Il processo generale per la configurazione della UI ibrida di Apigee e dei servizi Google Cloud è la seguente:
Azione | Basandosi | Descrizione |
---|---|---|
Passaggio 1: crea un account Google Cloud | Console Google Cloud | Per utilizzare queste procedure è necessario un account Google Cloud. Questo account sarà associato a una nuova organizzazione ibrida. |
Passaggio 2: crea un progetto Google Cloud | Console Google Cloud | I progetti Google Cloud sono la base per creare, abilitare e utilizzare i servizi Google Cloud. Un progetto organizza tutte le tue risorse Google Cloud. |
Passaggio 3: abilita le API | Console Google Cloud o riga di comando | Senza questi servizi, i servizi ibridi non sarebbero in grado di comunicare tra loro o con altri servizi. |
Passaggio 4: crea un'organizzazione | Riga di comando | I progetti appartengono alle organizzazioni. Quando avrai un'organizzazione, sarà quasi tutto pronto per effettuare chiamate API e creare proxy API. |
Passaggio 5: aggiungi un ambiente | UI ibrida Apigee o riga di comando | Un ambiente fornisce un contesto isolato o una sandbox per l'esecuzione dei proxy API. In un'unica organizzazione, puoi creare più ambienti. Se non esegui questa operazione, non potrai completare l'installazione del runtime ibrido né disporre di un ambiente in cui eseguire il deployment dei proxy API. |
Passaggio successivo
Ciascuno di questi passaggi è descritto nelle sezioni seguenti.