Prima di iniziare
I passaggi descritti in questa procedura di installazione ibrida vengono eseguiti con uno o più dei seguenti elementi:
- Console Google Cloud
- Interfaccia utente di Apigee hybrid
-
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/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 dei nomi delle variabili 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 il 20
minuti. Se non completi tutti i passaggi entro questo periodo di tempo, devi recuperare nuovamente le credenziali di autorizzazione. Ad esempio:
Nella riga di comando, ottieni la tua autenticazione gcloud
le credenziali utilizzando il comando seguente:
Linux/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
Nel processo di questa guida ti verrà chiesto di aggiungere altre variabili di ambiente e potresti volere per aggiungerle allo script. Ad esempio:
- LONG_RUNNING_OPERATION_ID: l'UUID dell'operazione asincrona a lunga esecuzione che fa parte della procedura di creazione dell'organizzazione.
- APIGEECTL_HOME: il percorso della directory in cui installi
apigeectl
utilità.
Panoramica della procedura
Questa sezione fornisce una panoramica delle attività da svolgere per configurare l'interfaccia utente 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, devi disporre di un account Google Cloud. Questo account verrà 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: attiva le API | Console Google Cloud o riga di comando | Senza questi, i servizi ibridi non potrebbero comunicare tra loro o con altri servizi. |
Passaggio 4: crea un'organizzazione | Riga di comando | I progetti appartengono alle organizzazioni. Quando avrai un'organizzazione, sarai quasi pronto per chiamate API e creazione di proxy API. |
Passaggio 5: aggiungi un ambiente | Interfaccia utente o riga di comando di Apigee hybrid | 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 lo fai, non potrai completare l'installazione del runtime ibrido, né avrai a disposizione un luogo in cui eseguire il deployment dei proxy API. |
Passaggio successivo
Ciascuno di questi passaggi è descritto nelle sezioni seguenti.