步驟 1：定義環境變數

本頁適用於 Apigee 和 Apigee Hybrid。

查看 Apigee Edge 說明文件。

本步驟的操作說明

本節說明如何設定在整份說明文件 (尤其是本設定教學課程中) 使用的幾個環境變數。Google 強烈建議您使用這些指令，以便輸入顯示的指令。

這是在啟動 Apigee 佈建精靈前，您要在指令列執行的兩個步驟中的第一個步驟。

執行步驟

如何在指令列中定義環境變數：

  1. 為目前專案定義下列環境變數：
    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"

    其中：

    • PROJECT_ID 是您在必要條件中建立的 Cloud 專案 ID。如果不確定專案 ID，請使用 Cloud 控制台或 gcloud projects list 指令來查看。
    • PROJECT_NUMBER 是您在必要條件中建立的 Cloud 專案編號。這個範例會發出 gcloud 指令，為您取得專案編號。或者，您也可以在 Google Cloud 控制台專案資訊主頁中找到該 ID，也可以使用 gcloud projects list 指令來查看。

    • RUNTIME_LOCATION 是執行個體所在的實際位置。有效值為任何 Compute Engine 區域 (適用於付費機構) 或 Compute Engine 區域 (適用於評估機構)。詳情請參閱 Compute Engine 位置。

    • ANALYTICS_REGION 是儲存數據分析資料的實體位置。

      有效值是 Compute Engine 區域的子集。可能的值包括：

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

      評估和付費帳戶都會使用區域做為 Analytics 位置。因此，對於付費機構而言，這個值可以與 RUNTIME_LOCATION (也是區域) 相同。不過，ANALYTICS_REGION 的值不一定要與 RUNTIME_LOCATION 相同。不過，如果兩者相同，可能會帶來效能優勢。

      對於評估帳戶，數據分析位置是區域，但執行階段位置是區域，因此兩者不會相同。

    • RUNTIME_LOCATION 是應用程式金鑰環和金鑰的實際儲存位置。Apigee 會使用應用程式金鑰加密應用程式資料 (例如 KVM、快取和用戶端密鑰)，然後將這些資料儲存在資料庫中。

      與分析區域類似，有效值是 Compute Engine 區域的子集。這個值可以與 $RUNTIME_LOCATION 相同 (也是區域)，但不一定需要相同。如果兩者相同，可能會帶來效能優勢。

    • RUNTIME_LOCATION 是應用程式金鑰儲存位置的金鑰環名稱。鑰匙圈名稱必須是貴機構的專屬名稱。如果您建立其他區域，這些區域的金鑰環名稱不得與現有的金鑰環名稱相同。
    • APPKEY_KEY_NAME 是應用程式金鑰的名稱。 應用程式金鑰名稱在指定的金鑰環中不得重複。
    • DISK_KEY_RING_NAME 是磁碟金鑰環的名稱。磁碟金鑰環名稱必須與應用程式金鑰名稱不同。您將在 $RUNTIME_LOCATION 所在的位置建立磁碟金鑰環。
    • DISK_KEY_NAME 是磁碟加密金鑰的名稱，Apigee 會在將執行個體例項資料寫入磁碟前，先使用這個金鑰加密資料。

    以下範例會定義付費機構的環境變數。

    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"

    如果這是評估機構，RUNTIME_LOCATION 會設為可用區，而非區域。

    您會在指令中使用變數名稱 (例如 $PROJECT_ID) 做為字串文字。

    請注意，您可能不會在佈建和設定期間使用所有這些環境變數。

  2. (選用) 透過回應您剛剛設定的值來檢查您的工作。請注意，如要在指令中使用變數，請在變數名稱前加上美元符號 ($)。
    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

    echo 指令的回應內容應如下所示：

    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

如果在這個程序中遇到錯誤，請參閱疑難排解。

1 NEXT：啟用 API 3 4 5 6 4 5 7 8