You are viewing documentation for KubeSphere version:v3.0.0

KubeSphere v3.0.0 documentation is no longer actively maintained. The version you are currently viewing is a static snapshot. For up-to-date documentation, see the latest version.

Kubernetes Cluster Configurations

This tutorial explains how to customize Kubernetes cluster configurations in config-sample.yaml (needed for Multi-node Installation) when you use KubeKey to provision a cluster. You can refer to the following section to understand each parameter.

######################### Kubernetes #########################

kubernetes:
    version: v1.17.9 # The default k8s version is v1.17.9; you can specify 1.15.2, v1.16.13 or v1.18.6 based on your needs.
    imageRepo: kubesphere  # DockerHub Repo
    clusterName: cluster.local # Kubernetes Cluster Name
    masqueradeAll: false  # masqueradeAll tells kube-proxy to SNAT everything if using the pure iptables proxy mode. [Default: false]
    maxPods: 110  # maxPods is the number of pods that can run on this Kubelet. [Default: 110]
    nodeCidrMaskSize: 24  # Internal network node size allocation. This is the size allocated to each node in your network. [Default: 24]
    proxyMode: ipvs  # The mode specifies which proxy mode to use. [Default: ipvs]
  network:
    plugin: calico   # Calico by default. KubeSphere Network Policy is based on Calico. You can also specify Flannel based on your needs.
    calico:
      ipipMode: Always  # IPIP Mode to use for the IPv4 POOL created at start up. If it is set to a value other than Never, vxlanMode should be set to "Never". [Always | CrossSubnet | Never] [Default: Always]
      vxlanMode: Never  # VXLAN Mode to use for the IPv4 POOL created at start up. If it is set to a value other than Never, ipipMode should be set to "Never". [Always | CrossSubnet | Never] [Default: Never]
      vethMTU: 1440  # The maximum transmission unit (MTU) setting determines the largest packet size that can be transmitted through your network. [Default: 1440]
    kubePodsCIDR: 10.233.64.0/18    # A valid CIDR range for Kubernetes pod subnet. It should not overlap with node subnet, and it should not overlap with Kubernetes services subnet.
    kubeServiceCIDR: 10.233.0.0/18  # A valid CIDR range for Kubernetes services. It should not overlap with node subnet, and it should not overlap with Kubernetes pod subnet.
  registry:
    registryMirrors: []   # For users who need to speed up downloads.
    insecureRegistries: [] # Set an address of insecure image registry. See https://docs.docker.com/registry/insecure/
    privateRegistry: ""   # Configure a private image registry for air-gapped installation (for example, docker local registry or Harbor).
  addons: []  # You can specify any add-ons with one or more Helm Charts or YAML files in this field (for example, CSI plugins or cloud provider plugins).
What’s on this Page