You can manage your environments with a combination of the Google Cloud console and the hybrid
runtime configuration file. This section describes how to create a new environment, edit an
environment's details, and delete an existing environment with Google Cloud. You must then update
your overrides.yaml on the runtime plane to complete the creation or deletion of an environment.
Create a new environment in the UI
To create a new environment, you must do the following (in this order):
Create a new environment in the Google Cloud console.
AND
Provision the new environment in your overrides file.
You can create up to 75 environments per organization.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-26 UTC."],[[["\u003cp\u003eThis document explains how to manage Apigee hybrid environments using the Google Cloud console and the runtime configuration file.\u003c/p\u003e\n"],["\u003cp\u003eCreating a new environment involves creating it in the Google Cloud console and then provisioning it in the \u003ccode\u003eoverrides.yaml\u003c/code\u003e file on the runtime plane, with a possible delay of several minutes.\u003c/p\u003e\n"],["\u003cp\u003eExisting environments can be edited for their display name and description directly within the UI.\u003c/p\u003e\n"],["\u003cp\u003eDeleting an environment requires first deleting it in the Apigee UI, and then removing it from the runtime's \u003ccode\u003eoverrides.yaml\u003c/code\u003e file.\u003c/p\u003e\n"],["\u003cp\u003eYou can create up to 75 environments per organization.\u003c/p\u003e\n"]]],[],null,["# Manage environments\n\n| You are currently viewing version 1.10 of the Apigee hybrid documentation. **This version is end of life.** You should upgrade to a newer version. For more information, see [Supported versions](/apigee/docs/hybrid/supported-platforms#supported-versions).\n| **More Information** \n|\n| For more information, see:\n|\n| - [About environments and environment groups](/apigee/docs/api-platform/fundamentals/environments-overview)\n\nYou can manage your environments with a combination of the [Google Cloud console](https://console.cloud.google.com) and the hybrid\nruntime configuration file. This section describes how to create a new environment, edit an\nenvironment's details, and delete an existing environment with Google Cloud. You must then update\nyour overrides.yaml on the runtime plane to complete the creation or deletion of an environment.\n| **NOTE:** Do not create any new environments until you have installed the hybrid runtime on your cluster as described in [Part 2: Runtime quickstart](/apigee/docs/hybrid/v1.10/install-before-begin).\n\nCreate a new environment in the UI\n----------------------------------\n\nTo create a new environment, you must do the following (in this order):\n\n1. Create a new environment in the Google Cloud console. **AND**\n\n2. Provision the new environment in your overrides file.\n\n| **NOTE:** After you create a new environment in the UI, there can be a several minute delay before you can provision it in the runtime.\n\nYou can create up to 75 environments per organization.\n\n**To create a new environment:**\n\n1. Create the new environment as described in [Creating environments](/apigee/docs/api-platform/fundamentals/environments-working-with#create).\n\n There can be a several minute delay before the new environment is provisioned.\n\n Even when provisioning is done, you have one more step to perform. You must still add the\n environment to the runtime's overrides.yaml file.\n2. On the Kubernetes administration machine, add the new environment to the runtime's overrides file, as described in [How to add multiple environments](/apigee/docs/hybrid/v1.10/environment-create#how-to-add-multiple-environments).\n\nEdit an existing environment in the UI\n--------------------------------------\n\nYou can change the following properties of an existing environment in the UI:\n\n- Display name\n- Description\n\nTo edit an existing environment, see\n[Editing environments](/apigee/docs/api-platform/fundamentals/environments-working-with#edit).\n\nDelete an existing environment\n------------------------------\n\nTo delete an existing environment, you must do the following (in this order):\n\n1. Delete the environment in the UI, as described in this section **AND**\n\n2. Delete the environment from the runtime, as described in [Deleting environments](/apigee/docs/hybrid/v1.10/environment-delete).\n\n**To delete an existing environment:**\n\n1. Delete the environment in the Apigee UI using the instructions in [Deleting environments](/apigee/docs/api-platform/fundamentals/environments-working-with#delete).\n\n The environment's card in the UI displays a \"Pending Deletion\" label while Apigee deletes the\n environment.\n\n There can be a several minute delay before the deletion is completed.\n | **NOTE:** You're not quite done. You must still delete the environment from the runtime's `overrides.yaml` file.\n2. Delete the environment from the runtime's `overrides.yaml` file, as described in [Deleting environments](/apigee/docs/hybrid/v1.10/environment-delete)."]]