1. Sign in to VB Studio. See Access VB Studio from the Oracle Cloud Home Page.
2. On the Organization page, click + Create.
3. On the Project Details page, enter a unique name and description for the project.
4. In Security, select the project's privacy setting.

   A private project is accessible to invited users only. Users who aren't invited can't access it or make changes to it. You can invite users after creating the project.

   A shared project is accessible to all users of the organization. Any user can view the source code, create or update issues, edit wiki pages, and interact with project builds. However, only invited users can make updates to the source code in Git repositories, create and run build jobs, and perform deployment operations.

5. In Preferred Language, specify the language for the email notifications your project users will receive. You can change the language in which the user interface appears in your user preferences.
6. Click Next.
7. On the Template page, select the Empty Project template, then click Next.
8. On the Properties page, select the wiki markup type, then click Finish.

After the project is provisioned, the Project Home page opens where you can see a summary of the project's provisioning activities. Review the activities feed for any errors.

1. In the navigation menu, click Environments , then click + Create Environment.
2. In Environment Name and Description, enter a unique name and description, and click Create.
3. In the environment's Service Instances tab, click Add Instance.
4. Locate and add your Visual Builder instance:
   1. Make sure Instance Type is set to Visual Builder and Oracle Integration and Add Instance Using is set to Instance List. This is the preferred approach.
   2. Click next to OCI Details, select the region and compartment where your Visual Builder instance is, and click Update.
   3. Select your Visual Builder instance from the selected compartment's instance list and click Add.

   If you don't see the instance you want to add (because it's connected to a different OCI account), select Visual Builder Credentials under Add Instance Using. In Base URL, enter the Visual Builder instance's URL; update the Instance Name if needed; enter the credentials of a user who can access the Visual Builder instance in Username and Password; and click Add.

5. If your target instance uses a different identity domain than your VB Studio instance, OAuth tokens (via three-legged OAuth flows) are used to secure programmatic access to the instance. Before any OAuth tokens can be created, you must provide authorization to acquire OAuth tokens. Click Authorize when prompted, then sign in with credentials to connect and deploy to the target instance.

1. In the navigation menu, click Workspaces .
2. Click New and select New Visual Application.
3. In Workspace Name, add a name for your workspace.
4. In Development Environment, select the environment you created in the previous step.
5. In Visual Application Template, don't change the default (Default VBCS Application).
6. In Git Repository, select Create new repository, and enter a repository name and working branch name.

1. In your Visual Builder Studio navigation menu, click Builds .
2. In the Jobs tab, click the deployment job.
3. Click Configure, then click the Steps tab.
4. In Target Instance, make sure that the environment you created in Step 2 is selected.
5. In Username and Password, enter the credentials of a user who can connect and deploy to the Visual Builder development instance. The credentials will be used when the package and deploy build pipeline runs.
6. (Optional) Choose Use custom file names and add custom file name details.
7. (Optional) To overwrite the application's default version, specify the new version in Application Version. Leave it empty to use the version defined in the application's visual-application.json file.

   Don't deselect the Include the application version in the URL checkbox.

8. (Optional) In Application Profile, specify the development application profile. Leave it empty to use the application's default profile.

   Using application profiles, you can define different combinations of servers and security settings for each of your environments, and use them when deploying the application to an environment. To learn more, see What Are Application Profiles?

9. (Optional) To use the existing application's database, in Data Management, select Keep existing environment data. To use a clean database for the application, in Data Management, select Use clean database.
10. Click Save.