Page last modified on November 15, 2018 at 2:05 PM PST by Initial commit (Page history)
Beginning with v1.8.0, kubeadm uploads the configuration of your cluster to a ConfigMap called
kubeadm-config in the kube-system namespace, and later reads the ConfigMap when upgrading.
This enables correct configuration of system components, and provides a seamless user experience.
You can execute kubeadm config view to view the ConfigMap. If you initialized your cluster using
kubeadm v1.7.x or lower, you must use kubeadm config upload to create the ConfigMap before you
may use kubeadm upgrade.
In Kubernetes v1.11.0, some new commands were added. You can use kubeadm config print-default
to print the default configuration and kubeadm config migrate to convert your old configuration
files to a newer version. kubeadm config images list and kubeadm config images pull can be used
to list and pull the images that kubeadm requires.
Upload a configuration file to the in-cluster ConfigMap for kubeadm configuration.
Using this command, you can upload configuration to the ConfigMap in the cluster using the same config file you gave to ‘kubeadm init’. If you initialized your cluster using a v1.7.x or lower kubeadm client and used the –config option, you need to run this command with the same config file before upgrading to v1.8 using ‘kubeadm upgrade’.
The configuration is located in the “kube-system” namespace in the “kubeadm-config” ConfigMap.
kubeadm config upload from-file [flags]
| --config string | |
| Path to a kubeadm config file. WARNING: Usage of a configuration file is experimental. | |
| -h, --help | |
| help for from-file | |
| --kubeconfig string Default: "/etc/kubernetes/admin.conf" | |
| The KubeConfig file to use when talking to the cluster. | |
Create the in-cluster configuration file for the first time from using flags.
Using this command, you can upload configuration to the ConfigMap in the cluster using the same flags you gave to ‘kubeadm init’. If you initialized your cluster using a v1.7.x or lower kubeadm client and set certain flags, you need to run this command with the same flags before upgrading to v1.8 using ‘kubeadm upgrade’.
The configuration is located in the “kube-system” namespace in the “kubeadm-config” ConfigMap.
kubeadm config upload from-flags [flags]
| --apiserver-advertise-address string | |
| The IP address the API Server will advertise it's listening on. Specify '0.0.0.0' to use the address of the default network interface. | |
| --apiserver-bind-port int32 Default: 6443 | |
| Port for the API Server to bind to. | |
| --apiserver-cert-extra-sans stringSlice | |
| Optional extra Subject Alternative Names (SANs) to use for the API Server serving certificate. Can be both IP addresses and DNS names. | |
| --cert-dir string Default: "/etc/kubernetes/pki" | |
| The path where to save and store the certificates. | |
| --cri-socket string Default: "/var/run/dockershim.sock" | |
| Specify the CRI socket to connect to. | |
| --feature-gates string | |
| A set of key=value pairs that describe feature gates for various features. Options are: Auditing=true|false (ALPHA - default=false) CoreDNS=true|false (default=true) DynamicKubeletConfig=true|false (ALPHA - default=false) SelfHosting=true|false (ALPHA - default=false) StoreCertsInSecrets=true|false (ALPHA - default=false) |
|
| -h, --help | |
| help for from-flags | |
| --kubernetes-version string Default: "stable-1.10" | |
| Choose a specific Kubernetes version for the control plane. | |
| --node-name string | |
| Specify the node name. | |
| --pod-network-cidr string | |
| Specify range of IP addresses for the pod network. If set, the control plane will automatically allocate CIDRs for every node. | |
| --service-cidr string Default: "10.96.0.0/12" | |
| Use alternative range of IP address for service VIPs. | |
| --service-dns-domain string Default: "cluster.local" | |
| Use alternative domain for services, e.g. "myorg.internal". | |
| --kubeconfig string Default: "/etc/kubernetes/admin.conf" | |
| The KubeConfig file to use when talking to the cluster. | |
View the kubeadm configuration stored inside the cluster.
Using this command, you can view the ConfigMap in the cluster where the configuration for kubeadm is located.
The configuration is located in the “kube-system” namespace in the “kubeadm-config” ConfigMap.
kubeadm config view [flags]
| -h, --help | |
| help for view | |
| --kubeconfig string Default: "/etc/kubernetes/admin.conf" | |
| The KubeConfig file to use when talking to the cluster. | |
Print the default values for a kubeadm configuration object.
This command prints the default MasterConfiguration object that is used for ‘kubeadm init’ and ‘kubeadm upgrade’, and the default NodeConfiguration object that is used for ‘kubeadm join’.
Note that sensitive values like the Bootstrap Token fields are replaced with silly values like {“abcdef.0123456789abcdef” “” “nil”
kubeadm config print-default [flags]
| --api-objects stringSlice | |
| A comma-separated list for API objects to print the default values for. Available values: [MasterConfiguration NodeConfiguration]. This flag unset means 'print all known objects' | |
| -h, --help | |
| help for print-default | |
| --kubeconfig string Default: "/etc/kubernetes/admin.conf" | |
| The KubeConfig file to use when talking to the cluster. | |
Read an older version of the kubeadm configuration API types from a file, and output the similar config object for the newer version.
This command lets you convert configuration objects of older versions to the latest supported version, locally in the CLI tool without ever touching anything in the cluster. In this version of kubeadm, the following API versions are supported: - kubeadm.k8s.io/v1alpha2 - kubeadm.k8s.io/v1alpha1
Further, kubeadm can only write out config of version “kubeadm.k8s.io/v1alpha2”, but read both types. So regardless of what version you pass to the –old-config parameter here, the API object will be read, deserialized, defaulted, converted, validated, and re-serialized when written to stdout or –new-config if specified.
In other words, the output of this command is what kubeadm actually would read internally if you submitted this file to “kubeadm init”
kubeadm config migrate [flags]
| -h, --help | |
| help for migrate | |
| --new-config string | |
| Path to the resulting equivalent kubeadm config file using the new API version. Optional, if not specified output will be sent to STDOUT. | |
| --old-config string | |
| Path to the kubeadm config file that is using an old API version and should be converted. This flag is mandatory. | |
| --kubeconfig string Default: "/etc/kubernetes/admin.conf" | |
| The KubeConfig file to use when talking to the cluster. | |
Print a list of images kubeadm will use. The configuration file is used in case any images or image repositories are customized.
Print a list of images kubeadm will use. The configuration file is used in case any images or image repositories are customized.
kubeadm config images list [flags]
| --config string | |
| Path to kubeadm config file. | |
| --feature-gates string | |
| A set of key=value pairs that describe feature gates for various features. Options are: Auditing=true|false (ALPHA - default=false) CoreDNS=true|false (default=true) DynamicKubeletConfig=true|false (ALPHA - default=false) SelfHosting=true|false (ALPHA - default=false) StoreCertsInSecrets=true|false (ALPHA - default=false) |
|
| -h, --help | |
| help for list | |
| --kubernetes-version string Default: "stable-1.10" | |
| Choose a specific Kubernetes version for the control plane. | |
| --kubeconfig string Default: "/etc/kubernetes/admin.conf" | |
| The KubeConfig file to use when talking to the cluster. | |
Pull images used by kubeadm.
Pull images used by kubeadm.
kubeadm config images pull [flags]
| --config string | |
| Path to kubeadm config file. | |
| --cri-socket-path string Default: "/var/run/dockershim.sock" | |
| Path to the CRI socket. | |
| --feature-gates string | |
| A set of key=value pairs that describe feature gates for various features. Options are: Auditing=true|false (ALPHA - default=false) CoreDNS=true|false (default=true) DynamicKubeletConfig=true|false (ALPHA - default=false) SelfHosting=true|false (ALPHA - default=false) StoreCertsInSecrets=true|false (ALPHA - default=false) |
|
| -h, --help | |
| help for pull | |
| --kubernetes-version string Default: "stable-1.10" | |
| Choose a specific Kubernetes version for the control plane. | |
| --kubeconfig string Default: "/etc/kubernetes/admin.conf" | |
| The KubeConfig file to use when talking to the cluster. | |