创建环境

本主题介绍如何为 Apigee Hybrid 创建新环境。如需了解简介，请参阅环境和环境组简介。

关于环境创建

环境创建构成包含两个步骤：

• 使用界面或 Apigee API 在管理平面创建环境。
• 将该环境的配置添加到替换文件并将其应用于集群。

添加和配置环境中介绍了添加环境的步骤，具体说明见第 5 步：添加环境和指定配置替换。

如何创建环境

1. 在 Apigee 界面中或使用 Create Environments API 创建一个或多个新环境。如需了解基本步骤，请参阅第 5 步：添加环境。

2. 在替换文件中的 envs[] 属性中添加新的环境定义。请注意，该属性是一个数组；因此，您可以为它添加多个环境定义。为新环境提供与您在界面中创建的环境的名称相同的名称。例如，以下配置定义了两个环境：test 和 prod：

   namespace: my-namespace
   org: my-organization
   ...
   envs:
     - name: test
       serviceAccountPaths:
         synchronizer: "your_keypath/synchronizer-manager-service-account.json
         udca: "your_keypath/analytic-agent-service-account.json
   
     - name: prod
       serviceAccountPaths:
         synchronizer: "your_keypath/synchronizer-manager-service-account.json
         udca: "your_keypath/analytic-agent-service-account.json
   ...

3. 将任何更改应用于集群：

   Helm

   使用 Helm 图表时，请使用以下命令按顺序将更改应用于每个环境。

   例如：

   helm upgrade ENV_RELEASE_NAME apigee-env/ \
     --install \
     --namespace APIGEE_NAMESPACE \
     --set env=ENV_NAME \
     -f OVERRIDES_FILE \
     --dry-run=server
   

   ENV_RELEASE_NAME 是用于跟踪 apigee-env 图表的安装和升级情况的名称。Helm 版本名称在 Apigee Hybrid 安装中必须是唯一的。如果您的环境名称是唯一的，则可以与 ENV_NAME 相同。但是，如果您的环境和环境组具有相同的名称，请务必为每个环境组输入唯一的 Helm 版本名称。例如，如果这两个 activity 都命名为 dev，您可以使用 dev-env-release 和 dev-envgroup-release 等名称。

   如需详细了解 Helm 中的版本，请参阅 Helm 文档中的三大概念。

   test 环境：

   helm upgrade test-release apigee-env/ \
     --namespace apigee \
     --atomic \
     --set env=test \
     -f OVERRIDES_FILE.yaml
   

   prod 环境：

   helm upgrade prod-release apigee-env/ \
     --namespace apigee \
     --set env=prod \
     --atomic \
     -f OVERRIDES_FILE.yaml
   

   apigeectl

   使用 apigeectl 时，您可以使用 --env ENV_NAME 标志单独将更改应用于每个环境，也可以使用 --all-envs 标志同时将更改应用于所有环境。例如：

   $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE.yaml --all-envs

如需详细了解虚拟主机配置，请参阅配置虚拟主机。如需了解环境配置元素的完整列表，请参阅配置属性参考中的环境。