Passaggio 1: definizione delle variabili di ambiente

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Attività di questo passaggio

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

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

Esegui il passaggio

Per definire le variabili di ambiente sulla 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 progetto Cloud che hai creato nell'ambito dei prerequisiti. Se non sai qual è il tuo 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 emette un comando gcloud per recuperare il numero di progetto. In alternativa, puoi trovarlo nella dashboard del progetto della console Google Cloud o utilizzare il comando gcloud projects list per trovarlo.

    • 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 ulteriori informazioni, consulta Località di Compute Engine.

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

      I valori validi sono un sottoinsieme delle regioni 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 che quelli a pagamento utilizzano le regioni per la posizione di Analytics. Pertanto, per le organizzazioni a pagamento, il valore può essere uguale a RUNTIME_LOCATION (anche una regione). Tuttavia, il valore di ANALYTICS_REGION non deve essere uguale a RUNTIME_LOCATION. Tuttavia, potrebbe esserci un vantaggio in termini di rendimento se sono uguali.

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

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

      Come per la regione di analisi, i valori validi sono un sottoinsieme delle regioni di Compute Engine. Il valore può essere uguale a $RUNTIME_LOCATION (anche una regione), ma non è obbligatorio. Se sono uguali, il rendimento potrebbe migliorare.

    • RUNTIME_LOCATION è il nome del keyring 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 ai nomi 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 della chiave automatizzata del disco. Il nome del keyring del disco deve essere diverso dal nome della chiave dell'applicazione. Puoi creare il portachiavi con il disco nella stessa posizione in cui si trova $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 tratta di un'organizzazione di valutazione, RUNTIME_LOCATION verrà impostato su una zona anziché su una regione.

    Utilizzerai i nomi delle variabili, ad esempio $PROJECT_ID, come stringhe letterali 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 eseguendo l'echo dei valori appena impostati. Tieni presente che quando vuoi utilizzare una variabile nei comandi, devi precedere il nome della variabile con il segno di 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 al seguente:

    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