diff --git a/site/content/docs/user/kind-example-config.yaml b/site/content/docs/user/kind-example-config.yaml index d74d4c8c6b..977fb9fd0e 100644 --- a/site/content/docs/user/kind-example-config.yaml +++ b/site/content/docs/user/kind-example-config.yaml @@ -1,30 +1,29 @@ # this config file contains all config fields with comments -kind: Config -apiVersion: kind.sigs.k8s.io/v1alpha2 +kind: Cluster +apiVersion: kind.sigs.k8s.io/v1alpha3 +# patch the generated kubeadm config with some extra settings +kubeadmConfigPatches: +- | + apiVersion: kubeadm.k8s.io/v1beta1 + kind: ClusterConfiguration + metadata: + name: config + networking: + serviceSubnet: 10.0.0.0/16 +# patch it further using a JSON 6902 patch +kubeadmConfigPatchesJson6902: +- group: kubeadm.k8s.io + version: v1beta1 + kind: ClusterConfiguration + patch: | + - op: add + path: /apiServer/certSANs/- + value: my-hostname # 1 control plane node and 3 workers nodes: # the control plane node config - role: control-plane - # patch the generated kubeadm config with some extra settings - kubeadmConfigPatches: - - | - apiVersion: kubeadm.k8s.io/v1beta1 - kind: ClusterConfiguration - metadata: - name: config - networking: - serviceSubnet: 10.0.0.0/16 - # patch it further using a JSON 6902 patch - kubeadmConfigPatchesJson6902: - - group: kubeadm.k8s.io - version: v1beta1 - kind: ClusterConfiguration - patch: | - - op: add - path: /apiServer/certSANs/- - value: my-hostname # the three workers - role: worker - # replicas specifes the number of nodes to create with this configuration - replicas: 3 - +- role: worker +- role: worker diff --git a/site/content/docs/user/quick-start.md b/site/content/docs/user/quick-start.md index a45a12558e..1950f8ee1c 100644 --- a/site/content/docs/user/quick-start.md +++ b/site/content/docs/user/quick-start.md @@ -202,12 +202,26 @@ In particular, many users may be interested in multi-node clusters. A simple configuration for this can be achieved with the following config file contents: ```yaml # three node (two workers) cluster config -kind: Config -apiVersion: kind.sigs.k8s.io/v1alpha2 +kind: Cluster +apiVersion: kind.sigs.k8s.io/v1alpha3 nodes: - role: control-plane - role: worker - replicas: 2 +- role: worker +``` + +You can also have a cluster with multiple control-plane nodes: +```yaml +# a cluster with 3 control-plane nodes and 3 workers +kind: Cluster +apiVersion: kind.sigs.k8s.io/v1alpha3 +nodes: +- role: control-plane +- role: control-plane +- role: control-plane +- role: worker +- role: worker +- role: worker ``` ### Exporting Cluster Logs diff --git a/site/data/apiVersions.yaml b/site/data/apiVersions.yaml index 5adf481bde..7cccc8d227 100644 --- a/site/data/apiVersions.yaml +++ b/site/data/apiVersions.yaml @@ -1,2 +1,3 @@ - v1alpha1 - v1alpha2 +- v1alpha3