Override the Alpine sidecar image

vCluster uses an Alpine sidecar container to manage host entries in the virtual cluster's /etc/hosts file. By default, it pulls the Alpine image from DockerHub.

Configure your own image

vCluster 0.20 and later

In your vcluster.yaml configuration, add the following:

sync:
  toHost:
    pods:
      rewriteHosts:
        initContainer:
          image: "your-alpine-or-similar-img"

vCluster 0.19 and earlier

Add the following to your vcluster.yaml:

syncer:
  extraArgs:
    - '--override-hosts-container-image="your-alpine-or-similar-img"'        

Add image pull secrets

For private registry images that require authentication add the following.

Ensure you replace secret-name-in-vcluster-ns with your actual secret name in the vCluster namespace.

vCluster 0.20 and later

controlPlane:
  advanced:
    workloadServiceAccount:
      imagePullSecrets:
        name: secret-name-in-vcluster-ns

vCluster 0.19 and earlier

serviceAccount:
  imagePullSecrets:
    - name: secret-name-in-vcluster-ns