Parte 1: servizi Google Cloud e configurazione dell'interfaccia utente ibrida

Prima di iniziare

I passaggi descritti in questo processo di installazione ibrida vengono eseguiti con una o più delle seguenti opzioni:

  • Console Google Cloud
  • UI ibrida di Apigee
  • Riga di comando gcloud

Variabili di ambiente

I passaggi eseguiti utilizzando la riga di comando utilizzano 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 dei nomi delle variabili che contengono spazi devono essere racchiusi tra virgolette doppie. Ad esempio: 

set ORGANIZATION_DESCRIPTION="My example organization number 1"

Token credenziali di autorizzazione

Il token delle credenziali di autorizzazione di gcloud scade dopo 20 minuti. Se non completi tutti i passaggi entro questo periodo di tempo, dovrai recuperare di nuovo le credenziali di autorizzazione. Ad esempio:

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

Altre variabili di ambiente

Nel processo di questa guida ti verrà chiesto di aggiungere altre variabili di ambiente 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 dell'interfaccia utente ibrida di Apigee e dei servizi Google Cloud è il 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 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: 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. Una volta creata un'organizzazione, sarà quasi tutto pronto per effettuare chiamate API e creare proxy API.
Passaggio 5: aggiungi un ambiente UI o riga di comando ibrida di Apigee Un ambiente fornisce un contesto isolato o 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.

Iniziamo!