Step 8: Add a new environment in the Hybrid UI

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.

Apigee recommends that you create no more than 25 environments.

The Hybrid UI includes most of Apigee Edge UI’s functionality, plus some Hybrid-specific 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 Hybrid UI.

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

  2. If you are prompted to select from more than one account, choose the account that owns the project you created in Step 3: Create a GCP project.
  3. Click Allow.

    Your browser navigates to the Hybrid UI main landing page:

    The Hybrid UI is similar to the New Edge Experience. Developer tasks, such as creating and editing API proxies, controlling proxies with flows, and handling faults, are very similar. Some administrative and operational tasks, however, such as managing users and deploying API proxies, are very different from the Edge UI. The topics in Administer describe the processes that are different.

  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:

    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 displays, with no environments (yet):

  6. Click +Environment in the upper right corner of the UI.

    The Define a new environment dialog box displays:

  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, “MyEnvironment”.
    2. Environment name: The programmatic name for the environment.

      For your first environment, enter “my-environment”.

      The Display name and the Environment name can be different.

      You will also use this name in the overrides.yaml file when you install the Hybrid runtime.

    3. Description (optional): Additional information about the environment that you want to add as a reminder. For example, enter "Created during initial installation."

    All fields except Description are required.

  8. Click Create.

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

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

    However, you’re not quite done. You'll need to also 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. For more information, see Runtime installation overview.