Skip to main content
Version: v0.38 Stable

networking

The networking key configures service replication, DNS resolution, and other networking options. For how to configure it, see Networking.

networking object ​

Networking options related to the virtual cluster.

serviceCIDR string ​

ServiceCIDR holds the service cidr for the virtual cluster. This should only be set if privateNodes.enabled is true or vCluster cannot detect the host service cidr.

podCIDR string 10.244.0.0/16 ​

PodCIDR holds the pod cidr for the virtual cluster. This should only be set if privateNodes.enabled is true.

replicateServices object ​

ReplicateServices allows replicating services from the host within the virtual cluster or the other way around.

toHost object[] ​

ToHost defines the services that should get synced from virtual cluster to the host cluster. If services are synced to a different namespace than the virtual cluster is in, additional permissions for the other namespace are required.

from string ​

From is the service that should get synced. Can be either in the form name or namespace/name.

to string ​

To is the target service that it should get synced to. Can be either in the form name or namespace/name.

fromHost object[] ​

FromHost defines the services that should get synced from the host to the virtual cluster.

from string ​

From is the service that should get synced. Can be either in the form name or namespace/name.

to string ​

To is the target service that it should get synced to. Can be either in the form name or namespace/name.

resolveDNS object[] ​

ResolveDNS allows to define extra DNS rules. This only works if embedded coredns is configured.

hostname string ​

Hostname is the hostname within the vCluster that should be resolved from.

service string ​

Service is the virtual cluster service that should be resolved from.

namespace string ​

Namespace is the virtual cluster namespace that should be resolved from.

target object ​

Target is the DNS target that should get mapped to

hostname string ​

Hostname to use as a DNS target

ip string ​

IP to use as a DNS target

hostService string ​

HostService to target, format is hostNamespace/hostService

hostNamespace string ​

HostNamespace to target

vClusterService string ​

VClusterService format is hostNamespace/vClusterName/vClusterNamespace/vClusterService

advanced object ​

Advanced holds advanced network options.

clusterDomain string cluster.local ​

ClusterDomain is the Kubernetes cluster domain to use within the virtual cluster.

fallbackHostCluster boolean false ​

FallbackHostCluster allows to fallback dns to the host cluster. This is useful if you want to reach host services without any other modification. You will need to provide a namespace for the service, e.g. my-other-service.my-other-namespace

proxyKubelets object ​

ProxyKubelets allows rewriting certain metrics and stats from the Kubelet to "fake" this for applications such as prometheus or other node exporters.

byHostname boolean true ​

ByHostname will add a special vCluster hostname to the nodes where the node can be reached at. This doesn't work for all applications, e.g. Prometheus requires a node IP.

byIP boolean true ​

ByIP will create a separate service in the host cluster for every node that will point to virtual cluster and will be used to route traffic.