本页面适用于 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-northeast1
asia-south1
europe-west1
us-central1
us-east1
us-west1
australia-southeast1
europe-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_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
如果您在此过程的这个过程中遇到错误,请参阅 问题排查。