From ea6cc89fb41b8b24ad9d66765e1fa0388b0af1b0 Mon Sep 17 00:00:00 2001 From: "Lubomir I. Ivanov" Date: Sun, 2 Dec 2018 03:33:18 +0200 Subject: [PATCH] kubeadm: update the reference docs for 1.13 (#10960) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * docs update to promote TaintBasedEvictions to beta (#10765) * First Korean l10n work for dev-1.13 (#10719) * Update outdated l10n(ko) contents (#10689) fixes #10686 * Translate concepts/overview/what-is-kubernetes in Korean (#10690) * Translate concepts/overview/what-is-kubernetes in Korean * Feedback from ClaudiaJKang * Translate concepts/overview/components in Korean (#10882) * Translate concepts/overview/components in Korean #10717 * Translate concepts/overview/components in Korean * Translate concepts/overview/components in Korean * Apply Korean glossary: 서비스 어카운트 * Translate concepts/overview/kubernetes-api in Korean (#10773) * Translate concepts/overview/kubernetes-api in Korean * Applied feedback from ianychoi * kubeadm: update the configuration docs to v1beta1 (#10959) * kubeadm: add small v1beta1 related updates (#10988) * update new feature gates to document (#11295) * Update dry run feature to beta (#11140) * kubeadm: add improvements to HA docs (#11094) * kubeadm: add information and diagrams for HA topologies * kubeadm: update HA doc with simplified steps * kubeadm: update HA doc with simplified steps * edit ha, add new topology topic, reorder by weight * troubleshoot markdown * fix more markdown, fix links * more markdown * more markdown * more markdown * changes after reviewer comments * add steps about Weave * update note about stacked topology * kubeadm: update reference docs - add section about working with phases under kubeadm-init.md - update GA / beta status of features - kubeadm alpha phase was moved to kubeadm init phase - new commands were added under kubeadm alpha - included new CoreDNS usage examples * Generate components and tools reference --- .../cloud-controller-manager.md | 74 +++++- .../feature-gates.md | 2 +- .../federation-apiserver.md | 11 +- .../federation-controller-manager.md | 9 +- .../kube-apiserver.md | 134 +++++++++-- .../kube-controller-manager.md | 83 ++++++- .../kube-proxy.md | 2 +- .../kube-scheduler.md | 219 +++++++++++++++++- content/en/docs/reference/kubectl/kubectl.md | 121 ++++++---- .../setup-tools/kubeadm/generated/kubeadm.md | 17 +- .../kubeadm/generated/kubeadm_alpha.md | 4 +- .../kubeadm/generated/kubeadm_alpha_certs.md | 50 ++++ ..._renew.md => kubeadm_alpha_certs_renew.md} | 2 +- ...ll.md => kubeadm_alpha_certs_renew_all.md} | 20 +- ...lpha_certs_renew_apiserver-etcd-client.md} | 20 +- ...a_certs_renew_apiserver-kubelet-client.md} | 20 +- ...=> kubeadm_alpha_certs_renew_apiserver.md} | 24 +- ...ha_certs_renew_etcd-healthcheck-client.md} | 20 +- ...=> kubeadm_alpha_certs_renew_etcd-peer.md} | 20 +- ... kubeadm_alpha_certs_renew_etcd-server.md} | 20 +- ...m_alpha_certs_renew_front-proxy-client.md} | 20 +- .../generated/kubeadm_alpha_kubeconfig.md | 52 +++++ ...er.md => kubeadm_alpha_kubeconfig_user.md} | 13 +- ...se_kubelet.md => kubeadm_alpha_kubelet.md} | 2 +- ...fig.md => kubeadm_alpha_kubelet_config.md} | 2 +- ... kubeadm_alpha_kubelet_config_download.md} | 4 +- ...dm_alpha_kubelet_config_enable-dynamic.md} | 4 +- ...kubeadm_alpha_phase_bootstrap-token_all.md | 122 ---------- ...lpha_phase_bootstrap-token_cluster-info.md | 65 ------ ...eadm_alpha_phase_bootstrap-token_create.md | 114 --------- ...bootstrap-token_node_allow-auto-approve.md | 65 ------ ...se_bootstrap-token_node_allow-post-csrs.md | 65 ------ .../kubeadm_alpha_phase_certs_all.md | 111 --------- .../kubeadm_alpha_phase_kubeconfig_all.md | 109 --------- ...lpha_phase_kubelet_config_write-to-disk.md | 70 ------ ...eadm_alpha_phase_kubelet_write-env-file.md | 73 ------ .../kubeadm_alpha_phase_preflight.md | 64 ----- ...ase_etcd.md => kubeadm_alpha_preflight.md} | 4 +- ...ode.md => kubeadm_alpha_preflight_node.md} | 32 +-- ...osting.md => kubeadm_alpha_selfhosting.md} | 0 ....md => kubeadm_alpha_selfhosting_pivot.md} | 23 +- .../kubeadm/generated/kubeadm_config.md | 2 +- .../generated/kubeadm_config_images.md | 2 +- .../generated/kubeadm_config_images_list.md | 4 +- .../generated/kubeadm_config_images_pull.md | 4 +- .../generated/kubeadm_config_migrate.md | 6 +- ...-token_node.md => kubeadm_config_print.md} | 12 +- ... => kubeadm_config_print_init-defaults.md} | 17 +- ... => kubeadm_config_print_join-defaults.md} | 36 ++- .../generated/kubeadm_config_upload.md | 2 +- .../kubeadm_config_upload_from-file.md | 2 +- .../kubeadm_config_upload_from-flags.md | 4 +- .../kubeadm/generated/kubeadm_config_view.md | 2 +- .../kubeadm/generated/kubeadm_init.md | 54 ++++- .../kubeadm/generated/kubeadm_init_phase.md | 50 ++++ ...e_addon.md => kubeadm_init_phase_addon.md} | 4 + ...all.md => kubeadm_init_phase_addon_all.md} | 35 +-- ...md => kubeadm_init_phase_addon_coredns.md} | 18 +- ...=> kubeadm_init_phase_addon_kube-proxy.md} | 18 +- .../kubeadm_init_phase_bootstrap-token.md | 85 +++++++ ...e_certs.md => kubeadm_init_phase_certs.md} | 6 +- .../generated/kubeadm_init_phase_certs_all.md | 96 ++++++++ ...init_phase_certs_apiserver-etcd-client.md} | 20 +- ...t_phase_certs_apiserver-kubelet-client.md} | 20 +- ... => kubeadm_init_phase_certs_apiserver.md} | 32 ++- ...s_ca.md => kubeadm_init_phase_certs_ca.md} | 10 +- ...md => kubeadm_init_phase_certs_etcd-ca.md} | 6 +- ...it_phase_certs_etcd-healthcheck-client.md} | 20 +- ... => kubeadm_init_phase_certs_etcd-peer.md} | 20 +- ...> kubeadm_init_phase_certs_etcd-server.md} | 22 +- ...ubeadm_init_phase_certs_front-proxy-ca.md} | 6 +- ...dm_init_phase_certs_front-proxy-client.md} | 20 +- ...s_sa.md => kubeadm_init_phase_certs_sa.md} | 16 +- ...md => kubeadm_init_phase_control-plane.md} | 6 +- ...> kubeadm_init_phase_control-plane_all.md} | 42 ++-- ...adm_init_phase_control-plane_apiserver.md} | 29 ++- ...phase_control-plane_controller-manager.md} | 23 +- ...adm_init_phase_control-plane_scheduler.md} | 21 +- .../generated/kubeadm_init_phase_etcd.md | 54 +++++ ...al.md => kubeadm_init_phase_etcd_local.md} | 28 ++- ...ig.md => kubeadm_init_phase_kubeconfig.md} | 4 + ...=> kubeadm_init_phase_kubeconfig_admin.md} | 16 +- .../kubeadm_init_phase_kubeconfig_all.md | 96 ++++++++ ...it_phase_kubeconfig_controller-manager.md} | 16 +- ... kubeadm_init_phase_kubeconfig_kubelet.md} | 22 +- ...ubeadm_init_phase_kubeconfig_scheduler.md} | 16 +- ...md => kubeadm_init_phase_kubelet-start.md} | 27 +-- .../kubeadm_init_phase_mark-control-plane.md | 78 +++++++ ...ter.md => kubeadm_init_phase_preflight.md} | 40 ++-- ...md => kubeadm_init_phase_upload-config.md} | 8 +- ...> kubeadm_init_phase_upload-config_all.md} | 19 +- ...beadm_init_phase_upload-config_kubeadm.md} | 17 +- ...beadm_init_phase_upload-config_kubelet.md} | 16 +- .../kubeadm/generated/kubeadm_join.md | 22 +- .../kubeadm/generated/kubeadm_reset.md | 7 + .../kubeadm/generated/kubeadm_token.md | 2 +- .../kubeadm/generated/kubeadm_token_create.md | 2 +- .../kubeadm/generated/kubeadm_token_delete.md | 2 +- .../generated/kubeadm_token_generate.md | 2 +- .../kubeadm/generated/kubeadm_token_list.md | 2 +- .../generated/kubeadm_upgrade_apply.md | 8 +- .../kubeadm/generated/kubeadm_upgrade_diff.md | 2 +- .../generated/kubeadm_upgrade_node_config.md | 6 +- ...upgrade_node_experimental-control-plane.md | 13 +- .../kubeadm/generated/kubeadm_upgrade_plan.md | 8 +- .../kubeadm/implementation-details.md | 56 ++--- .../setup-tools/kubeadm/kubeadm-alpha.md | 162 +++---------- .../setup-tools/kubeadm/kubeadm-config.md | 11 +- .../setup-tools/kubeadm/kubeadm-init-phase.md | 155 +++++++++++++ .../setup-tools/kubeadm/kubeadm-init.md | 88 +++---- .../setup-tools/kubeadm/kubeadm-join.md | 2 +- .../setup-tools/kubeadm/kubeadm-reset.md | 2 +- .../setup-tools/kubeadm/kubeadm-token.md | 2 +- .../setup-tools/kubeadm/kubeadm-upgrade.md | 3 + .../reference/setup-tools/kubeadm/kubeadm.md | 2 +- .../reference/setup-tools/kubefed/kubefed.md | 4 +- .../setup-tools/kubefed/kubefed_init.md | 4 +- .../setup-tools/kubefed/kubefed_join.md | 4 +- .../setup-tools/kubefed/kubefed_options.md | 4 +- .../setup-tools/kubefed/kubefed_unjoin.md | 4 +- .../setup-tools/kubefed/kubefed_version.md | 4 +- .../setup/independent/control-plane-flags.md | 13 +- .../independent/create-cluster-kubeadm.md | 28 +-- .../setup/independent/high-availability.md | 8 +- .../independent/setup-ha-etcd-with-kubeadm.md | 36 +-- .../docs/tasks/administer-cluster/coredns.md | 8 +- .../docs/concepts/overview/kubernetes-api.md | 1 + update-imported-docs/reference.yml | 2 +- update-imported-docs/release.yml | 2 +- 129 files changed, 2145 insertions(+), 1651 deletions(-) create mode 100644 content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_certs.md rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_certs_renew.md => kubeadm_alpha_certs_renew.md} (95%) rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_certs_renew_all.md => kubeadm_alpha_certs_renew_all.md} (77%) rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_certs_renew_apiserver-etcd-client.md => kubeadm_alpha_certs_renew_apiserver-etcd-client.md} (78%) rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_certs_renew_apiserver-kubelet-client.md => kubeadm_alpha_certs_renew_apiserver-kubelet-client.md} (78%) rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_certs_renew_apiserver.md => kubeadm_alpha_certs_renew_apiserver.md} (73%) rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_certs_renew_etcd-healthcheck-client.md => kubeadm_alpha_certs_renew_etcd-healthcheck-client.md} (78%) rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_certs_renew_etcd-peer.md => kubeadm_alpha_certs_renew_etcd-peer.md} (78%) rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_certs_renew_etcd-server.md => kubeadm_alpha_certs_renew_etcd-server.md} (78%) rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_certs_renew_front-proxy-client.md => kubeadm_alpha_certs_renew_front-proxy-client.md} (78%) create mode 100644 content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_kubeconfig.md rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_kubeconfig_user.md => kubeadm_alpha_kubeconfig_user.md} (85%) rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_kubelet.md => kubeadm_alpha_kubelet.md} (95%) rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_kubelet_config.md => kubeadm_alpha_kubelet_config.md} (96%) rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_kubelet_config_download.md => kubeadm_alpha_kubelet_config_download.md} (95%) rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_kubelet_config_enable-dynamic.md => kubeadm_alpha_kubelet_config_enable-dynamic.md} (95%) delete mode 100644 content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_bootstrap-token_all.md delete mode 100644 content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_bootstrap-token_cluster-info.md delete mode 100644 content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_bootstrap-token_create.md delete mode 100644 content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_bootstrap-token_node_allow-auto-approve.md delete mode 100644 content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_bootstrap-token_node_allow-post-csrs.md delete mode 100644 content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_all.md delete mode 100644 content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubeconfig_all.md delete mode 100644 content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubelet_config_write-to-disk.md delete mode 100644 content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubelet_write-env-file.md delete mode 100644 content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_preflight.md rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_etcd.md => kubeadm_alpha_preflight.md} (92%) rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_preflight_node.md => kubeadm_alpha_preflight_node.md} (89%) rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_selfhosting.md => kubeadm_alpha_selfhosting.md} (100%) rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_selfhosting_convert-from-staticpods.md => kubeadm_alpha_selfhosting_pivot.md} (76%) rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_bootstrap-token_node.md => kubeadm_config_print.md} (83%) rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_config_print-default.md => kubeadm_config_print_init-defaults.md} (61%) rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_upload-config.md => kubeadm_config_print_join-defaults.md} (59%) create mode 100644 content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase.md rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_addon.md => kubeadm_init_phase_addon.md} (95%) rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_addon_all.md => kubeadm_init_phase_addon_all.md} (70%) rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_addon_coredns.md => kubeadm_init_phase_addon_coredns.md} (80%) rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_addon_kube-proxy.md => kubeadm_init_phase_addon_kube-proxy.md} (77%) create mode 100644 content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_bootstrap-token.md rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_certs.md => kubeadm_init_phase_certs.md} (93%) create mode 100644 content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_certs_all.md rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_certs_apiserver-etcd-client.md => kubeadm_init_phase_certs_apiserver-etcd-client.md} (71%) rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_certs_apiserver-kubelet-client.md => kubeadm_init_phase_certs_apiserver-kubelet-client.md} (71%) rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_certs_apiserver.md => kubeadm_init_phase_certs_apiserver.md} (66%) rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_certs_ca.md => kubeadm_init_phase_certs_ca.md} (76%) rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_certs_etcd-ca.md => kubeadm_init_phase_certs_etcd-ca.md} (88%) rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_certs_etcd-healthcheck-client.md => kubeadm_init_phase_certs_etcd-healthcheck-client.md} (71%) rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_certs_etcd-peer.md => kubeadm_init_phase_certs_etcd-peer.md} (72%) rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_certs_etcd-server.md => kubeadm_init_phase_certs_etcd-server.md} (69%) rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_certs_front-proxy-ca.md => kubeadm_init_phase_certs_front-proxy-ca.md} (88%) rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_certs_front-proxy-client.md => kubeadm_init_phase_certs_front-proxy-client.md} (70%) rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_certs_sa.md => kubeadm_init_phase_certs_sa.md} (68%) rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_controlplane.md => kubeadm_init_phase_control-plane.md} (91%) rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_controlplane_all.md => kubeadm_init_phase_control-plane_all.md} (73%) rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_controlplane_apiserver.md => kubeadm_init_phase_control-plane_apiserver.md} (74%) rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_controlplane_controller-manager.md => kubeadm_init_phase_control-plane_controller-manager.md} (71%) rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_controlplane_scheduler.md => kubeadm_init_phase_control-plane_scheduler.md} (74%) create mode 100644 content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_etcd.md rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_etcd_local.md => kubeadm_init_phase_etcd_local.md} (67%) rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_kubeconfig.md => kubeadm_init_phase_kubeconfig.md} (95%) rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_kubeconfig_admin.md => kubeadm_init_phase_kubeconfig_admin.md} (82%) create mode 100644 content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_kubeconfig_all.md rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_kubeconfig_controller-manager.md => kubeadm_init_phase_kubeconfig_controller-manager.md} (81%) rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_kubeconfig_kubelet.md => kubeadm_init_phase_kubeconfig_kubelet.md} (73%) rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_kubeconfig_scheduler.md => kubeadm_init_phase_kubeconfig_scheduler.md} (82%) rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_mark-master.md => kubeadm_init_phase_kubelet-start.md} (58%) create mode 100644 content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_mark-control-plane.md rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_preflight_master.md => kubeadm_init_phase_preflight.md} (81%) rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase.md => kubeadm_init_phase_upload-config.md} (85%) rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_bootstrap-token.md => kubeadm_init_phase_upload-config_all.md} (70%) rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_kubelet_config_annotate-cri.md => kubeadm_init_phase_upload-config_kubeadm.md} (66%) rename content/en/docs/reference/setup-tools/kubeadm/generated/{kubeadm_alpha_phase_kubelet_config_upload.md => kubeadm_init_phase_upload-config_kubelet.md} (76%) create mode 100644 content/en/docs/reference/setup-tools/kubeadm/kubeadm-init-phase.md diff --git a/content/en/docs/reference/command-line-tools-reference/cloud-controller-manager.md b/content/en/docs/reference/command-line-tools-reference/cloud-controller-manager.md index 69f6e8b40a3f7..cf9efcbaa5267 100644 --- a/content/en/docs/reference/command-line-tools-reference/cloud-controller-manager.md +++ b/content/en/docs/reference/command-line-tools-reference/cloud-controller-manager.md @@ -32,6 +32,13 @@ cloud-controller-manager [flags] Should CIDRs for Pods be allocated and set on the cloud provider. + + --alsologtostderr + + + log to standard error as well as files + + --authentication-kubeconfig string @@ -96,7 +103,7 @@ cloud-controller-manager [flags] - --cert-dir string     Default: "/var/run/kubernetes" + --cert-dir string The directory where the TLS certs are located. If --tls-cert-file and --tls-private-key-file are provided, this flag will be ignored. @@ -130,6 +137,13 @@ cloud-controller-manager [flags] The provider for cloud services. Empty string for no provider. + + --cloud-provider-gce-lb-src-cidrs cidrs     Default: 130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16 + + + CIDRs opened in GCE firewall for LB traffic proxy & health checks + + --cluster-cidr string @@ -183,7 +197,7 @@ cloud-controller-manager [flags] --feature-gates mapStringBool - A set of key=value pairs that describe feature gates for alpha/experimental features. Options are:
APIListChunking=true|false (BETA - default=true)
APIResponseCompression=true|false (ALPHA - default=false)
AllAlpha=true|false (ALPHA - default=false)
AppArmor=true|false (BETA - default=true)
AttachVolumeLimit=true|false (BETA - default=false)
BalanceAttachedNodeVolumes=true|false (ALPHA - default=false)
BlockVolume=true|false (ALPHA - default=false)
CPUManager=true|false (BETA - default=true)
CRIContainerLogRotation=true|false (BETA - default=true)
CSIBlockVolume=true|false (ALPHA - default=false)
CSIDriverRegistry=true|false (ALPHA - default=false)
CSINodeInfo=true|false (ALPHA - default=false)
CSIPersistentVolume=true|false (BETA - default=true)
CustomCPUCFSQuotaPeriod=true|false (ALPHA - default=false)
CustomPodDNS=true|false (BETA - default=true)
CustomResourceSubresources=true|false (BETA - default=true)
CustomResourceValidation=true|false (BETA - default=true)
DebugContainers=true|false (ALPHA - default=false)
DevicePlugins=true|false (BETA - default=true)
DryRun=true|false (ALPHA - default=false)
DynamicKubeletConfig=true|false (BETA - default=true)
EnableEquivalenceClassCache=true|false (ALPHA - default=false)
ExpandInUsePersistentVolumes=true|false (ALPHA - default=false)
ExpandPersistentVolumes=true|false (BETA - default=true)
ExperimentalCriticalPodAnnotation=true|false (ALPHA - default=false)
ExperimentalHostUserNamespaceDefaulting=true|false (BETA - default=false)
GCERegionalPersistentDisk=true|false (BETA - default=true)
HugePages=true|false (BETA - default=true)
HyperVContainer=true|false (ALPHA - default=false)
Initializers=true|false (ALPHA - default=false)
KubeletPluginsWatcher=true|false (BETA - default=true)
LocalStorageCapacityIsolation=true|false (BETA - default=true)
MountContainers=true|false (ALPHA - default=false)
NodeLease=true|false (ALPHA - default=false)
PersistentLocalVolumes=true|false (BETA - default=true)
PodPriority=true|false (BETA - default=true)
PodReadinessGates=true|false (BETA - default=true)
PodShareProcessNamespace=true|false (BETA - default=true)
ProcMountType=true|false (ALPHA - default=false)
QOSReserved=true|false (ALPHA - default=false)
ResourceLimitsPriorityFunction=true|false (ALPHA - default=false)
ResourceQuotaScopeSelectors=true|false (BETA - default=true)
RotateKubeletClientCertificate=true|false (BETA - default=true)
RotateKubeletServerCertificate=true|false (BETA - default=true)
RunAsGroup=true|false (ALPHA - default=false)
RuntimeClass=true|false (ALPHA - default=false)
SCTPSupport=true|false (ALPHA - default=false)
ScheduleDaemonSetPods=true|false (BETA - default=true)
ServiceNodeExclusion=true|false (ALPHA - default=false)
StreamingProxyRedirects=true|false (BETA - default=true)
SupportPodPidsLimit=true|false (ALPHA - default=false)
Sysctls=true|false (BETA - default=true)
TTLAfterFinished=true|false (ALPHA - default=false)
TaintBasedEvictions=true|false (BETA - default=true)
TaintNodesByCondition=true|false (BETA - default=true)
TokenRequest=true|false (BETA - default=true)
TokenRequestProjection=true|false (BETA - default=true)
VolumeScheduling=true|false (BETA - default=true)
VolumeSnapshotDataSource=true|false (ALPHA - default=false)
VolumeSubpathEnvExpansion=true|false (ALPHA - default=false) + A set of key=value pairs that describe feature gates for alpha/experimental features. Options are:
APIListChunking=true|false (BETA - default=true)
APIResponseCompression=true|false (ALPHA - default=false)
AllAlpha=true|false (ALPHA - default=false)
AppArmor=true|false (BETA - default=true)
AttachVolumeLimit=true|false (BETA - default=true)
BalanceAttachedNodeVolumes=true|false (ALPHA - default=false)
BlockVolume=true|false (BETA - default=true)
BoundServiceAccountTokenVolume=true|false (ALPHA - default=false)
CPUManager=true|false (BETA - default=true)
CRIContainerLogRotation=true|false (BETA - default=true)
CSIBlockVolume=true|false (ALPHA - default=false)
CSIDriverRegistry=true|false (ALPHA - default=false)
CSINodeInfo=true|false (ALPHA - default=false)
CustomCPUCFSQuotaPeriod=true|false (ALPHA - default=false)
CustomPodDNS=true|false (BETA - default=true)
CustomResourceSubresources=true|false (BETA - default=true)
CustomResourceValidation=true|false (BETA - default=true)
CustomResourceWebhookConversion=true|false (ALPHA - default=false)
DebugContainers=true|false (ALPHA - default=false)
DevicePlugins=true|false (BETA - default=true)
DryRun=true|false (BETA - default=true)
DynamicAuditing=true|false (ALPHA - default=false)
DynamicKubeletConfig=true|false (BETA - default=true)
EnableEquivalenceClassCache=true|false (ALPHA - default=false)
ExpandInUsePersistentVolumes=true|false (ALPHA - default=false)
ExpandPersistentVolumes=true|false (BETA - default=true)
ExperimentalCriticalPodAnnotation=true|false (ALPHA - default=false)
ExperimentalHostUserNamespaceDefaulting=true|false (BETA - default=false)
HugePages=true|false (BETA - default=true)
HyperVContainer=true|false (ALPHA - default=false)
Initializers=true|false (ALPHA - default=false)
KubeletPodResources=true|false (ALPHA - default=false)
LocalStorageCapacityIsolation=true|false (BETA - default=true)
MountContainers=true|false (ALPHA - default=false)
NodeLease=true|false (ALPHA - default=false)
PersistentLocalVolumes=true|false (BETA - default=true)
PodPriority=true|false (BETA - default=true)
PodReadinessGates=true|false (BETA - default=true)
PodShareProcessNamespace=true|false (BETA - default=true)
ProcMountType=true|false (ALPHA - default=false)
QOSReserved=true|false (ALPHA - default=false)
ResourceLimitsPriorityFunction=true|false (ALPHA - default=false)
ResourceQuotaScopeSelectors=true|false (BETA - default=true)
RotateKubeletClientCertificate=true|false (BETA - default=true)
RotateKubeletServerCertificate=true|false (BETA - default=true)
RunAsGroup=true|false (ALPHA - default=false)
RuntimeClass=true|false (ALPHA - default=false)
SCTPSupport=true|false (ALPHA - default=false)
ScheduleDaemonSetPods=true|false (BETA - default=true)
ServiceNodeExclusion=true|false (ALPHA - default=false)
StreamingProxyRedirects=true|false (BETA - default=true)
SupportPodPidsLimit=true|false (ALPHA - default=false)
Sysctls=true|false (BETA - default=true)
TTLAfterFinished=true|false (ALPHA - default=false)
TaintBasedEvictions=true|false (BETA - default=true)
TaintNodesByCondition=true|false (BETA - default=true)
TokenRequest=true|false (BETA - default=true)
TokenRequestProjection=true|false (BETA - default=true)
ValidateProxyRedirects=true|false (ALPHA - default=false)
VolumeSnapshotDataSource=true|false (ALPHA - default=false)
VolumeSubpathEnvExpansion=true|false (ALPHA - default=false) @@ -263,6 +277,27 @@ cloud-controller-manager [flags] The duration the clients should wait between attempting acquisition and renewal of a leadership. This is only applicable if leader election is enabled. + + --log-backtrace-at traceLocation     Default: :0 + + + when logging hits line file:N, emit a stack trace + + + + --log-dir string + + + If non-empty, write log files in this directory + + + + --log-file string + + + If non-empty, use this log file + + --log-flush-frequency duration     Default: 5s @@ -270,6 +305,13 @@ cloud-controller-manager [flags] Maximum number of seconds between log flushes + + --logtostderr     Default: true + + + log to standard error instead of files + + --master string @@ -354,6 +396,20 @@ cloud-controller-manager [flags] The port on which to serve HTTPS with authentication and authorization.If 0, don't serve HTTPS at all. + + --skip-headers + + + If true, avoid header prefixes in the log messages + + + + --stderrthreshold severity     Default: 2 + + + logs at or above this threshold go to stderr + + --tls-cert-file string @@ -396,6 +452,13 @@ cloud-controller-manager [flags] If true, use individual service account credentials for each controller. + + -v, --v Level + + + log level for V logs + + --version version[=true] @@ -403,6 +466,13 @@ cloud-controller-manager [flags] Print version information and quit + + --vmodule moduleSpec + + + comma-separated list of pattern=N settings for file-filtered logging + + diff --git a/content/en/docs/reference/command-line-tools-reference/feature-gates.md b/content/en/docs/reference/command-line-tools-reference/feature-gates.md index 11a0901c6c515..7d665737c3b20 100644 --- a/content/en/docs/reference/command-line-tools-reference/feature-gates.md +++ b/content/en/docs/reference/command-line-tools-reference/feature-gates.md @@ -134,7 +134,7 @@ different Kubernetes components. | `VolumeScheduling` | `true` | Beta | 1.10 | 1.12 | | `VolumeScheduling` | `true` | GA | 1.13 | | | `VolumeSubpathEnvExpansion` | `false` | Alpha | 1.11 | | -| `VolumeSnapshotDataSource` | `false` | Alpha | 1.12 | | +| `VolumeSnapshotDataSource` | `false` | Alpha | 1.12 | - | | `ScheduleDaemonSetPods` | `false` | Alpha | 1.11 | 1.11 | | `ScheduleDaemonSetPods` | `true` | Beta | 1.12 | | diff --git a/content/en/docs/reference/command-line-tools-reference/federation-apiserver.md b/content/en/docs/reference/command-line-tools-reference/federation-apiserver.md index 7ec19bda28410..503488b89e8f1 100644 --- a/content/en/docs/reference/command-line-tools-reference/federation-apiserver.md +++ b/content/en/docs/reference/command-line-tools-reference/federation-apiserver.md @@ -1,8 +1,3 @@ ---- -title: federation-apiserver -notitle: true ---- - ## federation-apiserver @@ -109,8 +104,8 @@ ServiceProxyAllowExternalIPs=true|false (DEPRECATED - default=false) StreamingProxyRedirects=true|false (BETA - default=true) SupportIPVSProxyMode=true|false (BETA - default=false) SupportPodPidsLimit=true|false (ALPHA - default=false) -TaintBasedEvictions=true|false (BETA - default=true) -TaintNodesByCondition=true|false (BETA - default=true) +TaintBasedEvictions=true|false (ALPHA - default=false) +TaintNodesByCondition=true|false (ALPHA - default=false) VolumeScheduling=true|false (ALPHA - default=false) -h, --help help for federation-apiserver --log-flush-frequency duration Maximum number of seconds between log flushes (default 5s) @@ -150,4 +145,4 @@ VolumeScheduling=true|false (ALPHA - default=false) --watch-cache-sizes strings List of watch cache sizes for every resource (pods, nodes, etc.), comma separated. The individual override format: resource[.group]#size, where resource is lowercase plural (no version), group is optional, and size is a number. It takes effect when watch-cache is enabled. Some resources (replicationcontrollers, endpoints, nodes, pods, services, apiservices.apiregistration.k8s.io) have system defaults set by heuristics, others default to default-watch-cache-size ``` -###### Auto generated by spf13/cobra on 24-Sep-2018 +###### Auto generated by spf13/cobra on 1-Dec-2018 diff --git a/content/en/docs/reference/command-line-tools-reference/federation-controller-manager.md b/content/en/docs/reference/command-line-tools-reference/federation-controller-manager.md index e7d0460e554fa..8a1aae9c8a08d 100644 --- a/content/en/docs/reference/command-line-tools-reference/federation-controller-manager.md +++ b/content/en/docs/reference/command-line-tools-reference/federation-controller-manager.md @@ -1,8 +1,3 @@ ---- -title: federation-controller-manager -notitle: true ---- - ## federation-controller-manager @@ -32,7 +27,7 @@ federation-controller-manager [flags] --concurrent-service-syncs int The number of service syncing operations that will be done concurrently. Larger number = faster endpoint updating, but more CPU (and network) load (default 10) --contention-profiling Enable lock contention profiling, if profiling is enabled --controllers mapStringString A set of key=value pairs that describe controller configuration to enable/disable specific controllers. Key should be the resource name (like services) and value should be true or false. For example: services=false,ingresses=false - --dns-provider string DNS provider. Valid values are: ["aws-route53" "azure-azuredns" "coredns" "google-clouddns"] + --dns-provider string DNS provider. Valid values are: ["coredns" "google-clouddns" "aws-route53" "azure-azuredns"] --dns-provider-config string Path to config file for configuring DNS provider. --federated-api-burst int Burst to use while talking with federation apiserver (default 30) --federated-api-qps float32 QPS to use while talking with federation apiserver (default 20) @@ -56,4 +51,4 @@ federation-controller-manager [flags] --zone-name string Zone name, like example.com. ``` -###### Auto generated by spf13/cobra on 24-Sep-2018 +###### Auto generated by spf13/cobra on 1-Dec-2018 diff --git a/content/en/docs/reference/command-line-tools-reference/kube-apiserver.md b/content/en/docs/reference/command-line-tools-reference/kube-apiserver.md index 11f932a4f12e7..73359207da4e3 100644 --- a/content/en/docs/reference/command-line-tools-reference/kube-apiserver.md +++ b/content/en/docs/reference/command-line-tools-reference/kube-apiserver.md @@ -48,6 +48,13 @@ kube-apiserver [flags] If true, allow privileged containers. [default=false] + + --alsologtostderr + + + log to standard error as well as files + + --anonymous-auth     Default: true @@ -55,6 +62,13 @@ kube-apiserver [flags] Enables anonymous requests to the secure port of the API server. Requests that are not rejected by another authentication method are treated as anonymous requests. Anonymous requests have a username of system:anonymous, and a group name of system:unauthenticated. + + --api-audiences stringSlice + + + Identifiers of the API. The service account token authenticator will validate that tokens used against the API are bound to at least one of these audiences. If the --service-account-issuer flag is configured and this flag is not, this field defaults to a single element list containing the issuer URL . + + --apiserver-count int     Default: 1 @@ -62,6 +76,13 @@ kube-apiserver [flags] The number of apiservers running in the cluster, must be a positive number. (In use when --endpoint-reconciler-type=master-count is enabled.) + + --audit-dynamic-configuration + + + Enables dynamic audit configuration. This feature also requires the DynamicAuditing feature flag + + --audit-log-batch-buffer-size int     Default: 10000 @@ -136,7 +157,7 @@ kube-apiserver [flags] --audit-log-mode string     Default: "blocking" - Strategy for sending audit events. Blocking indicates sending events should block server responses. Batch causes the backend to buffer and write events asynchronously. Known modes are batch,blocking. + Strategy for sending audit events. Blocking indicates sending events should block server responses. Batch causes the backend to buffer and write events asynchronously. Known modes are batch,blocking,blocking-strict. @@ -168,7 +189,7 @@ kube-apiserver [flags] - --audit-log-version string     Default: "audit.k8s.io/v1beta1" + --audit-log-version string     Default: "audit.k8s.io/v1" API group and version used for serializing audit events written to log. @@ -241,7 +262,7 @@ kube-apiserver [flags] --audit-webhook-mode string     Default: "batch" - Strategy for sending audit events. Blocking indicates sending events should block server responses. Batch causes the backend to buffer and write events asynchronously. Known modes are batch,blocking. + Strategy for sending audit events. Blocking indicates sending events should block server responses. Batch causes the backend to buffer and write events asynchronously. Known modes are batch,blocking,blocking-strict. @@ -266,7 +287,7 @@ kube-apiserver [flags] - --audit-webhook-version string     Default: "audit.k8s.io/v1beta1" + --audit-webhook-version string     Default: "audit.k8s.io/v1" API group and version used for serializing audit events written to webhook. @@ -370,6 +391,13 @@ kube-apiserver [flags] The provider for cloud services. Empty string for no provider. + + --cloud-provider-gce-lb-src-cidrs cidrs     Default: 130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16 + + + CIDRs opened in GCE firewall for LB traffic proxy & health checks + + --contention-profiling @@ -385,24 +413,31 @@ kube-apiserver [flags] - --default-watch-cache-size int     Default: 100 + --default-not-ready-toleration-seconds int     Default: 300 - Default watch cache size. If zero, watch cache will be disabled for resources that do not have a default watch size set. + Indicates the tolerationSeconds of the toleration for notReady:NoExecute that is added by default to every pod that does not already have such a toleration. - --delete-collection-workers int     Default: 1 + --default-unreachable-toleration-seconds int     Default: 300 - Number of workers spawned for DeleteCollection call. These are used to speed up namespace cleanup. + Indicates the tolerationSeconds of the toleration for unreachable:NoExecute that is added by default to every pod that does not already have such a toleration. - --deserialization-cache-size int + --default-watch-cache-size int     Default: 100 - Number of deserialized json objects to cache in memory. + Default watch cache size. If zero, watch cache will be disabled for resources that do not have a default watch size set. + + + + --delete-collection-workers int     Default: 1 + + + Number of workers spawned for DeleteCollection call. These are used to speed up namespace cleanup. @@ -454,6 +489,13 @@ kube-apiserver [flags] Enables swagger ui on the apiserver at /swagger-ui + + --encryption-provider-config string + + + The file containing configuration for encryption providers to be used for storing secrets in etcd + + --endpoint-reconciler-type string     Default: "lease" @@ -525,6 +567,7 @@ kube-apiserver [flags] +<<<<<<< HEAD --encryption-provider-config string @@ -532,6 +575,8 @@ kube-apiserver [flags] +======= +>>>>>>> Generate copmonents and tools reference --external-hostname string @@ -542,7 +587,7 @@ kube-apiserver [flags] --feature-gates mapStringBool - A set of key=value pairs that describe feature gates for alpha/experimental features. Options are:
APIListChunking=true|false (BETA - default=true)
APIResponseCompression=true|false (ALPHA - default=false)
AllAlpha=true|false (ALPHA - default=false)
AppArmor=true|false (BETA - default=true)
AttachVolumeLimit=true|false (BETA - default=false)
BalanceAttachedNodeVolumes=true|false (ALPHA - default=false)
BlockVolume=true|false (ALPHA - default=false)
CPUManager=true|false (BETA - default=true)
CRIContainerLogRotation=true|false (BETA - default=true)
CSIBlockVolume=true|false (ALPHA - default=false)
CSIDriverRegistry=true|false (ALPHA - default=false)
CSINodeInfo=true|false (ALPHA - default=false)
CSIPersistentVolume=true|false (BETA - default=true)
CustomCPUCFSQuotaPeriod=true|false (ALPHA - default=false)
CustomPodDNS=true|false (BETA - default=true)
CustomResourceSubresources=true|false (BETA - default=true)
CustomResourceValidation=true|false (BETA - default=true)
DebugContainers=true|false (ALPHA - default=false)
DevicePlugins=true|false (BETA - default=true)
DryRun=true|false (ALPHA - default=false)
DynamicKubeletConfig=true|false (BETA - default=true)
EnableEquivalenceClassCache=true|false (ALPHA - default=false)
ExpandInUsePersistentVolumes=true|false (ALPHA - default=false)
ExpandPersistentVolumes=true|false (BETA - default=true)
ExperimentalCriticalPodAnnotation=true|false (ALPHA - default=false)
ExperimentalHostUserNamespaceDefaulting=true|false (BETA - default=false)
GCERegionalPersistentDisk=true|false (BETA - default=true)
HugePages=true|false (BETA - default=true)
HyperVContainer=true|false (ALPHA - default=false)
Initializers=true|false (ALPHA - default=false)
KubeletPluginsWatcher=true|false (BETA - default=true)
LocalStorageCapacityIsolation=true|false (BETA - default=true)
MountContainers=true|false (ALPHA - default=false)
NodeLease=true|false (ALPHA - default=false)
PersistentLocalVolumes=true|false (BETA - default=true)
PodPriority=true|false (BETA - default=true)
PodReadinessGates=true|false (BETA - default=true)
PodShareProcessNamespace=true|false (BETA - default=true)
ProcMountType=true|false (ALPHA - default=false)
QOSReserved=true|false (ALPHA - default=false)
ResourceLimitsPriorityFunction=true|false (ALPHA - default=false)
ResourceQuotaScopeSelectors=true|false (BETA - default=true)
RotateKubeletClientCertificate=true|false (BETA - default=true)
RotateKubeletServerCertificate=true|false (BETA - default=true)
RunAsGroup=true|false (ALPHA - default=false)
RuntimeClass=true|false (ALPHA - default=false)
SCTPSupport=true|false (ALPHA - default=false)
ScheduleDaemonSetPods=true|false (BETA - default=true)
ServiceNodeExclusion=true|false (ALPHA - default=false)
StreamingProxyRedirects=true|false (BETA - default=true)
SupportPodPidsLimit=true|false (ALPHA - default=false)
Sysctls=true|false (BETA - default=true)
TTLAfterFinished=true|false (ALPHA - default=false)
TaintBasedEvictions=true|false (BETA - default=true)
TaintNodesByCondition=true|false (BETA - default=true)
TokenRequest=true|false (BETA - default=true)
TokenRequestProjection=true|false (BETA - default=true)
VolumeScheduling=true|false (BETA - default=true)
VolumeSnapshotDataSource=true|false (ALPHA - default=false)
VolumeSubpathEnvExpansion=true|false (ALPHA - default=false) + A set of key=value pairs that describe feature gates for alpha/experimental features. Options are:
APIListChunking=true|false (BETA - default=true)
APIResponseCompression=true|false (ALPHA - default=false)
AllAlpha=true|false (ALPHA - default=false)
AppArmor=true|false (BETA - default=true)
AttachVolumeLimit=true|false (BETA - default=true)
BalanceAttachedNodeVolumes=true|false (ALPHA - default=false)
BlockVolume=true|false (BETA - default=true)
BoundServiceAccountTokenVolume=true|false (ALPHA - default=false)
CPUManager=true|false (BETA - default=true)
CRIContainerLogRotation=true|false (BETA - default=true)
CSIBlockVolume=true|false (ALPHA - default=false)
CSIDriverRegistry=true|false (ALPHA - default=false)
CSINodeInfo=true|false (ALPHA - default=false)
CustomCPUCFSQuotaPeriod=true|false (ALPHA - default=false)
CustomPodDNS=true|false (BETA - default=true)
CustomResourceSubresources=true|false (BETA - default=true)
CustomResourceValidation=true|false (BETA - default=true)
CustomResourceWebhookConversion=true|false (ALPHA - default=false)
DebugContainers=true|false (ALPHA - default=false)
DevicePlugins=true|false (BETA - default=true)
DryRun=true|false (BETA - default=true)
DynamicAuditing=true|false (ALPHA - default=false)
DynamicKubeletConfig=true|false (BETA - default=true)
EnableEquivalenceClassCache=true|false (ALPHA - default=false)
ExpandInUsePersistentVolumes=true|false (ALPHA - default=false)
ExpandPersistentVolumes=true|false (BETA - default=true)
ExperimentalCriticalPodAnnotation=true|false (ALPHA - default=false)
ExperimentalHostUserNamespaceDefaulting=true|false (BETA - default=false)
HugePages=true|false (BETA - default=true)
HyperVContainer=true|false (ALPHA - default=false)
Initializers=true|false (ALPHA - default=false)
KubeletPodResources=true|false (ALPHA - default=false)
LocalStorageCapacityIsolation=true|false (BETA - default=true)
MountContainers=true|false (ALPHA - default=false)
NodeLease=true|false (ALPHA - default=false)
PersistentLocalVolumes=true|false (BETA - default=true)
PodPriority=true|false (BETA - default=true)
PodReadinessGates=true|false (BETA - default=true)
PodShareProcessNamespace=true|false (BETA - default=true)
ProcMountType=true|false (ALPHA - default=false)
QOSReserved=true|false (ALPHA - default=false)
ResourceLimitsPriorityFunction=true|false (ALPHA - default=false)
ResourceQuotaScopeSelectors=true|false (BETA - default=true)
RotateKubeletClientCertificate=true|false (BETA - default=true)
RotateKubeletServerCertificate=true|false (BETA - default=true)
RunAsGroup=true|false (ALPHA - default=false)
RuntimeClass=true|false (ALPHA - default=false)
SCTPSupport=true|false (ALPHA - default=false)
ScheduleDaemonSetPods=true|false (BETA - default=true)
ServiceNodeExclusion=true|false (ALPHA - default=false)
StreamingProxyRedirects=true|false (BETA - default=true)
SupportPodPidsLimit=true|false (ALPHA - default=false)
Sysctls=true|false (BETA - default=true)
TTLAfterFinished=true|false (ALPHA - default=false)
TaintBasedEvictions=true|false (BETA - default=true)
TaintNodesByCondition=true|false (BETA - default=true)
TokenRequest=true|false (BETA - default=true)
TokenRequestProjection=true|false (BETA - default=true)
ValidateProxyRedirects=true|false (ALPHA - default=false)
VolumeSnapshotDataSource=true|false (ALPHA - default=false)
VolumeSubpathEnvExpansion=true|false (ALPHA - default=false) @@ -615,6 +660,27 @@ kube-apiserver [flags] If non-zero, the Kubernetes master service (which apiserver creates/maintains) will be of type NodePort, using this as the value of the port. If zero, the Kubernetes master service will be of type ClusterIP. + + --log-backtrace-at traceLocation     Default: :0 + + + when logging hits line file:N, emit a stack trace + + + + --log-dir string + + + If non-empty, write log files in this directory + + + + --log-file string + + + If non-empty, use this log file + + --log-flush-frequency duration     Default: 5s @@ -622,6 +688,13 @@ kube-apiserver [flags] Maximum number of seconds between log flushes + + --logtostderr     Default: true + + + log to standard error instead of files + + --master-service-namespace string     Default: "default" @@ -797,13 +870,6 @@ kube-apiserver [flags] The port on which to serve HTTPS with authentication and authorization.It cannot be switched off with 0. - - --service-account-api-audiences stringSlice - - - Identifiers of the API. The service account token authenticator will validate that tokens used against the API are bound to at least one of these audiences. - - --service-account-issuer string @@ -853,11 +919,29 @@ kube-apiserver [flags] A port range to reserve for services with NodePort visibility. Example: '30000-32767'. Inclusive at both ends of the range. + + --skip-headers + + + If true, avoid header prefixes in the log messages + + + + --stderrthreshold severity     Default: 2 + + + logs at or above this threshold go to stderr + + --storage-backend string +<<<<<<< HEAD The storage backend for persistence. Options: 'etcd3' (default) +======= + The storage backend for persistence. Options: 'etcd3' (default). +>>>>>>> Generate copmonents and tools reference @@ -916,6 +1000,13 @@ kube-apiserver [flags] If set, the file that will be used to secure the secure port of the API server via token authentication. + + -v, --v Level + + + log level for V logs + + --version version[=true] @@ -923,6 +1014,13 @@ kube-apiserver [flags] Print version information and quit + + --vmodule moduleSpec + + + comma-separated list of pattern=N settings for file-filtered logging + + --watch-cache     Default: true diff --git a/content/en/docs/reference/command-line-tools-reference/kube-controller-manager.md b/content/en/docs/reference/command-line-tools-reference/kube-controller-manager.md index 14b7fb230da9b..2f80707248ec5 100644 --- a/content/en/docs/reference/command-line-tools-reference/kube-controller-manager.md +++ b/content/en/docs/reference/command-line-tools-reference/kube-controller-manager.md @@ -38,6 +38,13 @@ kube-controller-manager [flags] Should CIDRs for Pods be allocated and set on the cloud provider. + + --alsologtostderr + + + log to standard error as well as files + + --attach-detach-reconcile-sync-period duration     Default: 1m0s @@ -109,7 +116,7 @@ kube-controller-manager [flags] - --cert-dir string     Default: "/var/run/kubernetes" + --cert-dir string The directory where the TLS certs are located. If --tls-cert-file and --tls-private-key-file are provided, this flag will be ignored. @@ -143,6 +150,13 @@ kube-controller-manager [flags] The provider for cloud services. Empty string for no provider. + + --cloud-provider-gce-lb-src-cidrs cidrs     Default: 130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16 + + + CIDRs opened in GCE firewall for LB traffic proxy & health checks + + --cluster-cidr string @@ -266,7 +280,7 @@ kube-controller-manager [flags] --controllers stringSlice     Default: [*] - A list of controllers to enable. '*' enables all on-by-default controllers, 'foo' enables the controller named 'foo', '-foo' disables the controller named 'foo'.
All controllers: attachdetach, bootstrapsigner, clusterrole-aggregation, cronjob, csrapproving, csrcleaner, csrsigning, daemonset, deployment, disruption, endpoint, garbagecollector, horizontalpodautoscaling, job, namespace, nodeipam, nodelifecycle, persistentvolume-binder, persistentvolume-expander, podgc, pv-protection, pvc-protection, replicaset, replicationcontroller, resourcequota, route, service, serviceaccount, serviceaccount-token, statefulset, tokencleaner, ttl, ttl-after-finished
Disabled-by-default controllers: bootstrapsigner, tokencleaner + A list of controllers to enable. '*' enables all on-by-default controllers, 'foo' enables the controller named 'foo', '-foo' disables the controller named 'foo'.
All controllers: attachdetach, bootstrapsigner, clusterrole-aggregation, cronjob, csrapproving, csrcleaner, csrsigning, daemonset, deployment, disruption, endpoint, garbagecollector, horizontalpodautoscaling, job, namespace, nodeipam, nodelifecycle, persistentvolume-binder, persistentvolume-expander, podgc, pv-protection, pvc-protection, replicaset, replicationcontroller, resourcequota, root-ca-cert-publisher, route, service, serviceaccount, serviceaccount-token, statefulset, tokencleaner, ttl, ttl-after-finished
Disabled-by-default controllers: bootstrapsigner, tokencleaner @@ -329,7 +343,7 @@ kube-controller-manager [flags] --feature-gates mapStringBool - A set of key=value pairs that describe feature gates for alpha/experimental features. Options are:
APIListChunking=true|false (BETA - default=true)
APIResponseCompression=true|false (ALPHA - default=false)
AllAlpha=true|false (ALPHA - default=false)
AppArmor=true|false (BETA - default=true)
AttachVolumeLimit=true|false (BETA - default=false)
BalanceAttachedNodeVolumes=true|false (ALPHA - default=false)
BlockVolume=true|false (ALPHA - default=false)
CPUManager=true|false (BETA - default=true)
CRIContainerLogRotation=true|false (BETA - default=true)
CSIBlockVolume=true|false (ALPHA - default=false)
CSIDriverRegistry=true|false (ALPHA - default=false)
CSINodeInfo=true|false (ALPHA - default=false)
CSIPersistentVolume=true|false (BETA - default=true)
CustomCPUCFSQuotaPeriod=true|false (ALPHA - default=false)
CustomPodDNS=true|false (BETA - default=true)
CustomResourceSubresources=true|false (BETA - default=true)
CustomResourceValidation=true|false (BETA - default=true)
DebugContainers=true|false (ALPHA - default=false)
DevicePlugins=true|false (BETA - default=true)
DryRun=true|false (ALPHA - default=false)
DynamicKubeletConfig=true|false (BETA - default=true)
EnableEquivalenceClassCache=true|false (ALPHA - default=false)
ExpandInUsePersistentVolumes=true|false (ALPHA - default=false)
ExpandPersistentVolumes=true|false (BETA - default=true)
ExperimentalCriticalPodAnnotation=true|false (ALPHA - default=false)
ExperimentalHostUserNamespaceDefaulting=true|false (BETA - default=false)
GCERegionalPersistentDisk=true|false (BETA - default=true)
HugePages=true|false (BETA - default=true)
HyperVContainer=true|false (ALPHA - default=false)
Initializers=true|false (ALPHA - default=false)
KubeletPluginsWatcher=true|false (BETA - default=true)
LocalStorageCapacityIsolation=true|false (BETA - default=true)
MountContainers=true|false (ALPHA - default=false)
NodeLease=true|false (ALPHA - default=false)
PersistentLocalVolumes=true|false (BETA - default=true)
PodPriority=true|false (BETA - default=true)
PodReadinessGates=true|false (BETA - default=true)
PodShareProcessNamespace=true|false (BETA - default=true)
ProcMountType=true|false (ALPHA - default=false)
QOSReserved=true|false (ALPHA - default=false)
ResourceLimitsPriorityFunction=true|false (ALPHA - default=false)
ResourceQuotaScopeSelectors=true|false (BETA - default=true)
RotateKubeletClientCertificate=true|false (BETA - default=true)
RotateKubeletServerCertificate=true|false (BETA - default=true)
RunAsGroup=true|false (ALPHA - default=false)
RuntimeClass=true|false (ALPHA - default=false)
SCTPSupport=true|false (ALPHA - default=false)
ScheduleDaemonSetPods=true|false (BETA - default=true)
ServiceNodeExclusion=true|false (ALPHA - default=false)
StreamingProxyRedirects=true|false (BETA - default=true)
SupportPodPidsLimit=true|false (ALPHA - default=false)
Sysctls=true|false (BETA - default=true)
TTLAfterFinished=true|false (ALPHA - default=false)
TaintBasedEvictions=true|false (BETA - default=true)
TaintNodesByCondition=true|false (BETA - default=true)
TokenRequest=true|false (BETA - default=true)
TokenRequestProjection=true|false (BETA - default=true)
VolumeScheduling=true|false (BETA - default=true)
VolumeSnapshotDataSource=true|false (ALPHA - default=false)
VolumeSubpathEnvExpansion=true|false (ALPHA - default=false) + A set of key=value pairs that describe feature gates for alpha/experimental features. Options are:
APIListChunking=true|false (BETA - default=true)
APIResponseCompression=true|false (ALPHA - default=false)
AllAlpha=true|false (ALPHA - default=false)
AppArmor=true|false (BETA - default=true)
AttachVolumeLimit=true|false (BETA - default=true)
BalanceAttachedNodeVolumes=true|false (ALPHA - default=false)
BlockVolume=true|false (BETA - default=true)
BoundServiceAccountTokenVolume=true|false (ALPHA - default=false)
CPUManager=true|false (BETA - default=true)
CRIContainerLogRotation=true|false (BETA - default=true)
CSIBlockVolume=true|false (ALPHA - default=false)
CSIDriverRegistry=true|false (ALPHA - default=false)
CSINodeInfo=true|false (ALPHA - default=false)
CustomCPUCFSQuotaPeriod=true|false (ALPHA - default=false)
CustomPodDNS=true|false (BETA - default=true)
CustomResourceSubresources=true|false (BETA - default=true)
CustomResourceValidation=true|false (BETA - default=true)
CustomResourceWebhookConversion=true|false (ALPHA - default=false)
DebugContainers=true|false (ALPHA - default=false)
DevicePlugins=true|false (BETA - default=true)
DryRun=true|false (BETA - default=true)
DynamicAuditing=true|false (ALPHA - default=false)
DynamicKubeletConfig=true|false (BETA - default=true)
EnableEquivalenceClassCache=true|false (ALPHA - default=false)
ExpandInUsePersistentVolumes=true|false (ALPHA - default=false)
ExpandPersistentVolumes=true|false (BETA - default=true)
ExperimentalCriticalPodAnnotation=true|false (ALPHA - default=false)
ExperimentalHostUserNamespaceDefaulting=true|false (BETA - default=false)
HugePages=true|false (BETA - default=true)
HyperVContainer=true|false (ALPHA - default=false)
Initializers=true|false (ALPHA - default=false)
KubeletPodResources=true|false (ALPHA - default=false)
LocalStorageCapacityIsolation=true|false (BETA - default=true)
MountContainers=true|false (ALPHA - default=false)
NodeLease=true|false (ALPHA - default=false)
PersistentLocalVolumes=true|false (BETA - default=true)
PodPriority=true|false (BETA - default=true)
PodReadinessGates=true|false (BETA - default=true)
PodShareProcessNamespace=true|false (BETA - default=true)
ProcMountType=true|false (ALPHA - default=false)
QOSReserved=true|false (ALPHA - default=false)
ResourceLimitsPriorityFunction=true|false (ALPHA - default=false)
ResourceQuotaScopeSelectors=true|false (BETA - default=true)
RotateKubeletClientCertificate=true|false (BETA - default=true)
RotateKubeletServerCertificate=true|false (BETA - default=true)
RunAsGroup=true|false (ALPHA - default=false)
RuntimeClass=true|false (ALPHA - default=false)
SCTPSupport=true|false (ALPHA - default=false)
ScheduleDaemonSetPods=true|false (BETA - default=true)
ServiceNodeExclusion=true|false (ALPHA - default=false)
StreamingProxyRedirects=true|false (BETA - default=true)
SupportPodPidsLimit=true|false (ALPHA - default=false)
Sysctls=true|false (BETA - default=true)
TTLAfterFinished=true|false (ALPHA - default=false)
TaintBasedEvictions=true|false (BETA - default=true)
TaintNodesByCondition=true|false (BETA - default=true)
TokenRequest=true|false (BETA - default=true)
TokenRequestProjection=true|false (BETA - default=true)
ValidateProxyRedirects=true|false (ALPHA - default=false)
VolumeSnapshotDataSource=true|false (ALPHA - default=false)
VolumeSubpathEnvExpansion=true|false (ALPHA - default=false) @@ -388,13 +402,6 @@ kube-controller-manager [flags] The limit that the server gives to clients for the maximum number of streams in an HTTP/2 connection. Zero means to use golang's default. - - --insecure-experimental-approve-all-kubelet-csrs-for-group string - - - This flag does nothing. - - --kube-api-burst int32     Default: 30 @@ -465,6 +472,27 @@ kube-controller-manager [flags] The duration the clients should wait between attempting acquisition and renewal of a leadership. This is only applicable if leader election is enabled. + + --log-backtrace-at traceLocation     Default: :0 + + + when logging hits line file:N, emit a stack trace + + + + --log-dir string + + + If non-empty, write log files in this directory + + + + --log-file string + + + If non-empty, use this log file + + --log-flush-frequency duration     Default: 5s @@ -472,6 +500,13 @@ kube-controller-manager [flags] Maximum number of seconds between log flushes + + --logtostderr     Default: true + + + log to standard error instead of files + + --master string @@ -675,6 +710,20 @@ kube-controller-manager [flags] CIDR Range for Services in cluster. Requires --allocate-node-cidrs to be true + + --skip-headers + + + If true, avoid header prefixes in the log messages + + + + --stderrthreshold severity     Default: 2 + + + logs at or above this threshold go to stderr + + --terminated-pod-gc-threshold int32     Default: 12500 @@ -731,6 +780,13 @@ kube-controller-manager [flags] If true, use individual service account credentials for each controller. + + -v, --v Level + + + log level for V logs + + --version version[=true] @@ -738,6 +794,13 @@ kube-controller-manager [flags] Print version information and quit + + --vmodule moduleSpec + + + comma-separated list of pattern=N settings for file-filtered logging + + diff --git a/content/en/docs/reference/command-line-tools-reference/kube-proxy.md b/content/en/docs/reference/command-line-tools-reference/kube-proxy.md index 8b874b14b1cd9..209e694c293d6 100644 --- a/content/en/docs/reference/command-line-tools-reference/kube-proxy.md +++ b/content/en/docs/reference/command-line-tools-reference/kube-proxy.md @@ -111,7 +111,7 @@ kube-proxy [flags] --feature-gates mapStringBool - A set of key=value pairs that describe feature gates for alpha/experimental features. Options are:
APIListChunking=true|false (BETA - default=true)
APIResponseCompression=true|false (ALPHA - default=false)
AllAlpha=true|false (ALPHA - default=false)
AppArmor=true|false (BETA - default=true)
AttachVolumeLimit=true|false (BETA - default=false)
BalanceAttachedNodeVolumes=true|false (ALPHA - default=false)
BlockVolume=true|false (ALPHA - default=false)
CPUManager=true|false (BETA - default=true)
CRIContainerLogRotation=true|false (BETA - default=true)
CSIBlockVolume=true|false (ALPHA - default=false)
CSIDriverRegistry=true|false (ALPHA - default=false)
CSINodeInfo=true|false (ALPHA - default=false)
CSIPersistentVolume=true|false (BETA - default=true)
CustomCPUCFSQuotaPeriod=true|false (ALPHA - default=false)
CustomPodDNS=true|false (BETA - default=true)
CustomResourceSubresources=true|false (BETA - default=true)
CustomResourceValidation=true|false (BETA - default=true)
DebugContainers=true|false (ALPHA - default=false)
DevicePlugins=true|false (BETA - default=true)
DryRun=true|false (ALPHA - default=false)
DynamicKubeletConfig=true|false (BETA - default=true)
EnableEquivalenceClassCache=true|false (ALPHA - default=false)
ExpandInUsePersistentVolumes=true|false (ALPHA - default=false)
ExpandPersistentVolumes=true|false (BETA - default=true)
ExperimentalCriticalPodAnnotation=true|false (ALPHA - default=false)
ExperimentalHostUserNamespaceDefaulting=true|false (BETA - default=false)
GCERegionalPersistentDisk=true|false (BETA - default=true)
HugePages=true|false (BETA - default=true)
HyperVContainer=true|false (ALPHA - default=false)
Initializers=true|false (ALPHA - default=false)
KubeletPluginsWatcher=true|false (BETA - default=true)
LocalStorageCapacityIsolation=true|false (BETA - default=true)
MountContainers=true|false (ALPHA - default=false)
NodeLease=true|false (ALPHA - default=false)
PersistentLocalVolumes=true|false (BETA - default=true)
PodPriority=true|false (BETA - default=true)
PodReadinessGates=true|false (BETA - default=true)
PodShareProcessNamespace=true|false (BETA - default=true)
ProcMountType=true|false (ALPHA - default=false)
QOSReserved=true|false (ALPHA - default=false)
ResourceLimitsPriorityFunction=true|false (ALPHA - default=false)
ResourceQuotaScopeSelectors=true|false (BETA - default=true)
RotateKubeletClientCertificate=true|false (BETA - default=true)
RotateKubeletServerCertificate=true|false (BETA - default=true)
RunAsGroup=true|false (ALPHA - default=false)
RuntimeClass=true|false (ALPHA - default=false)
SCTPSupport=true|false (ALPHA - default=false)
ScheduleDaemonSetPods=true|false (BETA - default=true)
ServiceNodeExclusion=true|false (ALPHA - default=false)
StreamingProxyRedirects=true|false (BETA - default=true)
SupportPodPidsLimit=true|false (ALPHA - default=false)
Sysctls=true|false (BETA - default=true)
TTLAfterFinished=true|false (ALPHA - default=false)
TaintBasedEvictions=true|false (BETA - default=true)
TaintNodesByCondition=true|false (BETA - default=true)
TokenRequest=true|false (BETA - default=true)
TokenRequestProjection=true|false (BETA - default=true)
VolumeScheduling=true|false (BETA - default=true)
VolumeSnapshotDataSource=true|false (ALPHA - default=false)
VolumeSubpathEnvExpansion=true|false (ALPHA - default=false) + A set of key=value pairs that describe feature gates for alpha/experimental features. Options are:
APIListChunking=true|false (BETA - default=true)
APIResponseCompression=true|false (ALPHA - default=false)
AllAlpha=true|false (ALPHA - default=false)
AppArmor=true|false (BETA - default=true)
AttachVolumeLimit=true|false (BETA - default=true)
BalanceAttachedNodeVolumes=true|false (ALPHA - default=false)
BlockVolume=true|false (BETA - default=true)
BoundServiceAccountTokenVolume=true|false (ALPHA - default=false)
CPUManager=true|false (BETA - default=true)
CRIContainerLogRotation=true|false (BETA - default=true)
CSIBlockVolume=true|false (ALPHA - default=false)
CSIDriverRegistry=true|false (ALPHA - default=false)
CSINodeInfo=true|false (ALPHA - default=false)
CustomCPUCFSQuotaPeriod=true|false (ALPHA - default=false)
CustomPodDNS=true|false (BETA - default=true)
CustomResourceSubresources=true|false (BETA - default=true)
CustomResourceValidation=true|false (BETA - default=true)
CustomResourceWebhookConversion=true|false (ALPHA - default=false)
DebugContainers=true|false (ALPHA - default=false)
DevicePlugins=true|false (BETA - default=true)
DryRun=true|false (BETA - default=true)
DynamicAuditing=true|false (ALPHA - default=false)
DynamicKubeletConfig=true|false (BETA - default=true)
EnableEquivalenceClassCache=true|false (ALPHA - default=false)
ExpandInUsePersistentVolumes=true|false (ALPHA - default=false)
ExpandPersistentVolumes=true|false (BETA - default=true)
ExperimentalCriticalPodAnnotation=true|false (ALPHA - default=false)
ExperimentalHostUserNamespaceDefaulting=true|false (BETA - default=false)
HugePages=true|false (BETA - default=true)
HyperVContainer=true|false (ALPHA - default=false)
Initializers=true|false (ALPHA - default=false)
KubeletPodResources=true|false (ALPHA - default=false)
LocalStorageCapacityIsolation=true|false (BETA - default=true)
MountContainers=true|false (ALPHA - default=false)
NodeLease=true|false (ALPHA - default=false)
PersistentLocalVolumes=true|false (BETA - default=true)
PodPriority=true|false (BETA - default=true)
PodReadinessGates=true|false (BETA - default=true)
PodShareProcessNamespace=true|false (BETA - default=true)
ProcMountType=true|false (ALPHA - default=false)
QOSReserved=true|false (ALPHA - default=false)
ResourceLimitsPriorityFunction=true|false (ALPHA - default=false)
ResourceQuotaScopeSelectors=true|false (BETA - default=true)
RotateKubeletClientCertificate=true|false (BETA - default=true)
RotateKubeletServerCertificate=true|false (BETA - default=true)
RunAsGroup=true|false (ALPHA - default=false)
RuntimeClass=true|false (ALPHA - default=false)
SCTPSupport=true|false (ALPHA - default=false)
ScheduleDaemonSetPods=true|false (BETA - default=true)
ServiceNodeExclusion=true|false (ALPHA - default=false)
StreamingProxyRedirects=true|false (BETA - default=true)
SupportPodPidsLimit=true|false (ALPHA - default=false)
Sysctls=true|false (BETA - default=true)
TTLAfterFinished=true|false (ALPHA - default=false)
TaintBasedEvictions=true|false (BETA - default=true)
TaintNodesByCondition=true|false (BETA - default=true)
TokenRequest=true|false (BETA - default=true)
TokenRequestProjection=true|false (BETA - default=true)
ValidateProxyRedirects=true|false (ALPHA - default=false)
VolumeSnapshotDataSource=true|false (ALPHA - default=false)
VolumeSubpathEnvExpansion=true|false (ALPHA - default=false) diff --git a/content/en/docs/reference/command-line-tools-reference/kube-scheduler.md b/content/en/docs/reference/command-line-tools-reference/kube-scheduler.md index f7351688ff727..511ee18e51359 100644 --- a/content/en/docs/reference/command-line-tools-reference/kube-scheduler.md +++ b/content/en/docs/reference/command-line-tools-reference/kube-scheduler.md @@ -50,6 +50,62 @@ kube-scheduler [flags] DEPRECATED: the scheduling algorithm provider to use, one of: ClusterAutoscalerProvider | DefaultProvider + + --alsologtostderr + + + log to standard error as well as files + + + + --authentication-kubeconfig string + + + kubeconfig file pointing at the 'core' kubernetes server with enough rights to create tokenaccessreviews.authentication.k8s.io. This is optional. If empty, all token requests are considered to be anonymous and no client CA is looked up in the cluster. + + + + --authentication-skip-lookup + + + If false, the authentication-kubeconfig will be used to lookup missing authentication configuration from the cluster. + + + + --authentication-token-webhook-cache-ttl duration     Default: 10s + + + The duration to cache responses from the webhook token authenticator. + + + + --authorization-always-allow-paths stringSlice     Default: [/healthz] + + + A list of HTTP paths to skip during authorization, i.e. these are authorized without contacting the 'core' kubernetes server. + + + + --authorization-kubeconfig string + + + kubeconfig file pointing at the 'core' kubernetes server with enough rights to create subjectaccessreviews.authorization.k8s.io. This is optional. If empty, all requests not skipped by authorization are forbidden. + + + + --authorization-webhook-cache-authorized-ttl duration     Default: 10s + + + The duration to cache 'authorized' responses from the webhook authorizer. + + + + --authorization-webhook-cache-unauthorized-ttl duration     Default: 10s + + + The duration to cache 'unauthorized' responses from the webhook authorizer. + + --azure-container-registry-config string @@ -57,6 +113,27 @@ kube-scheduler [flags] Path to the file containing Azure container registry configuration information. + + --bind-address ip     Default: 0.0.0.0 + + + The IP address on which to listen for the --secure-port port. The associated interface(s) must be reachable by the rest of the cluster, and by CLI/web clients. If blank, all interfaces will be used (0.0.0.0 for all IPv4 interfaces and :: for all IPv6 interfaces). + + + + --cert-dir string + + + The directory where the TLS certs are located. If --tls-cert-file and --tls-private-key-file are provided, this flag will be ignored. + + + + --client-ca-file string + + + If set, any request presenting a client certificate signed by one of the authorities in the client-ca-file is authenticated with an identity corresponding to the CommonName of the client certificate. + + --config string @@ -75,7 +152,7 @@ kube-scheduler [flags] --feature-gates mapStringBool - A set of key=value pairs that describe feature gates for alpha/experimental features. Options are:
APIListChunking=true|false (BETA - default=true)
APIResponseCompression=true|false (ALPHA - default=false)
AllAlpha=true|false (ALPHA - default=false)
AppArmor=true|false (BETA - default=true)
AttachVolumeLimit=true|false (BETA - default=false)
BalanceAttachedNodeVolumes=true|false (ALPHA - default=false)
BlockVolume=true|false (ALPHA - default=false)
CPUManager=true|false (BETA - default=true)
CRIContainerLogRotation=true|false (BETA - default=true)
CSIBlockVolume=true|false (ALPHA - default=false)
CSIDriverRegistry=true|false (ALPHA - default=false)
CSINodeInfo=true|false (ALPHA - default=false)
CSIPersistentVolume=true|false (BETA - default=true)
CustomCPUCFSQuotaPeriod=true|false (ALPHA - default=false)
CustomPodDNS=true|false (BETA - default=true)
CustomResourceSubresources=true|false (BETA - default=true)
CustomResourceValidation=true|false (BETA - default=true)
DebugContainers=true|false (ALPHA - default=false)
DevicePlugins=true|false (BETA - default=true)
DryRun=true|false (ALPHA - default=false)
DynamicKubeletConfig=true|false (BETA - default=true)
EnableEquivalenceClassCache=true|false (ALPHA - default=false)
ExpandInUsePersistentVolumes=true|false (ALPHA - default=false)
ExpandPersistentVolumes=true|false (BETA - default=true)
ExperimentalCriticalPodAnnotation=true|false (ALPHA - default=false)
ExperimentalHostUserNamespaceDefaulting=true|false (BETA - default=false)
GCERegionalPersistentDisk=true|false (BETA - default=true)
HugePages=true|false (BETA - default=true)
HyperVContainer=true|false (ALPHA - default=false)
Initializers=true|false (ALPHA - default=false)
KubeletPluginsWatcher=true|false (BETA - default=true)
LocalStorageCapacityIsolation=true|false (BETA - default=true)
MountContainers=true|false (ALPHA - default=false)
NodeLease=true|false (ALPHA - default=false)
PersistentLocalVolumes=true|false (BETA - default=true)
PodPriority=true|false (BETA - default=true)
PodReadinessGates=true|false (BETA - default=true)
PodShareProcessNamespace=true|false (BETA - default=true)
ProcMountType=true|false (ALPHA - default=false)
QOSReserved=true|false (ALPHA - default=false)
ResourceLimitsPriorityFunction=true|false (ALPHA - default=false)
ResourceQuotaScopeSelectors=true|false (BETA - default=true)
RotateKubeletClientCertificate=true|false (BETA - default=true)
RotateKubeletServerCertificate=true|false (BETA - default=true)
RunAsGroup=true|false (ALPHA - default=false)
RuntimeClass=true|false (ALPHA - default=false)
SCTPSupport=true|false (ALPHA - default=false)
ScheduleDaemonSetPods=true|false (BETA - default=true)
ServiceNodeExclusion=true|false (ALPHA - default=false)
StreamingProxyRedirects=true|false (BETA - default=true)
SupportPodPidsLimit=true|false (ALPHA - default=false)
Sysctls=true|false (BETA - default=true)
TTLAfterFinished=true|false (ALPHA - default=false)
TaintBasedEvictions=true|false (BETA - default=true)
TaintNodesByCondition=true|false (BETA - default=true)
TokenRequest=true|false (BETA - default=true)
TokenRequestProjection=true|false (BETA - default=true)
VolumeScheduling=true|false (BETA - default=true)
VolumeSnapshotDataSource=true|false (ALPHA - default=false)
VolumeSubpathEnvExpansion=true|false (ALPHA - default=false) + A set of key=value pairs that describe feature gates for alpha/experimental features. Options are:
APIListChunking=true|false (BETA - default=true)
APIResponseCompression=true|false (ALPHA - default=false)
AllAlpha=true|false (ALPHA - default=false)
AppArmor=true|false (BETA - default=true)
AttachVolumeLimit=true|false (BETA - default=true)
BalanceAttachedNodeVolumes=true|false (ALPHA - default=false)
BlockVolume=true|false (BETA - default=true)
BoundServiceAccountTokenVolume=true|false (ALPHA - default=false)
CPUManager=true|false (BETA - default=true)
CRIContainerLogRotation=true|false (BETA - default=true)
CSIBlockVolume=true|false (ALPHA - default=false)
CSIDriverRegistry=true|false (ALPHA - default=false)
CSINodeInfo=true|false (ALPHA - default=false)
CustomCPUCFSQuotaPeriod=true|false (ALPHA - default=false)
CustomPodDNS=true|false (BETA - default=true)
CustomResourceSubresources=true|false (BETA - default=true)
CustomResourceValidation=true|false (BETA - default=true)
CustomResourceWebhookConversion=true|false (ALPHA - default=false)
DebugContainers=true|false (ALPHA - default=false)
DevicePlugins=true|false (BETA - default=true)
DryRun=true|false (BETA - default=true)
DynamicAuditing=true|false (ALPHA - default=false)
DynamicKubeletConfig=true|false (BETA - default=true)
EnableEquivalenceClassCache=true|false (ALPHA - default=false)
ExpandInUsePersistentVolumes=true|false (ALPHA - default=false)
ExpandPersistentVolumes=true|false (BETA - default=true)
ExperimentalCriticalPodAnnotation=true|false (ALPHA - default=false)
ExperimentalHostUserNamespaceDefaulting=true|false (BETA - default=false)
HugePages=true|false (BETA - default=true)
HyperVContainer=true|false (ALPHA - default=false)
Initializers=true|false (ALPHA - default=false)
KubeletPodResources=true|false (ALPHA - default=false)
LocalStorageCapacityIsolation=true|false (BETA - default=true)
MountContainers=true|false (ALPHA - default=false)
NodeLease=true|false (ALPHA - default=false)
PersistentLocalVolumes=true|false (BETA - default=true)
PodPriority=true|false (BETA - default=true)
PodReadinessGates=true|false (BETA - default=true)
PodShareProcessNamespace=true|false (BETA - default=true)
ProcMountType=true|false (ALPHA - default=false)
QOSReserved=true|false (ALPHA - default=false)
ResourceLimitsPriorityFunction=true|false (ALPHA - default=false)
ResourceQuotaScopeSelectors=true|false (BETA - default=true)
RotateKubeletClientCertificate=true|false (BETA - default=true)
RotateKubeletServerCertificate=true|false (BETA - default=true)
RunAsGroup=true|false (ALPHA - default=false)
RuntimeClass=true|false (ALPHA - default=false)
SCTPSupport=true|false (ALPHA - default=false)
ScheduleDaemonSetPods=true|false (BETA - default=true)
ServiceNodeExclusion=true|false (ALPHA - default=false)
StreamingProxyRedirects=true|false (BETA - default=true)
SupportPodPidsLimit=true|false (ALPHA - default=false)
Sysctls=true|false (BETA - default=true)
TTLAfterFinished=true|false (ALPHA - default=false)
TaintBasedEvictions=true|false (BETA - default=true)
TaintNodesByCondition=true|false (BETA - default=true)
TokenRequest=true|false (BETA - default=true)
TokenRequestProjection=true|false (BETA - default=true)
ValidateProxyRedirects=true|false (ALPHA - default=false)
VolumeSnapshotDataSource=true|false (ALPHA - default=false)
VolumeSubpathEnvExpansion=true|false (ALPHA - default=false) @@ -85,6 +162,13 @@ kube-scheduler [flags] help for kube-scheduler + + --http2-max-streams-per-connection int + + + The limit that the server gives to clients for the maximum number of streams in an HTTP/2 connection. Zero means to use golang's default. + + --kube-api-burst int32     Default: 100 @@ -162,6 +246,27 @@ kube-scheduler [flags] DEPRECATED: define the namespace of the lock object. + + --log-backtrace-at traceLocation     Default: :0 + + + when logging hits line file:N, emit a stack trace + + + + --log-dir string + + + If non-empty, write log files in this directory + + + + --log-file string + + + If non-empty, use this log file + + --log-flush-frequency duration     Default: 5s @@ -169,6 +274,13 @@ kube-scheduler [flags] Maximum number of seconds between log flushes + + --logtostderr     Default: true + + + log to standard error instead of files + + --master string @@ -218,6 +330,41 @@ kube-scheduler [flags] DEPRECATED: enable profiling via web interface host:port/debug/pprof/ + + --requestheader-allowed-names stringSlice + + + List of client certificate common names to allow to provide usernames in headers specified by --requestheader-username-headers. If empty, any client certificate validated by the authorities in --requestheader-client-ca-file is allowed. + + + + --requestheader-client-ca-file string + + + Root certificate bundle to use to verify client certificates on incoming requests before trusting usernames in headers specified by --requestheader-username-headers. WARNING: generally do not depend on authorization being already done for incoming requests. + + + + --requestheader-extra-headers-prefix stringSlice     Default: [x-remote-extra-] + + + List of request header prefixes to inspect. X-Remote-Extra- is suggested. + + + + --requestheader-group-headers stringSlice     Default: [x-remote-group] + + + List of request headers to inspect for groups. X-Remote-Group is suggested. + + + + --requestheader-username-headers stringSlice     Default: [x-remote-user] + + + List of request headers to inspect for usernames. X-Remote-User is common. + + --scheduler-name string     Default: "default-scheduler" @@ -225,6 +372,62 @@ kube-scheduler [flags] DEPRECATED: name of the scheduler, used to select which pods will be processed by this scheduler, based on pod's "spec.schedulerName". + + --secure-port int     Default: 10259 + + + The port on which to serve HTTPS with authentication and authorization.If 0, don't serve HTTPS at all. + + + + --skip-headers + + + If true, avoid header prefixes in the log messages + + + + --stderrthreshold severity     Default: 2 + + + logs at or above this threshold go to stderr + + + + --tls-cert-file string + + + File containing the default x509 Certificate for HTTPS. (CA cert, if any, concatenated after server cert). If HTTPS serving is enabled, and --tls-cert-file and --tls-private-key-file are not provided, a self-signed certificate and key are generated for the public address and saved to the directory specified by --cert-dir. + + + + --tls-cipher-suites stringSlice + + + Comma-separated list of cipher suites for the server. If omitted, the default Go cipher suites will be use. Possible values: TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA,TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256,TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256,TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA,TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305,TLS_ECDHE_ECDSA_WITH_RC4_128_SHA,TLS_ECDHE_RSA_WITH_3DES_EDE_CBC_SHA,TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA,TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256,TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256,TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA,TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305,TLS_ECDHE_RSA_WITH_RC4_128_SHA,TLS_RSA_WITH_3DES_EDE_CBC_SHA,TLS_RSA_WITH_AES_128_CBC_SHA,TLS_RSA_WITH_AES_128_CBC_SHA256,TLS_RSA_WITH_AES_128_GCM_SHA256,TLS_RSA_WITH_AES_256_CBC_SHA,TLS_RSA_WITH_AES_256_GCM_SHA384,TLS_RSA_WITH_RC4_128_SHA + + + + --tls-min-version string + + + Minimum TLS version supported. Possible values: VersionTLS10, VersionTLS11, VersionTLS12 + + + + --tls-private-key-file string + + + File containing the default x509 private key matching --tls-cert-file. + + + + --tls-sni-cert-key namedCertKey     Default: [] + + + A pair of x509 certificate and private key file paths, optionally suffixed with a list of domain patterns which are fully qualified domain names, possibly with prefixed wildcard segments. If no domain patterns are provided, the names of the certificate are extracted. Non-wildcard matches trump over wildcard matches, explicit domain patterns trump over extracted names. For multiple key/certificate pairs, use the --tls-sni-cert-key multiple times. Examples: "example.crt,example.key" or "foo.crt,foo.key:*.foo.com,foo.com". + + --use-legacy-policy-config @@ -232,6 +435,13 @@ kube-scheduler [flags] DEPRECATED: when set to true, scheduler will ignore policy ConfigMap and uses policy config file + + -v, --v Level + + + log level for V logs + + --version version[=true] @@ -239,6 +449,13 @@ kube-scheduler [flags] Print version information and quit + + --vmodule moduleSpec + + + comma-separated list of pattern=N settings for file-filtered logging + + --write-config-to string diff --git a/content/en/docs/reference/kubectl/kubectl.md b/content/en/docs/reference/kubectl/kubectl.md index 3d6f5808c20ea..6a04d35919e58 100755 --- a/content/en/docs/reference/kubectl/kubectl.md +++ b/content/en/docs/reference/kubectl/kubectl.md @@ -9,7 +9,7 @@ kubectl controls the Kubernetes cluster manager ### Synopsis -kubectl controls the Kubernetes cluster manager. +kubectl controls the Kubernetes cluster manager. Find more information at: https://kubernetes.io/docs/reference/kubectl/overview/ @@ -26,13 +26,6 @@ kubectl [flags] - - --allow-verification-with-non-compliant-keys - - - Allow a SignatureVerifier to use keys which are technically non-compliant with RFC6962. - - --alsologtostderr @@ -62,7 +55,7 @@ kubectl [flags] - --cache-dir string     Default: "/Users/zarnold/.kube/http-cache" + --cache-dir string     Default: "/Users/tim/.kube/http-cache" Default HTTP cache directory @@ -159,6 +152,13 @@ kubectl [flags] If non-empty, write log files in this directory + + --log-file string + + + If non-empty, use this log file + + --log-flush-frequency duration     Default: 5s @@ -187,6 +187,20 @@ kubectl [flags] If present, the namespace scope for this CLI request + + --profile string     Default: "none" + + + Name of profile to capture. One of (none|cpu|heap|goroutine|threadcreate|block|mutex) + + + + --profile-output string     Default: "profile.pprof" + + + Name of the file to write the profile to + + --request-timeout string     Default: "0" @@ -201,6 +215,13 @@ kubectl [flags] The address and port of the Kubernetes API server + + --skip-headers + + + If true, avoid header prefixes in the log messages + + --stderrthreshold severity     Default: 2 @@ -249,45 +270,45 @@ kubectl [flags] ### SEE ALSO -* [kubectl alpha](/docs/reference/generated/kubectl/kubectl-commands#alpha) - Commands for features in alpha -* [kubectl annotate](/docs/reference/generated/kubectl/kubectl-commands#annotate) - Update the annotations on a resource -* [kubectl api-resources](/docs/reference/generated/kubectl/kubectl-commands#api-resources) - Print the supported API resources on the server -* [kubectl api-versions](/docs/reference/generated/kubectl/kubectl-commands#api-versions) - Print the supported API versions on the server, in the form of "group/version" -* [kubectl apply](/docs/reference/generated/kubectl/kubectl-commands#apply) - Apply a configuration to a resource by filename or stdin -* [kubectl attach](/docs/reference/generated/kubectl/kubectl-commands#attach) - Attach to a running container -* [kubectl auth](/docs/reference/generated/kubectl/kubectl-commands#auth) - Inspect authorization -* [kubectl autoscale](/docs/reference/generated/kubectl/kubectl-commands#autoscale) - Auto-scale a Deployment, ReplicaSet, or ReplicationController -* [kubectl certificate](/docs/reference/generated/kubectl/kubectl-commands#certificate) - Modify certificate resources. -* [kubectl cluster-info](/docs/reference/generated/kubectl/kubectl-commands#cluster-info) - Display cluster info -* [kubectl completion](/docs/reference/generated/kubectl/kubectl-commands#completion) - Output shell completion code for the specified shell (bash or zsh) -* [kubectl config](/docs/reference/generated/kubectl/kubectl-commands#config) - Modify kubeconfig files -* [kubectl convert](/docs/reference/generated/kubectl/kubectl-commands#convert) - Convert config files between different API versions -* [kubectl cordon](/docs/reference/generated/kubectl/kubectl-commands#cordon) - Mark node as unschedulable -* [kubectl cp](/docs/reference/generated/kubectl/kubectl-commands#cp) - Copy files and directories to and from containers. -* [kubectl create](/docs/reference/generated/kubectl/kubectl-commands#create) - Create a resource from a file or from stdin. -* [kubectl delete](/docs/reference/generated/kubectl/kubectl-commands#delete) - Delete resources by filenames, stdin, resources and names, or by resources and label selector -* [kubectl describe](/docs/reference/generated/kubectl/kubectl-commands#describe) - Show details of a specific resource or group of resources -* [kubectl drain](/docs/reference/generated/kubectl/kubectl-commands#drain) - Drain node in preparation for maintenance -* [kubectl edit](/docs/reference/generated/kubectl/kubectl-commands#edit) - Edit a resource on the server -* [kubectl exec](/docs/reference/generated/kubectl/kubectl-commands#exec) - Execute a command in a container -* [kubectl explain](/docs/reference/generated/kubectl/kubectl-commands#explain) - Documentation of resources -* [kubectl expose](/docs/reference/generated/kubectl/kubectl-commands#expose) - Take a replication controller, service, deployment or pod and expose it as a new Kubernetes Service -* [kubectl get](/docs/reference/generated/kubectl/kubectl-commands#get) - Display one or many resources -* [kubectl label](/docs/reference/generated/kubectl/kubectl-commands#label) - Update the labels on a resource -* [kubectl logs](/docs/reference/generated/kubectl/kubectl-commands#logs) - Print the logs for a container in a pod -* [kubectl options](/docs/reference/generated/kubectl/kubectl-commands#options) - Print the list of flags inherited by all commands -* [kubectl patch](/docs/reference/generated/kubectl/kubectl-commands#patch) - Update field(s) of a resource using strategic merge patch -* [kubectl plugin](/docs/reference/generated/kubectl/kubectl-commands#plugin) - Provides utilities for interacting with plugins. -* [kubectl port-forward](/docs/reference/generated/kubectl/kubectl-commands#port-forward) - Forward one or more local ports to a pod -* [kubectl proxy](/docs/reference/generated/kubectl/kubectl-commands#proxy) - Run a proxy to the Kubernetes API server -* [kubectl replace](/docs/reference/generated/kubectl/kubectl-commands#replace) - Replace a resource by filename or stdin -* [kubectl rollout](/docs/reference/generated/kubectl/kubectl-commands#rollout) - Manage the rollout of a resource -* [kubectl run](/docs/reference/generated/kubectl/kubectl-commands#run) - Run a particular image on the cluster -* [kubectl scale](/docs/reference/generated/kubectl/kubectl-commands#scale) - Set a new size for a Deployment, ReplicaSet, Replication Controller, or Job -* [kubectl set](/docs/reference/generated/kubectl/kubectl-commands#set) - Set specific features on objects -* [kubectl taint](/docs/reference/generated/kubectl/kubectl-commands#taint) - Update the taints on one or more nodes -* [kubectl top](/docs/reference/generated/kubectl/kubectl-commands#top) - Display Resource (CPU/Memory/Storage) usage. -* [kubectl uncordon](/docs/reference/generated/kubectl/kubectl-commands#uncordon) - Mark node as schedulable -* [kubectl version](/docs/reference/generated/kubectl/kubectl-commands#version) - Print the client and server version information -* [kubectl wait](/docs/reference/generated/kubectl/kubectl-commands#wait) - Experimental: Wait for a specific condition on one or many resources. +* [kubectl annotate](kubectl_annotate.md) - Update the annotations on a resource +* [kubectl api-resources](kubectl_api-resources.md) - Print the supported API resources on the server +* [kubectl api-versions](kubectl_api-versions.md) - Print the supported API versions on the server, in the form of "group/version" +* [kubectl apply](kubectl_apply.md) - Apply a configuration to a resource by filename or stdin +* [kubectl attach](kubectl_attach.md) - Attach to a running container +* [kubectl auth](kubectl_auth.md) - Inspect authorization +* [kubectl autoscale](kubectl_autoscale.md) - Auto-scale a Deployment, ReplicaSet, or ReplicationController +* [kubectl certificate](kubectl_certificate.md) - Modify certificate resources. +* [kubectl cluster-info](kubectl_cluster-info.md) - Display cluster info +* [kubectl completion](kubectl_completion.md) - Output shell completion code for the specified shell (bash or zsh) +* [kubectl config](kubectl_config.md) - Modify kubeconfig files +* [kubectl convert](kubectl_convert.md) - Convert config files between different API versions +* [kubectl cordon](kubectl_cordon.md) - Mark node as unschedulable +* [kubectl cp](kubectl_cp.md) - Copy files and directories to and from containers. +* [kubectl create](kubectl_create.md) - Create a resource from a file or from stdin. +* [kubectl delete](kubectl_delete.md) - Delete resources by filenames, stdin, resources and names, or by resources and label selector +* [kubectl describe](kubectl_describe.md) - Show details of a specific resource or group of resources +* [kubectl diff](kubectl_diff.md) - Diff live version against would-be applied version +* [kubectl drain](kubectl_drain.md) - Drain node in preparation for maintenance +* [kubectl edit](kubectl_edit.md) - Edit a resource on the server +* [kubectl exec](kubectl_exec.md) - Execute a command in a container +* [kubectl explain](kubectl_explain.md) - Documentation of resources +* [kubectl expose](kubectl_expose.md) - Take a replication controller, service, deployment or pod and expose it as a new Kubernetes Service +* [kubectl get](kubectl_get.md) - Display one or many resources +* [kubectl label](kubectl_label.md) - Update the labels on a resource +* [kubectl logs](kubectl_logs.md) - Print the logs for a container in a pod +* [kubectl options](kubectl_options.md) - Print the list of flags inherited by all commands +* [kubectl patch](kubectl_patch.md) - Update field(s) of a resource using strategic merge patch +* [kubectl plugin](kubectl_plugin.md) - Provides utilities for interacting with plugins. +* [kubectl port-forward](kubectl_port-forward.md) - Forward one or more local ports to a pod +* [kubectl proxy](kubectl_proxy.md) - Run a proxy to the Kubernetes API server +* [kubectl replace](kubectl_replace.md) - Replace a resource by filename or stdin +* [kubectl rollout](kubectl_rollout.md) - Manage the rollout of a resource +* [kubectl run](kubectl_run.md) - Run a particular image on the cluster +* [kubectl scale](kubectl_scale.md) - Set a new size for a Deployment, ReplicaSet, Replication Controller, or Job +* [kubectl set](kubectl_set.md) - Set specific features on objects +* [kubectl taint](kubectl_taint.md) - Update the taints on one or more nodes +* [kubectl top](kubectl_top.md) - Display Resource (CPU/Memory/Storage) usage. +* [kubectl uncordon](kubectl_uncordon.md) - Mark node as schedulable +* [kubectl version](kubectl_version.md) - Print the client and server version information +* [kubectl wait](kubectl_wait.md) - Experimental: Wait for a specific condition on one or many resources. diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm.md index 66869de837879..3d114781675a5 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm.md @@ -5,32 +5,31 @@ kubeadm: easily bootstrap a secure Kubernetes cluster -kubeadm: easily bootstrap a secure Kubernetes cluster. ┌──────────────────────────────────────────────────────────┐ - │ KUBEADM IS CURRENTLY IN BETA │ + │ KUBEADM │ + │ Easily bootstrap a secure Kubernetes cluster │ │ │ - │ But please, try it out and give us feedback at: │ + │ Please give us feedback at: │ │ https://github.com/kubernetes/kubeadm/issues │ - │ and at-mention @kubernetes/sig-cluster-lifecycle-bugs │ - │ or @kubernetes/sig-cluster-lifecycle-feature-requests │ └──────────────────────────────────────────────────────────┘ Example usage: - Create a two-machine cluster with one master (which controls the cluster), - and one node (where your workloads, like Pods and Deployments run). + Create a two-machine cluster with one control-plane node + (which controls the cluster), and one worker node + (where your workloads, like Pods and Deployments run). ┌──────────────────────────────────────────────────────────┐ │ On the first machine: │ ├──────────────────────────────────────────────────────────┤ - │ master# kubeadm init │ + │ control-plane# kubeadm init │ └──────────────────────────────────────────────────────────┘ ┌──────────────────────────────────────────────────────────┐ │ On the second machine: │ ├──────────────────────────────────────────────────────────┤ - │ node# kubeadm join │ + │ worker# kubeadm join │ └──────────────────────────────────────────────────────────┘ You can then repeat the second step on as many other machines as you like. diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha.md index 9022c61dbc59d..ced9d4b528ee8 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha.md @@ -1,10 +1,10 @@ -Experimental sub-commands not yet fully functional. +Kubeadm experimental sub-commands ### Synopsis -Experimental sub-commands not yet fully functional. +Kubeadm experimental sub-commands ### Options diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_certs.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_certs.md new file mode 100644 index 0000000000000..8548203f74cc8 --- /dev/null +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_certs.md @@ -0,0 +1,50 @@ + +Commands related to handling kubernetes certificates + +### Synopsis + + +Commands related to handling kubernetes certificates + +### Options + + + + + + + + + + + + + + + + +
-h, --help
help for certs
+ + + +### Options inherited from parent commands + + + + + + + + + + + + + + + + +
--rootfs string
[EXPERIMENTAL] The path to the 'real' host root filesystem.
+ + + diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_renew.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_certs_renew.md similarity index 95% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_renew.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_certs_renew.md index 348c268eede5c..f212b9e12be0f 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_renew.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_certs_renew.md @@ -7,7 +7,7 @@ Renews certificates for a Kubernetes cluster This command is not meant to be run on its own. See list of available subcommands. ``` -kubeadm alpha phase certs renew [flags] +kubeadm alpha certs renew [flags] ``` ### Options diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_renew_all.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_certs_renew_all.md similarity index 77% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_renew_all.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_certs_renew_all.md index c5fd726b3c979..60fa27fb569eb 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_renew_all.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_certs_renew_all.md @@ -7,7 +7,7 @@ renew all available certificates Renews all known certificates necessary to run the control plan. Renewals are run unconditionally, regardless of expiration date. Renewals can also be run individually for more control. ``` -kubeadm alpha phase certs renew all [flags] +kubeadm alpha certs renew all [flags] ``` ### Options @@ -30,7 +30,21 @@ kubeadm alpha phase certs renew all [flags] --config string - Path to kubeadm config file (WARNING: Usage of a configuration file is experimental) + Path to a kubeadm configuration file. + + + + --csr-dir string + + + The path to output the CSRs and private keys to + + + + --csr-only + + + Create CSRs instead of generating certificates @@ -44,7 +58,7 @@ kubeadm alpha phase certs renew all [flags] --kubeconfig string     Default: "/etc/kubernetes/admin.conf" - The KubeConfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. + The kubeconfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_renew_apiserver-etcd-client.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_certs_renew_apiserver-etcd-client.md similarity index 78% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_renew_apiserver-etcd-client.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_certs_renew_apiserver-etcd-client.md index 255b18b0d103c..3489a9d6773ab 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_renew_apiserver-etcd-client.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_certs_renew_apiserver-etcd-client.md @@ -9,7 +9,7 @@ Renews the client apiserver uses to access etcd, and saves them into apiserver-e Extra attributes such as SANs will be based on the existing certificates, there is no need to resupply them. ``` -kubeadm alpha phase certs renew apiserver-etcd-client [flags] +kubeadm alpha certs renew apiserver-etcd-client [flags] ``` ### Options @@ -32,7 +32,21 @@ kubeadm alpha phase certs renew apiserver-etcd-client [flags] --config string - Path to kubeadm config file (WARNING: Usage of a configuration file is experimental) + Path to a kubeadm configuration file. + + + + --csr-dir string + + + The path to output the CSRs and private keys to + + + + --csr-only + + + Create CSRs instead of generating certificates @@ -46,7 +60,7 @@ kubeadm alpha phase certs renew apiserver-etcd-client [flags] --kubeconfig string     Default: "/etc/kubernetes/admin.conf" - The KubeConfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. + The kubeconfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_renew_apiserver-kubelet-client.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_certs_renew_apiserver-kubelet-client.md similarity index 78% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_renew_apiserver-kubelet-client.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_certs_renew_apiserver-kubelet-client.md index 1fc536f2acf27..b6e5f7406f76e 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_renew_apiserver-kubelet-client.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_certs_renew_apiserver-kubelet-client.md @@ -9,7 +9,7 @@ Renews the Client certificate for the API server to connect to kubelet, and save Extra attributes such as SANs will be based on the existing certificates, there is no need to resupply them. ``` -kubeadm alpha phase certs renew apiserver-kubelet-client [flags] +kubeadm alpha certs renew apiserver-kubelet-client [flags] ``` ### Options @@ -32,7 +32,21 @@ kubeadm alpha phase certs renew apiserver-kubelet-client [flags] --config string - Path to kubeadm config file (WARNING: Usage of a configuration file is experimental) + Path to a kubeadm configuration file. + + + + --csr-dir string + + + The path to output the CSRs and private keys to + + + + --csr-only + + + Create CSRs instead of generating certificates @@ -46,7 +60,7 @@ kubeadm alpha phase certs renew apiserver-kubelet-client [flags] --kubeconfig string     Default: "/etc/kubernetes/admin.conf" - The KubeConfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. + The kubeconfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_renew_apiserver.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_certs_renew_apiserver.md similarity index 73% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_renew_apiserver.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_certs_renew_apiserver.md index c56b907b9917f..d45c3ca73a6be 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_renew_apiserver.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_certs_renew_apiserver.md @@ -1,15 +1,15 @@ -Generates the certificate for serving the kubernetes API +Generates the certificate for serving the Kubernetes API ### Synopsis -Renews the certificate for serving the kubernetes API, and saves them into apiserver.cert and apiserver.key files. +Renews the certificate for serving the Kubernetes API, and saves them into apiserver.cert and apiserver.key files. Extra attributes such as SANs will be based on the existing certificates, there is no need to resupply them. ``` -kubeadm alpha phase certs renew apiserver [flags] +kubeadm alpha certs renew apiserver [flags] ``` ### Options @@ -32,7 +32,21 @@ kubeadm alpha phase certs renew apiserver [flags] --config string - Path to kubeadm config file (WARNING: Usage of a configuration file is experimental) + Path to a kubeadm configuration file. + + + + --csr-dir string + + + The path to output the CSRs and private keys to + + + + --csr-only + + + Create CSRs instead of generating certificates @@ -46,7 +60,7 @@ kubeadm alpha phase certs renew apiserver [flags] --kubeconfig string     Default: "/etc/kubernetes/admin.conf" - The KubeConfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. + The kubeconfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_renew_etcd-healthcheck-client.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_certs_renew_etcd-healthcheck-client.md similarity index 78% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_renew_etcd-healthcheck-client.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_certs_renew_etcd-healthcheck-client.md index 1ecafc8366871..3c798047f3975 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_renew_etcd-healthcheck-client.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_certs_renew_etcd-healthcheck-client.md @@ -9,7 +9,7 @@ Renews the client certificate for liveness probes to healtcheck etcd, and saves Extra attributes such as SANs will be based on the existing certificates, there is no need to resupply them. ``` -kubeadm alpha phase certs renew etcd-healthcheck-client [flags] +kubeadm alpha certs renew etcd-healthcheck-client [flags] ``` ### Options @@ -32,7 +32,21 @@ kubeadm alpha phase certs renew etcd-healthcheck-client [flags] --config string - Path to kubeadm config file (WARNING: Usage of a configuration file is experimental) + Path to a kubeadm configuration file. + + + + --csr-dir string + + + The path to output the CSRs and private keys to + + + + --csr-only + + + Create CSRs instead of generating certificates @@ -46,7 +60,7 @@ kubeadm alpha phase certs renew etcd-healthcheck-client [flags] --kubeconfig string     Default: "/etc/kubernetes/admin.conf" - The KubeConfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. + The kubeconfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_renew_etcd-peer.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_certs_renew_etcd-peer.md similarity index 78% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_renew_etcd-peer.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_certs_renew_etcd-peer.md index 75da17a311108..b8cf86bad1444 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_renew_etcd-peer.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_certs_renew_etcd-peer.md @@ -9,7 +9,7 @@ Renews the credentials for etcd nodes to communicate with each other, and saves Extra attributes such as SANs will be based on the existing certificates, there is no need to resupply them. ``` -kubeadm alpha phase certs renew etcd-peer [flags] +kubeadm alpha certs renew etcd-peer [flags] ``` ### Options @@ -32,7 +32,21 @@ kubeadm alpha phase certs renew etcd-peer [flags] --config string - Path to kubeadm config file (WARNING: Usage of a configuration file is experimental) + Path to a kubeadm configuration file. + + + + --csr-dir string + + + The path to output the CSRs and private keys to + + + + --csr-only + + + Create CSRs instead of generating certificates @@ -46,7 +60,7 @@ kubeadm alpha phase certs renew etcd-peer [flags] --kubeconfig string     Default: "/etc/kubernetes/admin.conf" - The KubeConfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. + The kubeconfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_renew_etcd-server.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_certs_renew_etcd-server.md similarity index 78% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_renew_etcd-server.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_certs_renew_etcd-server.md index a44a852aeb0fe..123111cd5557a 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_renew_etcd-server.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_certs_renew_etcd-server.md @@ -9,7 +9,7 @@ Renews the certificate for serving etcd, and saves them into etcd/server.cert an Extra attributes such as SANs will be based on the existing certificates, there is no need to resupply them. ``` -kubeadm alpha phase certs renew etcd-server [flags] +kubeadm alpha certs renew etcd-server [flags] ``` ### Options @@ -32,7 +32,21 @@ kubeadm alpha phase certs renew etcd-server [flags] --config string - Path to kubeadm config file (WARNING: Usage of a configuration file is experimental) + Path to a kubeadm configuration file. + + + + --csr-dir string + + + The path to output the CSRs and private keys to + + + + --csr-only + + + Create CSRs instead of generating certificates @@ -46,7 +60,7 @@ kubeadm alpha phase certs renew etcd-server [flags] --kubeconfig string     Default: "/etc/kubernetes/admin.conf" - The KubeConfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. + The kubeconfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_renew_front-proxy-client.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_certs_renew_front-proxy-client.md similarity index 78% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_renew_front-proxy-client.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_certs_renew_front-proxy-client.md index 41ad8887a17ed..ed9f18495a7ea 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_renew_front-proxy-client.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_certs_renew_front-proxy-client.md @@ -9,7 +9,7 @@ Renews the client for the front proxy, and saves them into front-proxy-client.ce Extra attributes such as SANs will be based on the existing certificates, there is no need to resupply them. ``` -kubeadm alpha phase certs renew front-proxy-client [flags] +kubeadm alpha certs renew front-proxy-client [flags] ``` ### Options @@ -32,7 +32,21 @@ kubeadm alpha phase certs renew front-proxy-client [flags] --config string - Path to kubeadm config file (WARNING: Usage of a configuration file is experimental) + Path to a kubeadm configuration file. + + + + --csr-dir string + + + The path to output the CSRs and private keys to + + + + --csr-only + + + Create CSRs instead of generating certificates @@ -46,7 +60,7 @@ kubeadm alpha phase certs renew front-proxy-client [flags] --kubeconfig string     Default: "/etc/kubernetes/admin.conf" - The KubeConfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. + The kubeconfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_kubeconfig.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_kubeconfig.md new file mode 100644 index 0000000000000..24b0f4d901330 --- /dev/null +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_kubeconfig.md @@ -0,0 +1,52 @@ + +Kubeconfig file utilities + +### Synopsis + + +Kubeconfig file utilities. + + Alpha Disclaimer: this command is currently alpha. + +### Options + + + + + + + + + + + + + + + + +
-h, --help
help for kubeconfig
+ + + +### Options inherited from parent commands + + + + + + + + + + + + + + + + +
--rootfs string
[EXPERIMENTAL] The path to the 'real' host root filesystem.
+ + + diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubeconfig_user.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_kubeconfig_user.md similarity index 85% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubeconfig_user.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_kubeconfig_user.md index 9f7c0d92f0add..c12f50d3cf718 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubeconfig_user.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_kubeconfig_user.md @@ -6,17 +6,17 @@ Outputs a kubeconfig file for an additional user Outputs a kubeconfig file for an additional user. -Alpha Disclaimer: this command is currently alpha. + Alpha Disclaimer: this command is currently alpha. ``` -kubeadm alpha phase kubeconfig user [flags] +kubeadm alpha kubeconfig user [flags] ``` ### Examples ``` # Outputs a kubeconfig file for an additional user named foo - kubeadm alpha phase kubeconfig user --client-name=foo + kubeadm alpha kubeconfig user --client-name=foo ``` ### Options @@ -63,13 +63,6 @@ kubeadm alpha phase kubeconfig user [flags] help for user - - --kubeconfig-dir string     Default: "/etc/kubernetes" - - - The path where to save the kubeconfig file - - --org stringSlice diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubelet.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_kubelet.md similarity index 95% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubelet.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_kubelet.md index 648b219e76e90..5479cf594e084 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubelet.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_kubelet.md @@ -1,5 +1,5 @@ -Commands related to handling the kubelet. +Commands related to handling the kubelet ### Synopsis diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubelet_config.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_kubelet_config.md similarity index 96% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubelet_config.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_kubelet_config.md index 2c2d8ca00467b..be9d4fcc26935 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubelet_config.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_kubelet_config.md @@ -1,5 +1,5 @@ -Handles kubelet configuration. +Utilities for kubelet configuration ### Synopsis diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubelet_config_download.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_kubelet_config_download.md similarity index 95% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubelet_config_download.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_kubelet_config_download.md index 8f1118ee1e072..20ad0bbf4c53c 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubelet_config_download.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_kubelet_config_download.md @@ -9,7 +9,7 @@ Downloads the kubelet configuration from a ConfigMap of the form "kubelet-config Alpha Disclaimer: this command is currently alpha. ``` -kubeadm alpha phase kubelet config download [flags] +kubeadm alpha kubelet config download [flags] ``` ### Examples @@ -42,7 +42,7 @@ kubeadm alpha phase kubelet config download [flags] --kubeconfig string     Default: "/etc/kubernetes/kubelet.conf" - The KubeConfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. + The kubeconfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubelet_config_enable-dynamic.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_kubelet_config_enable-dynamic.md similarity index 95% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubelet_config_enable-dynamic.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_kubelet_config_enable-dynamic.md index 91bf90d15e8b8..fdad69928b9a0 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubelet_config_enable-dynamic.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_kubelet_config_enable-dynamic.md @@ -11,7 +11,7 @@ WARNING: This feature is still experimental, and disabled by default. Enable onl Alpha Disclaimer: this command is currently alpha. ``` -kubeadm alpha phase kubelet config enable-dynamic [flags] +kubeadm alpha kubelet config enable-dynamic [flags] ``` ### Examples @@ -44,7 +44,7 @@ kubeadm alpha phase kubelet config enable-dynamic [flags] --kubeconfig string     Default: "/etc/kubernetes/admin.conf" - The KubeConfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. + The kubeconfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_bootstrap-token_all.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_bootstrap-token_all.md deleted file mode 100644 index 0169c68221815..0000000000000 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_bootstrap-token_all.md +++ /dev/null @@ -1,122 +0,0 @@ - -Makes all the bootstrap token configurations and creates an initial token - -### Synopsis - - -Bootstrap tokens are used for establishing bidirectional trust between a node joining the cluster and a the master node. - -This command makes all the configurations required to make bootstrap tokens works and then creates an initial token. - -Alpha Disclaimer: this command is currently alpha. - -``` -kubeadm alpha phase bootstrap-token all [flags] -``` - -### Examples - -``` - # Makes all the bootstrap token configurations and creates an initial token, functionally - # equivalent to what generated by kubeadm init. - kubeadm alpha phase bootstrap-token all -``` - -### Options - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
--config string
Path to kubeadm config file. WARNING: Usage of a configuration file is experimental
--description string
A human friendly description of how this token is used.
--groups stringSlice     Default: [system:bootstrappers:kubeadm:default-node-token]
Extra groups that this token will authenticate as when used for authentication. Must match "\\Asystem:bootstrappers:[a-z0-9:-]{0,255}[a-z0-9]\\z"
-h, --help
help for all
--skip-token-print
Skip printing of the bootstrap token
--token string
The token to use for establishing bidirectional trust between nodes and masters. The format is [a-z0-9]{6}\.[a-z0-9]{16} - e.g. abcdef.0123456789abcdef
--token-ttl duration     Default: 24h0m0s
The duration before the token is automatically deleted (e.g. 1s, 2m, 3h). If set to '0', the token will never expire
--usages stringSlice     Default: [signing,authentication]
Describes the ways in which this token can be used. You can pass --usages multiple times or provide a comma separated list of options. Valid options: [signing,authentication]
- - - -### Options inherited from parent commands - - - - - - - - - - - - - - - - - - - - - - - -
--kubeconfig string     Default: "/etc/kubernetes/admin.conf"
The KubeConfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file.
--rootfs string
[EXPERIMENTAL] The path to the 'real' host root filesystem.
- - - diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_bootstrap-token_cluster-info.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_bootstrap-token_cluster-info.md deleted file mode 100644 index 5cc7f3fc05be5..0000000000000 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_bootstrap-token_cluster-info.md +++ /dev/null @@ -1,65 +0,0 @@ - -Uploads the cluster-info ConfigMap from the given kubeconfig file - -### Synopsis - - -Uploads the "cluster-info" ConfigMap in the "kube-public" namespace, populating it with cluster information extracted from the given kubeconfig file. The ConfigMap is used for the node bootstrap process in its initial phases, before the client trusts the API server. - -See online documentation about Authenticating with Bootstrap Tokens for more details. - -Alpha Disclaimer: this command is currently alpha. - -``` -kubeadm alpha phase bootstrap-token cluster-info [flags] -``` - -### Options - - - - - - - - - - - - - - - - -
-h, --help
help for cluster-info
- - - -### Options inherited from parent commands - - - - - - - - - - - - - - - - - - - - - - - -
--kubeconfig string     Default: "/etc/kubernetes/admin.conf"
The KubeConfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file.
--rootfs string
[EXPERIMENTAL] The path to the 'real' host root filesystem.
- - - diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_bootstrap-token_create.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_bootstrap-token_create.md deleted file mode 100644 index aed484bb388ad..0000000000000 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_bootstrap-token_create.md +++ /dev/null @@ -1,114 +0,0 @@ - -Creates a bootstrap token to be used for node joining - -### Synopsis - - -Creates a bootstrap token. If no token value is given, kubeadm will generate a random token instead. - -Alternatively, you can use kubeadm token. - -Alpha Disclaimer: this command is currently alpha. - -``` -kubeadm alpha phase bootstrap-token create [flags] -``` - -### Options - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
--config string
Path to kubeadm config file. WARNING: Usage of a configuration file is experimental
--description string
A human friendly description of how this token is used.
--groups stringSlice     Default: [system:bootstrappers:kubeadm:default-node-token]
Extra groups that this token will authenticate as when used for authentication. Must match "\\Asystem:bootstrappers:[a-z0-9:-]{0,255}[a-z0-9]\\z"
-h, --help
help for create
--skip-token-print
Skip printing of the bootstrap token
--token string
The token to use for establishing bidirectional trust between nodes and masters. The format is [a-z0-9]{6}\.[a-z0-9]{16} - e.g. abcdef.0123456789abcdef
--token-ttl duration     Default: 24h0m0s
The duration before the token is automatically deleted (e.g. 1s, 2m, 3h). If set to '0', the token will never expire
--usages stringSlice     Default: [signing,authentication]
Describes the ways in which this token can be used. You can pass --usages multiple times or provide a comma separated list of options. Valid options: [signing,authentication]
- - - -### Options inherited from parent commands - - - - - - - - - - - - - - - - - - - - - - - -
--kubeconfig string     Default: "/etc/kubernetes/admin.conf"
The KubeConfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file.
--rootfs string
[EXPERIMENTAL] The path to the 'real' host root filesystem.
- - - diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_bootstrap-token_node_allow-auto-approve.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_bootstrap-token_node_allow-auto-approve.md deleted file mode 100644 index 405ece9bce9ab..0000000000000 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_bootstrap-token_node_allow-auto-approve.md +++ /dev/null @@ -1,65 +0,0 @@ - -Configures RBAC rules to allow the csrapprover controller automatically approve CSRs from a node bootstrap token - -### Synopsis - - -Configures RBAC rules to allow the csrapprover controller to automatically approve certificate signing requests generated by nodes joining the cluster. It configures also RBAC rules for certificates rotation (with auto approval of new certificates). - -See online documentation about TLS bootstrapping for more details. - -Alpha Disclaimer: this command is currently alpha. - -``` -kubeadm alpha phase bootstrap-token node allow-auto-approve [flags] -``` - -### Options - - - - - - - - - - - - - - - - -
-h, --help
help for allow-auto-approve
- - - -### Options inherited from parent commands - - - - - - - - - - - - - - - - - - - - - - - -
--kubeconfig string     Default: "/etc/kubernetes/admin.conf"
The KubeConfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file.
--rootfs string
[EXPERIMENTAL] The path to the 'real' host root filesystem.
- - - diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_bootstrap-token_node_allow-post-csrs.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_bootstrap-token_node_allow-post-csrs.md deleted file mode 100644 index 8aee98f2ec4f7..0000000000000 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_bootstrap-token_node_allow-post-csrs.md +++ /dev/null @@ -1,65 +0,0 @@ - -Configures RBAC to allow node bootstrap tokens to post CSRs in order for nodes to get long term certificate credentials - -### Synopsis - - -Configures RBAC rules to allow node bootstrap tokens to post a certificate signing request, thus enabling nodes joining the cluster to request long term certificate credentials. - -See online documentation about TLS bootstrapping for more details. - -Alpha Disclaimer: this command is currently alpha. - -``` -kubeadm alpha phase bootstrap-token node allow-post-csrs [flags] -``` - -### Options - - - - - - - - - - - - - - - - -
-h, --help
help for allow-post-csrs
- - - -### Options inherited from parent commands - - - - - - - - - - - - - - - - - - - - - - - -
--kubeconfig string     Default: "/etc/kubernetes/admin.conf"
The KubeConfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file.
--rootfs string
[EXPERIMENTAL] The path to the 'real' host root filesystem.
- - - diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_all.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_all.md deleted file mode 100644 index 07916e76e8e38..0000000000000 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_all.md +++ /dev/null @@ -1,111 +0,0 @@ - -Generates all PKI assets necessary to establish the control plane - -### Synopsis - - -Generates a self-signed CA to provision identities for each component in the cluster (including nodes) and client certificates to be used by various components. - -If a given certificate and private key pair both exist, kubeadm skips the generation step and existing files will be used. - -Alpha Disclaimer: this command is currently alpha. - -``` -kubeadm alpha phase certs all [flags] -``` - -### Examples - -``` - # Creates all PKI assets necessary to establish the control plane, - # functionally equivalent to what generated by kubeadm init. - kubeadm alpha phase certs all - - # Creates all PKI assets using options read from a configuration file. - kubeadm alpha phase certs all --config masterconfiguration.yaml -``` - -### Options - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
--apiserver-advertise-address string
The IP address the API server is accessible on, to use for the API server serving cert
--apiserver-cert-extra-sans stringSlice
Optional extra altnames to use for the API server serving cert. Can be both IP addresses and DNS names
--cert-dir string     Default: "/etc/kubernetes/pki"
The path where to save the certificates
--config string
Path to kubeadm config file (WARNING: Usage of a configuration file is experimental)
-h, --help
help for all
--service-cidr string     Default: "10.96.0.0/12"
Alternative range of IP address for service VIPs, from which derives the internal API server VIP that will be added to the API Server serving cert
--service-dns-domain string     Default: "cluster.local"
Alternative domain for services, to use for the API server serving cert
- - - -### Options inherited from parent commands - - - - - - - - - - - - - - - - -
--rootfs string
[EXPERIMENTAL] The path to the 'real' host root filesystem.
- - - diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubeconfig_all.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubeconfig_all.md deleted file mode 100644 index ffb3610e9bcca..0000000000000 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubeconfig_all.md +++ /dev/null @@ -1,109 +0,0 @@ - -Generates all kubeconfig files necessary to establish the control plane and the admin kubeconfig file - -### Synopsis - - -Generates all kubeconfig files necessary to establish the control plane and the admin kubeconfig file. - -Alpha Disclaimer: this command is currently alpha. - -``` -kubeadm alpha phase kubeconfig all [flags] -``` - -### Examples - -``` - # Generates all kubeconfig files, functionally equivalent to what generated - # by kubeadm init. - kubeadm alpha phase kubeconfig all - - # Generates all kubeconfig files using options read from a configuration file. - kubeadm alpha phase kubeconfig all --config masterconfiguration.yaml -``` - -### Options - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
--apiserver-advertise-address string
The IP address the API server is accessible on
--apiserver-bind-port int32     Default: 6443
The port the API server is accessible on
--cert-dir string     Default: "/etc/kubernetes/pki"
The path where certificates are stored
--config string
Path to kubeadm config file. WARNING: Usage of a configuration file is experimental
-h, --help
help for all
--kubeconfig-dir string     Default: "/etc/kubernetes"
The path where to save the kubeconfig file
--node-name string
The node name that should be used for the kubelet client certificate
- - - -### Options inherited from parent commands - - - - - - - - - - - - - - - - -
--rootfs string
[EXPERIMENTAL] The path to the 'real' host root filesystem.
- - - diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubelet_config_write-to-disk.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubelet_config_write-to-disk.md deleted file mode 100644 index 02eaee18e03cf..0000000000000 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubelet_config_write-to-disk.md +++ /dev/null @@ -1,70 +0,0 @@ - -Writes kubelet configuration to disk, either based on the --config argument. - -### Synopsis - - -Writes kubelet configuration to disk, based on the kubeadm configuration passed via "--config". - -Alpha Disclaimer: this command is currently alpha. - -``` -kubeadm alpha phase kubelet config write-to-disk [flags] -``` - -### Examples - -``` - # Extracts the kubelet configuration from a kubeadm configuration file - kubeadm alpha phase kubelet config write-to-disk --config kubeadm.yaml -``` - -### Options - - - - - - - - - - - - - - - - - - - - - - - -
--config string
Path to kubeadm config file (WARNING: Usage of a configuration file is experimental)
-h, --help
help for write-to-disk
- - - -### Options inherited from parent commands - - - - - - - - - - - - - - - - -
--rootfs string
[EXPERIMENTAL] The path to the 'real' host root filesystem.
- - - diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubelet_write-env-file.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubelet_write-env-file.md deleted file mode 100644 index eadafa78ddfdc..0000000000000 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubelet_write-env-file.md +++ /dev/null @@ -1,73 +0,0 @@ - -Writes an environment file with runtime flags for the kubelet. - -### Synopsis - - -Writes an environment file with flags that should be passed to the kubelet executing on the master or node. This --config flag can either consume a InitConfiguration object or a JoinConfiguration one, as this function is used for both "kubeadm init" and "kubeadm join". - -Alpha Disclaimer: this command is currently alpha. - -``` -kubeadm alpha phase kubelet write-env-file [flags] -``` - -### Examples - -``` - # Writes a dynamic environment file with kubelet flags from a InitConfiguration file. - kubeadm alpha phase kubelet write-env-file --config masterconfig.yaml - - # Writes a dynamic environment file with kubelet flags from a JoinConfiguration file. - kubeadm alpha phase kubelet write-env-file --config nodeconfig.yaml -``` - -### Options - - - - - - - - - - - - - - - - - - - - - - - -
--config string
Path to kubeadm config file (WARNING: Usage of a configuration file is experimental)
-h, --help
help for write-env-file
- - - -### Options inherited from parent commands - - - - - - - - - - - - - - - - -
--rootfs string
[EXPERIMENTAL] The path to the 'real' host root filesystem.
- - - diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_preflight.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_preflight.md deleted file mode 100644 index b41e864631991..0000000000000 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_preflight.md +++ /dev/null @@ -1,64 +0,0 @@ - -Run pre-flight checks - -### Synopsis - - -This command is not meant to be run on its own. See list of available subcommands. - -### Options - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
--config string
Path to kubeadm config file (WARNING: Usage of a configuration file is experimental)
-h, --help
help for preflight
--ignore-preflight-errors stringSlice
A list of checks whose errors will be shown as warnings. Example: 'IsPrivilegedUser,Swap'. Value 'all' ignores errors from all checks.
- - - -### Options inherited from parent commands - - - - - - - - - - - - - - - - -
--rootfs string
[EXPERIMENTAL] The path to the 'real' host root filesystem.
- - - diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_etcd.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_preflight.md similarity index 92% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_etcd.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_preflight.md index 60819008a3c7f..d88f71b0d9204 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_etcd.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_preflight.md @@ -1,5 +1,5 @@ -Generates static Pod manifest file for etcd. +Commands related to pre-flight checks ### Synopsis @@ -19,7 +19,7 @@ This command is not meant to be run on its own. See list of available subcommand -h, --help - help for etcd + help for preflight diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_preflight_node.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_preflight_node.md similarity index 89% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_preflight_node.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_preflight_node.md index 2c0cfe2247d9b..47be57c832538 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_preflight_node.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_preflight_node.md @@ -9,14 +9,14 @@ Run node pre-flight checks, functionally equivalent to what implemented by kubea Alpha Disclaimer: this command is currently alpha. ``` -kubeadm alpha phase preflight node [flags] +kubeadm alpha preflight node [flags] ``` ### Examples ``` # Run node pre-flight checks. - kubeadm alpha phase preflight node + kubeadm alpha preflight node ``` ### Options @@ -28,6 +28,13 @@ kubeadm alpha phase preflight node [flags] + + --config string + + + Path to a kubeadm configuration file. + + -h, --help @@ -35,6 +42,13 @@ kubeadm alpha phase preflight node [flags] help for node + + --ignore-preflight-errors stringSlice + + + A list of checks whose errors will be shown as warnings. Example: 'IsPrivilegedUser,Swap'. Value 'all' ignores errors from all checks. + + @@ -49,20 +63,6 @@ kubeadm alpha phase preflight node [flags] - - --config string - - - Path to kubeadm config file (WARNING: Usage of a configuration file is experimental) - - - - --ignore-preflight-errors stringSlice - - - A list of checks whose errors will be shown as warnings. Example: 'IsPrivilegedUser,Swap'. Value 'all' ignores errors from all checks. - - --rootfs string diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_selfhosting.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_selfhosting.md similarity index 100% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_selfhosting.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_selfhosting.md diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_selfhosting_convert-from-staticpods.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_selfhosting_pivot.md similarity index 76% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_selfhosting_convert-from-staticpods.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_selfhosting_pivot.md index fc403a9d46578..4f04e48126a6b 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_selfhosting_convert-from-staticpods.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_selfhosting_pivot.md @@ -11,17 +11,15 @@ See the documentation for self-hosting limitations. Alpha Disclaimer: this command is currently alpha. ``` -kubeadm alpha phase selfhosting convert-from-staticpods [flags] +kubeadm alpha selfhosting pivot [flags] ``` ### Examples ``` - # Converts a static Pod-hosted control plane into a self-hosted one, - # functionally equivalent to what generated by kubeadm init executed - # with --feature-gates=SelfHosting=true. + # Converts a static Pod-hosted control plane into a self-hosted one. - kubeadm alpha phase selfhosting convert-from-staticpods + kubeadm alpha phase self-hosting convert-from-staticpods ``` ### Options @@ -48,24 +46,31 @@ kubeadm alpha phase selfhosting convert-from-staticpods [flags] - --feature-gates string + -f, --force - 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 (BETA - default=false) + Pivot the cluster without prompting for confirmation -h, --help - help for convert-from-staticpods + help for pivot --kubeconfig string     Default: "/etc/kubernetes/admin.conf" - The KubeConfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. + The kubeconfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. + + + + -s, --store-certs-in-secrets + + + Enable storing certs in secrets diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config.md index b84059532066d..6c615daacd689 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config.md @@ -35,7 +35,7 @@ kubeadm config [flags] --kubeconfig string     Default: "/etc/kubernetes/admin.conf" - The KubeConfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. + The kubeconfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config_images.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config_images.md index ee309006b8d29..4b1073d17b69d 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config_images.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config_images.md @@ -44,7 +44,7 @@ kubeadm config images [flags] --kubeconfig string     Default: "/etc/kubernetes/admin.conf" - The KubeConfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. + The kubeconfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config_images_list.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config_images_list.md index 345d8328986ea..fac2d052f2a47 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config_images_list.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config_images_list.md @@ -30,7 +30,7 @@ kubeadm config images list [flags] --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 (BETA - default=false) + A set of key=value pairs that describe feature gates for various features. Options are:
@@ -65,7 +65,7 @@ kubeadm config images list [flags] --kubeconfig string     Default: "/etc/kubernetes/admin.conf" - The KubeConfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. + The kubeconfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config_images_pull.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config_images_pull.md index 83b3a6c10ccfc..7cb2173a265b1 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config_images_pull.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config_images_pull.md @@ -37,7 +37,7 @@ kubeadm config images pull [flags] --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 (BETA - default=false) + A set of key=value pairs that describe feature gates for various features. Options are:
@@ -72,7 +72,7 @@ kubeadm config images pull [flags] --kubeconfig string     Default: "/etc/kubernetes/admin.conf" - The KubeConfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. + The kubeconfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config_migrate.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config_migrate.md index eff30744e38eb..6d84dbd52620a 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config_migrate.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config_migrate.md @@ -8,10 +8,10 @@ Read an older version of the kubeadm configuration API types from a file, and ou 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/v1alpha3 +- kubeadm.k8s.io/v1beta1 -Further, kubeadm can only write out config of version "kubeadm.k8s.io/v1alpha3", but read both types. +Further, kubeadm can only write out config of version "kubeadm.k8s.io/v1beta1", 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. @@ -72,7 +72,7 @@ kubeadm config migrate [flags] --kubeconfig string     Default: "/etc/kubernetes/admin.conf" - The KubeConfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. + The kubeconfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_bootstrap-token_node.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config_print.md similarity index 83% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_bootstrap-token_node.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config_print.md index ef5cab6139750..ea98b1fa30b67 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_bootstrap-token_node.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config_print.md @@ -1,10 +1,14 @@ -Configures the node bootstrap process +Print configuration ### Synopsis -This command is not meant to be run on its own. See list of available subcommands. +This command prints configurations for subcommands provided. + +``` +kubeadm config print [flags] +``` ### Options @@ -19,7 +23,7 @@ This command is not meant to be run on its own. See list of available subcommand -h, --help - help for node + help for print @@ -40,7 +44,7 @@ This command is not meant to be run on its own. See list of available subcommand --kubeconfig string     Default: "/etc/kubernetes/admin.conf" - The KubeConfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. + The kubeconfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config_print-default.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config_print_init-defaults.md similarity index 61% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config_print-default.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config_print_init-defaults.md index ede571108cdde..afdc7c3d4efe9 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config_print-default.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config_print_init-defaults.md @@ -1,19 +1,18 @@ -Print the default values for a kubeadm configuration object. +Print default init configuration, that can be used for 'kubeadm init' ### Synopsis -This command prints the default InitConfiguration object that is used for 'kubeadm init' and 'kubeadm upgrade', -and the default JoinConfiguration object that is used for 'kubeadm join'. +This command prints objects such as the default init configuration that is used for 'kubeadm init'. -Note that sensitive values like the Bootstrap Token fields are replaced with silly values like {"abcdef.0123456789abcdef" "" "nil" [] []} in order to pass validation but +Note that sensitive values like the Bootstrap Token fields are replaced with placeholder values like {"abcdef.0123456789abcdef" "" "nil" [] []} in order to pass validation but not perform the real computation for creating a token. ``` -kubeadm config print-default [flags] +kubeadm config print init-defaults [flags] ``` ### Options @@ -26,17 +25,17 @@ kubeadm config print-default [flags] - --api-objects stringSlice + --component-configs stringSlice - A comma-separated list for API objects to print the default values for. Available values: [InitConfiguration ClusterConfiguration JoinConfiguration KubeProxyConfiguration KubeletConfiguration MasterConfiguration]. This flag unset means 'print all known objects' + A comma-separated list for component config API objects to print the default values for. Available values: [KubeProxyConfiguration KubeletConfiguration]. If this flag is not set, no component configs will be printed. -h, --help - help for print-default + help for init-defaults @@ -57,7 +56,7 @@ kubeadm config print-default [flags] --kubeconfig string     Default: "/etc/kubernetes/admin.conf" - The KubeConfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. + The kubeconfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_upload-config.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config_print_join-defaults.md similarity index 59% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_upload-config.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config_print_join-defaults.md index 657b6430042f8..d26a83dc92fda 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_upload-config.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config_print_join-defaults.md @@ -1,24 +1,18 @@ -Uploads the currently used configuration for kubeadm to a ConfigMap +Print default join configuration, that can be used for 'kubeadm join' ### Synopsis -Uploads the kubeadm init configuration of your cluster to a ConfigMap called kubeadm-config in the kube-system namespace. This enables correct configuration of system components and a seamless user experience when upgrading. -Alternatively, you can use kubeadm config. +This command prints objects such as the default join configuration that is used for 'kubeadm join'. -Alpha Disclaimer: this command is currently alpha. +Note that sensitive values like the Bootstrap Token fields are replaced with placeholder values like {"abcdef.0123456789abcdef" "" "nil" [] []} in order to pass validation but +not perform the real computation for creating a token. -``` -kubeadm alpha phase upload-config [flags] -``` - -### Examples ``` - # uploads the configuration of your cluster - kubeadm alpha phase upload-config --config=myConfig.yaml +kubeadm config print join-defaults [flags] ``` ### Options @@ -31,24 +25,17 @@ kubeadm alpha phase upload-config [flags] - --config string + --component-configs stringSlice - Path to a kubeadm config file. WARNING: Usage of a configuration file is experimental + A comma-separated list for component config API objects to print the default values for. Available values: [KubeProxyConfiguration KubeletConfiguration]. If this flag is not set, no component configs will be printed. -h, --help - help for upload-config - - - - --kubeconfig string     Default: "/etc/kubernetes/admin.conf" - - - The KubeConfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. + help for join-defaults @@ -65,6 +52,13 @@ kubeadm alpha phase upload-config [flags] + + --kubeconfig string     Default: "/etc/kubernetes/admin.conf" + + + The kubeconfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. + + --rootfs string diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config_upload.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config_upload.md index d16f6f91246ef..b4e825099a6ef 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config_upload.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config_upload.md @@ -44,7 +44,7 @@ kubeadm config upload [flags] --kubeconfig string     Default: "/etc/kubernetes/admin.conf" - The KubeConfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. + The kubeconfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config_upload_from-file.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config_upload_from-file.md index 87764b606f456..51d7987479234 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config_upload_from-file.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config_upload_from-file.md @@ -57,7 +57,7 @@ kubeadm config upload from-file [flags] --kubeconfig string     Default: "/etc/kubernetes/admin.conf" - The KubeConfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. + The kubeconfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config_upload_from-flags.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config_upload_from-flags.md index bb660cbe41709..08c1adb2f1d9c 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config_upload_from-flags.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config_upload_from-flags.md @@ -64,7 +64,7 @@ kubeadm config upload from-flags [flags] --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 (BETA - default=false) + A set of key=value pairs that describe feature gates for various features. Options are:
@@ -127,7 +127,7 @@ kubeadm config upload from-flags [flags] --kubeconfig string     Default: "/etc/kubernetes/admin.conf" - The KubeConfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. + The kubeconfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config_view.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config_view.md index 664055d815c0b..a389c5d947e0e 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config_view.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_config_view.md @@ -48,7 +48,7 @@ kubeadm config view [flags] --kubeconfig string     Default: "/etc/kubernetes/admin.conf" - The KubeConfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. + The kubeconfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init.md index c476ed58034b6..e626212ffdf3f 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init.md @@ -6,6 +6,44 @@ Run this command in order to set up the Kubernetes master. Run this command in order to set up the Kubernetes master. +The "init" command executes the following phases: +``` +preflight Run master pre-flight checks +kubelet-start Writes kubelet settings and (re)starts the kubelet +certs Certificate generation + /ca Generates the self-signed Kubernetes CA to provision identities for other Kubernetes components + /apiserver Generates the certificate for serving the Kubernetes API + /apiserver-kubelet-client Generates the Client certificate for the API server to connect to kubelet + /front-proxy-ca Generates the self-signed CA to provision identities for front proxy + /front-proxy-client Generates the client for the front proxy + /etcd-ca Generates the self-signed CA to provision identities for etcd + /etcd-server Generates the certificate for serving etcd + /etcd-peer Generates the credentials for etcd nodes to communicate with each other + /etcd-healthcheck-client Generates the client certificate for liveness probes to healtcheck etcd + /apiserver-etcd-client Generates the client apiserver uses to access etcd + /sa Generates a private key for signing service account tokens along with its public key +kubeconfig Generates all kubeconfig files necessary to establish the control plane and the admin kubeconfig file + /admin Generates a kubeconfig file for the admin to use and for kubeadm itself + /kubelet Generates a kubeconfig file for the kubelet to use *only* for cluster bootstrapping purposes + /controller-manager Generates a kubeconfig file for the controller manager to use + /scheduler Generates a kubeconfig file for the scheduler to use +control-plane Generates all static Pod manifest files necessary to establish the control plane + /apiserver Generates the kube-apiserver static Pod manifest + /controller-manager Generates the kube-controller-manager static Pod manifest + /scheduler Generates the kube-scheduler static Pod manifest +etcd Generates static Pod manifest file for local etcd. + /local Generates the static Pod manifest file for a local, single-node local etcd instance. +upload-config Uploads the kubeadm and kubelet configuration to a ConfigMap + /kubeadm Uploads the kubeadm ClusterConfiguration to a ConfigMap + /kubelet Uploads the kubelet component config to a ConfigMap +mark-control-plane Mark a node as a control-plane +bootstrap-token Generates bootstrap tokens used to join a node to a cluster +addon Installs required addons for passing Conformance tests + /coredns Installs the CoreDNS addon to a Kubernetes cluster + /kube-proxy Installs the kube-proxy addon to a Kubernetes cluster +``` + + ``` kubeadm init [flags] ``` @@ -72,7 +110,7 @@ kubeadm init [flags] --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 (BETA - default=false) + A set of key=value pairs that describe feature gates for various features. Options are:
@@ -89,6 +127,13 @@ kubeadm init [flags] A list of checks whose errors will be shown as warnings. Example: 'IsPrivilegedUser,Swap'. Value 'all' ignores errors from all checks. + + --image-repository string     Default: "k8s.gcr.io" + + + Choose a container registry to pull control plane images from + + --kubernetes-version string     Default: "stable-1" @@ -124,6 +169,13 @@ kubeadm init [flags] Use alternative domain for services, e.g. "myorg.internal". + + --skip-phases stringSlice + + + List of phases to be skipped + + --skip-token-print diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase.md new file mode 100644 index 0000000000000..b2946caf1fa02 --- /dev/null +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase.md @@ -0,0 +1,50 @@ + +use this command to invoke single phase of the init workflow + +### Synopsis + + +use this command to invoke single phase of the init workflow + +### Options + + + + + + + + + + + + + + + + +
-h, --help
help for phase
+ + + +### Options inherited from parent commands + + + + + + + + + + + + + + + + +
--rootfs string
[EXPERIMENTAL] The path to the 'real' host root filesystem.
+ + + diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_addon.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_addon.md similarity index 95% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_addon.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_addon.md index 834becc463aa5..1ddc02f451112 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_addon.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_addon.md @@ -6,6 +6,10 @@ Installs required addons for passing Conformance tests This command is not meant to be run on its own. See list of available subcommands. +``` +kubeadm init phase addon [flags] +``` + ### Options diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_addon_all.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_addon_all.md similarity index 70% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_addon_all.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_addon_all.md index f30b47e3235db..76e1055467042 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_addon_all.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_addon_all.md @@ -1,24 +1,13 @@ -Installs all addons to a Kubernetes cluster +Installs all the addons ### Synopsis -Installs the CoreDNS and the kube-proxy addons components via the API server. Please note that although the DNS server is deployed, it will not be scheduled until CNI is installed. - -Alpha Disclaimer: this command is currently alpha. - -``` -kubeadm alpha phase addon all [flags] -``` - -### Examples +Installs all the addons ``` - # Installs the CoreDNS and the kube-proxy addons components via the API server, - # functionally equivalent to what installed by kubeadm init. - - kubeadm alpha phase selfhosting from-staticpods +kubeadm init phase addon all [flags] ``` ### Options @@ -34,28 +23,28 @@ kubeadm alpha phase addon all [flags] - + - + - + - + @@ -76,35 +65,35 @@ kubeadm alpha phase addon all [flags] - + - + - + - + - + diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_addon_coredns.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_addon_coredns.md similarity index 80% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_addon_coredns.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_addon_coredns.md index 4387b42f8e0a0..a358676d53070 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_addon_coredns.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_addon_coredns.md @@ -4,12 +4,10 @@ Installs the CoreDNS addon to a Kubernetes cluster ### Synopsis -Installs the CoreDNS addon components via the API server. Please note that although the DNS server is deployed, it will not be scheduled until CNI is installed. - -Alpha Disclaimer: this command is currently alpha. +Installs the CoreDNS addon components via the API server. Please note that although the DNS server is deployed, it will not be scheduled until CNI is installed. ``` -kubeadm alpha phase addon coredns [flags] +kubeadm init phase addon coredns [flags] ``` ### Options @@ -25,14 +23,14 @@ kubeadm alpha phase addon coredns [flags] - + - + @@ -53,28 +51,28 @@ kubeadm alpha phase addon coredns [flags] - + - + - + - + diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_addon_kube-proxy.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_addon_kube-proxy.md similarity index 77% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_addon_kube-proxy.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_addon_kube-proxy.md index 0c36be46766ee..f967ae1647d0e 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_addon_kube-proxy.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_addon_kube-proxy.md @@ -4,12 +4,10 @@ Installs the kube-proxy addon to a Kubernetes cluster ### Synopsis -Installs the kube-proxy addon components via the API server. - -Alpha Disclaimer: this command is currently alpha. +Installs the kube-proxy addon components via the API server. ``` -kubeadm alpha phase addon kube-proxy [flags] +kubeadm init phase addon kube-proxy [flags] ``` ### Options @@ -25,21 +23,21 @@ kubeadm alpha phase addon kube-proxy [flags] - + - + - + @@ -60,21 +58,21 @@ kubeadm alpha phase addon kube-proxy [flags] - + - + - + diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_bootstrap-token.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_bootstrap-token.md new file mode 100644 index 0000000000000..c853d7d2fb37e --- /dev/null +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_bootstrap-token.md @@ -0,0 +1,85 @@ + +Generates bootstrap tokens used to join a node to a cluster + +### Synopsis + + +Bootstrap tokens are used for establishing bidirectional trust between a node joining the cluster and a the control-plane node. + +This command makes all the configurations required to make bootstrap tokens works and then creates an initial token. + +``` +kubeadm init phase bootstrap-token [flags] +``` + +### Examples + +``` + # Makes all the bootstrap token configurations and creates an initial token, functionally + # equivalent to what generated by kubeadm init. + kubeadm init phase bootstrap-token +``` + +### Options + +
--apiserver-advertise-address string
The IP address the API server is accessible onThe 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
The port the API server is accessible onPort for the API Server to bind to.
--config string
Path to a kubeadm config file. WARNING: Usage of a configuration file is experimentalPath to kubeadm config file. WARNING: Usage of a configuration file is experimental.
--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 (BETA - default=false)		A set of key=value pairs that describe feature gates for various features. Options are:
--kubeconfig string     Default: "/etc/kubernetes/admin.conf"
The KubeConfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file.The kubeconfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file.
--kubernetes-version string     Default: "stable-1"
Choose a specific Kubernetes version for the control planeChoose a specific Kubernetes version for the control plane.
--pod-network-cidr string
The range of IP addresses used for the Pod networkSpecify 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"
The range of IP address used for service VIPsUse alternative range of IP address for service VIPs.
--service-dns-domain string     Default: "cluster.local"
Alternative domain for servicesUse alternative domain for services, e.g. "myorg.internal".
--config string
Path to a kubeadm config file. WARNING: Usage of a configuration file is experimentalPath to kubeadm config file. WARNING: Usage of a configuration file is experimental.
--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 (BETA - default=false)		A set of key=value pairs that describe feature gates for various features. Options are:
--kubeconfig string     Default: "/etc/kubernetes/admin.conf"
The KubeConfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file.The kubeconfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file.
--kubernetes-version string     Default: "stable-1"
Choose a specific Kubernetes version for the control planeChoose a specific Kubernetes version for the control plane.
--service-cidr string     Default: "10.96.0.0/12"
The range of IP address used for service VIPsUse alternative range of IP address for service VIPs.
--service-dns-domain string     Default: "cluster.local"
Alternative domain for servicesUse alternative domain for services, e.g. "myorg.internal".
--apiserver-advertise-address string
The IP address the API server is accessible onThe 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
The port the API server is accessible onPort for the API Server to bind to.
--config string
Path to a kubeadm config file. WARNING: Usage of a configuration file is experimentalPath to kubeadm config file. WARNING: Usage of a configuration file is experimental.
--kubeconfig string     Default: "/etc/kubernetes/admin.conf"
The KubeConfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file.The kubeconfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file.
--kubernetes-version string     Default: "stable-1"
Choose a specific Kubernetes version for the control planeChoose a specific Kubernetes version for the control plane.
--pod-network-cidr string
The range of IP addresses used for the Pod networkSpecify range of IP addresses for the pod network. If set, the control plane will automatically allocate CIDRs for every node.
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--config string
Path to kubeadm config file. WARNING: Usage of a configuration file is experimental.
-h, --help
help for bootstrap-token
--kubeconfig-dir string     Default: "/etc/kubernetes"
The path where to save the kubeconfig file.
--skip-token-print
Skip printing of the default bootstrap token generated by 'kubeadm init'.
+ + + +### Options inherited from parent commands + + + + + + + + + + + + + + + + +
--rootfs string
[EXPERIMENTAL] The path to the 'real' host root filesystem.
+ + + diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_certs.md similarity index 93% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_certs.md index 56d01fba8e226..538a7a1b33934 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_certs.md @@ -1,11 +1,15 @@ -Generates certificates for a Kubernetes cluster +Certificate generation ### Synopsis This command is not meant to be run on its own. See list of available subcommands. +``` +kubeadm init phase certs [flags] +``` + ### Options diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_certs_all.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_certs_all.md new file mode 100644 index 0000000000000..910b94afbeda5 --- /dev/null +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_certs_all.md @@ -0,0 +1,96 @@ + +Generates all certificates + +### Synopsis + + +Generates all certificates + +``` +kubeadm init phase certs all [flags] +``` + +### Options + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--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-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.
--config string
Path to kubeadm config file. WARNING: Usage of a configuration file is experimental.
-h, --help
help for all
--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".
+ + + +### Options inherited from parent commands + + + + + + + + + + + + + + + + +
--rootfs string
[EXPERIMENTAL] The path to the 'real' host root filesystem.
+ + + diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_apiserver-etcd-client.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_certs_apiserver-etcd-client.md similarity index 71% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_apiserver-etcd-client.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_certs_apiserver-etcd-client.md index 65ef3d793a3da..01e798e144127 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_apiserver-etcd-client.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_certs_apiserver-etcd-client.md @@ -11,7 +11,7 @@ If both files already exist, kubeadm skips the generation step and existing file Alpha Disclaimer: this command is currently alpha. ``` -kubeadm alpha phase certs apiserver-etcd-client [flags] +kubeadm init phase certs apiserver-etcd-client [flags] ``` ### Options @@ -27,14 +27,28 @@ kubeadm alpha phase certs apiserver-etcd-client [flags] --cert-dir string     Default: "/etc/kubernetes/pki" - The path where to save the certificates + The path where to save and store the certificates. --config string - Path to kubeadm config file (WARNING: Usage of a configuration file is experimental) + Path to kubeadm config file. WARNING: Usage of a configuration file is experimental. + + + + --csr-dir string + + + The path to output the CSRs and private keys to + + + + --csr-only + + + Create CSRs instead of generating certificates diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_apiserver-kubelet-client.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_certs_apiserver-kubelet-client.md similarity index 71% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_apiserver-kubelet-client.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_certs_apiserver-kubelet-client.md index 37aeb21fb43d8..b3e30655c4649 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_apiserver-kubelet-client.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_certs_apiserver-kubelet-client.md @@ -11,7 +11,7 @@ If both files already exist, kubeadm skips the generation step and existing file Alpha Disclaimer: this command is currently alpha. ``` -kubeadm alpha phase certs apiserver-kubelet-client [flags] +kubeadm init phase certs apiserver-kubelet-client [flags] ``` ### Options @@ -27,14 +27,28 @@ kubeadm alpha phase certs apiserver-kubelet-client [flags] --cert-dir string     Default: "/etc/kubernetes/pki" - The path where to save the certificates + The path where to save and store the certificates. --config string - Path to kubeadm config file (WARNING: Usage of a configuration file is experimental) + Path to kubeadm config file. WARNING: Usage of a configuration file is experimental. + + + + --csr-dir string + + + The path to output the CSRs and private keys to + + + + --csr-only + + + Create CSRs instead of generating certificates diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_apiserver.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_certs_apiserver.md similarity index 66% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_apiserver.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_certs_apiserver.md index 13f358c12a087..a36c16aee3da7 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_apiserver.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_certs_apiserver.md @@ -1,10 +1,10 @@ -Generates the certificate for serving the kubernetes API +Generates the certificate for serving the Kubernetes API ### Synopsis -Generates the certificate for serving the kubernetes API, and saves them into apiserver.cert and apiserver.key files. +Generates the certificate for serving the Kubernetes API, and saves them into apiserver.cert and apiserver.key files. Default SANs are kubernetes, kubernetes.default, kubernetes.default.svc, kubernetes.default.svc.cluster.local, 10.96.0.1, 127.0.0.1 @@ -13,7 +13,7 @@ If both files already exist, kubeadm skips the generation step and existing file Alpha Disclaimer: this command is currently alpha. ``` -kubeadm alpha phase certs apiserver [flags] +kubeadm init phase certs apiserver [flags] ``` ### Options @@ -29,28 +29,42 @@ kubeadm alpha phase certs apiserver [flags] --apiserver-advertise-address string - The IP address the API server is accessible on, to use for the API server serving cert + 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-cert-extra-sans stringSlice - Optional extra altnames to use for the API server serving cert. Can be both IP addresses and DNS names + 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 the certificates + The path where to save and store the certificates. --config string - Path to kubeadm config file (WARNING: Usage of a configuration file is experimental) + Path to kubeadm config file. WARNING: Usage of a configuration file is experimental. + + + + --csr-dir string + + + The path to output the CSRs and private keys to + + + + --csr-only + + + Create CSRs instead of generating certificates @@ -64,14 +78,14 @@ kubeadm alpha phase certs apiserver [flags] --service-cidr string     Default: "10.96.0.0/12" - Alternative range of IP address for service VIPs, from which derives the internal API server VIP that will be added to the API Server serving cert + Use alternative range of IP address for service VIPs. --service-dns-domain string     Default: "cluster.local" - Alternative domain for services, to use for the API server serving cert + Use alternative domain for services, e.g. "myorg.internal". diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_ca.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_certs_ca.md similarity index 76% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_ca.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_certs_ca.md index 7f4e19a2d3a38..257da0ea6a1cd 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_ca.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_certs_ca.md @@ -1,17 +1,17 @@ -Generates the self-signed kubernetes CA to provision identities for other kuberenets components +Generates the self-signed Kubernetes CA to provision identities for other Kubernetes components ### Synopsis -Generates the self-signed kubernetes CA to provision identities for other kuberenets components, and saves them into ca.cert and ca.key files. +Generates the self-signed Kubernetes CA to provision identities for other Kubernetes components, and saves them into ca.cert and ca.key files. If both files already exist, kubeadm skips the generation step and existing files will be used. Alpha Disclaimer: this command is currently alpha. ``` -kubeadm alpha phase certs ca [flags] +kubeadm init phase certs ca [flags] ``` ### Options @@ -27,14 +27,14 @@ kubeadm alpha phase certs ca [flags] --cert-dir string     Default: "/etc/kubernetes/pki" - The path where to save the certificates + The path where to save and store the certificates. --config string - Path to kubeadm config file (WARNING: Usage of a configuration file is experimental) + Path to kubeadm config file. WARNING: Usage of a configuration file is experimental. diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_etcd-ca.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_certs_etcd-ca.md similarity index 88% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_etcd-ca.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_certs_etcd-ca.md index 186905c298690..210b0d1dd2dca 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_etcd-ca.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_certs_etcd-ca.md @@ -11,7 +11,7 @@ If both files already exist, kubeadm skips the generation step and existing file Alpha Disclaimer: this command is currently alpha. ``` -kubeadm alpha phase certs etcd-ca [flags] +kubeadm init phase certs etcd-ca [flags] ``` ### Options @@ -27,14 +27,14 @@ kubeadm alpha phase certs etcd-ca [flags] --cert-dir string     Default: "/etc/kubernetes/pki" - The path where to save the certificates + The path where to save and store the certificates. --config string - Path to kubeadm config file (WARNING: Usage of a configuration file is experimental) + Path to kubeadm config file. WARNING: Usage of a configuration file is experimental. diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_etcd-healthcheck-client.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_certs_etcd-healthcheck-client.md similarity index 71% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_etcd-healthcheck-client.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_certs_etcd-healthcheck-client.md index fd5b135b02469..65e5c41bedfa7 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_etcd-healthcheck-client.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_certs_etcd-healthcheck-client.md @@ -11,7 +11,7 @@ If both files already exist, kubeadm skips the generation step and existing file Alpha Disclaimer: this command is currently alpha. ``` -kubeadm alpha phase certs etcd-healthcheck-client [flags] +kubeadm init phase certs etcd-healthcheck-client [flags] ``` ### Options @@ -27,14 +27,28 @@ kubeadm alpha phase certs etcd-healthcheck-client [flags] --cert-dir string     Default: "/etc/kubernetes/pki" - The path where to save the certificates + The path where to save and store the certificates. --config string - Path to kubeadm config file (WARNING: Usage of a configuration file is experimental) + Path to kubeadm config file. WARNING: Usage of a configuration file is experimental. + + + + --csr-dir string + + + The path to output the CSRs and private keys to + + + + --csr-only + + + Create CSRs instead of generating certificates diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_etcd-peer.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_certs_etcd-peer.md similarity index 72% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_etcd-peer.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_certs_etcd-peer.md index d9a73e800a75e..2e045ae1e1ac7 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_etcd-peer.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_certs_etcd-peer.md @@ -13,7 +13,7 @@ If both files already exist, kubeadm skips the generation step and existing file Alpha Disclaimer: this command is currently alpha. ``` -kubeadm alpha phase certs etcd-peer [flags] +kubeadm init phase certs etcd-peer [flags] ``` ### Options @@ -29,14 +29,28 @@ kubeadm alpha phase certs etcd-peer [flags] --cert-dir string     Default: "/etc/kubernetes/pki" - The path where to save the certificates + The path where to save and store the certificates. --config string - Path to kubeadm config file (WARNING: Usage of a configuration file is experimental) + Path to kubeadm config file. WARNING: Usage of a configuration file is experimental. + + + + --csr-dir string + + + The path to output the CSRs and private keys to + + + + --csr-only + + + Create CSRs instead of generating certificates diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_etcd-server.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_certs_etcd-server.md similarity index 69% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_etcd-server.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_certs_etcd-server.md index 6965eceb66891..a960d01e4f77b 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_etcd-server.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_certs_etcd-server.md @@ -6,14 +6,14 @@ Generates the certificate for serving etcd Generates the certificate for serving etcd, and saves them into etcd/server.cert and etcd/server.key files. -Default SANs are localhost, 127.0.0.1, ::1 +Default SANs are localhost, 127.0.0.1, 127.0.0.1, ::1 If both files already exist, kubeadm skips the generation step and existing files will be used. Alpha Disclaimer: this command is currently alpha. ``` -kubeadm alpha phase certs etcd-server [flags] +kubeadm init phase certs etcd-server [flags] ``` ### Options @@ -29,14 +29,28 @@ kubeadm alpha phase certs etcd-server [flags] --cert-dir string     Default: "/etc/kubernetes/pki" - The path where to save the certificates + The path where to save and store the certificates. --config string - Path to kubeadm config file (WARNING: Usage of a configuration file is experimental) + Path to kubeadm config file. WARNING: Usage of a configuration file is experimental. + + + + --csr-dir string + + + The path to output the CSRs and private keys to + + + + --csr-only + + + Create CSRs instead of generating certificates diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_front-proxy-ca.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_certs_front-proxy-ca.md similarity index 88% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_front-proxy-ca.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_certs_front-proxy-ca.md index e6cde90042dc2..bff25d78cd7d7 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_front-proxy-ca.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_certs_front-proxy-ca.md @@ -11,7 +11,7 @@ If both files already exist, kubeadm skips the generation step and existing file Alpha Disclaimer: this command is currently alpha. ``` -kubeadm alpha phase certs front-proxy-ca [flags] +kubeadm init phase certs front-proxy-ca [flags] ``` ### Options @@ -27,14 +27,14 @@ kubeadm alpha phase certs front-proxy-ca [flags] --cert-dir string     Default: "/etc/kubernetes/pki" - The path where to save the certificates + The path where to save and store the certificates. --config string - Path to kubeadm config file (WARNING: Usage of a configuration file is experimental) + Path to kubeadm config file. WARNING: Usage of a configuration file is experimental. diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_front-proxy-client.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_certs_front-proxy-client.md similarity index 70% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_front-proxy-client.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_certs_front-proxy-client.md index bde1a92cda58e..9a051340a1c95 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_front-proxy-client.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_certs_front-proxy-client.md @@ -11,7 +11,7 @@ If both files already exist, kubeadm skips the generation step and existing file Alpha Disclaimer: this command is currently alpha. ``` -kubeadm alpha phase certs front-proxy-client [flags] +kubeadm init phase certs front-proxy-client [flags] ``` ### Options @@ -27,14 +27,28 @@ kubeadm alpha phase certs front-proxy-client [flags] --cert-dir string     Default: "/etc/kubernetes/pki" - The path where to save the certificates + The path where to save and store the certificates. --config string - Path to kubeadm config file (WARNING: Usage of a configuration file is experimental) + Path to kubeadm config file. WARNING: Usage of a configuration file is experimental. + + + + --csr-dir string + + + The path to output the CSRs and private keys to + + + + --csr-only + + + Create CSRs instead of generating certificates diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_sa.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_certs_sa.md similarity index 68% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_sa.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_certs_sa.md index 4c707b4a5cfd9..951b773eac6e0 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_certs_sa.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_certs_sa.md @@ -9,7 +9,7 @@ Generates the private key for signing service account tokens along with its publ Alpha Disclaimer: this command is currently alpha. ``` -kubeadm alpha phase certs sa [flags] +kubeadm init phase certs sa [flags] ``` ### Options @@ -21,20 +21,6 @@ kubeadm alpha phase certs sa [flags] - - --cert-dir string     Default: "/etc/kubernetes/pki" - - - The path where to save the certificates - - - - --config string - - - Path to kubeadm config file (WARNING: Usage of a configuration file is experimental) - - -h, --help diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_controlplane.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_control-plane.md similarity index 91% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_controlplane.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_control-plane.md index 3605a67b17143..38cc40ed905ca 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_controlplane.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_control-plane.md @@ -6,6 +6,10 @@ Generates all static Pod manifest files necessary to establish the control plane This command is not meant to be run on its own. See list of available subcommands. +``` +kubeadm init phase control-plane [flags] +``` + ### Options @@ -19,7 +23,7 @@ This command is not meant to be run on its own. See list of available subcommand - + diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_controlplane_all.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_control-plane_all.md similarity index 73% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_controlplane_all.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_control-plane_all.md index e940dae06b4f2..322a54531818e 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_controlplane_all.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_control-plane_all.md @@ -1,26 +1,13 @@ -Generates all static Pod manifest files necessary to establish the control plane +Generates all static Pod manifest files ### Synopsis -Generates all static Pod manifest files necessary to establish the control plane. - -Alpha Disclaimer: this command is currently alpha. - -``` -kubeadm alpha phase controlplane all [flags] -``` - -### Examples +Generates all static Pod manifest files ``` - # Generates all static Pod manifest files for control plane components, - # functionally equivalent to what generated by kubeadm init. - kubeadm alpha phase controlplane all - - # Generates all static Pod manifest files using options read from a configuration file. - kubeadm alpha phase controlplane --config masterconfiguration.yaml +kubeadm init phase control-plane all [flags] ``` ### Options @@ -36,14 +23,14 @@ kubeadm alpha phase controlplane all [flags] - + - + @@ -57,14 +44,14 @@ kubeadm alpha phase controlplane all [flags] - + - + @@ -78,7 +65,7 @@ kubeadm alpha phase controlplane all [flags] - + @@ -88,18 +75,25 @@ kubeadm alpha phase controlplane all [flags] + + + + + + + - + - + @@ -113,7 +107,7 @@ kubeadm alpha phase controlplane all [flags] - + diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_controlplane_apiserver.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_control-plane_apiserver.md similarity index 74% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_controlplane_apiserver.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_control-plane_apiserver.md index de5fff7083f13..6ebc0d2724758 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_controlplane_apiserver.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_control-plane_apiserver.md @@ -1,15 +1,13 @@ -Generates the API server static Pod manifest +Generates the kube-apiserver static Pod manifest ### Synopsis -Generates the static Pod manifest file for the API server and saves it into /etc/kubernetes/manifests/kube-apiserver.yaml file. - -Alpha Disclaimer: this command is currently alpha. +Generates the kube-apiserver static Pod manifest ``` -kubeadm alpha phase controlplane apiserver [flags] +kubeadm init phase control-plane apiserver [flags] ``` ### Options @@ -25,14 +23,14 @@ kubeadm alpha phase controlplane apiserver [flags] - + - + @@ -46,21 +44,21 @@ kubeadm alpha phase controlplane apiserver [flags] - + - + - + @@ -70,18 +68,25 @@ kubeadm alpha phase controlplane apiserver [flags] + + + + + + + - + - + diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_controlplane_controller-manager.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_control-plane_controller-manager.md similarity index 71% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_controlplane_controller-manager.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_control-plane_controller-manager.md index 402703698c2a8..19fb762a7e786 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_controlplane_controller-manager.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_control-plane_controller-manager.md @@ -1,15 +1,13 @@ -Generates the controller-manager static Pod manifest +Generates the kube-controller-manager static Pod manifest ### Synopsis -Generates the static Pod manifest file for the controller-manager and saves it into /etc/kubernetes/manifests/kube-controller-manager.yaml file. - -Alpha Disclaimer: this command is currently alpha. +Generates the kube-controller-manager static Pod manifest ``` -kubeadm alpha phase controlplane controller-manager [flags] +kubeadm init phase control-plane controller-manager [flags] ``` ### Options @@ -25,14 +23,14 @@ kubeadm alpha phase controlplane controller-manager [flags] - + - + @@ -49,18 +47,25 @@ kubeadm alpha phase controlplane controller-manager [flags] + + + + + + + - + - + diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_controlplane_scheduler.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_control-plane_scheduler.md similarity index 74% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_controlplane_scheduler.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_control-plane_scheduler.md index e07e4b46d893d..9cf579ab56e93 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_controlplane_scheduler.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_control-plane_scheduler.md @@ -1,15 +1,13 @@ -Generates the scheduler static Pod manifest +Generates the kube-scheduler static Pod manifest ### Synopsis -Generates the static Pod manifest file for the scheduler and saves it into /etc/kubernetes/manifests/kube-scheduler.yaml file. - -Alpha Disclaimer: this command is currently alpha. +Generates the kube-scheduler static Pod manifest ``` -kubeadm alpha phase controlplane scheduler [flags] +kubeadm init phase control-plane scheduler [flags] ``` ### Options @@ -25,14 +23,14 @@ kubeadm alpha phase controlplane scheduler [flags] - + - + @@ -42,11 +40,18 @@ kubeadm alpha phase controlplane scheduler [flags] + + + + + + + - + diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_etcd.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_etcd.md new file mode 100644 index 0000000000000..fa2a91f055085 --- /dev/null +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_etcd.md @@ -0,0 +1,54 @@ + +Generates static Pod manifest file for local etcd. + +### Synopsis + + +This command is not meant to be run on its own. See list of available subcommands. + +``` +kubeadm init phase etcd [flags] +``` + +### Options + +
-h, --help
help for controlplanehelp for control-plane
--apiserver-advertise-address string
The IP address of the API server is accessible onThe 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
The port the API server is accessible onPort for the API Server to bind to.
--cert-dir string     Default: "/etc/kubernetes/pki"
The path where certificates are storedThe path where to save and store the certificates.
--config string
Path to kubeadm config file. WARNING: Usage of a configuration file is experimentalPath to kubeadm config file. WARNING: Usage of a configuration file is experimental.
--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 (BETA - default=false)		A set of key=value pairs that describe feature gates for various features. Options are:
help for all
--image-repository string     Default: "k8s.gcr.io"
Choose a container registry to pull control plane images from
--kubernetes-version string     Default: "stable-1"
Choose a specific Kubernetes version for the control planeChoose a specific Kubernetes version for the control plane.
--pod-network-cidr string
The range of IP addresses used for the Pod networkSpecify 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"
The range of IP address used for service VIPsUse alternative range of IP address for service VIPs.
--apiserver-advertise-address string
The IP address of the API server is accessible onThe 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
The port the API server is accessible onPort for the API Server to bind to.
--cert-dir string     Default: "/etc/kubernetes/pki"
The path where certificates are storedThe path where to save and store the certificates.
--config string
Path to kubeadm config file. WARNING: Usage of a configuration file is experimentalPath to kubeadm config file. WARNING: Usage of a configuration file is experimental.
--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 (BETA - default=false)		A set of key=value pairs that describe feature gates for various features. Options are:
help for apiserver
--image-repository string     Default: "k8s.gcr.io"
Choose a container registry to pull control plane images from
--kubernetes-version string     Default: "stable-1"
Choose a specific Kubernetes version for the control planeChoose a specific Kubernetes version for the control plane.
--service-cidr string     Default: "10.96.0.0/12"
The range of IP address used for service VIPsUse alternative range of IP address for service VIPs.
--cert-dir string     Default: "/etc/kubernetes/pki"
The path where certificates are storedThe path where to save and store the certificates.
--config string
Path to kubeadm config file. WARNING: Usage of a configuration file is experimentalPath to kubeadm config file. WARNING: Usage of a configuration file is experimental.
help for controller-manager
--image-repository string     Default: "k8s.gcr.io"
Choose a container registry to pull control plane images from
--kubernetes-version string     Default: "stable-1"
Choose a specific Kubernetes version for the control planeChoose a specific Kubernetes version for the control plane.
--pod-network-cidr string
The range of IP addresses used for the Pod networkSpecify range of IP addresses for the pod network. If set, the control plane will automatically allocate CIDRs for every node.
--cert-dir string     Default: "/etc/kubernetes/pki"
The path where certificates are storedThe path where to save and store the certificates.
--config string
Path to kubeadm config file. WARNING: Usage of a configuration file is experimentalPath to kubeadm config file. WARNING: Usage of a configuration file is experimental.
help for scheduler
--image-repository string     Default: "k8s.gcr.io"
Choose a container registry to pull control plane images from
--kubernetes-version string     Default: "stable-1"
Choose a specific Kubernetes version for the control planeChoose a specific Kubernetes version for the control plane.
+ + + + + + + + + + + + + + +
-h, --help
help for etcd
+ + + +### Options inherited from parent commands + + + + + + + + + + + + + + + + +
--rootfs string
[EXPERIMENTAL] The path to the 'real' host root filesystem.
+ + + diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_etcd_local.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_etcd_local.md similarity index 67% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_etcd_local.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_etcd_local.md index 19802040fc04b..ced1517a3b812 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_etcd_local.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_etcd_local.md @@ -1,26 +1,25 @@ -Generates the static Pod manifest file for a local, single-node etcd instance +Generates the static Pod manifest file for a local, single-node local etcd instance. ### Synopsis -Generates the static Pod manifest file for a local, single-node etcd instance and saves it to /etc/kubernetes/manifests/etcd.yaml file. - -Alpha Disclaimer: this command is currently alpha. +Generates the static Pod manifest file for a local, single-node local etcd instance. ``` -kubeadm alpha phase etcd local [flags] +kubeadm init phase etcd local [flags] ``` ### Examples ``` # Generates the static Pod manifest file for etcd, functionally - # equivalent to what generated by kubeadm init. - kubeadm alpha phase etcd local + # equivalent to what is generated by kubeadm init. + kubeadm init phase etcd local - # Generates the static Pod manifest file for etcd. - kubeadm alpha phase etcd local --config masterconfiguration.yaml + # Generates the static Pod manifest file for etcd using options + # read from a configuration file. + kubeadm init phase etcd local --config config.yaml ``` ### Options @@ -36,14 +35,14 @@ kubeadm alpha phase etcd local [flags] --cert-dir string     Default: "/etc/kubernetes/pki" - The path where certificates are stored + The path where to save and store the certificates. --config string - Path to kubeadm config file. WARNING: Usage of a configuration file is experimental + Path to kubeadm config file. WARNING: Usage of a configuration file is experimental. @@ -53,6 +52,13 @@ kubeadm alpha phase etcd local [flags] help for local + + --image-repository string     Default: "k8s.gcr.io" + + + Choose a container registry to pull control plane images from + + diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubeconfig.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_kubeconfig.md similarity index 95% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubeconfig.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_kubeconfig.md index ba11bde684c0b..8931be52e7964 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubeconfig.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_kubeconfig.md @@ -6,6 +6,10 @@ Generates all kubeconfig files necessary to establish the control plane and the This command is not meant to be run on its own. See list of available subcommands. +``` +kubeadm init phase kubeconfig [flags] +``` + ### Options diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubeconfig_admin.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_kubeconfig_admin.md similarity index 82% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubeconfig_admin.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_kubeconfig_admin.md index e58fad7829a94..a10f9aaf656d0 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubeconfig_admin.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_kubeconfig_admin.md @@ -4,12 +4,10 @@ Generates a kubeconfig file for the admin to use and for kubeadm itself ### Synopsis -Generates the kubeconfig file for the admin and for kubeadm itself, and saves it to admin.conf file. - -Alpha Disclaimer: this command is currently alpha. +Generates the kubeconfig file for the admin and for kubeadm itself, and saves it to admin.conf file. ``` -kubeadm alpha phase kubeconfig admin [flags] +kubeadm init phase kubeconfig admin [flags] ``` ### Options @@ -25,28 +23,28 @@ kubeadm alpha phase kubeconfig admin [flags] - + - + - + - + @@ -60,7 +58,7 @@ kubeadm alpha phase kubeconfig admin [flags] - + diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_kubeconfig_all.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_kubeconfig_all.md new file mode 100644 index 0000000000000..698541d2733ad --- /dev/null +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_kubeconfig_all.md @@ -0,0 +1,96 @@ + +Generates all kubeconfig files + +### Synopsis + + +Generates all kubeconfig files + +``` +kubeadm init phase kubeconfig all [flags] +``` + +### Options + +
--apiserver-advertise-address string
The IP address the API server is accessible onThe 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
The port the API server is accessible onPort for the API Server to bind to.
--cert-dir string     Default: "/etc/kubernetes/pki"
The path where certificates are storedThe path where to save and store the certificates.
--config string
Path to kubeadm config file. WARNING: Usage of a configuration file is experimentalPath to kubeadm config file. WARNING: Usage of a configuration file is experimental.
--kubeconfig-dir string     Default: "/etc/kubernetes"
The path where to save the kubeconfig fileThe path where to save the kubeconfig file.
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--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.
--cert-dir string     Default: "/etc/kubernetes/pki"
The path where to save and store the certificates.
--config string
Path to kubeadm config file. WARNING: Usage of a configuration file is experimental.
-h, --help
help for all
--kubeconfig-dir string     Default: "/etc/kubernetes"
The path where to save the kubeconfig file.
--node-name string
Specify the node name.
+ + + +### Options inherited from parent commands + + + + + + + + + + + + + + + + +
--rootfs string
[EXPERIMENTAL] The path to the 'real' host root filesystem.
+ + + diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubeconfig_controller-manager.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_kubeconfig_controller-manager.md similarity index 81% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubeconfig_controller-manager.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_kubeconfig_controller-manager.md index 24f77d50af270..3a27c9a950b5f 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubeconfig_controller-manager.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_kubeconfig_controller-manager.md @@ -4,12 +4,10 @@ Generates a kubeconfig file for the controller manager to use ### Synopsis -Generates the kubeconfig file for the controller manager to use and saves it to /etc/kubernetes/controller-manager.conf file. - -Alpha Disclaimer: this command is currently alpha. +Generates the kubeconfig file for the controller manager to use and saves it to controller-manager.conf file ``` -kubeadm alpha phase kubeconfig controller-manager [flags] +kubeadm init phase kubeconfig controller-manager [flags] ``` ### Options @@ -25,28 +23,28 @@ kubeadm alpha phase kubeconfig controller-manager [flags] --apiserver-advertise-address string - The IP address the API server is accessible on + 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 - The port the API server is accessible on + Port for the API Server to bind to. --cert-dir string     Default: "/etc/kubernetes/pki" - The path where certificates are stored + The path where to save and store the certificates. --config string - Path to kubeadm config file. WARNING: Usage of a configuration file is experimental + Path to kubeadm config file. WARNING: Usage of a configuration file is experimental. @@ -60,7 +58,7 @@ kubeadm alpha phase kubeconfig controller-manager [flags] --kubeconfig-dir string     Default: "/etc/kubernetes" - The path where to save the kubeconfig file + The path where to save the kubeconfig file. diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubeconfig_kubelet.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_kubeconfig_kubelet.md similarity index 73% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubeconfig_kubelet.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_kubeconfig_kubelet.md index ff7c787b1de73..2ba61026cb99e 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubeconfig_kubelet.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_kubeconfig_kubelet.md @@ -1,17 +1,15 @@ -Generates a kubeconfig file for the kubelet to use. Please note that this should be used *only* for bootstrapping purposes +Generates a kubeconfig file for the kubelet to use *only* for cluster bootstrapping purposes ### Synopsis -Generates the kubeconfig file for the kubelet to use and saves it to /etc/kubernetes/kubelet.conf file. +Generates the kubeconfig file for the kubelet to use and saves it to kubelet.conf file. -Please note that this should only be used for bootstrapping purposes. After your control plane is up, you should request all kubelet credentials from the CSR API. - -Alpha Disclaimer: this command is currently alpha. +Please note that this should only be used for cluster bootstrapping purposes. After your control plane is up, you should request all kubelet credentials from the CSR API. ``` -kubeadm alpha phase kubeconfig kubelet [flags] +kubeadm init phase kubeconfig kubelet [flags] ``` ### Options @@ -27,28 +25,28 @@ kubeadm alpha phase kubeconfig kubelet [flags] --apiserver-advertise-address string - The IP address the API server is accessible on + 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 - The port the API server is accessible on + Port for the API Server to bind to. --cert-dir string     Default: "/etc/kubernetes/pki" - The path where certificates are stored + The path where to save and store the certificates. --config string - Path to kubeadm config file. WARNING: Usage of a configuration file is experimental + Path to kubeadm config file. WARNING: Usage of a configuration file is experimental. @@ -62,14 +60,14 @@ kubeadm alpha phase kubeconfig kubelet [flags] --kubeconfig-dir string     Default: "/etc/kubernetes" - The path where to save the kubeconfig file + The path where to save the kubeconfig file. --node-name string - The node name that should be used for the kubelet client certificate + Specify the node name. diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubeconfig_scheduler.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_kubeconfig_scheduler.md similarity index 82% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubeconfig_scheduler.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_kubeconfig_scheduler.md index 6de62a33ce9b4..892e77c829f19 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubeconfig_scheduler.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_kubeconfig_scheduler.md @@ -4,12 +4,10 @@ Generates a kubeconfig file for the scheduler to use ### Synopsis -Generates the kubeconfig file for the scheduler to use and saves it to /etc/kubernetes/scheduler.conf file. - -Alpha Disclaimer: this command is currently alpha. +Generates the kubeconfig file for the scheduler to use and saves it to scheduler.conf file. ``` -kubeadm alpha phase kubeconfig scheduler [flags] +kubeadm init phase kubeconfig scheduler [flags] ``` ### Options @@ -25,28 +23,28 @@ kubeadm alpha phase kubeconfig scheduler [flags] --apiserver-advertise-address string - The IP address the API server is accessible on + 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 - The port the API server is accessible on + Port for the API Server to bind to. --cert-dir string     Default: "/etc/kubernetes/pki" - The path where certificates are stored + The path where to save and store the certificates. --config string - Path to kubeadm config file. WARNING: Usage of a configuration file is experimental + Path to kubeadm config file. WARNING: Usage of a configuration file is experimental. @@ -60,7 +58,7 @@ kubeadm alpha phase kubeconfig scheduler [flags] --kubeconfig-dir string     Default: "/etc/kubernetes" - The path where to save the kubeconfig file + The path where to save the kubeconfig file. diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_mark-master.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_kubelet-start.md similarity index 58% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_mark-master.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_kubelet-start.md index 61e3e17473a73..69a28ad329fdf 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_mark-master.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_kubelet-start.md @@ -1,25 +1,20 @@ -Mark a node as master +Writes kubelet settings and (re)starts the kubelet ### Synopsis -Applies a label that specifies that a node is a master and a taint that forces workloads to be deployed accordingly. - -Alpha Disclaimer: this command is currently alpha. +Writes a file with KubeletConfiguration and an environment file with node specific kubelet settings, and then (re)starts kubelet. ``` -kubeadm alpha phase mark-master [flags] +kubeadm init phase kubelet-start [flags] ``` ### Examples ``` - # Applies master label and taint to the current node, functionally equivalent to what executed by kubeadm init. - kubeadm alpha phase mark-master - - # Applies master label and taint to a specific node - kubeadm alpha phase mark-master --node-name myNode + # Writes a dynamic environment file with kubelet flags from a InitConfiguration file. + kubeadm init phase kubelet-start --config masterconfig.yaml ``` ### Options @@ -35,28 +30,28 @@ kubeadm alpha phase mark-master [flags] --config string - Path to kubeadm config file. WARNING: Usage of a configuration file is experimental + Path to kubeadm config file. WARNING: Usage of a configuration file is experimental. - -h, --help + --cri-socket string     Default: "/var/run/dockershim.sock" - help for mark-master + Specify the CRI socket to connect to. - --kubeconfig string     Default: "/etc/kubernetes/admin.conf" + -h, --help - The KubeConfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. + help for kubelet-start --node-name string - The node name to which label and taints should apply + Specify the node name. diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_mark-control-plane.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_mark-control-plane.md new file mode 100644 index 0000000000000..4c0d119be5cda --- /dev/null +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_mark-control-plane.md @@ -0,0 +1,78 @@ + +Mark a node as a control-plane + +### Synopsis + + +Mark a node as a control-plane + +``` +kubeadm init phase mark-control-plane [flags] +``` + +### Examples + +``` + # Applies control-plane label and taint to the current node, functionally equivalent to what executed by kubeadm init. + kubeadm init phase mark-control-plane --config config.yml + + # Applies control-plane label and taint to a specific node + kubeadm init phase mark-control-plane --node-name myNode +``` + +### Options + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--config string
Path to kubeadm config file. WARNING: Usage of a configuration file is experimental.
-h, --help
help for mark-control-plane
--node-name string
Specify the node name.
+ + + +### Options inherited from parent commands + + + + + + + + + + + + + + + + +
--rootfs string
[EXPERIMENTAL] The path to the 'real' host root filesystem.
+ + + diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_preflight_master.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_preflight.md similarity index 81% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_preflight_master.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_preflight.md index eb1b8de7efb12..b5f2626e72bae 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_preflight_master.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_preflight.md @@ -4,19 +4,17 @@ Run master pre-flight checks ### Synopsis -Run master pre-flight checks, functionally equivalent to what implemented by kubeadm init. - -Alpha Disclaimer: this command is currently alpha. +Run master pre-flight checks, functionally equivalent to what implemented by kubeadm init. ``` -kubeadm alpha phase preflight master [flags] +kubeadm init phase preflight [flags] ``` ### Examples ``` - # Run master pre-flight checks. - kubeadm alpha phase preflight master + # Run master pre-flight checks using a config file. + kubeadm init phase preflight --config kubeadm-config.yml ``` ### Options @@ -28,11 +26,25 @@ kubeadm alpha phase preflight master [flags] + + --config string + + + Path to kubeadm config file. WARNING: Usage of a configuration file is experimental. + + -h, --help - help for master + help for preflight + + + + --ignore-preflight-errors stringSlice + + + A list of checks whose errors will be shown as warnings. Example: 'IsPrivilegedUser,Swap'. Value 'all' ignores errors from all checks. @@ -49,20 +61,6 @@ kubeadm alpha phase preflight master [flags] - - --config string - - - Path to kubeadm config file (WARNING: Usage of a configuration file is experimental) - - - - --ignore-preflight-errors stringSlice - - - A list of checks whose errors will be shown as warnings. Example: 'IsPrivilegedUser,Swap'. Value 'all' ignores errors from all checks. - - --rootfs string diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_upload-config.md similarity index 85% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_upload-config.md index 11771b9355c68..0f20e04b16fc0 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_upload-config.md @@ -1,11 +1,15 @@ -Invoke subsets of kubeadm functions separately for a manual install. +Uploads the kubeadm and kubelet configuration to a ConfigMap ### Synopsis This command is not meant to be run on its own. See list of available subcommands. +``` +kubeadm init phase upload-config [flags] +``` + ### Options @@ -19,7 +23,7 @@ This command is not meant to be run on its own. See list of available subcommand - + diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_bootstrap-token.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_upload-config_all.md similarity index 70% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_bootstrap-token.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_upload-config_all.md index 638eda6f50be2..8e697d5c5b930 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_bootstrap-token.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_upload-config_all.md @@ -1,10 +1,14 @@ -Manage kubeadm-specific bootstrap token functions +Uploads all configuration to a config map ### Synopsis -This command is not meant to be run on its own. See list of available subcommands. +Uploads all configuration to a config map + +``` +kubeadm init phase upload-config all [flags] +``` ### Options @@ -15,18 +19,25 @@ This command is not meant to be run on its own. See list of available subcommand + + + + + + + - + - + diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubelet_config_annotate-cri.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_upload-config_kubeadm.md similarity index 66% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubelet_config_annotate-cri.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_upload-config_kubeadm.md index 5b9cd0fa6ac1f..986d5ac0ad817 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubelet_config_annotate-cri.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_upload-config_kubeadm.md @@ -1,21 +1,22 @@ -annotates the node with the given crisocket +Uploads the kubeadm ClusterConfiguration to a ConfigMap ### Synopsis -Adds an annotation to the current node with the CRI socket specified in the kubeadm InitConfiguration object. +Uploads the kubeadm ClusterConfiguration to a ConfigMap called kubeadm-config in the kube-system namespace. This enables correct configuration of system components and a seamless user experience when upgrading. -Alpha Disclaimer: this command is currently alpha. +Alternatively, you can use kubeadm config. ``` -kubeadm alpha phase kubelet config annotate-cri [flags] +kubeadm init phase upload-config kubeadm [flags] ``` ### Examples ``` - kubeadm alpha phase kubelet config annotate-cri --config kubeadm.yaml + # uploads the configuration of your cluster + kubeadm init phase upload-config --config=myConfig.yaml ``` ### Options @@ -31,21 +32,21 @@ kubeadm alpha phase kubelet config annotate-cri [flags] - + - + - + diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubelet_config_upload.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_upload-config_kubelet.md similarity index 76% rename from content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubelet_config_upload.md rename to content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_upload-config_kubelet.md index 63584465ca339..8eb48c01ec0a1 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_alpha_phase_kubelet_config_upload.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_init_phase_upload-config_kubelet.md @@ -1,22 +1,20 @@ -Uploads kubelet configuration to a ConfigMap based on a kubeadm InitConfiguration file. +Uploads the kubelet component config to a ConfigMap ### Synopsis -Uploads kubelet configuration extracted from the kubeadm InitConfiguration object to a ConfigMap of the form kubelet-config-1.X in the cluster, where X is the minor version of the current (API Server) Kubernetes version. - -Alpha Disclaimer: this command is currently alpha. +Uploads kubelet configuration extracted from the kubeadm InitConfiguration object to a ConfigMap of the form kubelet-config-1.X in the cluster, where X is the minor version of the current (API Server) Kubernetes version. ``` -kubeadm alpha phase kubelet config upload [flags] +kubeadm init phase upload-config kubelet [flags] ``` ### Examples ``` # Uploads the kubelet configuration from the kubeadm Config file to a ConfigMap in the cluster. - kubeadm alpha phase kubelet config upload --config kubeadm.yaml + kubeadm init phase upload-config kubelet --config kubeadm.yaml ``` ### Options @@ -32,21 +30,21 @@ kubeadm alpha phase kubelet config upload [flags] - + - + - + diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_join.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_join.md index cc288daa976a9..5116ad9850109 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_join.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_join.md @@ -16,7 +16,7 @@ provide a file - a subset of the standard kubeconfig file. This file can be a local file or downloaded via an HTTPS URL. The forms are kubeadm join --discovery-token abcdef.1234567890abcdef 1.2.3.4:6443, kubeadm join --discovery-file path/to/file.conf, or kubeadm join ---discovery-file `https://url/file.conf`. Only one form can be used. If +--discovery-file https://url/file.conf. Only one form can be used. If the discovery information is loaded from a URL, HTTPS must be used. Also, in that case the host installed CA bundle is used to verify the connection. @@ -92,14 +92,14 @@ kubeadm join [flags] - + - + @@ -123,13 +123,6 @@ kubeadm join [flags] - - - - - - - @@ -151,18 +144,11 @@ kubeadm join [flags] - - - - - - - - + diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_reset.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_reset.md index d4f273f1c8dbd..ee319608530e4 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_reset.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_reset.md @@ -54,6 +54,13 @@ kubeadm reset [flags] + + + + + + +
-h, --help
help for phasehelp for upload-config
--config string
Path to kubeadm config file. WARNING: Usage of a configuration file is experimental.
-h, --help
help for bootstrap-tokenhelp for all
--kubeconfig string     Default: "/etc/kubernetes/admin.conf"
The KubeConfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file.The kubeconfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file.
--config string
Path to kubeadm config file (WARNING: Usage of a configuration file is experimental)Path to kubeadm config file. WARNING: Usage of a configuration file is experimental.
-h, --help
help for annotate-crihelp for kubeadm
--kubeconfig string     Default: "/etc/kubernetes/admin.conf"
The KubeConfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file.The kubeconfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file.
--config string
Path to kubeadm config file (WARNING: Usage of a configuration file is experimental)Path to kubeadm config file. WARNING: Usage of a configuration file is experimental.
-h, --help
help for uploadhelp for kubelet
--kubeconfig string     Default: "/etc/kubernetes/admin.conf"
The KubeConfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file.The kubeconfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file.
--discovery-file string
A file or url from which to load cluster information.A file or URL from which to load cluster information.
--discovery-token string
A token used to validate cluster information fetched from the api server.A token used to validate cluster information fetched from the API server.
Create a new control plane instance on this node
--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 (BETA - default=false)
-h, --help
Specify the node name.
--tls-bootstrap-token string
A token used for TLS bootstrapping.
--token string
Use this token for both discovery-token and tls-bootstrap-token.Use this token for both discovery-token and tls-bootstrap-token when those values are not provided.
A list of checks whose errors will be shown as warnings. Example: 'IsPrivilegedUser,Swap'. Value 'all' ignores errors from all checks.
--kubeconfig string     Default: "/etc/kubernetes/admin.conf"
The kubeconfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file.
diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_token.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_token.md index 77e2596f6b257..3ba6f214561f8 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_token.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_token.md @@ -54,7 +54,7 @@ kubeadm token [flags] --kubeconfig string     Default: "/etc/kubernetes/admin.conf" - The KubeConfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. + The kubeconfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_token_create.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_token_create.md index fe2a710103ccb..dfb557fcc6eaf 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_token_create.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_token_create.md @@ -100,7 +100,7 @@ kubeadm token create [token] --kubeconfig string     Default: "/etc/kubernetes/admin.conf" - The KubeConfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. + The kubeconfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_token_delete.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_token_delete.md index 3a92d9ff74feb..415ce6e1078a7 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_token_delete.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_token_delete.md @@ -56,7 +56,7 @@ kubeadm token delete [token-value] --kubeconfig string     Default: "/etc/kubernetes/admin.conf" - The KubeConfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. + The kubeconfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_token_generate.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_token_generate.md index 43aed13f1c323..2194e642031d9 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_token_generate.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_token_generate.md @@ -61,7 +61,7 @@ kubeadm token generate [flags] --kubeconfig string     Default: "/etc/kubernetes/admin.conf" - The KubeConfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. + The kubeconfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_token_list.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_token_list.md index ed4f822fd46ec..d49fb72c86740 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_token_list.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_token_list.md @@ -53,7 +53,7 @@ kubeadm token list [flags] --kubeconfig string     Default: "/etc/kubernetes/admin.conf" - The KubeConfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. + The kubeconfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_upgrade_apply.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_upgrade_apply.md index 87ace5dcc009c..b199ac406fdf3 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_upgrade_apply.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_upgrade_apply.md @@ -37,7 +37,7 @@ kubeadm upgrade apply [version] --config string - Path to kubeadm config file (WARNING: Usage of a configuration file is experimental) + Path to a kubeadm configuration file. @@ -65,7 +65,7 @@ kubeadm upgrade apply [version] --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 (BETA - default=false) + A set of key=value pairs that describe feature gates for various features. Options are:
@@ -97,10 +97,10 @@ kubeadm upgrade apply [version] - --kubeconfig string     Default: "/Users/zarnold/.kube/config" + --kubeconfig string     Default: "/Users/tim/.kube/config" - The KubeConfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. + The kubeconfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_upgrade_diff.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_upgrade_diff.md index 099dd2381c162..0403034bdfaab 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_upgrade_diff.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_upgrade_diff.md @@ -30,7 +30,7 @@ kubeadm upgrade diff [version] [flags] --config string - Path to kubeadm config file (WARNING: Usage of a configuration file is experimental) + Path to a kubeadm configuration file. diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_upgrade_node_config.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_upgrade_node_config.md index 957e151227aa9..85c5ccd8fec68 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_upgrade_node_config.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_upgrade_node_config.md @@ -14,11 +14,11 @@ kubeadm upgrade node config [flags] ``` # Downloads the kubelet configuration from the ConfigMap in the cluster. Uses a specific desired kubelet version. - kubeadm upgrade node config --kubelet-version v1.12.0 + kubeadm upgrade node config --kubelet-version v1.13.0 # Simulates the downloading of the kubelet configuration from the ConfigMap in the cluster with a specific desired # version. Does not change any state locally on the node. - kubeadm upgrade node config --kubelet-version v1.12.0 --dry-run + kubeadm upgrade node config --kubelet-version v1.13.0 --dry-run ``` ### Options @@ -48,7 +48,7 @@ kubeadm upgrade node config [flags] --kubeconfig string     Default: "/etc/kubernetes/kubelet.conf" - The KubeConfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. + The kubeconfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_upgrade_node_experimental-control-plane.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_upgrade_node_experimental-control-plane.md index 091f7ac1edd64..7b85992770d3d 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_upgrade_node_experimental-control-plane.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_upgrade_node_experimental-control-plane.md @@ -14,11 +14,11 @@ kubeadm upgrade node experimental-control-plane [flags] ``` # Downloads the kubelet configuration from the ConfigMap in the cluster. Uses a specific desired kubelet version. - kubeadm upgrade node config --kubelet-version v1.12.0 + kubeadm upgrade node config --kubelet-version v1.13.0 # Simulates the downloading of the kubelet configuration from the ConfigMap in the cluster with a specific desired # version. Does not change any state locally on the node. - kubeadm upgrade node config --kubelet-version v1.12.0 --dry-run + kubeadm upgrade node config --kubelet-version v1.13.0 --dry-run ``` ### Options @@ -37,6 +37,13 @@ kubeadm upgrade node experimental-control-plane [flags] Do not change any state, just output the actions that would be performed. + + --etcd-upgrade     Default: true + + + Perform the upgrade of etcd. + + -h, --help @@ -48,7 +55,7 @@ kubeadm upgrade node experimental-control-plane [flags] --kubeconfig string     Default: "/etc/kubernetes/kubelet.conf" - The KubeConfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. + The kubeconfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. diff --git a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_upgrade_plan.md b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_upgrade_plan.md index 842e070f19ad1..a58b22d6ba5f2 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_upgrade_plan.md +++ b/content/en/docs/reference/setup-tools/kubeadm/generated/kubeadm_upgrade_plan.md @@ -37,14 +37,14 @@ kubeadm upgrade plan [version] [flags] --config string - Path to kubeadm config file (WARNING: Usage of a configuration file is experimental) + Path to a kubeadm configuration 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 (BETA - default=false) + A set of key=value pairs that describe feature gates for various features. Options are:
@@ -62,10 +62,10 @@ kubeadm upgrade plan [version] [flags] - --kubeconfig string     Default: "/Users/zarnold/.kube/config" + --kubeconfig string     Default: "/Users/tim/.kube/config" - The KubeConfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. + The kubeconfig file to use when talking to the cluster. If the flag is not set, a set of standard locations are searched for an existing KubeConfig file. diff --git a/content/en/docs/reference/setup-tools/kubeadm/implementation-details.md b/content/en/docs/reference/setup-tools/kubeadm/implementation-details.md index 36cb28b8e2607..b5c6ebd32c42a 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/implementation-details.md +++ b/content/en/docs/reference/setup-tools/kubeadm/implementation-details.md @@ -71,7 +71,7 @@ in a majority of cases, and the most intuitive location; other constants paths a The `kubeadm init` [internal workflow](/docs/reference/setup-tools/kubeadm/kubeadm-init/#init-workflow) consists of a sequence of atomic work tasks to perform, as described in `kubeadm init`. -The [`kubeadm alpha phase`](/docs/reference/setup-tools/kubeadm/kubeadm-alpha/) command allows users to invoke individually each task, and ultimately offers a reusable and composable +The [`kubeadm init phase`](/docs/reference/setup-tools/kubeadm/kubeadm-init-phase/) command allows users to invoke individually each task, and ultimately offers a reusable and composable API/toolbox that can be used by other Kubernetes bootstrap tools, by any IT automation tool or by advanced user for creating custom clusters. @@ -122,7 +122,7 @@ In any case the user can skip specific preflight checks (or eventually all prefl Please note that: -1. Preflight checks can be invoked individually with the [`kubeadm alpha phase preflight`](/docs/reference/setup-tools/kubeadm/kubeadm-alpha/#cmd-phase-preflight) command +1. Preflight checks can be invoked individually with the [`kubeadm init phase preflight`](/docs/reference/setup-tools/kubeadm/kubeadm-init-phase/#cmd-phase-preflight) command ### Generate the necessary certificates @@ -158,7 +158,7 @@ Certificates are stored by default in `/etc/kubernetes/pki`, but this directory 3. If kubeadm is running in [ExternalCA mode](/docs/reference/setup-tools/kubeadm/kubeadm-init/#external-ca-mode); all the certificates must be provided by the user, because kubeadm cannot generate them by itself 4. In case of kubeadm is executed in the `--dry-run` mode, certificates files are written in a temporary folder -5. Certificate generation can be invoked individually with the [`kubeadm alpha phase certs all`](/docs/reference/setup-tools/kubeadm/kubeadm-alpha/#cmd-phase-certs) command +5. Certificate generation can be invoked individually with the [`kubeadm init phase certs all`](/docs/reference/setup-tools/kubeadm/kubeadm-init-phase/#cmd-phase-certs) command ### Generate kubeconfig files for control plane components @@ -186,7 +186,7 @@ Please note that: 2. If a given kubeconfig file exists, and its content is evaluated compliant with the above specs, the existing file will be used and the generation phase for the given kubeconfig skipped 3. If kubeadm is running in [ExternalCA mode](/docs/reference/setup-tools/kubeadm/kubeadm-init/#external-ca-mode), all the required kubeconfig must be provided by the user as well, because kubeadm cannot generate any of them by itself 4. In case of kubeadm is executed in the `--dry-run` mode, kubeconfig files are written in a temporary folder -5. Kubeconfig files generation can be invoked individually with the [`kubeadm alpha phase kubeconfig all`](/docs/reference/setup-tools/kubeadm/kubeadm-alpha/#cmd-phase-kubeconfig) command +5. Kubeconfig files generation can be invoked individually with the [`kubeadm init phase kubeconfig all`](/docs/reference/setup-tools/kubeadm/kubeadm-init-phase/#cmd-phase-kubeconfig) command ### Generate static Pod manifests for control plane components @@ -213,7 +213,7 @@ Please note that: should be used for all control plane components, this one will be used. see [using custom images](/docs/reference/setup-tools/kubeadm/kubeadm-init/#custom-images) for more details 2. In case of kubeadm is executed in the `--dry-run` mode, static Pods files are written in a temporary folder -3. Static Pod manifest generation for master components can be invoked individually with the [`kubeadm alpha phase controlplane all`](/docs/reference/setup-tools/kubeadm/kubeadm-alpha/#cmd-phase-controlplane) command +3. Static Pod manifest generation for master components can be invoked individually with the [`kubeadm init phase control-plane all`](/docs/reference/setup-tools/kubeadm/kubeadm-init-phase/#cmd-phase-control-plane) command #### API server @@ -226,10 +226,6 @@ The static Pod manifest for the API server is affected by following parameters p if an external etcd server is not be provided, a local etcd will be used (via host network) - If a cloud provider is specified, the corresponding `--cloud-provider` is configured, together with the `--cloud-config` path if such file exists (this is experimental, alpha and will be removed in a future version) - - If kubeadm is invoked with `--feature-gates=HighAvailability`, the flag `--endpoint-reconciler-type=lease` is set, thus enabling - automatic reconciliation of endpoints for the internal API server VIP - - If kubeadm is invoked with `--feature-gates=DynamicKubeletConfig`, the corresponding feature on API server is activated - with the `--feature-gates=DynamicKubeletConfig=true` flag Other API server flags that are set unconditionally are: @@ -309,11 +305,11 @@ Please note that: 1. The etcd image will be pulled from `k8s.gcr.io`. In case an alternative image repository is specified this one will be used; In case an alternative image name is specified, this one will be used. see [using custom images](/docs/reference/setup-tools/kubeadm/kubeadm-init/#custom-images) for more details 2. in case of kubeadm is executed in the `--dry-run` mode, the etcd static Pod manifest is written in a temporary folder -3. Static Pod manifest generation for local etcd can be invoked individually with the [`kubeadm alpha phase etcd local`](/docs/reference/setup-tools/kubeadm/kubeadm-alpha/#cmd-phase-etcd) command +3. Static Pod manifest generation for local etcd can be invoked individually with the [`kubeadm init phase etcd local`](/docs/reference/setup-tools/kubeadm/kubeadm-init-phase/#cmd-phase-etcd) command -### (optional and alpha in v1.9) Write init kubelet configuration +### Optional Dynamic Kublet Configuration -If kubeadm is invoked with `--feature-gates=DynamicKubeletConfig`, it writes the kubelet init configuration +To use this functionality call `kubeadm alpha kubelet config enable-dynamic`. It writes the kubelet init configuration into `/var/lib/kubelet/config/init/kubelet` file. The init configuration is used for starting the kubelet on this specific node, providing an alternative for the kubelet drop-in file; @@ -345,7 +341,7 @@ If kubeadm is invoked with `--feature-gates=DynamicKubeletConfig`: 1. Write the kubelet base configuration into the `kubelet-base-config-v1.9` ConfigMap in the `kube-system` namespace 2. Creates RBAC rules for granting read access to that ConfigMap to all bootstrap tokens and all kubelet instances (that is `system:bootstrappers:kubeadm:default-node-token` and `system:nodes` groups) -3. Enable the dynamic kubelet configuration feature for the initial master node by pointing `Node.spec.configSource` to the newly-created ConfigMap +3. Enable the dynamic kubelet configuration feature for the initial control-plane node by pointing `Node.spec.configSource` to the newly-created ConfigMap ### Save the kubeadm ClusterConfiguration in a ConfigMap for later reference @@ -358,7 +354,7 @@ state and make new decisions based on that data. Please note that: 1. Before uploading, sensitive information like e.g. the token are stripped from the configuration -2. Upload of master configuration can be invoked individually with the [`kubeadm alpha phase upload-config`](/docs/reference/setup-tools/kubeadm/kubeadm-alpha/#cmd-phase-upload-config) command +2. Upload of master configuration can be invoked individually with the [`kubeadm init phase upload-config`](/docs/reference/setup-tools/kubeadm/kubeadm-init-phase/#cmd-phase-upload-config) command 3. If you initialized your cluster using kubeadm v1.7.x or lower, you must create manually the master configuration ConfigMap before `kubeadm upgrade` to v1.8 . In order to facilitate this task, the [`kubeadm config upload (from-flags|from-file)`](/docs/reference/setup-tools/kubeadm/kubeadm-config/) was implemented @@ -372,7 +368,7 @@ As soon as the control plane is available, kubeadm executes following actions: Please note that: -1. Mark master phase can be invoked individually with the [`kubeadm alpha phase mark-master`](/docs/reference/setup-tools/kubeadm/kubeadm-alpha/#cmd-phase-mark-master) command +1. Mark control-plane phase phase can be invoked individually with the [`kubeadm init phase mark-control-plane`](/docs/reference/setup-tools/kubeadm/kubeadm-init-phase/#cmd-phase-mark-master) command ### Configure TLS-Bootstrapping for node joining @@ -383,7 +379,7 @@ existing cluster; for more details see also [design proposal](https://github.com setting API server and controller flags as already described in previous paragraphs. Please note that: -1. TLS bootstrapping for nodes can be configured with the [`kubeadm alpha phase bootstrap-token all`](/docs/reference/setup-tools/kubeadm/kubeadm-alpha/#cmd-phase-bootstrap-token) +1. TLS bootstrapping for nodes can be configured with the [`kubeadm init phase bootstrap-token`](/docs/reference/setup-tools/kubeadm/kubeadm-init-phase/#cmd-phase-bootstrap-token) command, executing all the configuration steps described in following paragraphs; alternatively, each step can be invoked individually #### Create a bootstrap token @@ -441,7 +437,7 @@ can handle to serving the `cluster-info` ConfigMap. Kubeadm installs the internal DNS server and the kube-proxy addon components via the API server. Please note that: -1. This phase can be invoked individually with the [`kubeadm alpha phase addon all`](/docs/reference/setup-tools/kubeadm/kubeadm-alpha/#cmd-phase-addon) command. +1. This phase can be invoked individually with the [`kubeadm init phase addon all`](/docs/reference/setup-tools/kubeadm/kubeadm-init-phase/#cmd-phase-addon) command. #### proxy @@ -457,9 +453,11 @@ Note that: - The CoreDNS service is named `kube-dns`. This is done to prevent any interruption in service when the user is switching the cluster DNS from kube-dns to CoreDNS or vice-versa -- In Kubernetes version 1.11 and later, CoreDNS is the default DNS server and you must -invoke kubeadm with `--feature-gates=CoreDNS=false` to install kube-dns instead - In Kubernetes version 1.10 and earlier, you must enable CoreDNS with `--feature-gates=CoreDNS=true` +- In Kubernetes version 1.11 and 1.12, CoreDNS is the default DNS server and you must +invoke kubeadm with `--feature-gates=CoreDNS=false` to install kube-dns instead +- In Kubernetes version 1.13 and later, the `CoreDNS` feature gate is no longer available and kube-dns can be installed using the `--config` method described [here](/docs/reference/setup-tools/kubeadm/kubeadm-init-phase/#cmd-phase-addon) + A ServiceAccount for CoreDNS/kube-dns is created in the `kube-system` namespace. @@ -468,11 +466,11 @@ Deploy the `kube-dns` Deployment and Service: - It's the upstream CoreDNS deployment relatively unmodified - The `kube-dns` ServiceAccount is bound to the privileges in the `system:kube-dns` ClusterRole -### (Optional and alpha in v1.9) self-hosting +### Optional self-hosting -This phase is performed only if `kubeadm init` is invoked with `—features-gates=selfHosting` +To enable self hosting on a existing static Pod control-plane use `kubeadm alpha selfhosting pivot`. -The self hosting phase basically replaces static Pods for control plane components with DaemonSets; this is achieved by executing +Self hosting basically replaces static Pods for control plane components with DaemonSets; this is achieved by executing following procedure for API server, scheduler and controller manager static Pods: - Load the static Pod specification from disk @@ -485,21 +483,9 @@ following procedure for API server, scheduler and controller manager static Pods - Create the DaemonSet resource in `kube-system` namespace. Wait until the Pods are running. - Remove the static Pod manifest file. The kubelet will stop the original static Pod-hosted component that was running -Please note that: - -1. Self hosting is not yet resilient to node restarts; this can be fixed with external checkpointing or with kubelet checkpointing +Please note that self hosting is not yet resilient to node restarts; this can be fixed with external checkpointing or with kubelet checkpointing for the control plane Pods. See [self-hosting](/docs/reference/setup-tools/kubeadm/kubeadm-init/#self-hosting) for more details. -2. If invoked with `—features-gates=StoreCertsInSecrets` following additional steps will be executed - - - Creation of `ca`, `apiserver`, `apiserver-kubelet-client`, `sa`, `front-proxy-ca`, `front-proxy-client` TLS secrets - in `kube-system` namespace with respective certificates and keys. - Important! storing the CA key in a Secret might have security implications - - Creation of `schedler.conf` and `controller-manager.conf` secrets in`kube-system` namespace with respective kubeconfig files - - Mutation of all the Pod specs by replacing host path volumes with projected volumes from the secrets above - -3. This phase can be invoked individually with the [`kubeadm alpha phase selfhosting convert-from-staticpods`](/docs/reference/setup-tools/kubeadm/kubeadm-alpha/#cmd-phase-self-hosting) command. - ## kubeadm join phases internal design Similarly to `kubeadm init`, also `kubeadm join` internal workflow consists of a sequence of atomic work tasks to perform. diff --git a/content/en/docs/reference/setup-tools/kubeadm/kubeadm-alpha.md b/content/en/docs/reference/setup-tools/kubeadm/kubeadm-alpha.md index 68c14d99d4b9d..da92919353a51 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/kubeadm-alpha.md +++ b/content/en/docs/reference/setup-tools/kubeadm/kubeadm-alpha.md @@ -11,162 +11,64 @@ weight: 90 from the community. Please try it out and give us feedback! {{< /caution >}} -In v1.8.0, kubeadm introduced the `kubeadm alpha phase` command with the aim of making kubeadm more modular. This modularity enables you to invoke atomic sub-steps of the bootstrap process; you can let kubeadm do some parts and fill in yourself where you need customizations. - -`kubeadm alpha phase` is consistent with [kubeadm init workflow](/docs/reference/setup-tools/kubeadm/kubeadm-init/#init-workflow), -and behind the scene both use the same code. - -## kubeadm alpha phase preflight {#cmd-phase-preflight} - -You can execute preflight checks both for the master node, like in `kubeadm init`, or for the worker node -like in `kubeadm join`. - -{{< tabs name="tab-preflight" >}} -{{< tab name="master" include="generated/kubeadm_alpha_phase_preflight_master.md" />}} -{{< tab name="node" include="generated/kubeadm_alpha_phase_preflight_node.md" />}} -{{< /tabs >}} - - -## kubeadm alpha phase certs {#cmd-phase-certs} - -You can create all required certificates with the `all` subcommand or selectively create certificates. - -{{< tabs name="tab-certs" >}} -{{< tab name="all" include="generated/kubeadm_alpha_phase_certs_all.md" />}} -{{< tab name="ca" include="generated/kubeadm_alpha_phase_certs_ca.md" />}} -{{< tab name="apiserver" include="generated/kubeadm_alpha_phase_certs_apiserver.md" />}} -{{< tab name="apiserver-kubelet-client" include="generated/kubeadm_alpha_phase_certs_apiserver-kubelet-client.md" />}} -{{< tab name="sa" include="generated/kubeadm_alpha_phase_certs_sa.md" />}} -{{< tab name="front-proxy-ca" include="generated/kubeadm_alpha_phase_certs_front-proxy-ca.md" />}} -{{< tab name="front-proxy-client" include="generated/kubeadm_alpha_phase_certs_front-proxy-client.md" />}} -{{< /tabs >}} - -## kubeadm alpha phase certs renew {#cmd-phase-certs-renew} +## kubeadm alpha certs renew {#cmd-certs-renew} You can renew all Kubernetes certificates using the `all` subcommand or renew them selectively. {{< tabs name="tab-certs-renew" >}} -{{< tab name="all" include="generated/kubeadm_alpha_phase_certs_renew_all.md" />}} -{{< tab name="apiserver-etcd-client" include="generated/kubeadm_alpha_phase_certs_renew_apiserver-etcd-client.md" />}} -{{< tab name="apiserver-kubelet-client" include="generated/kubeadm_alpha_phase_certs_renew_apiserver-kubelet-client.md" />}} -{{< tab name="apiserver" include="generated/kubeadm_alpha_phase_certs_renew_apiserver.md" />}} -{{< tab name="etcd-healthcheck-client" include="generated/kubeadm_alpha_phase_certs_renew_etcd-healthcheck-client.md" />}} -{{< tab name="etcd-peer" include="generated/kubeadm_alpha_phase_certs_renew_etcd-peer.md" />}} -{{< tab name="etcd-server" include="generated/kubeadm_alpha_phase_certs_renew_etcd-server.md" />}} -{{< tab name="front-proxy-client" include="generated/kubeadm_alpha_phase_certs_renew_front-proxy-client.md" />}} +{{< tab name="renew" include="generated/kubeadm_alpha_certs_renew.md" />}} +{{< tab name="all" include="generated/kubeadm_alpha_certs_renew_all.md" />}} +{{< tab name="apiserver-etcd-client" include="generated/kubeadm_alpha_certs_renew_apiserver-etcd-client.md" />}} +{{< tab name="apiserver-kubelet-client" include="generated/kubeadm_alpha_certs_renew_apiserver-kubelet-client.md" />}} +{{< tab name="apiserver" include="generated/kubeadm_alpha_certs_renew_apiserver.md" />}} +{{< tab name="etcd-healthcheck-client" include="generated/kubeadm_alpha_certs_renew_etcd-healthcheck-client.md" />}} +{{< tab name="etcd-peer" include="generated/kubeadm_alpha_certs_renew_etcd-peer.md" />}} +{{< tab name="etcd-server" include="generated/kubeadm_alpha_certs_renew_etcd-server.md" />}} +{{< tab name="front-proxy-client" include="generated/kubeadm_alpha_certs_renew_front-proxy-client.md" />}} {{< /tabs >}} -## kubeadm alpha phase kubeconfig {#cmd-phase-kubeconfig} -You can create all required kubeconfig files with the `all` subcommand, or selectively create the files. -Additionally, the `user` subcommand supports the creation of kubeconfig files for additional users. +## kubeadm alpha kubeconfig user {#cmd-phase-kubeconfig} + +The `user` subcommand can be used for the creation of kubeconfig files for additional users. {{< tabs name="tab-kubeconfig" >}} -{{< tab name="all" include="generated/kubeadm_alpha_phase_kubeconfig_all.md" />}} -{{< tab name="admin" include="generated/kubeadm_alpha_phase_kubeconfig_admin.md" />}} -{{< tab name="kubelet" include="generated/kubeadm_alpha_phase_kubeconfig_kubelet.md" />}} -{{< tab name="controller-manager" include="generated/kubeadm_alpha_phase_kubeconfig_controller-manager.md" />}} -{{< tab name="scheduler" include="generated/kubeadm_alpha_phase_kubeconfig_scheduler.md" />}} -{{< tab name="user" include="generated/kubeadm_alpha_phase_kubeconfig_user.md" />}} +{{< tab name="kubeconfig" include="generated/kubeadm_alpha_kubeconfig.md" />}} +{{< tab name="user" include="generated/kubeadm_alpha_kubeconfig_user.md" />}} {{< /tabs >}} -## kubeadm alpha phase kubelet {#cmd-phase-kubelet} +## kubeadm alpha kubelet config {#cmd-phase-kubelet} -Use the following commands to manage the kubelet phase. +Use the following commands to either download the kubelet configuration from the cluster or +to enable the DynamicKubeletConfiguration feature. {{< tabs name="tab-kubelet" >}} -{{< tab name="config annotate-cri" include="generated/kubeadm_alpha_phase_kubelet_config_annotate-cri.md" />}} -{{< tab name="config download" include="generated/kubeadm_alpha_phase_kubelet_config_download.md" />}} -{{< tab name="config enable-dynamic" include="generated/kubeadm_alpha_phase_kubelet_config_enable-dynamic.md" />}} -{{< tab name="config upload" include="generated/kubeadm_alpha_phase_kubelet_config_upload.md" />}} -{{< tab name="config write-to-disk" include="generated/kubeadm_alpha_phase_kubelet_config_write-to-disk.md" />}} -{{< tab name="write-env-file" include="generated/kubeadm_alpha_phase_kubelet_write-env-file.md" />}} -{{< /tabs >}} - -## kubeadm alpha phase controlplane {#cmd-phase-controlplane} - -You can create all required static Pod files for the control plane components with the `all` subcommand, -or selectively create the files. - -{{< tabs name="tab-controlplane" >}} -{{< tab name="all" include="generated/kubeadm_alpha_phase_controlplane_all.md" />}} -{{< tab name="apiserver" include="generated/kubeadm_alpha_phase_controlplane_apiserver.md" />}} -{{< tab name="controller-manager" include="generated/kubeadm_alpha_phase_controlplane_controller-manager.md" />}} -{{< tab name="scheduler" include="generated/kubeadm_alpha_phase_controlplane_scheduler.md" />}} -{{< /tabs >}} - - -## kubeadm alpha phase etcd {#cmd-phase-etcd} - -Use the following command to create a self-hosted, local etcd instance based on a static Pod file. - -{{< tabs name="tab-etcd" >}} -{{< tab name="etcd local" include="generated/kubeadm_alpha_phase_etcd_local.md" />}} -{{< /tabs >}} - - -## kubeadm alpha phase mark-master {#cmd-phase-mark-master} - -Use the following command to label and taint the node with the `node-role.kubernetes.io/master=""` key-value pair. - -{{< tabs name="tab-mark-master" >}} -{{< tab name="mark-master" include="generated/kubeadm_alpha_phase_mark-master.md" />}} -{{< /tabs >}} - - -## kubeadm alpha phase bootstrap-token {#cmd-phase-bootstrap-token} - -Use the following actions to fully configure bootstrap tokens. -You can fully configure bootstrap tokens with the `all` subcommand, -or selectively configure single elements. - -{{< tabs name="tab-bootstrap-token" >}} -{{< tab name="all" include="generated/kubeadm_alpha_phase_bootstrap-token_all.md" />}} -{{< tab name="create" include="generated/kubeadm_alpha_phase_bootstrap-token_create.md" />}} -{{< tab name="cluster-info" include="generated/kubeadm_alpha_phase_bootstrap-token_cluster-info.md " />}} -{{< tab name="node allow-auto-approve" include="generated/kubeadm_alpha_phase_bootstrap-token_node_allow-auto-approve.md" />}} -{{< tab name="node allow-post-csrs" include="generated/kubeadm_alpha_phase_bootstrap-token_node_allow-post-csrs.md" />}} +{{< tab name="kubelet" include="generated/kubeadm_alpha_kubelet.md" />}} +{{< tab name="download" include="generated/kubeadm_alpha_kubelet_config_download.md" />}} +{{< tab name="enable-dynamic" include="generated/kubeadm_alpha_kubelet_config_download.md" />}} {{< /tabs >}} +## kubeadm alpha preflight node {#cmd-phase-preflight} -## kubeadm alpha phase upload-config {#cmd-phase-upload-config} +You can use the `node` sub command to run preflight checks on a worker node. -You can use this command to upload the kubeadm configuration to your cluster. -Alternatively, you can use [kubeadm config](/docs/reference/setup-tools/kubeadm/kubeadm-config/). - -{{< tabs name="upload-config" >}} -{{< tab name="mark-master" include="generated/kubeadm_alpha_phase_upload-config.md" />}} -{{< /tabs >}} - - -## kubeadm alpha phase addon {#cmd-phase-addon} - -You can install all the available addons with the `all` subcommand, or -install them selectively. - -{{< note >}} -If `kubeadm` is invoked with `--feature-gates=CoreDNS=false`, kube-dns is installed. -{{< /note >}} - -{{< tabs name="tab-addon" >}} -{{< tab name="all" include="generated/kubeadm_alpha_phase_addon_all.md" />}} -{{< tab name="kube-proxy" include="generated/kubeadm_alpha_phase_addon_kube-proxy.md" />}} -{{< tab name="coredns" include="generated/kubeadm_alpha_phase_addon_coredns.md" />}} +{{< tabs name="tab-preflight" >}} +{{< tab name="preflight" include="generated/kubeadm_alpha_preflight.md" />}} +{{< tab name="node" include="generated/kubeadm_alpha_preflight_node.md" />}} {{< /tabs >}} -## kubeadm alpha phase self-hosting {#cmd-phase-self-hosting} +## kubeadm alpha selfhosting pivot {#cmd-selfhosting} -{{< caution >}} -Self-hosting is an alpha feature. See [kubeadm init](/docs/reference/setup-tools/kubeadm/kubeadm-init/) documentation for self-hosting limitations. -{{< /caution >}} +The subcommand `pivot` can be used to conver a static Pod-hosted control plane into a self-hosted one. -{{< tabs name="tab-self-hosting" >}} -{{< tab name="self-hosting" include="generated/kubeadm_alpha_phase_selfhosting_convert-from-staticpods.md" />}} +{{< tabs name="selfhosting" >}} +{{< tab name="selfhosting" include="generated/kubeadm_alpha_selfhosting.md" />}} +{{< tab name="pivot" include="generated/kubeadm_alpha_selfhosting_pivot.md" />}} {{< /tabs >}} ## What's next -* [kubeadm init](/docs/reference/setup-tools/kubeadm/kubeadm-init/) to bootstrap a Kubernetes master node +* [kubeadm init](/docs/reference/setup-tools/kubeadm/kubeadm-init/) to bootstrap a Kubernetes control-plane node * [kubeadm join](/docs/reference/setup-tools/kubeadm/kubeadm-join/) to connect a node to the cluster * [kubeadm reset](/docs/reference/setup-tools/kubeadm/kubeadm-reset/) to revert any changes made to this host by `kubeadm init` or `kubeadm join` diff --git a/content/en/docs/reference/setup-tools/kubeadm/kubeadm-config.md b/content/en/docs/reference/setup-tools/kubeadm/kubeadm-config.md index b5e9a19f9315d..e7ea1eaefe02d 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/kubeadm-config.md +++ b/content/en/docs/reference/setup-tools/kubeadm/kubeadm-config.md @@ -21,6 +21,10 @@ to print the default configuration and `kubeadm config migrate` to convert your 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. +In Kubernetes v1.13.0 and later to list/pull kube-dns images instead of the CoreDNS image +the `--config` method described [here](/docs/reference/setup-tools/kubeadm/kubeadm-init-phase/#cmd-phase-addon) +has to be used. + {{% /capture %}} {{% capture body %}} @@ -33,8 +37,11 @@ to list and pull the images that kubeadm requires. ## kubeadm config view {#cmd-config-view} {{< include "generated/kubeadm_config_view.md" >}} -## kubeadm config print-default {#cmd-config-print-default} -{{< include "generated/kubeadm_config_print-default.md" >}} +## kubeadm config print init-defaults {#cmd-config-print-init-defaults} +{{< include "generated/kubeadm_config_print_init-defaults.md" >}} + +## kubeadm config print join-defaults {#cmd-config-print-join-defaults} +{{< include "generated/kubeadm_config_print_join-defaults.md" >}} ## kubeadm config migrate {#cmd-config-migrate} {{< include "generated/kubeadm_config_migrate.md" >}} diff --git a/content/en/docs/reference/setup-tools/kubeadm/kubeadm-init-phase.md b/content/en/docs/reference/setup-tools/kubeadm/kubeadm-init-phase.md new file mode 100644 index 0000000000000..360ac57aac704 --- /dev/null +++ b/content/en/docs/reference/setup-tools/kubeadm/kubeadm-init-phase.md @@ -0,0 +1,155 @@ +--- +title: kubeadm init phase +weight: 90 +--- +In v1.8.0, kubeadm introduced the `kubeadm alpha phase` command with the aim of making kubeadm more modular. In v1.13.0 this command graduated to `kubeadm init phase`. This modularity enables you to invoke atomic sub-steps of the bootstrap process. Hence, you can let kubeadm do some parts and fill in yourself where you need customizations. + +`kubeadm init phase` is consistent with the [kubeadm init workflow](/docs/reference/setup-tools/kubeadm/kubeadm-init/#init-workflow), +and behind the scene both use the same code. + +## kubeadm init phase preflight {#cmd-phase-preflight} + +Using this command you can execute preflight checks on a control-plane node. + +{{< tabs name="tab-preflight" >}} +{{< tab name="preflight" include="generated/kubeadm_init_phase_preflight.md" />}} +{{< /tabs >}} + +## kubeadm init phase certs {#cmd-phase-certs} + +Can be used to create all required certificates by kubeadm. + +{{< tabs name="tab-certs" >}} +{{< tab name="certs" include="generated/kubeadm_init_phase_certs.md" />}} +{{< tab name="all" include="generated/kubeadm_init_phase_certs_all.md" />}} +{{< tab name="apiserver-etcd-client" include="generated/kubeadm_init_phase_certs_apiserver-etcd-client.md" />}} +{{< tab name="apiserver-kubelet-client" include="generated/kubeadm_init_phase_certs_apiserver-kubelet-client.md" />}} +{{< tab name="apiserver" include="generated/kubeadm_init_phase_certs_apiserver.md" />}} +{{< tab name="ca" include="generated/kubeadm_init_phase_certs_ca.md" />}} +{{< tab name="etcd-ca" include="generated/kubeadm_init_phase_certs_etcd-ca.md" />}} +{{< tab name="healthcheck-client" include="generated/kubeadm_init_phase_certs_etcd-healthcheck-client.md" />}} +{{< tab name="etcd-peer" include="generated/kubeadm_init_phase_certs_etcd-peer.md" />}} +{{< tab name="etcd-server" include="generated/kubeadm_init_phase_certs_etcd-server.md" />}} +{{< tab name="front-proxy-ca" include="generated/kubeadm_init_phase_certs_front-proxy-ca.md" />}} +{{< tab name="front-proxy-client" include="generated/kubeadm_init_phase_certs_front-proxy-client.md" />}} +{{< tab name="certs_sa" include="generated/kubeadm_init_phase_certs_sa.md" />}} +{{< /tabs >}} + +## kubeadm init phase kubeconfig {#cmd-phase-kubeconfig} + +You can create all required kubeconfig files by calling the `all` subcommand or call then individually. + +{{< tabs name="tab-kubeconfig" >}} +{{< tab name="kubeconfig" include="generated/kubeadm_init_phase_kubeconfig.md" />}} +{{< tab name="all" include="generated/kubeadm_init_phase_kubeconfig_all.md" />}} +{{< tab name="admin" include="generated/kubeadm_init_phase_kubeconfig_admin.md" />}} +{{< tab name="controller-manager" include="generated/kubeadm_init_phase_kubeconfig_controller-manager.md" />}} +{{< tab name="kubelet" include="generated/kubeadm_init_phase_kubeconfig_kubelet.md" />}} +{{< tab name="scheduler" include="generated/kubeadm_init_phase_kubeconfig_scheduler.md" />}} +{{< /tabs >}} + +## kubeadm init phase kubelet-start {#cmd-phase-kubelet-start} + +This phase will write the kubelet configuration file and environment file and then start the kubelet. + +{{< tabs name="tab-kubelet-start" >}} +{{< tab name="kubelet-start" include="generated/kubeadm_init_phase_kubelet-start.md" />}} +{{< /tabs >}} + +## kubeadm init phase control-plane {#cmd-phase-control-plane} + +Using this phase you can create all required static Pod files for the control plane components. + +{{< tabs name="tab-control-plane" >}} +{{< tab name="control-plane" include="generated/kubeadm_init_phase_control-plane.md" />}} +{{< tab name="all" include="generated/kubeadm_init_phase_control-plane_all.md" />}} +{{< tab name="apiserver" include="generated/kubeadm_init_phase_control-plane_apiserver.md" />}} +{{< tab name="controller-manager" include="generated/kubeadm_init_phase_control-plane_controller-manager.md" />}} +{{< tab name="scheduler" include="generated/kubeadm_init_phase_control-plane_scheduler.md" />}} +{{< /tabs >}} + + +## kubeadm init phase etcd {#cmd-phase-etcd} + +Use the following phase to create a local etcd instance based on a static Pod file. + +{{< tabs name="tab-etcd" >}} +{{< tab name="etcd" include="generated/kubeadm_init_phase_etcd.md" />}} +{{< tab name="local" include="generated/kubeadm_init_phase_etcd_local.md" />}} +{{< /tabs >}} + + +## kubeadm init phase mark-control-plane {#cmd-phase-control-plane} + +Use the following phase to label and taint the node with the `node-role.kubernetes.io/master=""` key-value pair. + +{{< tabs name="tab-mark-control-plane" >}} +{{< tab name="mark-control-plane" include="generated/kubeadm_init_phase_mark-control-plane.md" />}} +{{< /tabs >}} + + +## kubeadm init phase bootstrap-token {#cmd-phase-bootstrap-token} + +Use the following phase to configure bootstrap tokens. + +{{< tabs name="tab-bootstrap-token" >}} +{{< tab name="bootstrap-token" include="generated/kubeadm_init_phase_bootstrap-token.md" />}} +{{< /tabs >}} + + +## kubeadm init phase upload-config {#cmd-phase-upload-config} + +You can use this command to upload the kubeadm configuration to your cluster. +Alternatively, you can use [kubeadm config](/docs/reference/setup-tools/kubeadm/kubeadm-config/). + +{{< tabs name="upload-config" >}} +{{< tab name="upload-config" include="generated/kubeadm_init_phase_upload-config.md" />}} +{{< tab name="all" include="generated/kubeadm_init_phase_upload-config_all.md" />}} +{{< tab name="kubeadm" include="generated/kubeadm_init_phase_upload-config_kubeadm.md" />}} +{{< tab name="kubelet" include="generated/kubeadm_init_phase_upload-config_kubelet.md" />}} +{{< /tabs >}} + + +## kubeadm init phase addon {#cmd-phase-addon} + +You can install all the available addons with the `all` subcommand, or +install them selectively. + +{{< tabs name="tab-addon" >}} +{{< tab name="addon" include="generated/kubeadm_init_phase_addon.md" />}} +{{< tab name="all" include="generated/kubeadm_init_phase_addon_all.md" />}} +{{< tab name="kube-proxy" include="generated/kubeadm_init_phase_addon_kube-proxy.md" />}} +{{< tab name="coredns" include="generated/kubeadm_init_phase_addon_coredns.md" />}} +{{< /tabs >}} + +To use kube-dns instead of CoreDNS you have to pass a configuration file: + +```bash +# for installing a DNS addon only +kubeadm init phase addon coredns --config=someconfig.yaml +# for creating a complete control plane node +kubeadm init --config=someconfig.yaml +# for listing or pulling images +kubeadm config images list/pull --config=someconfig.yaml +# for upgrades +kubeadm upgrade apply --config=someconfig.yaml +``` + +The file has to contain a [`DNS`](https://godoc.org/k8s.io/kubernetes/cmd/kubeadm/app/apis/kubeadm/v1beta1#DNS) field in[`ClusterConfiguration`](https://godoc.org/k8s.io/kubernetes/cmd/kubeadm/app/apis/kubeadm/v1beta1#ClusterConfiguration) +and also a type for the addon - `kube-dns` (default value is `CoreDNS`). + +```yaml +apiVersion: kubeadm.k8s.io/v1beta1 +kind: ClusterConfiguration +dns: + type: "kube-dns" +``` + +For more details on each field in the `v1beta1` configuration you can navigate to our +[API reference pages.] (https://godoc.org/k8s.io/kubernetes/cmd/kubeadm/app/apis/kubeadm/v1beta1) + +## What's next +* [kubeadm init](/docs/reference/setup-tools/kubeadm/kubeadm-init/) to bootstrap a Kubernetes control-plane node +* [kubeadm join](/docs/reference/setup-tools/kubeadm/kubeadm-join/) to connect a node to the cluster +* [kubeadm reset](/docs/reference/setup-tools/kubeadm/kubeadm-reset/) to revert any changes made to this host by `kubeadm init` or `kubeadm join` +* [kubeadm alpha](/docs/reference/setup-tools/kubeadm/kubeadm-alpha/) to try experimental functionality diff --git a/content/en/docs/reference/setup-tools/kubeadm/kubeadm-init.md b/content/en/docs/reference/setup-tools/kubeadm/kubeadm-init.md index f43a5435d4a76..72cd8f5a63339 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/kubeadm-init.md +++ b/content/en/docs/reference/setup-tools/kubeadm/kubeadm-init.md @@ -8,7 +8,7 @@ content_template: templates/concept weight: 20 --- {{% capture overview %}} -This command initializes a Kubernetes master node. +This command initializes a Kubernetes control-plane node. {{% /capture %}} {{% capture body %}} @@ -16,7 +16,7 @@ This command initializes a Kubernetes master node. {{< include "generated/kubeadm_init.md" >}} ### Init workflow {#init-workflow} -`kubeadm init` bootstraps a Kubernetes master node by executing the +`kubeadm init` bootstraps a Kubernetes control-plane node by executing the following steps: 1. Runs a series of pre-flight checks to validate the system state @@ -36,13 +36,6 @@ following steps: API server, each with its own identity, as well as an additional kubeconfig file for administration named `admin.conf`. -1. If kubeadm is invoked with `--feature-gates=DynamicKubeletConfig` enabled, - it writes the kubelet init configuration into the `/var/lib/kubelet/config/init/kubelet` file. - See [Set Kubelet parameters via a config file](/docs/tasks/administer-cluster/kubelet-config-file/) - and [Reconfigure a Node's Kubelet in a Live Cluster](/docs/tasks/administer-cluster/reconfigure-kubelet/) - for more information about Dynamic Kubelet Configuration. - This functionality is now by default disabled as it is behind a feature gate, but is expected to be a default in future versions. - 1. Generates static Pod manifests for the API server, controller manager and scheduler. In case an external etcd is not provided, an additional static Pod manifest are generated for etcd. @@ -52,13 +45,7 @@ following steps: Once control plane Pods are up and running, the `kubeadm init` sequence can continue. -1. If kubeadm is invoked with `--feature-gates=DynamicKubeletConfig` enabled, - it completes the kubelet dynamic configuration by creating a ConfigMap and some RBAC rules that enable - kubelets to access to it, and updates the node by pointing `Node.spec.configSource` to the - newly-created ConfigMap. - This functionality is now by default disabled as it is behind a feature gate, but is expected to be a default in future versions. - -1. Apply labels and taints to the master node so that no additional workloads will +1. Apply labels and taints to the control-plane node so that no additional workloads will run there. 1. Generates the token that additional nodes can use to register @@ -82,17 +69,47 @@ following steps: 1. Installs a DNS server (CoreDNS) and the kube-proxy addon components via the API server. In Kubernetes version 1.11 and later CoreDNS is the default DNS server. - To install kube-dns instead of CoreDNS, kubeadm must be invoked with `--feature-gates=CoreDNS=false`. + To install kube-dns instead of CoreDNS, the DNS addon has to configured in the kubeadm `ClusterConfiguration`. For more information about the configuration see the section + `Using kubeadm init with a configuration file` bellow. Please note that although the DNS server is deployed, it will not be scheduled until CNI is installed. -1. If `kubeadm init` is invoked with the alpha self-hosting feature enabled, - (`--feature-gates=SelfHosting=true`), the static Pod based control plane is - transformed into a [self-hosted control plane](#self-hosting). +### Using init phases with kubeadm {#init-phases} + +Kubeadm allows you create a control-plane node in phases. In 1.13 the `kubeadm init phase` command has graduated to GA from it’s previous alpha state under `kubeadm alpha phase`. + +To view the ordered list of phases and sub-phases you can call `kubeadm init --help`. The list will be located at the top of the help screen and each phase will have a description next to it. +Note that by calling `kubeadm init` all of the phases and sub-phases will be executed in this exact order. + +Some phases have unique flags, so if you want to have a look at the list of available options add `--help`, for example: + +```bash +sudo kubeadm init phase control-plane controller-manager --help +``` + +You can also use `--help` to see the list of sub-phases for a certain parent phase: + +```bash +sudo kubeadm init phase control-plane --help +``` + +`kubeadm init` also expose a flag called `--skip-phases` that can be used to skip certain phases. The flag accepts a list of phase names and the names can be taken from the above ordered list. + +An example: + +```bash +sudo kubeadm init phase control-plane all --config=configfile.yaml +sudo kubeadm init phase etcd local --config=configfile.yaml +# you can now modify the control plane and etcd manifest files +sudo kubeadm init --skip-phases=control-plane,etcd --config=configfile.yaml +``` + +What this example would do is write the manifest files for the control plane and etcd in `/etc/kubernetes/manifests` based on the configuration in `configfile.yaml`. This allows you to modify the files and then skip these phases using `--skip-phases`. By calling the last command you will create a control plane node with the custom manifest files. ### Using kubeadm init with a configuration file {#config-file} {{< caution >}} -The config file is still considered alpha and may change in future versions. +**Caution:** The config file is +still considered beta and may change in future versions. {{< /caution >}} It's possible to configure `kubeadm init` with a configuration file instead of command @@ -100,7 +117,7 @@ line flags, and some more advanced features may only be available as 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 -[kubeadm config print-default](/docs/reference/setup-tools/kubeadm/kubeadm-config/) command. +[kubeadm config print](/docs/reference/setup-tools/kubeadm/kubeadm-config/) command. It is **recommended** that you migrate your old `v1alpha3` configuration to `v1beta1` using the [kubeadm config migrate](/docs/reference/setup-tools/kubeadm/kubeadm-config/) command, because `v1alpha3` will be removed in Kubernetes 1.14. @@ -266,7 +283,7 @@ In order to set up a cluster where the master and worker nodes communicate with ### Setting the node name -By default, `kubeadm` assigns a node name based on a machine's host address. You can override this setting with the `--node-name`flag. +By default, `kubeadm` assigns a node name based on a machine's host address. You can override this setting with the `--node-name`flag. The flag passes the appropriate [`--hostname-override`](https://kubernetes.io/docs/reference/command-line-tools-reference/kubelet/#options) to the kubelet. @@ -289,24 +306,15 @@ and will be removed in 1.13. #### Caveats -Self-hosting in 1.8 has some important limitations. In particular, a -self-hosted cluster _cannot recover from a reboot of the master node_ +Self-hosting in 1.8 and later has some important limitations. In particular, a +self-hosted cluster _cannot recover from a reboot of the control-plane node_ without manual intervention. This and other limitations are expected to be resolved before self-hosting graduates from alpha. By default, self-hosted control plane Pods rely on credentials loaded from [`hostPath`](https://kubernetes.io/docs/concepts/storage/volumes/#hostpath) volumes. Except for initial creation, these credentials are not managed by -kubeadm. You can use `--feature-gates=StoreCertsInSecrets=true` to enable an -experimental mode where control plane credentials are loaded from Secrets -instead. This requires very careful control over the authentication and -authorization configuration for your cluster, and may not be appropriate for -your environment. - -{{< caution >}} -`StoreCertsInSecrets` is an alpha feature. It is deprecated in 1.12 -and will be removed in 1.13. -{{< /caution >}} +kubeadm. In kubeadm 1.8, the self-hosted portion of the control plane does not include etcd, which still runs as a static Pod. @@ -316,7 +324,7 @@ which still runs as a static Pod. The self-hosting bootstrap process is documented in the [kubeadm design document](https://github.com/kubernetes/kubeadm/blob/master/docs/design/design_v1.9.md#optional-self-hosting). -In summary, `kubeadm init --feature-gates=SelfHosting=true` works as follows: +In summary, `kubeadm alpha selfhosting` works as follows: 1. Waits for this bootstrap static control plane to be running and healthy. This is identical to the `kubeadm init` process without self-hosting. @@ -336,8 +344,6 @@ In summary, `kubeadm init --feature-gates=SelfHosting=true` works as follows: 1. When the original static control plane stops, the new self-hosted control plane is able to bind to listening ports and become active. -This process (steps 3-6) can also be triggered with `kubeadm phase selfhosting convert-from-staticpods`. - ### Running kubeadm without an internet connection For running kubeadm without an internet connection you have to pre-pull the required master images for the version of choice: @@ -388,11 +394,11 @@ know the IP address that the master will have after it is started. kubeadm token generate ``` -1. Start both the master node and the worker nodes concurrently with this token. +1. Start both the control-plane node and the worker nodes concurrently with this token. As they come up they should find each other and form the cluster. The same `--token` argument can be used on both `kubeadm init` and `kubeadm join`. -Once the cluster is up, you can grab the admin credentials from the master node +Once the cluster is up, you can grab the admin credentials from the control-plane node at `/etc/kubernetes/admin.conf` and use that to talk to the cluster. Note that this style of bootstrap has some relaxed security guarantees because @@ -403,6 +409,8 @@ provisioned). For details, see the [kubeadm join](/docs/reference/setup-tools/ku {{% /capture %}} {{% capture whatsnext %}} +* [kubeadm init phase](/docs/reference/setup-tools/kubeadm/kubeadm-init-phase/) to understand more about +`kubadm init` phases * [kubeadm join](/docs/reference/setup-tools/kubeadm/kubeadm-join/) to bootstrap a Kubernetes worker node and join it to the cluster * [kubeadm upgrade](/docs/reference/setup-tools/kubeadm/kubeadm-upgrade/) to upgrade a Kubernetes cluster to a newer version * [kubeadm reset](/docs/reference/setup-tools/kubeadm/kubeadm-reset/) to revert any changes made to this host by `kubeadm init` or `kubeadm join` diff --git a/content/en/docs/reference/setup-tools/kubeadm/kubeadm-join.md b/content/en/docs/reference/setup-tools/kubeadm/kubeadm-join.md index 2fb074626b689..7cf67a109c98a 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/kubeadm-join.md +++ b/content/en/docs/reference/setup-tools/kubeadm/kubeadm-join.md @@ -223,7 +223,7 @@ For details on individual fields in `JoinConfiguration` see [the godoc](https:// {{% /capture %}} {{% capture whatsnext %}} -* [kubeadm init](/docs/reference/setup-tools/kubeadm/kubeadm-init/) to bootstrap a Kubernetes master node +* [kubeadm init](/docs/reference/setup-tools/kubeadm/kubeadm-init/) to bootstrap a Kubernetes control-plane node * [kubeadm token](/docs/reference/setup-tools/kubeadm/kubeadm-token/) to manage tokens for `kubeadm join` * [kubeadm reset](/docs/reference/setup-tools/kubeadm/kubeadm-reset/) to revert any changes made to this host by `kubeadm init` or `kubeadm join` {{% /capture %}} diff --git a/content/en/docs/reference/setup-tools/kubeadm/kubeadm-reset.md b/content/en/docs/reference/setup-tools/kubeadm/kubeadm-reset.md index 611c722666437..94ecaeb09805f 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/kubeadm-reset.md +++ b/content/en/docs/reference/setup-tools/kubeadm/kubeadm-reset.md @@ -28,6 +28,6 @@ See the [etcd documentation](https://github.com/coreos/etcd/tree/master/etcdctl) {{% /capture %}} {{% capture whatsnext %}} -* [kubeadm init](/docs/reference/setup-tools/kubeadm/kubeadm-init/) to bootstrap a Kubernetes master node +* [kubeadm init](/docs/reference/setup-tools/kubeadm/kubeadm-init/) to bootstrap a Kubernetes control-plane node * [kubeadm join](/docs/reference/setup-tools/kubeadm/kubeadm-join/) to bootstrap a Kubernetes worker node and join it to the cluster {{% /capture %}} diff --git a/content/en/docs/reference/setup-tools/kubeadm/kubeadm-token.md b/content/en/docs/reference/setup-tools/kubeadm/kubeadm-token.md index b4daa61343a42..0102447ef0639 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/kubeadm-token.md +++ b/content/en/docs/reference/setup-tools/kubeadm/kubeadm-token.md @@ -10,7 +10,7 @@ weight: 70 {{% capture overview %}} Bootstrap tokens are used for establishing bidirectional trust between a node joining -the cluster and a master node, as described in [authenticating with bootstrap tokens](/docs/reference/access-authn-authz/bootstrap-tokens/). +the cluster and a control-plane node, as described in [authenticating with bootstrap tokens](/docs/reference/access-authn-authz/bootstrap-tokens/). `kubeadm init` creates an initial token with a 24-hour TTL. The following commands allow you to manage such a token and also to create and manage new ones. diff --git a/content/en/docs/reference/setup-tools/kubeadm/kubeadm-upgrade.md b/content/en/docs/reference/setup-tools/kubeadm/kubeadm-upgrade.md index 480580aa810b6..b525a62edc3e5 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/kubeadm-upgrade.md +++ b/content/en/docs/reference/setup-tools/kubeadm/kubeadm-upgrade.md @@ -21,12 +21,15 @@ For more version-specific upgrade guidance, see the following resources: * [1.10 to 1.11 upgrades](/docs/tasks/administer-cluster/kubeadm/kubeadm-upgrade-1-11/) * [1.11 to 1.12 upgrades](/docs/tasks/administer-cluster/kubeadm/kubeadm-upgrade-1-12/) + * [1.12 to 1.13 upgrades](/docs/tasks/administer-cluster/kubeadm/kubeadm-upgrade-1-13/) _For older versions, please refer to older documentation sets on the Kubernetes website._ In Kubernetes v1.11.0 and later, you can use `kubeadm upgrade diff` to see the changes that would be applied to static pod manifests. +To use kube-dns with upgrades in Kubernetes v1.13.0 and later please follow [this guide](docs/reference/setup-tools/kubeadm/kubeadm-init-phase/#cmd-phase-addon). + ## kubeadm upgrade plan {#cmd-upgrade-plan} {{< include "generated/kubeadm_upgrade_plan.md" >}} diff --git a/content/en/docs/reference/setup-tools/kubeadm/kubeadm.md b/content/en/docs/reference/setup-tools/kubeadm/kubeadm.md index c680eb5c408cf..eccf635588e72 100644 --- a/content/en/docs/reference/setup-tools/kubeadm/kubeadm.md +++ b/content/en/docs/reference/setup-tools/kubeadm/kubeadm.md @@ -14,7 +14,7 @@ Instead, we expect higher-level and more tailored tooling to be built on top of ## What's next -* [kubeadm init](/docs/reference/setup-tools/kubeadm/kubeadm-init) to bootstrap a Kubernetes master node +* [kubeadm init](/docs/reference/setup-tools/kubeadm/kubeadm-init) to bootstrap a Kubernetes control-plane node * [kubeadm join](/docs/reference/setup-tools/kubeadm/kubeadm-join) to bootstrap a Kubernetes worker node and join it to the cluster * [kubeadm upgrade](/docs/reference/setup-tools/kubeadm/kubeadm-upgrade) to upgrade a Kubernetes cluster to a newer version * [kubeadm config](/docs/reference/setup-tools/kubeadm/kubeadm-config) if you initialized your cluster using kubeadm v1.7.x or lower, to configure your cluster for `kubeadm upgrade` diff --git a/content/en/docs/reference/setup-tools/kubefed/kubefed.md b/content/en/docs/reference/setup-tools/kubefed/kubefed.md index 4d296ba22c253..274d622d91be9 100644 --- a/content/en/docs/reference/setup-tools/kubefed/kubefed.md +++ b/content/en/docs/reference/setup-tools/kubefed/kubefed.md @@ -19,7 +19,7 @@ kubefed [flags] --alsologtostderr log to standard error as well as files --as string Username to impersonate for the operation --as-group stringArray Group to impersonate for the operation, this flag can be repeated to specify multiple groups. - --cache-dir string Default HTTP cache directory (default "/Users/zarnold/.kube/http-cache") + --cache-dir string Default HTTP cache directory (default "/Users/tim/.kube/http-cache") --certificate-authority string Path to a cert file for the certificate authority --client-certificate string Path to a client certificate file for TLS --client-key string Path to a client key file for TLS @@ -63,4 +63,4 @@ kubefed [flags] * [kubefed unjoin](kubefed_unjoin.md) - Unjoin a cluster from a federation * [kubefed version](kubefed_version.md) - Print the client and server version information -###### Auto generated by spf13/cobra on 24-Sep-2018 +###### Auto generated by spf13/cobra on 1-Dec-2018 diff --git a/content/en/docs/reference/setup-tools/kubefed/kubefed_init.md b/content/en/docs/reference/setup-tools/kubefed/kubefed_init.md index 69da8c83fe499..6676fbaa317bc 100644 --- a/content/en/docs/reference/setup-tools/kubefed/kubefed_init.md +++ b/content/en/docs/reference/setup-tools/kubefed/kubefed_init.md @@ -59,7 +59,7 @@ kubefed init FEDERATION_NAME --host-cluster-context=HOST_CONTEXT [flags] --alsologtostderr log to standard error as well as files --as string Username to impersonate for the operation --as-group stringArray Group to impersonate for the operation, this flag can be repeated to specify multiple groups. - --cache-dir string Default HTTP cache directory (default "/Users/zarnold/.kube/http-cache") + --cache-dir string Default HTTP cache directory (default "/Users/tim/.kube/http-cache") --certificate-authority string Path to a cert file for the certificate authority --client-certificate string Path to a client certificate file for TLS --client-key string Path to a client key file for TLS @@ -98,4 +98,4 @@ kubefed init FEDERATION_NAME --host-cluster-context=HOST_CONTEXT [flags] ### SEE ALSO * [kubefed](kubefed.md) - kubefed controls a Kubernetes Cluster Federation -###### Auto generated by spf13/cobra on 24-Sep-2018 +###### Auto generated by spf13/cobra on 1-Dec-2018 diff --git a/content/en/docs/reference/setup-tools/kubefed/kubefed_join.md b/content/en/docs/reference/setup-tools/kubefed/kubefed_join.md index 79b29a4f99e3e..3ffc5e42a6617 100644 --- a/content/en/docs/reference/setup-tools/kubefed/kubefed_join.md +++ b/content/en/docs/reference/setup-tools/kubefed/kubefed_join.md @@ -53,7 +53,7 @@ kubefed join CLUSTER_NAME --host-cluster-context=HOST_CONTEXT [flags] --alsologtostderr log to standard error as well as files --as string Username to impersonate for the operation --as-group stringArray Group to impersonate for the operation, this flag can be repeated to specify multiple groups. - --cache-dir string Default HTTP cache directory (default "/Users/zarnold/.kube/http-cache") + --cache-dir string Default HTTP cache directory (default "/Users/tim/.kube/http-cache") --certificate-authority string Path to a cert file for the certificate authority --client-certificate string Path to a client certificate file for TLS --client-key string Path to a client key file for TLS @@ -92,4 +92,4 @@ kubefed join CLUSTER_NAME --host-cluster-context=HOST_CONTEXT [flags] ### SEE ALSO * [kubefed](kubefed.md) - kubefed controls a Kubernetes Cluster Federation -###### Auto generated by spf13/cobra on 24-Sep-2018 +###### Auto generated by spf13/cobra on 1-Dec-2018 diff --git a/content/en/docs/reference/setup-tools/kubefed/kubefed_options.md b/content/en/docs/reference/setup-tools/kubefed/kubefed_options.md index d1255f2865aba..5bbd9f34a6737 100644 --- a/content/en/docs/reference/setup-tools/kubefed/kubefed_options.md +++ b/content/en/docs/reference/setup-tools/kubefed/kubefed_options.md @@ -30,7 +30,7 @@ kubefed options [flags] --alsologtostderr log to standard error as well as files --as string Username to impersonate for the operation --as-group stringArray Group to impersonate for the operation, this flag can be repeated to specify multiple groups. - --cache-dir string Default HTTP cache directory (default "/Users/zarnold/.kube/http-cache") + --cache-dir string Default HTTP cache directory (default "/Users/tim/.kube/http-cache") --certificate-authority string Path to a cert file for the certificate authority --client-certificate string Path to a client certificate file for TLS --client-key string Path to a client key file for TLS @@ -69,4 +69,4 @@ kubefed options [flags] ### SEE ALSO * [kubefed](kubefed.md) - kubefed controls a Kubernetes Cluster Federation -###### Auto generated by spf13/cobra on 24-Sep-2018 +###### Auto generated by spf13/cobra on 1-Dec-2018 diff --git a/content/en/docs/reference/setup-tools/kubefed/kubefed_unjoin.md b/content/en/docs/reference/setup-tools/kubefed/kubefed_unjoin.md index ae80ef3bb8e7d..067492602605a 100644 --- a/content/en/docs/reference/setup-tools/kubefed/kubefed_unjoin.md +++ b/content/en/docs/reference/setup-tools/kubefed/kubefed_unjoin.md @@ -40,7 +40,7 @@ kubefed unjoin CLUSTER_NAME --host-cluster-context=HOST_CONTEXT [flags] --alsologtostderr log to standard error as well as files --as string Username to impersonate for the operation --as-group stringArray Group to impersonate for the operation, this flag can be repeated to specify multiple groups. - --cache-dir string Default HTTP cache directory (default "/Users/zarnold/.kube/http-cache") + --cache-dir string Default HTTP cache directory (default "/Users/tim/.kube/http-cache") --certificate-authority string Path to a cert file for the certificate authority --client-certificate string Path to a client certificate file for TLS --client-key string Path to a client key file for TLS @@ -79,4 +79,4 @@ kubefed unjoin CLUSTER_NAME --host-cluster-context=HOST_CONTEXT [flags] ### SEE ALSO * [kubefed](kubefed.md) - kubefed controls a Kubernetes Cluster Federation -###### Auto generated by spf13/cobra on 24-Sep-2018 +###### Auto generated by spf13/cobra on 1-Dec-2018 diff --git a/content/en/docs/reference/setup-tools/kubefed/kubefed_version.md b/content/en/docs/reference/setup-tools/kubefed/kubefed_version.md index eb2cfdbfffe20..50e57f1f017cf 100644 --- a/content/en/docs/reference/setup-tools/kubefed/kubefed_version.md +++ b/content/en/docs/reference/setup-tools/kubefed/kubefed_version.md @@ -33,7 +33,7 @@ kubefed version [flags] --alsologtostderr log to standard error as well as files --as string Username to impersonate for the operation --as-group stringArray Group to impersonate for the operation, this flag can be repeated to specify multiple groups. - --cache-dir string Default HTTP cache directory (default "/Users/zarnold/.kube/http-cache") + --cache-dir string Default HTTP cache directory (default "/Users/tim/.kube/http-cache") --certificate-authority string Path to a cert file for the certificate authority --client-certificate string Path to a client certificate file for TLS --client-key string Path to a client key file for TLS @@ -72,4 +72,4 @@ kubefed version [flags] ### SEE ALSO * [kubefed](kubefed.md) - kubefed controls a Kubernetes Cluster Federation -###### Auto generated by spf13/cobra on 24-Sep-2018 +###### Auto generated by spf13/cobra on 1-Dec-2018 diff --git a/content/en/docs/setup/independent/control-plane-flags.md b/content/en/docs/setup/independent/control-plane-flags.md index e49667f8f726a..1929b1ae17b8b 100644 --- a/content/en/docs/setup/independent/control-plane-flags.md +++ b/content/en/docs/setup/independent/control-plane-flags.md @@ -8,15 +8,16 @@ weight: 40 {{% capture overview %}} -The kubeadm configuration exposes the following fields that can override the default flags passed to control plane components such as the APIServer, ControllerManager and Scheduler: +The kubeadm `ClusterConfiguration` object exposes the field `extraArgs` that can override the default flags passed to control plane +components such as the APIServer, ControllerManager and Scheduler. The components are defined using the following fields: -- `APIServerExtraArgs` -- `ControllerManagerExtraArgs` -- `SchedulerExtraArgs` +- `apiServer` +- `controllerManager` +- `scheduler` -These fields consist of `key: value` pairs. To override a flag for a control plane component: +The `extraArgs` field consist of `key: value` pairs. To override a flag for a control plane component: -1. Add the appropriate field to your configuration. +1. Add the appropriate fields to your configuration. 2. Add the flags to override to the field. For more details on each field in the configuration you can navigate to our diff --git a/content/en/docs/setup/independent/create-cluster-kubeadm.md b/content/en/docs/setup/independent/create-cluster-kubeadm.md index 8db68b4f836e7..c69ec051326a1 100644 --- a/content/en/docs/setup/independent/create-cluster-kubeadm.md +++ b/content/en/docs/setup/independent/create-cluster-kubeadm.md @@ -37,21 +37,20 @@ but you may also build them from source for other OSes. | Area | Maturity Level | |---------------------------|--------------- | -| Command line UX | beta | -| Implementation | beta | -| Config file API | alpha | -| Self-hosting | alpha | -| kubeadm alpha subcommands | alpha | +| Command line UX | GA | +| Implementation | GA | +| Config file API | beta | | CoreDNS | GA | +| kubeadm alpha subcommands | alpha | +| High availability | alpha | | DynamicKubeletConfig | alpha | +| Self-hosting | alpha | -kubeadm's overall feature state is **Beta** and will soon be graduated to -**General Availability (GA)** during 2018. Some sub-features, like self-hosting -or the configuration file API are still under active development. The -implementation of creating the cluster may change slightly as the tool evolves, -but the overall implementation should be pretty stable. Any commands under -`kubeadm alpha` are by definition, supported on an alpha level. +kubeadm's overall feature state is **GA**. Some sub-features, like the configuration +file API are still under active development. The implementation of creating the cluster +may change slightly as the tool evolves, but the overall implementation should be pretty stable. +Any commands under `kubeadm alpha` are by definition, supported on an alpha level. ### Support timeframes @@ -70,6 +69,7 @@ timeframe; which also applies to `kubeadm`. | v1.10.x | March 2018 | December 2018   | | v1.11.x | June 2018 | March 2019   | | v1.12.x | September 2018 | June 2019   | +| v1.13.x | December 2018 | September 2019   | {{% /capture %}} @@ -391,7 +391,7 @@ And once the CoreDNS pod is up and running, you can continue by joining your nod If your network is not working or CoreDNS is not in the Running state, check out our [troubleshooting docs](/docs/setup/independent/troubleshooting-kubeadm/). -### Master Isolation +### Control plane node isolation By default, your cluster will not schedule pods on the master for security reasons. If you want to be able to schedule pods on the master, e.g. for a @@ -508,7 +508,7 @@ and `scp` using that other user instead. The `admin.conf` file gives the user _superuser_ privileges over the cluster. This file should be used sparingly. For normal users, it's recommended to generate an unique credential to which you whitelist privileges. You can do -this with the `kubeadm alpha phase kubeconfig user --client-name ` +this with the `kubeadm alpha kubeconfig user --client-name ` command. That command will print out a KubeConfig file to STDOUT which you should save to a file and distribute to your user. After that, whitelist privileges by using `kubectl create (cluster)rolebinding`. @@ -598,6 +598,8 @@ kubeadm deb/rpm packages and binaries are built for amd64, arm (32-bit), arm64, following the [multi-platform proposal](https://github.com/kubernetes/community/blob/master/contributors/design-proposals/multi-platform.md). +Multiplatform container images for the control plane and addons are also supported since v1.12. + Only some of the network providers offer solutions for all platforms. Please consult the list of network providers above or the documentation from each provider to figure out whether the provider supports your chosen platform. diff --git a/content/en/docs/setup/independent/high-availability.md b/content/en/docs/setup/independent/high-availability.md index 0cf64093d226e..b43bb3377b421 100644 --- a/content/en/docs/setup/independent/high-availability.md +++ b/content/en/docs/setup/independent/high-availability.md @@ -243,13 +243,15 @@ SSH is required if you want to control all nodes from a single machine. This process writes all the requested files in the `/etc/kubernetes` folder. -1. Start `kubeadm` on this node: +1. Start `kubeadm join` on this node using the join command that was previously given to you by `kubeadm init` on + the first node. It should look something like this: ```sh sudo kubeadm join 192.168.0.200:6443 --token j04n3m.octy8zely83cy2ts --discovery-token-ca-cert-hash sha256:84938d2a22203a8e56a787ec0c6ddad7bc7dbd52ebabc62fd5f4dbea72b14d1f --experimental-control-plane ``` - - Notice that this is the command that was returned from running `kubeadm init` on the first node, with the addition of the `--experimental-control-plane` flag. This flag automates joining this control plane node to the cluster. + - Notice the addition of the `--experimental-control-plane` flag. This flag automates joining this + control plane node to the cluster. 1. Type the following and watch the pods of the components get started: @@ -328,7 +330,7 @@ To summarize: - Make sure the first control plane node is fully initialized. - Copy certificates between the first control plane node and the other control plane nodes. -- Join each control plane node with the join command you saved to a text file, plus the `--experimental-control-plane` flag. +- Join each control plane node with the join command you saved to a text file, plus add the `--experimental-control-plane` flag. ## Common tasks after bootstrapping control plane diff --git a/content/en/docs/setup/independent/setup-ha-etcd-with-kubeadm.md b/content/en/docs/setup/independent/setup-ha-etcd-with-kubeadm.md index 4bac5c7186103..1567bf0dda7c3 100644 --- a/content/en/docs/setup/independent/setup-ha-etcd-with-kubeadm.md +++ b/content/en/docs/setup/independent/setup-ha-etcd-with-kubeadm.md @@ -114,7 +114,7 @@ this example. generated the configuration files for kubeadm). ``` - kubeadm alpha phase certs etcd-ca + kubeadm init phase certs etcd-ca ``` This creates two files @@ -125,25 +125,25 @@ this example. 1. Create certificates for each member ```sh - kubeadm alpha phase certs etcd-server --config=/tmp/${HOST2}/kubeadmcfg.yaml - kubeadm alpha phase certs etcd-peer --config=/tmp/${HOST2}/kubeadmcfg.yaml - kubeadm alpha phase certs etcd-healthcheck-client --config=/tmp/${HOST2}/kubeadmcfg.yaml - kubeadm alpha phase certs apiserver-etcd-client --config=/tmp/${HOST2}/kubeadmcfg.yaml + kubeadm init phase certs etcd-server --config=/tmp/${HOST2}/kubeadmcfg.yaml + kubeadm init phase certs etcd-peer --config=/tmp/${HOST2}/kubeadmcfg.yaml + kubeadm init phase certs etcd-healthcheck-client --config=/tmp/${HOST2}/kubeadmcfg.yaml + kubeadm init phase certs apiserver-etcd-client --config=/tmp/${HOST2}/kubeadmcfg.yaml cp -R /etc/kubernetes/pki /tmp/${HOST2}/ # cleanup non-reusable certificates find /etc/kubernetes/pki -not -name ca.crt -not -name ca.key -type f -delete - kubeadm alpha phase certs etcd-server --config=/tmp/${HOST1}/kubeadmcfg.yaml - kubeadm alpha phase certs etcd-peer --config=/tmp/${HOST1}/kubeadmcfg.yaml - kubeadm alpha phase certs etcd-healthcheck-client --config=/tmp/${HOST1}/kubeadmcfg.yaml - kubeadm alpha phase certs apiserver-etcd-client --config=/tmp/${HOST1}/kubeadmcfg.yaml + kubeadm init phase certs etcd-server --config=/tmp/${HOST1}/kubeadmcfg.yaml + kubeadm init phase certs etcd-peer --config=/tmp/${HOST1}/kubeadmcfg.yaml + kubeadm init phase certs etcd-healthcheck-client --config=/tmp/${HOST1}/kubeadmcfg.yaml + kubeadm init phase certs apiserver-etcd-client --config=/tmp/${HOST1}/kubeadmcfg.yaml cp -R /etc/kubernetes/pki /tmp/${HOST1}/ find /etc/kubernetes/pki -not -name ca.crt -not -name ca.key -type f -delete - kubeadm alpha phase certs etcd-server --config=/tmp/${HOST0}/kubeadmcfg.yaml - kubeadm alpha phase certs etcd-peer --config=/tmp/${HOST0}/kubeadmcfg.yaml - kubeadm alpha phase certs etcd-healthcheck-client --config=/tmp/${HOST0}/kubeadmcfg.yaml - kubeadm alpha phase certs apiserver-etcd-client --config=/tmp/${HOST0}/kubeadmcfg.yaml + kubeadm init phase certs etcd-server --config=/tmp/${HOST0}/kubeadmcfg.yaml + kubeadm init phase certs etcd-peer --config=/tmp/${HOST0}/kubeadmcfg.yaml + kubeadm init phase certs etcd-healthcheck-client --config=/tmp/${HOST0}/kubeadmcfg.yaml + kubeadm init phase certs apiserver-etcd-client --config=/tmp/${HOST0}/kubeadmcfg.yaml # No need to move the certs because they are for HOST0 # clean up certs that should not be copied off this host @@ -233,9 +233,9 @@ this example. for etcd. ```sh - root@HOST0 $ kubeadm alpha phase etcd local --config=/tmp/${HOST0}/kubeadmcfg.yaml - root@HOST1 $ kubeadm alpha phase etcd local --config=/home/ubuntu/kubeadmcfg.yaml - root@HOST2 $ kubeadm alpha phase etcd local --config=/home/ubuntu/kubeadmcfg.yaml + root@HOST0 $ kubeadm init phase etcd local --config=/tmp/${HOST0}/kubeadmcfg.yaml + root@HOST1 $ kubeadm init phase etcd local --config=/home/ubuntu/kubeadmcfg.yaml + root@HOST2 $ kubeadm init phase etcd local --config=/home/ubuntu/kubeadmcfg.yaml ``` 1. Optional: Check the cluster health @@ -243,7 +243,7 @@ this example. ```sh docker run --rm -it \ --net host \ - -v /etc/kubernetes:/etc/kubernetes quay.io/coreos/etcd:v3.2.18 etcdctl \ + -v /etc/kubernetes:/etc/kubernetes quay.io/coreos/etcd:${ETCD_TAG} etcdctl \ --cert-file /etc/kubernetes/pki/etcd/peer.crt \ --key-file /etc/kubernetes/pki/etcd/peer.key \ --ca-file /etc/kubernetes/pki/etcd/ca.crt \ @@ -251,6 +251,8 @@ this example. ... cluster is healthy ``` + - Set `${ETCD_TAG}` to the version tag of your etcd image. For example `v3.2.24`. + - Set `${HOST0}`to the IP address of the host you are testing. {{% /capture %}} diff --git a/content/en/docs/tasks/administer-cluster/coredns.md b/content/en/docs/tasks/administer-cluster/coredns.md index db6d1881f68a2..a892cc69c7d1b 100644 --- a/content/en/docs/tasks/administer-cluster/coredns.md +++ b/content/en/docs/tasks/administer-cluster/coredns.md @@ -42,6 +42,10 @@ during an upgrade. For example, here is what a `v1.11.0` upgrade would look like kubeadm upgrade apply v1.11.0 --feature-gates=CoreDNS=true ``` +In Kubernetes version 1.13 and later the `CoreDNS` feature gate is removed and CoreDNS +is used by default. Follow the guide outlined [here](/docs/reference/setup-tools/kubeadm/kubeadm-init-phase#cmd-phase-addon) if you want +your upgraded cluster to use kube-dns. + In versions prior to 1.11 the Corefile will be **overwritten** by the one created during upgrade. **You should save your existing ConfigMap if you have customized it.** You may re-apply your customizations after the new ConfigMap is up and running. @@ -56,13 +60,15 @@ In Kubernetes 1.11, CoreDNS has graduated to General Availability (GA) and is installed by default. {{< /note >}} -To install kube-dns instead, set the `CoreDNS` feature gate +To install kube-dns on versions prior to 1.13, set the `CoreDNS` feature gate value to `false`: ``` kubeadm init --feature-gates=CoreDNS=false ``` +For versions 1.13 and later, follow the guide outlined [here](/docs/reference/setup-tools/kubeadm/kubeadm-init-phase#cmd-phase-addon). + ## Tuning CoreDNS When resource utilisation is a concern, it may be useful to tune the configuration of CoreDNS. For more details, check out the diff --git a/content/ko/docs/concepts/overview/kubernetes-api.md b/content/ko/docs/concepts/overview/kubernetes-api.md index 05e9e55d0af2e..bc84f00b6c225 100644 --- a/content/ko/docs/concepts/overview/kubernetes-api.md +++ b/content/ko/docs/concepts/overview/kubernetes-api.md @@ -21,6 +21,7 @@ API에 원격 접속하는 방법은 [Controlling API Access doc](/docs/referenc {{% /capture %}} +{{< toc >}} {{% capture body %}} diff --git a/update-imported-docs/reference.yml b/update-imported-docs/reference.yml index 6410f38e4c76c..e44b495f22a05 100644 --- a/update-imported-docs/reference.yml +++ b/update-imported-docs/reference.yml @@ -8,7 +8,7 @@ repos: cd $GOPATH git clone https://github.com/kubernetes/kubernetes.git src/k8s.io/kubernetes cd src/k8s.io/kubernetes - git checkout release-1.12 + git checkout release-1.13 make generated_files cp -L -R vendor $GOPATH/src rm -r vendor diff --git a/update-imported-docs/release.yml b/update-imported-docs/release.yml index 0da74c95bd421..3d3bd8850bb4f 100644 --- a/update-imported-docs/release.yml +++ b/update-imported-docs/release.yml @@ -4,5 +4,5 @@ repos: branch: master gen-absolute-links: true files: - - src: CHANGELOG-1.12.md + - src: CHANGELOG-1.13.md dst: content/en/docs/setup/release/notes.md