[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["難以理解","hardToUnderstand","thumb-down"],["資訊或程式碼範例有誤","incorrectInformationOrSampleCode","thumb-down"],["缺少我需要的資訊/範例","missingTheInformationSamplesINeed","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間：2025-08-18 (世界標準時間)。"],[[["\u003cp\u003eCreating new environments in Apigee hybrid involves a two-step process: first creating the environment in the management plane, and then adding configuration for it in your overrides file.\u003c/p\u003e\n"],["\u003cp\u003eNew environments can be created using the Apigee UI or the Create environments API, and the detailed steps can be found in the "Add an environment" documentation.\u003c/p\u003e\n"],["\u003cp\u003eTo configure an environment, define it within the \u003ccode\u003eenvs[]\u003c/code\u003e array in your overrides file, ensuring the name matches the one created in the UI.\u003c/p\u003e\n"],["\u003cp\u003eChanges to environment configurations are applied to the cluster sequentially, environment by environment, using Helm commands, with each release name being unique within the Apigee hybrid installation.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eapigee-env\u003c/code\u003e chart is used to make changes to each environment, using the Helm upgrade command with the correct namespace, environment name, and overrides file path.\u003c/p\u003e\n"]]],[],null,["# Create environments\n\n| You are currently viewing version 1.13 of the Apigee hybrid documentation. For more information, see [Supported versions](/apigee/docs/hybrid/supported-platforms#supported-versions).\n\n\nThis topic explains how to create new environments for Apigee hybrid. For an introduction, see\n[About environments and environment groups](/apigee/docs/api-platform/fundamentals/environments-overview).\n\nAbout environment creation\n--------------------------\n\n\nEnvironment creation is a two-step process:\n\n- Create an environment in the management plane using either the UI or an Apigee API.\n- Add configuration for that environment to your overrides file and apply it to the cluster.\n\nThe steps for adding an environment are described in adding and configuring an environment are\nexplained in [Step 5: Add an environment](/apigee/docs/hybrid/v1.13/precog-add-environment) and [Specify configuration overrides](/apigee/docs/hybrid/v1.13/install-copy-overrides#specify-configuration-overrides).\n\nHow to create an environment\n----------------------------\n\n1. Create one or more new environments in the [Apigee UI](https://apigee.google.com) or with the [Create environments API](/apigee/docs/reference/apis/apigee/rest/v1/organizations.environments/create). For the basic steps, see [Step 5: Add an environment](/apigee/docs/hybrid/v1.13/precog-add-environment).\n2. Add a new environment definition to the `envs[]` property in your overrides file.\n Note that the property is an array; therefore, you can add more than one environment definition\n to it.\n Give the new environment the same name as the environment you created in the UI.\n For example, the following configuration defines two environments: **test**\n and **prod**:\n\n ```actionscript-3\n namespace: my-namespace\n org: my-organization\n ...\n envs:\n - name: test\n serviceAccountPaths:\n synchronizer: \"your_keypath/synchronizer-manager-service-account.json\n udca: \"your_keypath/analytic-agent-service-account.json\n\n - name: prod\n serviceAccountPaths:\n synchronizer: \"your_keypath/synchronizer-manager-service-account.json\n udca: \"your_keypath/analytic-agent-service-account.json\n ...\n ```\n3. Apply any changes to the cluster. Apply the changes to each environment in sequence. \n\n ```\n helm upgrade ENV_RELEASE_NAME apigee-env/ \\\n --install \\\n --namespace APIGEE_NAMESPACE \\\n --set env=ENV_NAME \\\n -f OVERRIDES_FILE \\\n --dry-run=server\n ```\n - \u003cvar translate=\"no\"\u003eENV_RELEASE_NAME\u003c/var\u003e is a name used track installation and upgrades of the `apigee-env` chart. Helm release names must be unique within your Apigee hybrid installation. If you environment name is unique, this can be the same as \u003cvar translate=\"no\"\u003eENV_NAME\u003c/var\u003e. However, if you have the same name for your environment and environment group, make sure to enter a unique Helm release name for each. For example, if both are named `dev` you could use something like `dev-env-release` and `dev-envgroup-release`.\n - For more information on releases in Helm, see [Three big concepts](https://helm.sh/docs/intro/using_helm/#three-big-concepts) in the Helm documentation.\n\n The `test` environment: \n\n ```\n helm upgrade test-release apigee-env/ \\\n --namespace apigee \\\n --atomic \\\n --set env=test \\\n -f OVERRIDES_FILE.yaml\n ```\n | **Note:** If you see an error saying `Error: UPGRADE FAILED: \"`*test*`\" has no deployed releases`, replace `upgrade` with `install` and try the command again.\n\n The `prod` environment: \n\n ```\n helm upgrade prod-release apigee-env/ \\\n --namespace apigee \\\n --set env=prod \\\n --atomic \\\n -f OVERRIDES_FILE.yaml\n ```\n\n\nFor more information about virtual host configuration see [Configure virtual hosts](/apigee/docs/hybrid/v1.13/base-path-routing).\nFor a complete list of environment configuration elements, see [envs](/apigee/docs/hybrid/v1.13/config-prop-ref#envs) in the\n[Configuration\nproperty reference](/apigee/docs/hybrid/v1.13/config-prop-ref#envs)."]]
