Changing the Default Docker Images

An organization may wish to change the runtime images used by default for all users in the Pipelines installation. For example, if your organization has particular dependencies that are not met by the standard default runtime images, you may wish to use a set of custom runtime images.

To accomplish this, the system administrator can update the Pipelines system YAML, then restart the installation by running the pipelines CLI with the upgrade command. See Installing Pipelines for more information about upgrading a Pipelines installation.

An example system.yaml default image configuration is shown below with default images for node and java. There should only be one image with isDefault for each combination of architecture and os and one image with each combination of architecture , os , and language .

runtime:
  languageImages:
    - architecture: x86_64
      os: Ubuntu_16.04
      language: node
      registryUrl: releases-docker.jfrog.io
      image: jfrog/pipelines-u16node
      isDefault: true
      defaultVersion: 10.18.0
    - architecture: x86_64
      os: Ubuntu_16.04
      language: java
      registryUrl: releases-docker.jfrog.io
      image: jfrog/pipelines-u16java

architecture is the architecture on which this Docker image should be used. Currently, only x86_64 is supported.
os is the operating system on which this Docker image will be selected. To use the same image on multiple operating systems, add another entry to languageImages for each operating system.
The current operating system choices are:
- Ubuntu_18.04
- Ubuntu_16.04
- CentOS_7
- WindowsServer_2019
languageis the language, as listed in the step runtime configuration, for which this image should be used.
registryUrl is the optional Docker registry where the image can be found.
image is the image name, without tag.
isDefault designates that this image should be used when no language is specified for the step. Only one image for each architecture and operating system should be default.
defaultVersion is the default image tag, used if no language is listed in the step configuration. When a version is specified in the step configuration, it should match a tag for the image.