准备工作
此混合安装过程中的步骤会通过以下一种或多种方式执行:
- Google Cloud 控制台
- Apigee Hybrid 界面
-
gcloud
命令行
环境变量
使用命令行执行的步骤会利用用户创建的环境变量。如果终端窗口断开连接,系统将不会保存环境变量。
这些步骤中使用的环境变量如下所示:
Linux / MacOS
export PROJECT_ID="your_project_id"
export ORG_NAME=$PROJECT_ID
export ORG_DISPLAY_NAME="org_friendly_name"
export ORGANIZATION_DESCRIPTION="org_description_text"
export ANALYTICS_REGION="analytics_region"
export RUNTIMETYPE=HYBRID
export ENV_NAME="environment_name"
export ENV_DISPLAY_NAME="env_friendly_name"
export ENV_DESCRIPTION="env_description_text"
export DOMAIN="example.com"
export ENV_GROUP="environment-group-name"
export CLUSTER_NAME="cluster_name"
export CLUSTER_LOCATION="cluster_region"
包含空格的变量名称内容必须用英文双引号括起来。例如:
export ORGANIZATION_DESCRIPTION="My example organization number 1"
Windows
set PROJECT_ID="your_project_id"
set ORG_NAME=$PROJECT_ID
set ORG_DISPLAY_NAME="org_friendly_name"
set ORGANIZATION_DESCRIPTION="org_description_text"
set ANALYTICS_REGION="analytics_region"
set RUNTIMETYPE=HYBRID
set ENV_NAME="environment_name"
set ENV_DISPLAY_NAME="env_friendly_name"
set ENV_DESCRIPTION="env_description_text"
set DOMAIN="example.com"
set ENV_GROUP="environment-group-name"
set CLUSTER_NAME="cluster_name"
set CLUSTER_LOCATION="cluster_region"
包含空格的变量名称内容必须用英文双引号括起来。例如:
set ORGANIZATION_DESCRIPTION="My example organization number 1"
授权凭据令牌
gcloud
授权凭据令牌将于 20 分钟后到期。如果您在此期间未完成所有步骤,则必须再次获取授权凭据。例如:
在命令行中,使用以下命令获取 gcloud
身份验证凭据:
Linux / MacOS
TOKEN=$(gcloud auth print-access-token)
Windows
for /f "tokens=*" %a in ('gcloud auth print-access-token') do set TOKEN=%a
其他环境变量
在本指南的过程中,系统会要求您添加更多环境变量,并且您可能需要将这些环境变量添加到脚本中。例如:
- LONG_RUNNING_OPERATION_ID:作为组织创建过程一部分的异步长时间运行的操作的 UUID。
- APIGEECTL_HOME:
apigeectl
实用程序的安装目录路径。
过程概览
本部分简要介绍了设置混合界面和 Google Cloud 服务时必须完成的任务。
设置 Apigee 混合界面和 Google Cloud 服务的一般过程如下所示:
操作 | 使用 | 说明 |
---|---|---|
第 1 步:创建 Google Cloud 账号 | Google Cloud 控制台 | 您需要具有 Google Cloud 账号才能执行这些步骤。此账号将绑定到新混合组织。 |
第 2 步:创建 Google Cloud 项目 | Google Cloud 控制台 | Google Cloud 项目是创建、启用和使用 Google Cloud 服务的基础。项目用于组织您的所有 Google Cloud 资源。 |
第 3 步:启用 API | Google Cloud 控制台或命令行 | 没有这些 API,混合服务将无法相互通信或与其他服务通信。 |
第 4 步:创建组织 | 命令行 | 项目属于组织。拥有组织后,就基本可以进行 API 调用和创建 API 代理了。 |
第 5 步:添加环境 | Apigee Hybrid 界面或命令行 | 环境为运行 API 代理提供隔离上下文或沙盒。在单个组织中,您可以创建多个环境。 如果未执行此操作,您将无法完成混合运行时安装,也没有部署 API 代理的任何位置。 |
下一步
后续几个部分将介绍其中每个步骤。