Step 6: Create an environment and environment group

What you're doing in this step

At last! Apigee finished creating your new runtime instance. You're now going to create a new environment and attach it to a new environment group.

An environment group is a logical grouping of environments. You define your hostnames on an environment group rather than individual environments so that they can be shared. A service on the group called the ingress redirects requests to different environments within the group based on the hostnames assigned to the group.

Environment and environment group names must start with a lower case letter, be at least one character long, and can include lower case letters, numbers, and hyphens (as long as they don't end with a hyphen).

For more information, see Overview of environments and environment groups.

Perform the step

To create an environment and group and add it to the runtime:

  1. Open the Apigee provisioning wizard if it is not currently open. The wizard returns to the most recent incomplete task in the list.
  2. Click Edit next to Environment.

    The Set up an environment view displays:

    Create Environment screen

  3. In the Environment group name field, specify a name for your environment group. For example, test-group. You cannot change the name of an environment group once it has been created.

  4. In the Environment group host name field, specify the hostname that routes requests into this group. For example, sales.example.com.

    You can specify a single host name only in this field. To add more host names to the environment, use the Environments API.

  5. In the Environment name field, specify a name for your environment. For example, test. You cannot change the name of an environment once it has been created.
  6. Click Create & Attach to create the new environment and attach it to the new environment group.

Environments can be used across more than one runtime. This is useful when your runtimes are used for multiple regions.

Note that when you create a new environment, you must assign it to an environment group. Environments that are not assigned to groups have no hostnames pointing to them, and are therefore not accessible.

If you encounter errors during this part of the process, see Troubleshooting.


1 2 3 4 5 6 NEXT: Configure routing 8