创建环境

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

关于环境创建

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

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

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

如何创建环境

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

在替换文件中的 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
...

添加 virtualhosts 属性，并将其 routingRules 映射到环境。

virtualhosts:
  - name: default
    hostAliases: ["api.example.com"]
    sslCertPath: ./certs/fullchain.pem
    sslKeyPath: ./certs/privkey.pem
    routingRules:
      - env: test

将更改应用于集群。如果您更改了 envs[] 和 virtualhosts[] 属性，请使用以下命令应用更改：
```
apigeectl apply -f overrides-file.yaml -c synchronizer,udca,runtime
```
如果您只更改 virtualhosts 属性，请使用 --settings 标志应用这些配置更改：
```
apigeectl apply -f overrides-file.yaml --settings virtualhosts
```

如需详细了解虚拟主机配置，包括如何配置多个基本路径路由规则，请参阅配置虚拟主机。如需了解环境配置元素的完整列表，请参阅配置属性参考中的环境。