To deploy an extension to an Oracle Cloud Applications instance, you must create a VB Studio environment and add the instance to it. You can add only one Oracle Cloud Applications instance to each environment.

Each Oracle Cloud Applications DEV and TEST instance has its own identity domain. This means you'll need the target instance's URL—as well as a user's credentials that can access the instance—to set up the environment. These credentials must be those of a local user, not a federated identity, and must not require multi-factor authentication.

Here's what your Environments page might look like after you've added three new environments, one for another DEV instance and two for some TEST instances:

Description of the illustration vbs_environments.png

To create a new VB Studio environment:

1. In the VB Studio navigation menu, click Environments.
2. Click + Create Environment. In Environment Name and Description, enter a unique name and description, then click Create.
3. In the Service Instances tab, click + Add Instance.
4. In the Add Service Instance dialog box, select Oracle Cloud Applications.
5. Under Add Instance Using, select Application Credentials.
6. In Base URL, enter the Oracle Cloud Application's base URL.
7. In Instance Name, if required, update the instance's display name. The name will be displayed in the Service Instances tab.
8. In Username and Password, enter the credentials of a user who can access the Oracle Cloud Applications instance.

   These credentials must be those of a local user, not a federated identity, and must not require multi-factor authentication.

9. Under Authorization Type, select OAuth 2.0 or Basic.
10. Click Add.

11. If you chose OAuth 2.0 as the Authorization Type, you may be prompted for authorization to acquire OAuth tokens for accessing the target instance. Click Authorize when prompted, then sign in with credentials to access the Oracle Cloud Applications instance.

    Note:

    OAuth tokens (access and refresh) are typically cycled during regular use. If a token expires during an extended period of inactivity, like when you're away on vacation, click Actions and select Renew OAuth Access to restart the OAuth workflow.

    Note that the username under the Details section of the connected Oracle Cloud Applications endpoint shown in the Environments page's Instances tab displays the user that is logged in to the Oracle Cloud Applications instance and who creates the Refresh Token that the connection is using is shown. The details don't show the VB Studio username, which isn't relevant for a 3-legged OAuth Environment connection.

If the newly added instance stays in the Unknown status for some time, it usually indicates that the IDCS Application provisioning may have failed. VB Studio added the Oracle Cloud Applications instance, but can't access it. In this case, click Actions and select Remove to remove the Oracle Cloud Applications instance from the environment, and then click Add to add it again.

Once you're done, the Recent Activities feed on the Project Home page lists the newly created environment along with the service instance you added.