Create and Manage Docker Images

In VB Studio, you can import a Docker image from an external Docker registry or create a Docker image from a build executor template.

You'll need to configure VB Studio to connect to your OCI account before you can proceed. See Create a VB Studio Instance in Your Oracle Cloud Account or, if you've already created your VB Studio instance, see Change Your OCI Account.

Note:

You can't create or manage Docker images if VB Studio is connected to the built-in free account.

VB Studio provides out-of-the-box base Docker images for your organization's users. You can't modify or delete these Docker images, and they can't be used for building your job. These base images are used to create Docker images from Docker build executor templates.

Docker image Description
System Base OL7 Oracle Linux 7 base image with required software packages
System Base OL8 Oracle Linux 8 base image with required software packages

You can create and manage Docker images from the Build Executors tab on the Organization page.

  1. In the left navigator, click Organization Organization.
  2. Click the Build Executors tab.
  3. Click the Docker Images tab.

    The tab shows the number of Docker images that are in use or are in an error state.


    Description of build-executors-docker-images-summary.png follows
    Description of the illustration build-executors-docker-images-summary.png

    Notice that the system base images, indicated with the System badge, are displayed by default. To hide them, click the Hide system images checkbox to the right.

This table describes the actions you can perform to create and manage Docker images.

Action How To

Import a Docker image from an external Docker registry

  1. Click Create Image and select Create Image from Registry.

  2. In the Add Custom Docker Image dialog box, in Name, enter the image's name.

  3. In Registry Host, enter the Docker registry's host name.
  4. In Username and Password, enter the credentials of the users who can access the registry. If it's a public registry, leave the fields empty.
  5. In Image Name, enter the Docker image's name to be imported.
  6. In Version Tag, specify the Docker image's tag
  7. In Max Executors, specify the maximum number of executors to be created from the imported image.
  8. Click Add.
Create a Docker image from an executor template

You can create only one Docker image from an executor template.

  1. Click Create Image and select Create Image from Build Executor Template.
  2. From the Build Executor Template drop-down list, select the executor template.
  3. In Max Executors, specify the maximum number of executors to be created from the image.
  4. Click Save.
Change a Docker image's executor template Click Action Three horizontal dots and select Edit. In Build Executor Template, change the template and click Save.
Change a Docker image's maximum executors Click Action Three horizontal dots and select Edit. In Max Executors, change the number of executors and click Save.
Re-create a Docker image Click Action Three horizontal dots and Recreate Image. In the confirmation dialog box, click OK.
View a Docker image's log Click Action Three horizontal dots and select Show Log.

Delete a Docker image

 Click Action Three horizontal dots and select Delete. In the Delete Docker Image dialog box, click Delete.