第 3 步：创建环境组

在此步骤中，您将创建环境和环境组。

在 Apigee 中，API 代理会部署到环境，这些环境为代理提供隔离上下文。环境被组织为环境组，环境组为部署到组中环境的所有代理提供主机名。您必须具有至少一个环境和一个环境组。如需了解详情，请参阅环境和环境组简介。

创建环境

先创建环境，然后再创建环境组。您可以使用 Apigee 界面或使用 API 创建环境。您可能需要通过界面执行这些步骤以熟悉界面。

Apigee 界面

如需访问界面并添加环境，请执行以下步骤：

打开 Apigee 界面。如果您是首次登录，Hybrid 界面会显示意见征求对话框。如果系统提示您从多个账号中选择一个账号，请选择用于安装 Apigee Hybrid 的 Google Cloud 项目所属的账号。然后，点击允许。

您的浏览器会导航到界面的主着陆页：

Apigee 界面中的着陆页，包含左侧导航栏和大型链接图片。

确保从组织下拉列表中选择您的组织。如果尚未选择组织，请从下拉列表中选择组织，如以下示例所示：
依次点击管理 > 环境 > 概览。

此时将显示环境视图，但其中尚无环境：
点击添加环境。
此时会显示新建环境对话框：
在新建环境对话框中输入以下信息：
1. 显示名（必需）：在界面中使用的环境的易记名称。例如，“My First Environment”或“test”。与环境名称不同，显示名可以包含大写字母和其他特殊字符。
2. 环境名称（必需）：环境的程序化名称；也称为环境 ID。
  例如，“my-environment”或“test”。
  
  注意：环境名称只能包含小写字母、数字和连字符。您不能使用大写字母或任何其他特殊字符。此外，环境名称最多可包含 32 个字符。例如 my-test-env 或 my-test-env-42。
  
  显示名和环境名称可以不同。
3. 说明（可选）：要添加的关于环境用途的其他信息。例如“在初始安装期间创建”。
保留其他任何默认设置，然后点击创建。
Apigee 会创建新环境。

现在，您需要创建一个环境组，并将新环境添加到该组中。

Apigee API

要使用创建环境 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 （必需）环境名称可以包含小写字母、短划线和数字，并且必须以小写字母开头。此名称将用作标识符，并且在创建环境后无法更改。

调用以下 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"

成功发送创建请求后，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"

成功发送创建请求后，Environments API 将返回类似于如下所示的消息作为响应：

[
  "your-environment-name"
]

创建环境组

现在，创建一个环境组，并向其分配您刚刚创建的环境。

Apigee 界面

要使用 Apigee 界面创建环境组，请执行以下步骤：

打开 Apigee 界面。

您的浏览器会导航到 Apigee 界面的主着陆页。

确保从组织下拉列表中选择您的组织。如果未选择，请从下拉列表中选择。
依次点击管理 > 环境 > 群组。
此时将显示环境组概览视图：
点击 +环境组。
此时会显示添加环境组对话框。
输入名称，然后点击添加。
将指针悬停在新创建的环境组上，然后点击修改。

添加一个主机名，部署到此环境组中环境的所有代理都将使用此主机名。这应该是您拥有管理权限的网域。主机名可以是网域本身（例如 example.com），也可以包含子网域（例如 my-proxies.example.com）。

如果您需要注册网域，请与 Google Domains 之类的网域注册商联系。

显示未分配任何环境的“修改环境组”窗口

点击环境框中的添加 (+)。
此时会显示添加环境对话框。

列出可用环境的“添加环境”对话框

从列表中选择一个环境，然后点击添加。

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 （必需）这是部署到该环境组中环境的所有代理都将使用的主机名。这应该是您管理的网域。地址可以是网域本身（例如 example.com），也可以包含子网域（例如 my-proxies.example.com）。如果您没有托管网域，则可以暂时输入占位符。您稍后可以更改网域地址。
- ENV_GROUP （必需）环境名称可以包含小写字母、短划线和数字，并且必须以小写字母开头。此名称将用作标识符，创建后便无法更改。

创建环境组：

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 '{
     "environment": "'"$ENV_NAME"'",
   }' \
   "https://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"

成功发送创建请求后，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"

如果结果显示唯一的哈希值，则环境组创建和附加成功，如以下示例响应输出中所示：


        {
          "environmentGroupAttachments": [
            {
              "name": "c27046d1-b83e-4cba-xxxx-caaa660b2bd6",
              "environment": "your_envtest_hybrid",
              "createdAt": "1677826263567",
              "environmentGroupId": "your_envgroup_hybrid"
            }
          ]
        }

下一步

如需继续安装，请转到第 2 部分：Hybrid 运行时设置。