Parte 1: servizi Google Cloud e configurazione di UI ibrida

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.

Iniziamo