建立環境

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

關於建立環境

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

  • 在管理層中，使用 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. 對叢集套用任何變更：

    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 版本名稱。舉例來說，如果兩者都命名為「dev」，您可以使用「dev-env-release」和「dev-envgroup-release」。

      如要進一步瞭解 Helm 中的發布內容，請參閱 Helm 說明文件中的「Three big concepts」(三大概念)。

    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

如要進一步瞭解虛擬主機設定，請參閱「設定虛擬主機」。 如需環境設定元素的完整清單，請參閱設定屬性參考資料中的 envs。