Passaggio 1: definizione delle variabili di ambiente

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Cosa stai facendo in 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 utilizzarli in modo da poter inserire i comandi come mostrato.

Questo è il primo dei 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 nella riga di comando:

  1. Definisci le seguenti variabili di ambiente per il progetto attuale: 
    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 con certezza quale sia 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. In questo esempio viene inviato un comando gcloud per ottenere il numero del progetto. In alternativa, lo puoi trovare nella dashboard del progetto della console Google Cloud o puoi utilizzare il comando gcloud projects list per trovarlo.

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

    • ANALYTICS_REGION è la posizione fisica in cui memorizzi 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 gli account a pagamento utilizzano le regioni per la sede dell'analisi. Pertanto, per le organizzazioni a pagamento, il suo valore può essere uguale a RUNTIME_LOCATION (anche una regione). Tuttavia, il valore di ANALYTICS_REGION non deve essere uguale a RUNTIME_LOCATION. Tuttavia, se i due sono uguali, il rendimento potrebbe essere vantaggioso.

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

    • RUNTIME_LOCATION è la posizione fisica in cui sono archiviati la chiave e il keyring dell'applicazione. Apigee utilizza una chiave applicazione per criptare i dati delle applicazioni, come KVM, cache e client secret, 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 (anche una regione), ma non è necessario. Se sono uguali, le prestazioni potrebbero essere vantaggiose.

    • RUNTIME_LOCATION è il nome del keyring in cui è archiviata la chiave dell'applicazione. Il nome del keyring deve essere univoco per la tua organizzazione. Se crei altre regioni, 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 del keyring del disco. Il nome del keyring del disco deve essere diverso dal nome della chiave di applicazione. Il keyring del disco verrà creato 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 tuoi comandi.

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

  2. (Facoltativo) Controlla il tuo lavoro facendo eco ai valori appena impostati. Tieni presente che quando vuoi utilizzare una variabile nei comandi, anteponi il simbolo del dollaro ($ al nome della variabile). 
    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 come le 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 si verificano errori durante questa parte della procedura, consulta la sezione Risoluzione dei problemi.

1 AVANTI: Abilita le API 3 4 5 6 6 6 16}