建立環境

本主題說明如何建立新環境。如需簡介，請參閱「關於環境和環境群組」。

關於建立環境

建立環境的程序包含兩個步驟：

  • 在管理平面中，使用 UI 或 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. 新增 virtualhosts 屬性，將其 routingRules 對應至環境。
    virtualhosts:
  - name: default
    hostAliases: ["api.example.com"]
    sslCertPath: ./certs/fullchain.pem
    sslKeyPath: ./certs/privkey.pem
    routingRules:
      - env: test
  4. 對叢集套用任何變更。如果您同時變更 envs[] 和 virtualhosts[] 屬性，請使用下列指令套用變更： 
    apigeectl apply -f overrides-file.yaml -c synchronizer,udca,runtime

    如果只變更 virtualhosts 屬性，請使用 --settings 標記套用這些設定變更：

    apigeectl apply -f overrides-file.yaml --settings virtualhosts

如要進一步瞭解虛擬主機設定，包括如何設定多個 basepath 路由規則，請參閱「設定虛擬主機」。 如需環境設定元素的完整清單，請參閱設定屬性參考資料中的 envs。