注意:此产品的某些方面处于 Beta 版阶段。Hybrid 安装选项是 GA。要加入 Beta 版计划,请与您的 Apigee 代表联系。

第 1 步:定义环境变量

您在此步骤中执行的操作

本部分介绍如何设置要在整个文档中使用的一些环境变量。Apigee 强烈建议使用这些变量,以便您可以按照本教程(和其他教程)所示使用命令。

执行步骤

如需在命令行中定义环境变量,请执行以下操作

  1. 使用以下命令登录 Cloud:
    gcloud auth login

    该命令会启动浏览器窗口,提示您选择一个帐号(如果您有多个帐号)。然后,Cloud 会提示您允许访问。此操作只需执行一次:您日后无需再运行此命令、选择帐号或允许访问。

  2. 初始化 Cloud SDK(如初始化 Cloud SDK 所述);例如:
    gcloud init

    在 SDK 初始化期间,输入或选择您在前提条件中创建的项目的 ID。将此项目设置为默认项目。除非您日后想更改默认设置,否则无需运行此命令。

  3. 为当前项目定义以下环境变量:
    AUTH="Authorization: Bearer $(gcloud auth print-access-token)"
    PROJECT_ID="my-cloud-project"
    PROJECT_NUMBER="my-cloud-project-number"
    LOCATION="us-west1"
    ANALYTICS_REGION="us-west1"

    其中:

    • AUTH 使用不记名令牌定义 Authentication 标头。当您向 API 代理发送 HTTP 请求时,将会用到此标头。
    • PROJECT_ID 是您在前提条件中创建的 Cloud 项目 ID。如果您不确定自己的项目 ID 是什么,请使用 Cloud Console 或 gcloud projects list 命令进行查找。
    • PROJECT_NUMBER 是您在前提条件中创建的 Cloud 项目编号。如果您不确定自己的项目编号是什么,请使用 Cloud Console 或 gcloud projects list 命令进行查找。
    • LOCATION 是您创建集群的实际位置。有效值为任意 Compute Engine 地区

      $LOCATION 的值不必与 $ANALYTICS_REGION 相同。 (对于评估帐号,请使用区域,而不是地区。)

    • ANALYTICS_REGION 是您存储分析数据的实际位置。

      有效值是 Compute Engine 地区的子集。可能的值包括:

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

      $ANALYTICS_REGION 的值无需与 $LOCATION 相同。不过,如果两者相同,则可能会获得性能优势。 (对于评估帐号,请指定地区(与常规帐号一样)。

    您可以在命令中使用变量名称(例如“$PROJECT_ID”作为字符串字面量)。

  4. (可选)通过回送您刚刚设置的值来检查您的工作。请注意,要在命令中使用变量,请在变量名称前面加上美元符号 ($)。

    echo 命令的响应应如下所示:

    echo $AUTH
    Authorization: Bearer ya29.a123456678940B63hPSAMPLEsampleKKYVsample0f3pWDWZDuH2-hENkNaTvgZ1PD977TMvv6edBQPJezdHw040880Ol_LoD5ZDkt-i-knizia_KhA9L20sSvztL81-SAMPLE42ELPMASk2_1CxN
    
    echo $PROJECT_ID
    my-cloud-project
    
    echo $PROJECT_NUMBER
    my-cloud-project-number
    
    echo $LOCATION
    us-west1
    
    echo $ANALYTICS_REGION
    us-west1

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


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