kubeadm-init: update notes related to the configuration (#9638)
- mention `kubeadm config migrate`. - don't inline control plane flag info, but rather link to the new dedicated page. - mention that kuberenetesVersion controls the version of the images.
This commit is contained in:
committed by
k8s-ci-robot
parent
b87603b556
commit
22e91df7c7
@@ -102,6 +102,9 @@ configuration file options. This file is passed in the `--config` option.
|
|||||||
|
|
||||||
In Kubernetes 1.11 and later, the default configuration can be printed out using the
|
In Kubernetes 1.11 and later, the default configuration can be printed out using the
|
||||||
[kubeadm config print-default](/docs/reference/setup-tools/kubeadm/kubeadm-config/) command.
|
[kubeadm config print-default](/docs/reference/setup-tools/kubeadm/kubeadm-config/) command.
|
||||||
|
It is **recommended** that you migrate your old `v1alpha1` configuration to `v1alpha2` using
|
||||||
|
the [kubeadm config migrate](/docs/reference/setup-tools/kubeadm/kubeadm-config/) command,
|
||||||
|
because `v1alpha1` will be removed in Kubernetes 1.12.
|
||||||
|
|
||||||
For more details on each field in the configuration you can navigate to our
|
For more details on each field in the configuration you can navigate to our
|
||||||
[API reference pages.] (https://godoc.org/k8s.io/kubernetes/cmd/kubeadm/app/apis/kubeadm#MasterConfiguration)
|
[API reference pages.] (https://godoc.org/k8s.io/kubernetes/cmd/kubeadm/app/apis/kubeadm#MasterConfiguration)
|
||||||
@@ -259,26 +262,10 @@ unifiedControlPlaneImage: ""
|
|||||||
For information about kube-proxy parameters in the MasterConfiguration see:
|
For information about kube-proxy parameters in the MasterConfiguration see:
|
||||||
- [kube-proxy](https://godoc.org/k8s.io/kubernetes/pkg/proxy/apis/kubeproxyconfig/v1alpha1#KubeProxyConfiguration)
|
- [kube-proxy](https://godoc.org/k8s.io/kubernetes/pkg/proxy/apis/kubeproxyconfig/v1alpha1#KubeProxyConfiguration)
|
||||||
|
|
||||||
### Passing custom arguments to control plane components {#custom-args}
|
### Passing custom flags to control plane components {#control-plane-flags}
|
||||||
|
|
||||||
If you would like to override or extend the behaviour of a control plane component, you can provide
|
For information about passing flags to control plane components see:
|
||||||
extra arguments to kubeadm. When the component is deployed, these additional arguments are added to
|
- [control-plane-flags](/docs/setup/independent/control-plane-flags/)
|
||||||
the Pod command itself.
|
|
||||||
|
|
||||||
For example, to add additional feature-gate arguments to the API server, your [configuration file](#config-file)
|
|
||||||
will need to look like this:
|
|
||||||
|
|
||||||
```
|
|
||||||
apiVersion: kubeadm.k8s.io/v1alpha2
|
|
||||||
kind: MasterConfiguration
|
|
||||||
apiServerExtraArgs:
|
|
||||||
feature-gates: APIResponseCompression=true
|
|
||||||
```
|
|
||||||
|
|
||||||
To customize the scheduler or controller-manager, use `schedulerExtraArgs` and `controllerManagerExtraArgs` respectively.
|
|
||||||
|
|
||||||
For more information on parameters for the controller-manager and scheduler, see:
|
|
||||||
- [high-availability](/docs/setup/independent/high-availability)
|
|
||||||
|
|
||||||
### Using custom images {#custom-images}
|
### Using custom images {#custom-images}
|
||||||
|
|
||||||
@@ -294,6 +281,8 @@ Allowed customization are:
|
|||||||
* To provide a `unifiedControlPlaneImage` to be used instead of different images for control plane components.
|
* To provide a `unifiedControlPlaneImage` to be used instead of different images for control plane components.
|
||||||
* To provide a specific `etcd.image` to be used instead of the image available at`k8s.gcr.io`.
|
* To provide a specific `etcd.image` to be used instead of the image available at`k8s.gcr.io`.
|
||||||
|
|
||||||
|
Please note that the configuration field `kubernetesVersion` or the command line flag
|
||||||
|
`--kubernetes-version` affect the version of the images.
|
||||||
|
|
||||||
### Using custom certificates {#custom-certificates}
|
### Using custom certificates {#custom-certificates}
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user