minikube/docs/configuring_kubernetes.md

44 lines
1.8 KiB
Markdown
Raw Normal View History

# Configuring Kubernetes
Minikube has a "configurator" feature that allows users to configure the Kubernetes components with arbitrary values.
To use this feature, you can use the `--extra-config` flag on the `minikube start` command.
This flag is repeated, so you can pass it several times with several different values to set multiple options.
2019-04-30 17:13:06 +00:00
## Selecting a Kubernetes version
2019-05-01 17:45:02 +00:00
minikube defaults to the latest stable version of Kubernetes. You may select a different Kubernetes release by using the `--kubernetes-version` flag, for example:
2019-04-30 17:13:06 +00:00
2019-04-30 17:13:43 +00:00
`minikube start --kubernetes-version=v1.10.13`
2019-05-01 17:44:39 +00:00
minikube follows the [Kubernetes Version and Version Skew Support Policy](https://kubernetes.io/docs/setup/version-skew-policy/), so we guarantee support for the latest build for the last 3 minor Kubernetes releases. When practical, minikube extends this policy two additional minor releases so that users can emulate legacy environments.
2019-05-01 17:43:11 +00:00
As of April 2019, this means that minikube supports and actively tests against the latest builds of:
2019-04-30 17:13:06 +00:00
* v1.14 (default)
* v1.13
* v1.12
* v1.11 (best effort)
* v1.10 (best effort)
For more up to date information, see `OldestKubernetesVersion` and `NewestKubernetesVersion` in [constants.go](https://github.com/kubernetes/minikube/blob/master/pkg/minikube/constants/constants.go)
## kubeadm
2017-10-17 22:34:42 +00:00
The kubeadm bootstrapper can be configured by the `--extra-config` flag on the `minikube start` command. It takes a string of the form `component.key=value` where `component` is one of the strings
2019-03-13 13:59:25 +00:00
* kubeadm
2017-10-17 22:34:42 +00:00
* kubelet
* apiserver
* controller-manager
* scheduler
and `key=value` is a flag=value pair for the component being configured. For example,
2018-02-12 11:42:03 +00:00
```shell
2017-10-17 22:34:42 +00:00
minikube start --extra-config=apiserver.v=10 --extra-config=kubelet.max-pods=100
2019-03-13 13:59:25 +00:00
minikube start --extra-config=kubeadm.ignore-preflight-errors=SystemVerification # allows any version of docker
2017-10-17 22:34:42 +00:00
```