3 Set Up VB Studio for CI/CD

Everyone should read this chapter, regardless of what type of application your organization's members are building. The build system is one of VB Studio's most integral parts.

The build system in VB Studio enables your organization's developers to create jobs that build, package, test, and deploy applications and application extensions. In VB Studio, builds run either in VM build executors (VM executors, for short) or in Docker executors. Build executor templates define the operating system and software packages for VM executors, and Docker images define the operating system and software packages for Docker executors.

To build their applications, your organization's developers define build jobs in their VB Studio projects. A job is a configuration that defines the location where the application's source files are found, the commands needed to run the job and test scripts, the instructions for generating and packaging artifacts, and the location where those artifacts will be deployed.

To run builds, your organization's developers need some Compute instances with operating systems and software packages installed. For example, to build Node.js applications, they'll need Node.js installed on an OCI VM Compute instance, which they'll use to run to run their CI/CD builds.

Before you start configuring CI/CD for VB Studio, you need to make several decisions that will guide you through the configuration process:

• Step 1: Decide whether to use the free VM build executor

  This step is required. See VB Studio's Free VM Build Executor to understand what this build executor provides and whether it meets the needs of your organization's members.

• Step 2: Decide whether to run VM build executors or Docker executors

  This step is required. In VB Studio, builds run either in VM build executors or in Docker executors. If you're not sure which type you need, see What are Build Executors and Build Templates?.

• Step 3: Set up VB Studio to run VM build executors

  This step is optional. If you decided to go with VM Build executors in Step 2, use this step. If you decided to use Docker executors, go to Step 4. You must use one or the other.

• Step 4: Set up VB Studio to run builds on Docker executors

  This step is optional. If you decided to go with Docker executors in Step 2, use this step. If you decided to use VM build executors, go to Step 3. You must use one or the other.

• Step 5: Set Up Users and Groups

  This step is required. If you want to add groups instead of adding users individually, see Manage Your Organization's Groups.

• Step 6: Configure your OCI resources

  This step is optional. You only need to perform this task when you switch OCI compartments or accounts.