Create and Set Up Your Visual Builder Generation 2 Instance
Like other Oracle Cloud services, you must create an instance of Oracle Visual Builder before you can start using it.
You can create Visual Builder Generation 2 instances in any Oracle data region listed in Availability. To create and set up an instance, you must be assigned specific roles.
Confirm You Have the Required Roles
If you are the user that initially signed up and purchased universal credits for Oracle Cloud, you automatically have the necessary service entitlement roles to create Oracle Visual Builder instances. Otherwise, the correct roles must be explicitly assigned to your user account to create Oracle Visual Builder instances.
Without the necessary roles, instance creation fails.
To successfully create Oracle Visual Builder instances, ensure that your user account is assigned the required roles and to the required groups.
You must be assigned this role: | To ... |
---|---|
Cloud Account Administrator |
Set up Oracle Cloud Infrastructure (OCI) compartments and buckets. If you're not an account administrator, contact the administrator to add you to the OCI_Administrators IDCS group. |
Identity Domain Administrator or User Administrator |
Add users and assign IDCS roles and groups. If you're not an administrator, make sure that your OCI group is assigned a policy like this:
|
AUTONOMOUS_VISUALBUILDER_ENTITLEMENT_ADMINISTRATOR (Oracle Visual Builder entitlement administrator role in IDCS) |
Create the Visual Builder instance. If you're not the account administrator or the IDCS administrator, contact the IDCS admin to assign this IDCS role to you. If you're not assigned this role you won't see the user interface to provision a Visual Builder instance. |
Assign the entitlement administrator role to a user
If you are not sure you have the correct administrator role to provision an instance, or if you want to assign the correct role to a user, log in to Oracle Identity Cloud Services to manage the service's roles. To do this, you'll need to have the Identity Domain Administrator or User Administrator role assigned to you.
To assign the AUTONOMOUS_VISUALBUILDER_ENTITLEMENT_ADMINISTRATOR
role to a user.
- Log in to Oracle Identity Cloud Services.
- Click Oracle Cloud Services in the main navigation.
- Click VISUALBUILDERAUTO in the list of services.
- Open the Application Roles tab.
To see a list of users that have already been assigned the role, click Users Assigned.
- To assign the role to a user, choose Assign Users in the menu on the right.
- Select the users you want to assign the role to. Click OK.
Understand Your Responsibilities as an Administrator
This guide is directed to administrators provisioning, creating, and configuring Visual Builder instances and identities on Oracle Cloud Infrastructure.
Provisioning and administering Visual Builder typically involves the following responsibilities. Note that these tasks could be done by the same person (the tenant administrator) or by different people.
Responsibility | See |
---|---|
Create required OCI resources for the Visual Builder instance | Create Required OCI Resources |
Create a Visual Builder instance in an OCI compartment | Create the Visual Builder Instance |
Add users and groups | About Setting Up Users and Groups |
Manage the Visual Builder instance, such as start or stop the instance, or configure a custom endpoint | View and Manage the Visual Builder Instance |
Signing In to the OCI Console
Signing into the OCI Console differs depending on whether or not your cloud account uses identity domains.
If you are not sure if your cloud account uses identity domains, see About Setting Up Users and Groups.
Signing In to the Console in Cloud Accounts That Use Identity Domains
If your cloud account uses identity domains, you sign in to the OCI Console as a user configured in Oracle Cloud Infrastructure Identity and Access Management (IAM).
Signing In to the Console in Cloud Accounts That Do Not Use Identity Domains
If your cloud account does not use identity domains, you sign in to the OCI Console as a user federated through Oracle Identity Cloud Service. A federated environment enables business partners to integrate in the identity management realm by providing a mechanism for users to share identity information across respective security domains.
Create Required OCI Resources
Visual Builder instances use the Oracle Cloud Infrastructure (OCI) as their underlying infrastructure. If you're the tenant administrator, create the required OCI resources Visual Builder instances need.
To do this: | See this: |
---|---|
Create a compartment.
To create an instance, you must first create
a compartment. You can use the |
Create a Compartment for Visual Builder If you want someone else to create the compartment
and other OCI resources, add the user to the
|
Add users who can manage the Visual Builder instance.
If you want other non-admin users to create and manage Visual Builder instances, assign them the required OCI policies. Skip this step if you plan to create and manage the instances yourself. |
Create Oracle Cloud Infrastructure Groups and Policies |
Map a custom endpoint to the Visual Builder instance use it to access the instance instead of the original URL generated in the OCI Console | Create and Configure a Custom Endpoint for Your Visual Builder Instance |
Set Visual Builder instance quotas | Set Instance Quotas for a Compartment |
Add an Existing User to the OCI_Administrators IDCS Group
- On the OCI console, in the upper-left corner, click Navigation Menu
.
- Select Identity & Security and then under Identity, select Federation.
- Select the OracleIdentityCloudService link to view the default Oracle Identity Cloud Service identity federation.
- Select Groups from the Resources options.
- Click the
OCI_Administrators
group. - Click Add to IDCS Group.
- In the Add User to IDCS Group dialog box, select the user and click Add.
Create the Visual Builder Instance
You can create multiple Visual Builder instances in an OCI compartment.