建立環境

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

關於建立環境

建立環境的程序分為兩個步驟：

• 使用 UI 或 Apigee API 在管理層級建立環境。
• 將該環境的設定新增至覆寫檔案，然後套用至叢集。

如要新增環境，請參閱「步驟 5：新增環境」和「 指定設定覆寫值」中的說明，瞭解新增和設定環境的步驟。

如何建立環境

1. 您可以在 Apigee UI 中或使用 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。