Oracle Cloud Infrastructure Documentation

Connect to Your OCI Account and Add VM Build Executors

Configure VB Studio to connect to your own OCI account if you need more VM build executors to reduce the wait time for your organization's members, if you want to create custom build executor templates, or if you want to use advanced features for VM executors (such as use your own VCN or use a different VM shape).

  1. Configure your VB Studio instance to connect to your OCI account.

    If you don't have authorization to create and manage OCI resources, ask someone who can create the resources.

    1. If you haven't created a VB Studio instance yet, you can create the instance and connect it to your OCI account at the same time. See Create a VB Studio Instance in Your Oracle Cloud Account.
    2. If your VB Studio instance already exists and you now want to connect it to your own OCI account:
      1. In the Oracle Cloud Console, open the Visual Builder Studio Instances page and select your VB Studio instance.
      2. Click Edit.
      3. Select the Yes, I authorize this checkbox.
      4. Select the compartment that hosts your VB Studio resources.
      5. Click Save Changes.
  2. To see your new OCI connection in VB Studio:
    1. In the left navigator, click Organization Organization.
    2. Click the OCI Account tab.

To create custom build executor templates, see Create and Manage Build Executor Templates. Remember to add Node.js 20 or 22 to the executor template. Node.js 20 and 22 are the supported versions for packaging extensions.

To add more VM executors:

  1. Click the VM Build Executors tab.
  2. Click + Create VM.
  3. In the Add VM Build Executor dialog box, in Quantity, specify the number of VM executors you want to allocate.

    To minimize build execution delays, set the number of VM executors to the number of jobs that you expect to run in parallel using that template. If the OCI VM quota is available, that number of VM executors will be added to the Virtual Machines tab.

    If you're not sure about the number of VM executors you'll need, start with one VM executor and then add more as required. Note that the more VM executors you have running at a specific time, the higher the cost of OCPUs. To minimize the higher cost, use the Sleep Timeout setting on the VM Build Executors tab to automatically shut down inactive VM executors. You can always return to the VM Build Executors tab to remove or add VM executors, based on your actual usage.

  4. In Build Executor Template, select System Default OL7 for Visual Builder or an executor template with Node.js 20 or 22 software.
  5. In Region, Shape, and VCN Selection specify the VM's region, shape, and Virtual Cloud Network (VCN).
    • A region is a localized geographic area where the data centers are located. Remember, a VM executor is a VM on OCI Compute. Choose the region where your VB Studio account is or the one that's closest to you geographically.
    • A shape is a template that determines the number of CPUs, amount of memory, and other resources allocated to the created instance. Choose a shape of your preference.
    • A VCN is a software-defined network that you set up in the Oracle Cloud Infrastructure data centers in a particular region. By default, builds run in your VB Studio's compartment. To run builds in your own VCN, select Custom and specify its details.

    To learn more about regions and shapes, see Regions and Availability Domains and Compute Shapes. To find more about VCNs, see VCNs and Subnets.

  6. Click Add.