第 1 步:定义环境变量

您正在查看 Apigee X 文档。
查看 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"
    APPKEY_LOCATION="APPKEY_LOCATION"
    APPKEY_KEY_RING_NAME="APPKEY_KEY_RING_NAME"
    APPKEY_KEY_NAME="APPKEY_KEY_NAME"
    DISK_KEY_RING_NAME="DISK_KEY_RING_NAME"
    DISK_KEY_NAME="DISK_KEY_NAME"
    

    其中:

    • PROJECT_ID 是您在前提条件中创建的 Cloud 项目 ID。如果您不确定自己的项目 ID 是什么,请使用 Cloud Console 或 gcloud projects list 命令进行查找。
    • PROJECT_NUMBER 是您在前提条件中创建的 Cloud 项目编号。此示例发出 gcloud 命令以获取项目编号。或者,您可以在 Google Cloud Console 项目信息中心找到它,也可以使用 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"
    APPKEY_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 $APPKEY_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
    my-app-key-ring
    my-app-key
    my-disk-key-ring
    my-disk-key
    

如果您在此过程的这个过程中遇到错误,请参阅 问题排查


1 下一步:启用 API 3 4 5 6 7 8 9