在這個步驟中，您將建立環境和環境群組。
在 Apigee 中，API Proxy 會部署至環境，為 Proxy 提供獨立的結構定義。環境會分組為環境群組，為部署至群組內環境的所有 Proxy 提供主機名稱。您必須至少有一個環境和至少一個環境群組。詳情請參閱「關於環境和環境群組」。
建立環境
請先建立環境，再建立環境群組。您可以使用 Apigee UI 或 API 建立環境。建議您在這些步驟中使用 UI，熟悉操作方式。
Apigee UI
如要在 Apigee UI 中建立新環境，請按照下列步驟操作：
- 在 Apigee UI 中，依序前往「管理」>「環境」。
- 在「環境」窗格，點選「+ 建立環境」。
- 在「Create an environment」(建立環境) 窗格中，輸入下列資訊：
名稱：程式輔助環境名稱。名稱建立後即無法變更。
名稱長度必須介於 2 到 32 個字元之間，且只能使用小寫英文字母、數字或連字號。名稱開頭須為英文字母，結尾不得為連字號。名稱不得與貴組織中的任何其他環境名稱相同。
- 顯示名稱：使用者介面中顯示的環境名稱。
- 說明：選填。環境說明。
- 執行個體：將「執行個體」欄位留空。執行個體不適用於 Apigee Hybrid 安裝。
- 環境群組：暫時將「環境群組」欄位留空。您將在下一個程序中建立環境群組。
- 部署類型：對於大多數 Apigee hybrid 安裝作業，請選取部署個別 API Proxy 的選項。您可以選擇部署 API Proxy 設定環境的封存檔。 詳情請參閱「支援的部署類型」。
- 點選「建立」。
完成後，新環境會顯示在「Environments」(環境) 窗格的表格中。
Apigee API
如要使用 Create environments API 建立環境，請執行下列步驟：
- 在用來管理 Apigee 的裝置上開啟終端機。
-
在指令列中，使用下列指令取得
gcloud驗證憑證：Linux / MacOS
export TOKEN=$(gcloud auth print-access-token)
如要確認權杖是否已填入，請使用
echo，如以下範例所示：echo $TOKEN
這會以編碼字串的形式顯示權杖。
Windows
for /f "tokens=*" %a in ('gcloud auth print-access-token') do set TOKEN=%a如要確認權杖是否已填入，請使用
echo，如以下範例所示：echo %TOKEN%
這會以編碼字串的形式顯示權杖。
- 建立下列環境變數：
Linux / MacOS
export ENV_NAME="YOUR_ENV_NAME"
Windows
set ENV_NAME="YOUR_ENV_NAME"
其中：
-
ENV_NAME(必要) 環境名稱只能使用小寫英文字母、連字號和數字，且開頭須為小寫英文字母。這個名稱會做為 ID 使用，環境建立後即無法變更。
-
- 呼叫下列 Apigee API：
無資料落地
curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" -d '{ "name": "'"$ENV_NAME"'" }' "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/environments"資料落地設定
curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" -d '{ "name": "'"$ENV_NAME"'" }' "https://$CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/$ORG_NAME/environments"如果建立要求成功，Environments API 應會回應類似下列的訊息：
{ "name": "organizations/hybrid-example/operations/c2aee040-7e79-4fd4-b0cf-79ca1b7098a8", "metadata": { "@type": "type.googleapis.com/google.cloud.apigee.v1.OperationMetadata", "operationType": "INSERT", "targetResourceName": "organizations/hybrid-example/environments/example-env", "state": "IN_PROGRESS" } }
回應中的
state屬性指出 Apigee 已開始建立新環境，因此狀態為IN_PROGRESS。 - 確認環境是否已成功建立：
無資料落地
curl -H "Authorization: Bearer $TOKEN" \ "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/environments"資料落地設定
curl -H "Authorization: Bearer $TOKEN" \ "https://$CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/$ORG_NAME/environments"如果建立要求成功，Environments API 會傳回類似下列訊息：
[ "your-environment-name" ]
建立環境群組
現在請建立環境群組，並將剛才建立的環境指派給該群組。
Apigee UI
如要在 Apigee UI 中建立新的環境群組，請按照下列步驟操作：
- 在 Apigee UI 中，依序前往「管理」>「環境」>「環境群組」。
- 在「環境」窗格中，選取「環境群組」。
- 按一下「+ 建立環境群組」。
- 輸入下列資訊：
- 環境群組名稱：環境群組的名稱。名稱開頭和結尾須為英數字元。最多可包含 63 個英數字元和連字號。名稱不得與貴組織中任何現有的環境群組名稱相同。
主機名稱：可用來呼叫 Proxy 的主機名稱清單。 每個主機名稱必須位於獨立的一行。
您也可以選擇點選「使用這些網域設定 Google 負載平衡器」。 Cloud 控制台會開啟「負載平衡」頁面，您可以在該頁面設定主機名稱的負載平衡。
- 環境：要納入環境群組的環境清單 (選用)。
- 點選「建立」。
Apigee API
如要使用 Apigee API 建立環境群組，請按照下列步驟操作：
-
在指令列中，使用下列指令取得
gcloud驗證憑證：Linux / MacOS
TOKEN=$(gcloud auth print-access-token)
Windows
for /f "tokens=*" %a in ('gcloud auth print-access-token') do set TOKEN=%a - 建立下列環境變數：
Linux / MacOS
export DOMAIN="YOUR_DOMAIN"
export ENV_GROUP="YOUR_ENVIRONMENT_GROUP"Windows
data-terminal-prefix=">">set ENV_GROUP="YOUR_ENVIRONMENT_GROUP"
data-terminal-prefix=">">set DOMAIN="YOUR_DOMAIN"其中：
DOMAIN(必要) 這是部署至這個群組內環境的所有 Proxy 將使用的主機名稱。這個網域必須由您管理。 位址可以是網域本身 (例如example.com)，也可以包含子網域 (例如my-proxies.example.com)。如果您沒有受管理的網域，可以先輸入預留位置。你之後可以變更網域位址。-
ENV_GROUP(必要) 環境名稱只能使用小寫英文字母、連字號和數字，且開頭須為小寫英文字母。這個名稱會做為 ID 使用，建立後即無法變更。
- 建立環境群組：
無資料落地
curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" \ -d '{ "name": "'"$ENV_GROUP"'", "hostnames":["'"$DOMAIN"'"] }' \ "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups"資料落地設定
curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" \ -d '{ "name": "'"$ENV_GROUP"'", "hostnames":["'"$DOMAIN"'"] }' \ "https://$CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups" - 將環境指派給新群組：
無資料落地
curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" \ -d '{ "environment": "'"$ENV_NAME"'", }' \ "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups/$ENV_GROUP/attachments"資料落地設定
curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" \ -d '{ "environment": "'"$ENV_NAME"'", }' \ "https://$CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups/$ENV_GROUP/attachments" - 使用下列 CURL 指令，確認環境群組是否已成功建立：
無資料落地
curl -H "Authorization: Bearer $TOKEN" \ "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups"
資料落地設定
curl -H "Authorization: Bearer $TOKEN" \ "https://$CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups"
如果建立要求成功，Environments Group API 會傳回類似下列訊息：
{ "environmentGroups": [ { "name": "your_envgroup_hybrid", "hostnames": [ "apigee.hybrid.com" ], "createdAt": "1677826235324", "lastModifiedAt": "1677826235324", "state": "ACTIVE" } ] } - 使用下列 CURL 指令，擷取新建立環境群組的最新連結：
無資料落地
curl -H "Authorization: Bearer $TOKEN" \ "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups/$ENV_GROUP/attachments"
資料落地設定
curl -H "Authorization: Bearer $TOKEN" \ "https://$CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups/$ENV_GROUP/attachments"
如果結果顯示不重複的雜湊值，代表環境群組已成功建立並附加，如下列範例回應輸出所示：
{ "environmentGroupAttachments": [ { "name": "c27046d1-b83e-4cba-xxxx-caaa660b2bd6", "environment": "your_envtest_hybrid", "createdAt": "1677826263567", "environmentGroupId": "your_envgroup_hybrid" } ] }
下一步
如要繼續安裝，請參閱第 2 部分：混合式執行階段設定。