Manage environments

You are currently viewing version 1.12 of the Apigee hybrid documentation.This version is end of life. You should upgrade to a newer version. For more information, seeSupported versions.

More Information
For more information, see:

You can manage your environments with a combination of theGoogle Cloud console and the hybridruntime configuration file. This section describes how to create a new environment, edit anenvironment's details, and delete an existing environment with Google Cloud. You must then updateyour overrides.yaml on the runtime plane to complete the creation or deletion of an environment.

NOTE: Do not create any new environments until you haveinstalled the hybrid runtime on your cluster as described inPart 2: Runtime quickstart.

Create a new environment in the UI

To create a new environment, you must do the following (in this order):

  1. Create a new environment in the Google Cloud console.

    AND

  2. Provision the new environment in your overrides file.
NOTE: After you create a new environment in the UI, there canbe a several minute delay before you can provision it in the runtime.

You can create up to 75 environments per organization.

To create a new environment:

  1. Create the new environment as described inCreating environments.

    There can be a several minute delay before the new environment is provisioned.

    Even when provisioning is done, you have one more step to perform. You must still add the environment to the runtime's overrides.yaml file.

  2. On the Kubernetes administration machine, add the new environment to the runtime's overrides file, as described inHow to add multiple environments.

Edit an existing environment in the UI

You can change the following properties of an existing environment in the UI:

  • Display name
  • Description

To edit an existing environment, seeEditing environments.

Delete an existing environment

To delete an existing environment, you must do the following (in this order):

  1. Delete the environment in the UI, as described in this section

    AND

  2. Delete the environment from the runtime, as described inDeleting environments.

To delete an existing environment:

  1. Delete the environment in the Apigee UI using the instructions inDeleting environments.

    The environment's card in the UI displays a "Pending Deletion" label while Apigee deletes the environment.

    There can be a several minute delay before the deletion is completed.

    NOTE: You're not quite done. You must still delete the environment from the runtime'soverrides.yaml file.
  2. Delete the environment from the runtime'soverrides.yaml file, as described inDeleting environments.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-02-18 UTC.