nodepool/doc/source/openshift.rst

zuul

Openshift Driver

Selecting the openshift driver adds the following options to the providers section of the configuration.

providers.[openshift]

An Openshift provider's resources are partitioned into groups called pool (see providers.[openshift].pools for details), and within a pool, the node types which are to be made available are listed (see providers.[openshift].pools.labels for details).

Note

For documentation purposes the option names are prefixed providers.[openshift] to disambiguate from other drivers, but [openshift] is not required in the configuration (e.g. below providers.[openshift].pools refers to the pools key in the providers section when the openshift driver is selected).

Example:

providers:
  - name: cluster
    driver: openshift
    context: context-name
    pools:
      - name: main
        labels:
          - name: openshift-project
            type: project
          - name: openshift-pod
            type: pod
            image: docker.io/fedora:28

context

Name of the context configured in kube/config.

Before using the driver, Nodepool services need a kube/config file manually installed with self-provisioner (the service account needs to be able to create projects) context. Make sure the context is present in oc config get-contexts command output.

launch-retries

The number of times to retry launching a node before considering the job failed.

max-projects

Maximum number of projects that can be used.

pools

A pool defines a group of resources from an Openshift provider.

name

Project's name are prefixed with the pool's name.

priority

The priority of this provider pool (a lesser number is a higher priority). Nodepool launchers will yield requests to other provider pools with a higher priority as long as they are not paused. This means that in general, higher priority pools will reach quota first before lower priority pools begin to be used.

This setting may be specified at the provider level in order to apply to all pools within that provider, or it can be overridden here for a specific pool.

node-attributes

A dictionary of key-value pairs that will be stored with the node data in ZooKeeper. The keys and values can be any arbitrary string.

default-label-cpu

Only used by the providers.[openshift].pools.labels.type.pod label type; specifies specifies a default value for providers.[openshift].pools.labels.cpu for all labels of this pool that do not set their own value.

default-label-memory

Only used by the providers.[openshift].pools.labels.type.pod label type; specifies a default value in MiB for providers.[openshift].pools.labels.memory for all labels of this pool that do not set their own value.

default-label-storage

Only used by the providers.[openshift].pools.labels.type.pod label type; specifies a default value in MB for providers.[openshift].pools.labels.storage for all labels of this pool that do not set their own value.

default-label-cpu-limit

Only used by the providers.[openshift].pools.labels.type.pod label type; specifies specifies a default value for providers.[openshift].pools.labels.cpu-limit for all labels of this pool that do not set their own value.

default-label-memory-limit

Only used by the providers.[openshift].pools.labels.type.pod label type; specifies a default value in MiB for providers.[openshift].pools.labels.memory-limit for all labels of this pool that do not set their own value.

default-label-storage-limit

Only used by the providers.[openshift].pools.labels.type.pod label type; specifies a default value in MB for providers.[openshift].pools.labels.storage-limit for all labels of this pool that do not set their own value.

labels

Each entry in a pool`s labels section indicates that the corresponding label is available for use in this pool.

Each entry is a dictionary with the following keys

name

Identifier for this label; references an entry in the labels section.

type

The Openshift provider supports two types of labels:

project

Project labels provide an empty project configured with a service account that can create pods, services, configmaps, etc.

pod

Pod labels provide a new dedicated project with a single pod created using the providers.[openshift].pools.labels.image parameter and it is configured with a service account that can exec and get the logs of the pod.

image

Only used by the providers.[openshift].pools.labels.type.pod label type; specifies the image name used by the pod.

image-pull

The ImagePullPolicy, can be IfNotPresent, Always or Never.

image-pull-secrets

The imagePullSecrets needed to pull container images from a private registry.

Example:

labels:
  - name: openshift-pod
    image: docker.io/fedora:28
    image-pull-secrets:
      - name: registry-secret

labels

A dictionary of additional values to be added to the namespace or pod metadata. The value of this field is added to the metadata.labels field in OpenShift. Note that this field contains arbitrary key/value pairs and is unrelated to the concept of labels in Nodepool.

python-path

The path of the default python interpreter. Used by Zuul to set ansible_python_interpreter. The special value auto will direct Zuul to use inbuilt Ansible logic to select the interpreter on Ansible >=2.8, and default to /usr/bin/python2 for earlier versions.

shell-type

The shell type of the node's default shell executable. Used by Zuul to set ansible_shell_type. This setting should only be used

• For a windows image with the experimental connection-type ssh, in which case cmd or powershell should be set and reflect the node's DefaultShell configuration.
• If the default shell is not Bourne compatible (sh), but instead e.g. csh or fish, and the user is aware that there is a long-standing issue with ansible_shell_type in combination with become

cpu

Only used by the providers.[openshift].pools.labels.type.pod label type; specifies the number of cpu to request for the pod. If no limit is specified, this will also be used as the limit.

memory

Only used by the providers.[openshift].pools.labels.type.pod label type; specifies the amount of memory in MiB to request for the pod. If no limit is specified, this will also be used as the limit.

storage

Only used by the providers.[openshift].pools.labels.type.pod label type; specifies the amount of ephemeral-storage in MB to request for the pod. If no limit is specified, this will also be used as the limit.

cpu-limit

Only used by the providers.[openshift].pools.labels.type.pod label type; specifies the cpu limit for the pod.

memory-limit

Only used by the providers.[openshift].pools.labels.type.pod label type; specifies the memory limit in MiB for the pod.

storage-limit

Only used by the providers.[openshift].pools.labels.type.pod label type; specifies the ephemeral-storage limit in MB for the pod.

env

Only used by the providers.[openshift].pools.labels.type.pod label type; A list of environment variables to pass to the Pod.

name

The name of the environment variable passed to the Pod.

value

The value of the environment variable passed to the Pod.

node-selector

Only used by the providers.[openshift].pools.labels.type.pod label type; A map of key-value pairs to ensure the OpenShift scheduler places the Pod on a node with specific node labels.

scheduler-name

Only used by the providers.[openshift].pools.labels.type.pod label type. Sets the schedulerName field on the container. Normally left unset for the OpenShift default.

privileged

Only used by the providers.[openshift].pools.labels.type.pod label type. Sets the securityContext.privileged flag on the container. Normally left unset for the OpenShift default.

volumes

Only used by the providers.[openshift].pools.labels.type.pod label type. Sets the volumes field on the pod. If supplied, this should be a list of OpenShift Pod Volume definitions.

volume-mounts

Only used by the providers.[openshift].pools.labels.type.pod label type. Sets the volumeMounts flag on the container. If supplied, this should be a list of OpenShift Container VolumeMount definitions.