> [!CAUTION]
> You are currently viewing version 1.2 of the Apigee hybrid documentation. **This version is end of life.** You should upgrade to a newer version. For more information, see [Supported versions](https://docs.cloud.google.com/apigee/docs/hybrid/supported-platforms.md.txt#supported-versions).

<button class="button button-with-icon cloud-select-dropdown__button button-primary" aria-haspopup="true">Version 1.2 (unsupported)</button>

- Supported versions:
- [v1.17 (latest)](https://docs.cloud.google.com/apigee/docs/hybrid/v1.17/precog-add-environment.md.txt)
- [v1.16](https://docs.cloud.google.com/apigee/docs/hybrid/v1.16/precog-add-environment.md.txt)
- [v1.15](https://docs.cloud.google.com/apigee/docs/hybrid/v1.15/precog-add-environment.md.txt)
- [v1.14](https://docs.cloud.google.com/apigee/docs/hybrid/v1.14/precog-add-environment.md.txt)
- [List of supported versions](https://docs.cloud.google.com/apigee/docs/hybrid/supported-platforms.md.txt#supported-versions)
- Unsupported versions:
- [v1.13](https://docs.cloud.google.com/apigee/docs/hybrid/v1.13/precog-add-environment.md.txt)
- [v1.12](https://docs.cloud.google.com/apigee/docs/hybrid/v1.12/precog-add-environment.md.txt)
- [v1.11](https://docs.cloud.google.com/apigee/docs/hybrid/v1.11/precog-add-environment.md.txt)
- [v1.10](https://docs.cloud.google.com/apigee/docs/hybrid/v1.10/precog-add-environment.md.txt)
- [v1.9](https://docs.cloud.google.com/apigee/docs/hybrid/v1.9/precog-add-environment.md.txt)
- [v1.8](https://docs.cloud.google.com/apigee/docs/hybrid/v1.8/precog-add-environment.md.txt)
- [v1.7](https://docs.cloud.google.com/apigee/docs/hybrid/v1.7/precog-add-environment.md.txt)
- [v1.6](https://docs.cloud.google.com/apigee/docs/hybrid/v1.6/precog-add-environment.md.txt)
- [v1.5](https://docs.cloud.google.com/apigee/docs/hybrid/v1.5/precog-add-environment.md.txt)
- [v1.4](https://docs.cloud.google.com/apigee/docs/hybrid/v1.4/precog-add-environment.md.txt)
- [v1.3](https://docs.cloud.google.com/apigee/docs/hybrid/v1.3/precog-add-environment.md.txt)
- [v1.2](https://docs.cloud.google.com/apigee/docs/hybrid/v1.2/precog-add-environment.md.txt)
- [v1.1](https://docs.cloud.google.com/apigee/docs/hybrid/v1.1/precog-add-environment.md.txt)

You can now try out the hybrid UI and add a new environment. Without an environment, you have
nowhere to deploy your API proxies. Additionally, if you don't create an environment as described
in this section, then several steps in the hybrid runtime installation process will fail.

The hybrid UI includes functionality that lets you do the following in a hybrid-enabled organization:

- Create, edit, and delete environments
- Assign environment-level access control to GCP project users
- Deploy and undeploy API proxies to your cluster
- Get the deployment status of pods in your cluster

**To access the hybrid UI and add an environment:**

1. Open the [Apigee UI](https://apigee.google.com).

   If this is the first time you are logging in, hybrid displays a consent dialog box:

   ![A dialog that asks the user
   to give services access](https://docs.cloud.google.com/static/apigee/docs/hybrid/v1.2/images/ui-consent.png)
2. If you are prompted to select from more than one account, choose the account that owns the project you created in [Step 2: Create a Google Cloud project](https://docs.cloud.google.com/apigee/docs/hybrid/v1.2/precog-gcpproject.md.txt).
3. Click **Allow** .

   Your browser navigates to the hybrid UI main landing page:

   ![The landing page in the Apigee
   hybrid UI, which consists of left-hand navigation and large links/images](https://docs.cloud.google.com/static/apigee/docs/hybrid/v1.2/images/ui-landing.png)
4. Ensure that your hybrid-enabled organization is selected from the organization drop-down list. If not, select it from the drop-down list, as the following example shows: ![A list of organizations that are hybrid enabled](https://docs.cloud.google.com/static/apigee/docs/hybrid/v1.2/images/ui-project-selector.png)

   Note that when you select a hybrid-enabled organization from the drop-down list, the hybrid
   UI displays the Apigee organization name and the GCP project name in the header. In many cases,
   the Apigee organization name and GCP project name are the same.
5. Click **Admin \> Environments \> Overview** .

   The **Environments** view is displayed, with no environments (yet):

   ![The Environments view, which is blank (no environments)](https://docs.cloud.google.com/static/apigee/docs/hybrid/v1.2/images/ui-no-environments.png)
6. Click **+Environment** in the upper right corner of the UI.

   The **Define a new environment** dialog box is displayed:

   ![The Define a new environment dialog box](https://docs.cloud.google.com/static/apigee/docs/hybrid/v1.2/images/ui-new-environment.png)
7. Enter the following information in the **New Environment** dialog box:
   1. **Display name:** A friendly name for the environment that is used in the UI. For example, "My First Environment" or "test". Unlike, the **Environment
      name** , the **Display name** can include upper case and other special characters. Required.
   2. **Environment name:** The programmatic name for the environment; also known as the *environment ID* . Required.

      For example, "my-environment" or "test".

      > [!WARNING]
      > An environment name can contain only lower-case letters, numbers, and hyphens. You cannot use upper-case letters or any other special characters. In addition, the **Environment name** can be up to a maximum of 32 characters long. For example: `my-test-env` or `my-test-env-42`.

      You will also use this name in the `overrides.yaml` file when you
      [install the hybrid runtime](https://docs.cloud.google.com/apigee/docs/hybrid/v1.2/install-before-begin.md.txt).

      The **Display name** and the **Environment name** can be
      different.
   3. **Description:** Additional information about the environment that you want to add as a reminder of the purpose of the environment. For example, "Created during initial installation". Optional.
8. Click **Create** .

   Apigee creates the new environment and indicates that it is "Pending Provisioning":

   ![Badge showing the 'Pending Provisioning'
   message](https://docs.cloud.google.com/static/apigee/docs/hybrid/v1.2/images/ui-myenv-pending.png)

   In a few moments, it will be "provisioned":

   ![Badge showing that the new
   environment was provisioned](https://docs.cloud.google.com/static/apigee/docs/hybrid/v1.2/images/ui-myenv-provisioned.png)

   However, you're not quite done. You also need to add your new environment to the
   runtime's overrides.yaml file---but first you've got to install the runtime,
   so let's not get ahead of ourselves.

> [!NOTE]
> **Congratulations!**
>
> Now that you've created a GCP account and project, gotten an org provisioned, had a snack,
> added some service accounts and other users, and created a new environment, you're ready to
> install the hybrid runtime on your Kubernetes cluster.

## Next step

To continue with the installation, see
[Runtime installation: Before you begin](https://docs.cloud.google.com/apigee/docs/hybrid/v1.2/install-before-begin.md.txt).