1. Using Visual Builder Studio
  2. Common Tasks
  3. Create and Use Environments
  4. Define Your Environments
  5. Set Up an Environment

Set Up an Environment

You can create an environment and add service instances to it from different identity domains. For example, you can add an Oracle Database Classic Cloud Service instance from one identity domain and an Oracle Java Cloud Service instance from another.

If you plan to use VB Studio's Integration build steps (see Move Oracle Integration Artifacts, Packages, and Lookups Between Instances), you can add OIC instances to your Environment definition in the Service Instances tab. Follow the instructions in Add an Oracle Integration Instance to an Environment to use the Oracle Integration Credentials option for adding an Integration instance in another stripe to an environment.

  1. In the left navigator, click Environments Environments.
  2. Click Create (or + Create Environment if the page is empty).
  3. In Environment Name, enter a unique name and, in Description, enter a description.
  4. Click Create.
  5. In the Service Instances tab, click + Add Instance.
  6. In the Add Service Instances dialog, on the tab's left side, select the type of service instance (Visual Builder and Oracle Integration, Oracle Cloud Applications, or Infrastructure Services) and, if needed, the authentication method for connecting to the instance. You may have to fill out a dialog with the appropriate credentials to populate the list of selectable instances in table on the tab's right side. These are the instances you can select from and add.
    The table, to the right, lists the service instances:
    • The Visual Builder and Oracle Integration list show you IDCS resources from your current domain and OCI resources. OCI resources are labeled “Visual Builder” or “Integration”.
    • The Oracle Cloud Applications list includes IDCS resources only.
    • The Infrastructure Services list may include PSM instances or instances that are not VB or OIC instances.

      PSM entitlement is limited to Infrastructure Services.

    The current identity domain's service instances are marked as IDCS Resources.
    To search for services from another identity domain or account, click Edit Identity Edit icon and enter the identity domain ID and region in the popup that opens. You can only edit PSM Account details in Infrastructure Services.

    Note:

    You can't change the identity domain for Oracle Cloud Applications or for Visual Builder and Oracle Integration. You can only see the lists of these from the current identity domain.

    Here's what you need to know to add a new service instance to an environment:

    • To add a Visual Builder runtime or Integration instance in your Identity domain, select one that's listed in the table after selecting Visual Builder and Oracle Integration under Instance Type and Identity Domain under Authentication Method. If your environment already contains a Visual Builder runtime or an Integration instance, you'll need to remove it before adding a different one.

      To add an instance that's part of Oracle Integration in another identity domain to an environment, you'll need to select Visual Builder and Oracle Integration under Instance Type and Visual Builder Credentials or Oracle Integration Credentials under Authentication Method:
      • You'll need the Visual Builder instance's base URL, instance name, and user credentials to add the Visual Builder instance.
      • You'll need the Oracle Integration instance's base URL, instance name, and user credentials to add the Oracle Integration instance.

        See Add an Oracle Integration Instance to an Environment.

      Note:

      Typically, the Visual Builder instance added to your visual application's environment uses the same identity domain as your Visual Builder Studio instance. If you choose a Visual Builder instance from a different identity domain as your deployment environment, you'll see a warning about setting up the Allowed Origins configuration. If you see this, you'll need to talk to your administrator to make sure your instance's domain is added to its list of allowed origins, as described in Allow Other Domains Access to Services.

    • To add an Oracle Cloud Applications instance in the same identity domain to an environment, select the IDCS resource you want from the table. If you're viewing an environment that already contains services from another stripe, you'll see a message that the service instance is in a different identity domain and no details about it will be displayed. This is expected behavior. To add an Oracle Cloud Application from a different identity domain, you'll need the base Oracle Cloud Application's URL and the credentials of a user who can access the instance.

      See Add the Oracle Cloud Application's Production Instance to an Environment.

    • To add an Infrastructure Services instance, such as JCS or OCI resources (for example, Compute, Storage, or databases), to an environment, you'll need the instance's region, identity domain ID, and a user's credentials who can access the instance to display a list of the resources you can add to the environment:Add Infrastructure Services dialog with 9 resources to select from

      Note:

      To connect to an IDCS-based instance, instead of a traditional identity domain name, you'll need to provide an IDCS tenant name, which looks something like "IDCS-XXXXXXXXXXXXXXX", in the configuration dialog.
  7. If necessary, repeat steps 5 and 6 to find and add additional service instances from different identity domains and data centers.

You need credentials of a user who is assigned the administrator role for the service type to add or remove a PSM-based service instance. To assign or modify roles, see Modifying Roles in Managing and Monitoring Oracle Cloud.