Openshift Pods Driver

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

providers.[openshiftpods]
Type: list

The Openshift Pods driver is similar to the Openshift driver, but it only supports pod label. This enables using an unprivileged service account that doesn’t require the self-provisioner role.

Example:

providers:
  - name: cluster
    driver: openshiftpods
    context: unprivileged-context-name
    pools:
      - name: main
        labels:
          - name: openshift-pod
            image: docker.io/fedora:28
providers.[openshiftpods].context (required)

Name of the context configured in kube/config.

Before using the driver, Nodepool services need a kube/config file manually installed. Make sure the context is present in oc config get-contexts command output.

providers.[openshiftpods].launch-retries
Default: 3

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

providers.[openshiftpods].max-pods
Default: infinite
Type: int

Maximum number of pods that can be used.

providers.[openshiftpods].pools
Type: list

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

providers.[openshiftpods].pools.name (required)

The project’s (namespace) name that will be used to create the pods.

providers.[openshiftpods].pools.priority
Default: 100
Type: int

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.

providers.[openshiftpods].pools.node-attributes
Type: dict

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.

providers.[openshiftpods].labels
Type: list

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

providers.[openshiftpods].labels.name (required)

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

providers.[openshiftpods].labels.image

The image name.

providers.[openshiftpods].labels.image-pull
Default: IfNotPresent
Type: str

The ImagePullPolicy, can be IfNotPresent, Always or Never.

providers.[openshiftpods].labels.image-pull-secrets
Default: []
Type: list

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

Example:

labels:
  - name: openshift-pod
    type: pod
    image: docker.io/fedora:28
    image-pull-secrets:
      - name: registry-secret
providers.[openshiftpods].labels.cpu
Type: int

The number of cpu to request for the pod.

providers.[openshiftpods].labels.memory
Type: int

The amount of memory in MB to request for the pod.

providers.[openshiftpods].labels.python-path
providers.[openshiftpods].labels.:type: str
providers.[openshiftpods].labels.:default: auto

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.

providers.[openshiftpods].labels.shell-type
Default: sh
Type: str

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 pod 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

providers.[openshiftpods].labels.env
Default: []
Type: list

A list of environment variables to pass to the Pod.

providers.[openshiftpods].labels.env.name (required)
Type: str

The name of the environment variable passed to the Pod.

providers.[openshiftpods].labels.env.value (required)
Type: str

The value of the environment variable passed to the Pod.

providers.[openshiftpods].labels.node-selector
Type: dict

A map of key-value pairs to ensure the OpenShift scheduler places the Pod on a node with specific node labels.