第 1 部分：Google Cloud 服務和混合式 UI 設定

事前準備

這個混合安裝程序中所述的步驟會透過下列一或多個步驟執行：

  • Google Cloud 控制台
  • Apigee Hybrid UI
  • 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 公用程式的目錄路徑。

流程總覽

本節將概略說明設定混合式 UI 和 Google Cloud 服務時必須完成的任務。

設定 Apigee 混合式 UI 和 Google Cloud 服務的一般程序如下：

動作 根據 說明
步驟 1：建立 Google Cloud 帳戶 Google Cloud 控制台 您必須擁有 Google Cloud 帳戶才能執行這些程序。這個帳戶會繫結至新的混合式機構。
步驟 2：建立 Google Cloud 專案 Google Cloud 控制台 Google Cloud 專案是建立、啟用及使用 Google Cloud 服務的基礎。專案會統整所有 Google Cloud 資源。
步驟 3：啟用 API Google Cloud 控制台或指令列 否則，混合型服務就無法與其他服務或彼此溝通。
步驟 4：建立機構 指令列 專案屬於機構。建立組織後，您幾乎可以開始呼叫 API 和建立 API Proxy。
步驟 5：新增環境 Apigee Hybrid UI 或指令列 環境會為執行 API Proxy 提供隔離的背景或沙箱。您可以在單一機構中建立多個環境。如果您未執行這項操作，就無法完成混合型執行階段安裝作業，也無法將 API 代理程式部署至任何位置。

後續步驟

我們會在後續章節中說明每個步驟。

Let's Go!