Passaggio 1: definizione delle variabili di ambiente

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Cosa fai in questo passaggio

Questa sezione descrive come impostare diverse variabili di ambiente utilizzate in tutta la documentazione (e in particolare in questo tutorial di configurazione). Google consiglia vivamente di utilizzarli per poter inserire i comandi come mostrato.

Questo è il primo dei due passaggi che eseguirai dalla riga di comando prima di avviare la procedura guidata di provisioning di Apigee.

Esegui il passaggio

Per definire le variabili di ambiente nella riga di comando:

  1. Definisci le seguenti variabili di ambiente per il progetto corrente: 
    PROJECT_ID="YOUR_PROJECT_ID"
PROJECT_NUMBER=$(gcloud projects describe $PROJECT_ID --format="value(projectNumber)")
RUNTIME_LOCATION="YOUR_RUNTIME_LOCATION"
ANALYTICS_REGION="YOUR_ANALYTICS_REGION"
RUNTIMEDBKEY_LOCATION="RUNTIMEDB_LOCATION"
APPKEY_KEY_RING_NAME="RUNTIMEDB_KEY_RING_NAME"
APPKEY_KEY_NAME="RUNTIMEDB_KEY_NAME"
DISK_KEY_RING_NAME="DISK_KEY_RING_NAME"
DISK_KEY_NAME="DISK_KEY_NAME"

    Dove:

    • PROJECT_ID è l'ID del progetto Cloud che hai creato nell'ambito dei Prerequisiti. Se non sai qual è l'ID progetto, utilizza la console Cloud o il comando gcloud projects list per trovarlo.
    • PROJECT_NUMBER è il numero del progetto Cloud che hai creato nell'ambito dei prerequisiti. Questo esempio esegue un comando gcloud per ottenere il numero di progetto. In alternativa, puoi trovarlo nella dashboard del progetto della console Google Cloud oppure puoi utilizzare il comando gcloud projects list.

    • RUNTIME_LOCATION è la posizione fisica in cui si trova l'istanza. I valori validi sono qualsiasi regione di Compute Engine (per le organizzazioni a pagamento) o qualsiasi zona di Compute Engine (per le organizzazioni di valutazione). Per saperne di più, consulta Località di Compute Engine.

    • ANALYTICS_REGION è la posizione fisica in cui vengono archiviati i dati di analisi.

      I valori validi sono un sottoinsieme delle regioni di Compute Engine. I valori possibili sono:

      • asia-northeast1
      • asia-south1
      • europe-west1
      • us-central1
      • us-east1
      • us-west1
      • australia-southeast1
      • europe-west2

      Sia gli account di valutazione sia quelli a pagamento utilizzano le regioni per la posizione di Analytics. Pertanto, per le organizzazioni a pagamento il suo valore può essere uguale a RUNTIME_LOCATION (anch'essa una regione). Tuttavia, il valore di ANALYTICS_REGION non deve essere uguale a RUNTIME_LOCATION. Tuttavia, se sono uguali, le prestazioni potrebbero migliorare.

      Per gli account di valutazione, la posizione di Analytics è una regione, mentre la posizione di runtime è una zona, quindi non saranno uguali.

    • RUNTIME_LOCATION è la posizione fisica in cui sono archiviati le chiavi automatizzate e la chiave dell'applicazione. Apigee utilizza una chiave dell'applicazione per criptare i dati dell'applicazione, come KVM, cache e secret del client, che vengono poi archiviati nel database.

      Analogamente alla regione di analisi, i valori validi sono un sottoinsieme delle regioni di Compute Engine. Il valore può essere uguale a $RUNTIME_LOCATION (anch'essa una regione), ma non è obbligatorio. Potrebbe esserci un vantaggio in termini di rendimento se sono uguali.

    • RUNTIME_LOCATION è il nome delle chiavi automatizzate in cui è memorizzata la chiave dell'applicazione. Il nome del portachiavi deve essere univoco per la tua organizzazione. Se crei regioni aggiuntive, i nomi dei keyring per queste regioni non possono essere uguali a quelli dei keyring esistenti.
    • APPKEY_KEY_NAME è il nome della chiave dell'applicazione. I nomi delle chiavi dell'applicazione devono essere univoci all'interno di un determinato keyring.
    • DISK_KEY_RING_NAME è il nome delle chiavi automatizzate del disco. Il nome del keyring del disco deve essere diverso dal nome della chiave dell'applicazione. Creerai il portachiavi del disco nella stessa posizione di $RUNTIME_LOCATION.
    • DISK_KEY_NAME è il nome della chiave di crittografia del disco, che Apigee utilizza per criptare i dati dell'istanza di runtime prima che vengano scritti su disco.

    L'esempio seguente definisce le variabili di ambiente per un'organizzazione a pagamento. 

    PROJECT_ID="my-cloud-project"
PROJECT_NUMBER=$(gcloud projects describe $PROJECT_ID --format="value(projectNumber)")
RUNTIME_LOCATION="us-west1"
ANALYTICS_REGION="us-west1"
RUNTIMEDBKEY_LOCATION="us-west1"
APPKEY_KEY_RING_NAME="us-west1"
APPKEY_KEY_NAME="us-west1"
DISK_KEY_RING_NAME="us-west1"
DISK_KEY_NAME="us-west1"

    Se si trattasse di un'organizzazione di valutazione, RUNTIME_LOCATION verrebbe impostato su una zona anziché su una regione.

    Utilizzerai i nomi delle variabili, ad esempio $PROJECT_ID, come valori letterali stringa nei comandi.

    Tieni presente che potresti non utilizzare tutte queste variabili di ambiente durante il provisioning e la configurazione.

  2. (Facoltativo) Controlla il tuo lavoro ripetendo i valori che hai appena impostato. Tieni presente che quando vuoi utilizzare una variabile nei comandi, anteponi al nome della variabile il simbolo del dollaro ($). 
    echo $PROJECT_ID
echo $PROJECT_NUMBER
echo $ANALYTICS_REGION
echo $RUNTIMEDBKEY_LOCATION
echo $APPKEY_KEY_RING_NAME
echo $APPKEY_KEY_NAME
echo $DISK_KEY_RING_NAME
echo $DISK_KEY_NAME

    Le risposte ai comandi echo dovrebbero essere simili alle seguenti:

    Authorization: Bearer ya29.a123456678940B63hPSAMPLEsampleKKYVsample0f3pWDWZDuH2-hENkNa
TvgZ1PD977TMvv6edBQPJezdHw040880Ol_LoD5ZDkt-i-knizia_KhA9L20sSvztL81-SAMPLE42ELPMASk2_
1CxN
my-cloud-project
1234567890
us-west1
us-west1
us-west1
$RUNTIMEDB_KEY_RING_NAME
$RUNTIMEDB_KEY_NAME
$DISK_KEY_RING_NAME
$DISK_KEY_NAME

Se riscontri errori durante questa parte della procedura, consulta la sezione Risoluzione dei problemi.

1 PASSAGGIO SUCCESSIVO: abilita le API 3 4 5 6 7 8