This page describes how to create a container image.

Container images are used to run Workspaces, scripts in Workflows, Webapps and APIs.

A range of global images are available to use, however custom images can also be created that will meet any specific data processing requirements you may have. Up to 30 custom images can be created per tenant.


Contents


Before you start

As with creating any type of image, you will first need a Docker image file. 

Docker files can be loaded from existing global images or from your tenant.

For details of how to create a Docker images, see Dockerfile reference


Overview

To add a new custom image:

  1. Go to Models > Image Management.
  2. Click ADD.
    The New Image screen appears.


To edit an existing custom image:

  1. Go to Models > Image Management
  2. Hover over the required custom image and click the edit icon.
    The Edit Image screen appears.
For details of how to download (pull) images, see Pulling an Image.

Creating or editing an image 

You can create new images or edit existing ones. 

You may have to edit and rebuild an image if you are updating it with new code for use in a workflow.

The Create Image and Edit Image screens have identical fields:

Repository URL

Enter the location of the repository where the required image is stored.

For example, https://github.com/PeakBI/r-studio-image 


Token

If a token is required to access the repository.

Tokens can be generated and added from Settings > Access Tokens.


Repository Branch

This is the branch of the repository where your script is stored.


Build Path

This is the branch of the repository where your script is stored.

If the image is located within a folder in the GitHub repository, enter the folder name here.


Build Arguments

From here you can view the current build arguments and add additional ones so that they can be passed to your Docker image. For example, these could be arguments such as a Slack URL.

Make sure any build arguments that you add are referenced in the Docker file. 


To add a new build argument:


  1. Click BUILD ARGUMENTS.
    The Build Arguments window appears.
  2. Click ADD and then enter:
    Variable Name:
    Value:
  3. Click CONFIRM to save the argument.