Creating a New Environment

Requesting a new environment for your cloud service is done by clicking Create on the App Manager Environments page (see figure 5.3).

You must provide the following details in your request:

  • Region: each environment is created in a region. Once a region is selected for the first environment, it is fixed for all other environments so selecting the correct region is critical. The region for the new environment should be the region that your cloud service will be provisioned in. If you are not sure which region to select or in which region your cloud services will be provisioned, please contact Oracle Support or your Customer Success Manager, before you continue.
  • Name: the name of the environment that will be visible in your OCI Console. We will refer to it as environment OCI Name. This name has to be unique amongst all environment, including environment that have been deleted. In addition, this name cannot be changed later.

    The OCI Name is not related to your cloud service environment name or type, it is simply a name that is given to an OCI resource (similar other resources such as compartment, or compute node). The OCI Name will not appear on the environment URL and will not be displayed anywhere outside the OCI Console.

  • Type of Environment: the type of environment that should be created based on your account quota.
    • Generally speaking, the following values are available for selection:
      • Production
      • Pre-Production
      • Development
      • Additional Development
      • Additional Test
      • Additional Pre-Production
      • Additional Training
    • The Production, Pre-Production and Development environment types will always be available for selection. The additional environment values will only be visible if your cloud service order included items for additional environments.
    • The available values for the environment type will not be linked or affected by the number or type of existing environment you already have. For example, if you have already asked to provision a production environment you can still ask for an additional production environment type. The request will be accepted at first but will be rejected later due to quota violation (since you already have a production environment and you are entitled to only one of that type).
    • Environment type cannot be changed once an environment is created.
  • Admin username: Please provide the administrator username for the Identity Domain linked to this environment (see the Identity Domain field under Advance Options below). Please make sure that the Admin User ID provided in this field is defined as an administrator user in the environment’s Identity Domain. If the user is not defined or does not have administrator privileges, the provisioning request will fail.
  • Advanced Options (visible at the end of the page):
    • Compartment: since an environment is an OCI resource it must be assigned to a Compartment. The default Compartment will be the Root Compartment (which is the tenancy itself). Different compartments can be selected for new environments as needed. The assignment of an environment to a Compartment can be changed later if needed.

      Note:

      The compartment selected for the environment must match the compartment of the Identity Domain used for the environment. If they don’t match, you will not be able to see the desired Identity Domain in the available identity domains list,
    • Identity Domain: new environments are by default assigned to and therefore authenticated by the tenancy’s default identity domain which will be the “OracleIdentityCloudService” domain (if exists), or the “Default” domain. If you need the new environment to be assigned to a different identity domain you can select the different identity domain in this section. Please note that this will affect how the environment is provisioned and how it is authenticated.
    • Encryption: this section includes information about Encryption Keys that will be used to store data for your cloud service. If your cloud service supports the features of Bring Your Own Key (BYOK) you will need to specify if you are using the default Oracle-Managed keys or you are using your own encryption key.

      If you are not sure if your cloud service support BYOK, please contact Oracle Support or your Customer Success Manager.

      • If you are providing your own key, you will need to create an OCI Vault and an OCI Key in that vault and to specify the details of both.
    • Tags: each OCI resource can be assigned different tags. For more information about OCI Tags, please refer to the Oracle Cloud Infrastructure documentation.

Once all the necessary information is provided, you can submit the request by clicking the Create button.

Once the request is accepted the environment will be visible in the environment dashboard with a status of "Creating". When the provisioning is completed, the environment status will change to "Active".

Important Note:

The status of the environment in App Manager indicates the provisioning status of the environment and is not related to the availability or health of that environment in your cloud service.