Environments

An environment contains Kafka clusters and deployed components such as Connect, ksqlDB, and Schema Registry. You can define multiple environments for a Organizations, and there is no charge for creating or using additional environments. Different departments or teams can use separate environments to avoid interfering with each other.

This topic contains steps to manage environments using the Confluent Cloud Console, but you can also use the Confluent CLI environment command Confluent Cloud CLI or Confluent REST APIs to manage environments.

You cannot move cluster deployments between environments.

Group all clusters that should share one Schema Registry in a single environment. Separate development, test, and production environments isolate schema iteration in development from the production Schema Registry. There is no enforcement of which Schema Registry the clients of a Kafka cluster must use. For more information on Confluent Cloud Schema Registry, see Working with schemas.

View an environment

To view your existing environments:

  1. From the Confluent Cloud Administration menu in the upper right, click Environments. The environment panel displays.

    Confluent Cloud select Environments
  2. To select an environment, click on its panel. The name of the environment you are currently in is displayed at the top of the Cloud Console:

    Confluent Cloud Environment Indicator

Each panel shows the number of clusters within the environment, and provides links to edit or delete the environment.

Add an environment

To add a new environment:

  1. From the Confluent Cloud Administration menu in the upper right, click Environments. The environment panel displays.

    Confluent Cloud select Environments
  2. In the environment panel, click Add cloud environment.

    Confluent Cloud add Environments
  3. Enter a name for the environment. The environment name:

    • Cannot exceed 32 characters
    • Starts and ends with alphanumeric characters
    • Can contain hyphens and underscores, but cannot contain spaces.
    Confluent Cloud Edit environment name dialog
  4. Click Create.

You can now create a cluster or try the Quick Start for Confluent Cloud.

Update an environment name

To update an environment name:

  1. From the Confluent Cloud Administration menu, click Environments. The environment panel displays.

  2. Click the Edit link in the environment panel and edit the Environment name.

    Edit environment name dialog
  3. Click Save.

Delete an environment

Follow these instructions to delete an environment. At least one environment is required in every organization, so if you have only one environment left, it cannot be deleted.

Important

When you delete an environment, all clusters (for example, Apache Kafka®, Schema Registry, Connect, ksqlDB) within that environment are deleted.

  1. From the Confluent Cloud Administration menu, click Environments to display the environment panel.

  2. Click the Delete link for the environment you want to delete.

    Confluent Cloud add Environments
  3. Enter the environment name to confirm deletion and click Continue. You can click the clusters link to view the clusters in the environment that will be deleted.

    Confirm environment deletion