本页面适用于 Apigee 和 Apigee Hybrid。
查看 Apigee Edge 文档。
您在此步骤中执行的操作
本部分介绍如何设置在整个文档（尤其是此配置教程）中使用的几个环境变量。Google 强烈建议您使用它们，以便输入所示的命令。
这是在启动 Apigee 预配向导之前您将在命令行中执行的两个步骤中的第一步。
执行步骤
如需在命令行中定义环境变量，请执行以下操作：
- 为当前项目定义以下环境变量：
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-northeast1asia-south1europe-west1us-central1us-east1us-west1australia-southeast1europe-west2
评估和付费账号均使用分析位置作为区域。在此处，对于付费组织，该值可以与 RUNTIME_LOCATION（也是一个区域）相同。但是 collectd_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作为字符串字面量。请注意，在预配和配置期间，可能不会使用所有这些环境变量。
- PROJECT_ID 是您在前提条件中创建的 Cloud 项目 ID。如果您不确定自己的项目 ID 是什么，请使用 Cloud 控制台或
- （可选）通过回送您刚刚设置的值来检查您的工作。请注意，要在命令中使用变量，请在变量名称前面加上美元符号 ($)。
echo $PROJECT_ID
echo $PROJECT_NUMBERecho $ANALYTICS_REGIONecho $RUNTIMEDBKEY_LOCATIONecho $APPKEY_KEY_RING_NAMEecho $APPKEY_KEY_NAMEecho $DISK_KEY_RING_NAMEecho $DISK_KEY_NAMEecho命令的响应应如下所示：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
如果您在此过程的这个过程中遇到错误，请参阅 问题排查。