步驟 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 控制台專案資訊主頁中找到，或是使用 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、快取和用戶端密鑰，然後儲存在資料庫中。

      與 Analytics 地區類似，有效值是 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 下一步：啟用 API 3 4 5 6 7 8