1. Administering Visual Builder Studio
  2. Set Up VB Studio for CI/CD
  3. Step 4: Set up VB Studio to run builds on Docker executors
  4. Add Your First Docker Deployment VM

Add Your First Docker Deployment VM

If you haven't configured VB Studio to add VM executors, you can add your first Docker deployment VM from the Organization page's Build Executors tab.

Note:

If you have created a VCN for your VM executors, make sure that you have the VCN configured to support Docker executors. For instructions, see Use VB Studio's Default VCN or Create and Configure a Public Subnet in a VCN for a custom VCN.

  1. Configure VB Studio to connect to your OCI account.
  2. In the left navigator, click Organization Organization.
  3. Click the Build Executors tab.
  4. In the Custom Docker Executor tile, click Create Docker Executor.
    Description of vbstudio_create_first_docker_deploymentvm.png follows
    Description of the illustration vbstudio_create_first_docker_deploymentvm.png

  5. Add details to the Add VMs for Creating Docker Executors dialog:
    1. Number of VMs: Specify the number of Docker deployment VMs you want to create.
      The number you specify doesn't include the Docker Management VM. For example, if you specify 4 in Number of VMs, VB Studio will create five VMs: four Docker deployment VMs and one Docker Management VM.
    2. Executors created per VM: Enter the maximum number of Docker executors you want to deploy in each Docker deployment VM.
    3. Region: Select the region that's closer to you geographically.
      The drop-down list displays regions your OCI account is subscribed to.
    4. Shape: Select the Docker executor's shape.

      As this is your first Docker deployment VM, the Docker Management VM is also created with the same shape. Choose a shape with at least two OCPUs and 16 GB of RAM.

      After selecting the shape, wait for a few seconds. VB Studio calculates the number of Compute VM instances that can be created with the selected shape and displays it in the dialog box. If the required number of Compute VM instances aren't available, choose another shape.
    5. Volume: Specify the storage capacity for each Docker deployment VM.
    6. Number of OCPUs: If you've selected a Flex shape, specify the number of OCPUs to add in each Docker deployment VM.
    7. Amount of Memory: If you've selected a Flex shape, specify each Docker deployment VM's memory.
    8. Use only for project(s): (Optional) Select one or more projects to assign to this Docker deployment VM. After the Docker deployment VM is created, it will be restricted to running builds for the assigned projects. Builds for these projects will only run on this VM, and builds from other projects won't run on this VM.
  6. For VCN Select, choose Default or Custom.
    • If you chose Default, click Create. You are finished with this task.
    • If you chose Custom, continue to the next step.
  7. Fill out the additional details for the custom VCN:
    1. VCN Compartment: Select the compartment.
      If you're an Oracle Cloud OS Management Service (OSMS) user, don't select the OSMS compartment or a compartment with an OSMS policy.
    2. VCN: Select the VCN.
    3. Subnets Compartments: Select the compartments where your public subnets are. By default, it adds your VCN's compartment. If required, you can add more compartments.
    4. Subnets: Select a subnet. The list shows public subnets only.
      You can add multiple public subnets. If VB Studio can't create a Docker executor on the first subnet you've added, it tries to create it on the second subnet, and so on.
  8. Click Validate Network Setup.
  9. Click Create.
Before you try to use your Docker executors and images, you should check their states by visiting the tabs on the Organization page's Build Executors tab: