Schritt 1: Umgebungsvariablen definieren

Diese Seite gilt für Apigee und Apigee Hybrid.

Apigee Edge-Dokumentation aufrufen

Was Sie in diesem Schritt tun

In diesem Abschnitt wird beschrieben, wie Sie mehrere Umgebungsvariablen festlegen, die in der gesamten Dokumentation verwendet werden, insbesondere in dieser Konfigurationsanleitung. Google empfiehlt dringend, sie zu verwenden, damit Sie die Befehle wie dargestellt eingeben können.

Dies ist der erste von zwei Schritten, die Sie in der Befehlszeile ausführen, bevor Sie den Apigee-Bereitstellungsassistenten starten.

Schritt ausführen

So definieren Sie Umgebungsvariablen in der Befehlszeile:

  1. Definieren Sie folgende Umgebungsvariablen für das aktuelle Projekt:
    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"

    Wobei:

    • PROJECT_ID ist die Cloud-Projekt-ID, die Sie als eine der Voraussetzungen erstellt haben. Wenn Sie die Projekt-ID nicht kennen, verwenden Sie die Cloud Console oder den Befehl gcloud projects list, um sie zu erfahren.
    • PROJECT_NUMBER ist die Cloud-Projektnummer, die Sie unter Voraussetzungen erstellt haben. In diesem Beispiel wird der gcloud-Befehl ausgegeben, um die Projektnummer für Sie abzurufen. Sie finden sie auch im Projekt-Dashboard der Google Cloud Console. Sie können sie aber auch mit dem Befehl gcloud projects list aufrufen.

    • RUNTIME_LOCATION ist der physische Standort, an dem sich Ihre Instanz befindet. Gültige Werte sind beliebige Compute Engine-Regionen (für kostenpflichtige Organisationen) oder Compute Engine-Zonen (für Evaluierungsorganisationen). Weitere Informationen finden Sie unter Compute Engine-Standorte.

    • ANALYTICS_REGION ist der physische Standort, an dem Sie Ihre Analysedaten speichern.

      Gültige Werte sind Teilmengen der Compute Engine-Regionen. Folgende Werte sind möglich:

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

      Sowohl Eval- als auch kostenpflichtige Konten verwenden Regionen für den Analysestandort. Bei kostenpflichtigen Organisationen kann der Wert dem Wert von RUNTIME_LOCATION (auch eine Region) entsprechen. Der Wert von ANALYTICS_REGION muss aber nicht mit dem von RUNTIME_LOCATION übereinstimmen. Unter Umständen verbessert die Übereinstimmung aber die Leistung.

      Bei Eval-Konten ist der Analysestandort eine Region, aber der Laufzeitstandort eine Zone. Deshalb sind sie nicht identisch.

    • APPKEY_LOCATION ist der physische Standort, an dem der Schlüsselbund und der Schlüssel Ihrer Anwendung gespeichert sind. Apigee verwendet einen Anwendungsschlüssel, um Anwendungsdaten wie KVMs, Cache und den Clientschlüssel zu verschlüsseln, die dann in der Datenbank gespeichert werden.

      Ähnlich wie die Analyseregion sind die gültigen Werte eine Teilmenge der Compute Engine-Regionen. Der Wert kann mit Ihrer $RUNTIME_LOCATION übereinstimmen (auch eine Region), muss es jedoch nicht. Unter Umständen verbessert die Übereinstimmung die Leistung.

    • RUNTIME_LOCATION ist der Name des Schlüsselbunds, in dem der Anwendungsschlüssel gespeichert ist. Der Name des Schlüsselbunds muss für Ihre Organisation eindeutig sein. Wenn Sie weitere Regionen erstellen, müssen sich die Schlüsselbundnamen für diese Regionen von den vorhandenen Schlüsselbundnamen unterscheiden.
    • APPKEY_KEY_NAME ist der Name des Anwendungsschlüssels. Die Namen von Anwendungsschlüsseln innerhalb eines Schlüsselbunds müssen eindeutig sein.
    • DISK_KEY_RING_NAME ist der Name des Laufwerksschlüsselbunds. Der Name des Laufwerksschlüsselbunds muss sich vom Namen des Anwendungsschlüssels unterscheiden. Sie erstellen den Schlüsselbund des Laufwerks am selben Standort wie $RUNTIME_LOCATION.
    • DISK_KEY_NAME ist der Name des Schlüssels zur Laufwerkverschlüsselung, mit dem Apigee Laufzeitinstanzdaten verschlüsselt, bevor sie auf das Laufwerk geschrieben werden.

    Im folgenden Beispiel werden Umgebungsvariablen für eine kostenpflichtige Organisation definiert. 

    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"

    Bei einer Eval-Organisation würde der Wert für RUNTIME_LOCATION auf eine Zone und nicht auf eine Region festgelegt werden.

    Sie verwenden die Variablennamen (z. B. $PROJECT_ID) als String-Literale in Ihren Befehlen.

    Beachten Sie, dass Sie nicht alle diese Umgebungsvariablen während der Bereitstellung und Konfiguration verwenden können.

  2. (Optional) Um Ihre Arbeit zu testen, rufen Sie die soeben festgelegten Werte ab. Wenn Sie in Ihren Befehlen eine Variable verwenden möchten, stellen Sie dem Variablennamen ein Dollarzeichen ($) voran. 
    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

    Die Antworten auf Ihre echo-Befehle sollten etwa so aussehen:

    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

Wenn bei diesem Vorgang Fehler auftreten, lesen Sie den Abschnitt Fehlerbehebung.

1 NÄCHSTER: APIs aktivieren 3 4 5 6 7 8