Skip to main content

Container Options

Here's what the container registry configuration looks like, with the default values or [required] for property values that must be specified:

container:
registries:
- name: docker
blocked: false
insecure: false
location: docker.io
prefix: docker.io
username: null
password: null
searchRegistries: []
PropertyDescription
registries

Optionally specifies the prefixes for the default container registeries to be searched when pulling container images that don't identify a source registry. This defaults to Docker Hub (docker.io) but zero or more custom DNS hostnames or IP addresses may be specified.

PropertyDescription
name

string: Specifies the name to be used when persisting this as a V1ContainerRegistry to the cluster. This must be a valid Kubernetes name:

  • includes no more than 253 characters
  • includes only lowercase alphanumeric characters, '-' or '.'
  • starts with an alphanumeric character
  • ends with an alphanumeric character
blocked

bool: Optionally blocks pulls of images from registries that match prefix This defaults to false.

insecure

Optionally indicates that insecure HTTP requests may be used to access the registry. This defaults to false.

location

string: Optionally enables registry redirection. When specified, this indicates that images specified to be pulled from prefix will actually be pulled from locartion instead. This is a nice way to be able to reuse manifests and Helm charts such that they pull images from an alternate registry without modification. This defaults to null.

prefix

string: Specifies registry prefix, optionally with a subdomain "*" wildcard character for subdomain matching.

username

string: Optionally specifies the username to be used for authenticating with the upstream container registry. This defaults to null.

password

string: Optionally specifies the password to be used for authenticating with the upstream container registry. This defaults to null.

searchRegistries

array: Optionally specifies the prefixes for the default container registeries to be searched when pulling container images that don't identify a source registry. This defaults to Docker Hub (docker.io) but zero or more custom DNS hostnames or IP addresses may be specified.

NOTE: Container registries will be searched for containers in the order that registries appear in this list.