Oracle Cloud Infrastructure Documentation

Managing Applications Environments

This topic describes how to create and manage applications environments.

Environment management tasks include:

  • Creating an environment
  • Accessing the application service console
  • Viewing environment details and status
  • Adding and editing tags

About Environment State

During the lifecycle of your environment, the state can change based on actions taken on the environment. The state of the environment is not the same as the status of the application running on the environment. The following table shows the possible values for the state of your environment and how the environment state impacts the availability of running applications:

State Description Applications Available?
Creating The environment resource is being created. No
Active The environment resource is available. Yes
Updating The environment resource is updating. This status occurs when configurations or changes are being implemented, such as moving the environment to a different compartment. In this state, the applications are still available, but you can't make any other changes to the environment resource settings (such as adding tags) until this update is complete. Yes
Deleting The environment resource is in the process of being deleted. No
Deleted The environment resource has been deleted. No
Failed The environment resource creation failed. No

Environment Management Tasks

To create an environment
Note

The following steps are the general procedure for creating an environment. Some details for your application may vary. See your application's help for details on specific options for your application.

  1. From the Applications Console, under My Applications, click Create environment for the application you want to create an environment for.
  2. If multiple subscriptions are available to provision, select the Subscription ID from the list. To get more information about a subscription, click Show details.
  3. Confirm the default region or select another region from the list.

    The region is where an environment is geographically located. The region can't be changed after you create an environment. If this is the first environment that you are creating for this subscription, you can choose a different region from the list. If you have already created environments for this subscription, this field can't be updated. All environments associated with a single subscription must be located in the same region. For more information, see Choosing a Region for an Environment.

  4. Enter a Name for the environment. The name can't be changed later.
  5. Select the Type of instance. Environment instances included in your subscription that are available to provision are listed in the menu. For more information, see Selecting the Environment Type or Instance Type.
  6. Enter an email address for the default administrator.

    The administrator that you add here will be assigned the default Administrator role for the applications in this environment. For more information, see Assigning an Environment Administrator.

  7. To configure additional settings, click Show advanced options.
  8. (Optional) Click Compartments to select a different compartment in which to create this environment. The compartment selection defaults to the compartment that you last selected when you started the create environment flow. If you have not created any compartments in your tenancy, the root compartment is the only compartment available. For more information, see Choosing a Compartment.
  9. (Optional) Click the Tags tab to add tags to the environment. If you have permissions to create a resource, then you also have permissions to apply free-form tags to that resource. To apply a defined tag, you must have permissions to use the tag namespace. For more information about tagging, see Resource Tags. If you're not sure whether to apply tags, skip this option or ask an administrator. You can apply tags later.
  10. Click Create.

You can track the progress of the environment creation by viewing the status of the work request. After the Create environment work request succeeds, a welcome email with sign-in instructions is sent to the Admin email address entered during environment creation.

To access the service console
Note

Some instance types, such as the Maxymiser Recommendations instance type do not have a service console, therefore the Open service console option is not applicable.

After the environment is provisioned, you can access the service console from the environment details page:

  1. From the Applications Console, under My Applications, click the name of the application to view the list of environments.
  2. Click the name of the environment.
  3. On the details page, click Open service console. You will be prompted to enter your username and password for the application service.
To view environment details and status
  1. From the Applications Console, under My Applications, click the name of the application to view the Overview page.
  2. Click Environments.
  3. Under List Scope, in the Compartment list, click the name of the compartment where the environment is located.
  4. Click the name of the environment.
To move an environment to a different compartment

You can move environments from one compartment  to another. After you move an environment to a new compartment, inherent policies apply immediately and affect access to the environment. Moving an environment doesn't affect access to the applications on the environment. For more information, see Managing Compartments.

  1. From the Applications Console, under My Applications, click the name of the application to view the list of environments.
  2. Click the name of the environment.
  3. On the details page, under the General information, find Compartment, and click Change.
  4. Choose a different compartment from the list.
  5. Click Move environment.
To add or edit tags

For details on adding tags, see Resource Tags.

To delete an environment

Environment delete is not a supported self-service action. If you need to delete an environment, file a service request.