From 2718df3f3b922cd6d16e50a03651e3b891df10d7 Mon Sep 17 00:00:00 2001 From: Youth Tsui Date: Sat, 17 Nov 2018 12:09:51 +0800 Subject: [PATCH 1/2] kubeadm reference two file --- .../kubeadm/generated/kubeadm_init.md | 203 ++++++++++++++++++ .../reference/setup-tools/kubeadm/kubeadm.md | 33 +++ 2 files changed, 236 insertions(+) create mode 100644 content/zh/docs/reference/setup-tools/kubeadm/generated/kubeadm_init.md create mode 100644 content/zh/docs/reference/setup-tools/kubeadm/kubeadm.md diff --git a/content/zh/docs/reference/setup-tools/kubeadm/generated/kubeadm_init.md b/content/zh/docs/reference/setup-tools/kubeadm/generated/kubeadm_init.md new file mode 100644 index 0000000000..32e94830dd --- /dev/null +++ b/content/zh/docs/reference/setup-tools/kubeadm/generated/kubeadm_init.md @@ -0,0 +1,203 @@ + + +运行这个命令来搭建Kubernetes master节点 + + +### 简介 + + + +运行这个命令来搭建Kubernetes主节点。 + +``` +kubeadm init [flags] +``` + + +### 参数可选项 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--apiserver-advertise-address string
API Server将要广播的监听地址。如指定为 `0.0.0.0` 将使用缺省的网卡地址。
--apiserver-bind-port int32     缺省值: 6443
API Server绑定的端口
--apiserver-cert-extra-sans stringSlice
可选的额外提供的证书主题别名（SANs）用于指定API Server的服务器证书。可以是IP地址也可以是DNS名称。
--cert-dir string     缺省值: "/etc/kubernetes/pki"
证书的存储路径。
--config string
kubeadm配置文件的路径。警告：配置文件的功能是实验性的。
--cri-socket string     缺省值: "/var/run/dockershim.sock"
指明要连接的CRI socket文件
--dry-run
不会应用任何改变；只会输出将要执行的操作。
--feature-gates string
键值对的集合，用来控制各种功能的开关。可选项有:
Auditing=true|false (当前为ALPHA状态 - 缺省值=false)
CoreDNS=true|false (缺省值=true)
DynamicKubeletConfig=true|false (当前为BETA状态 - 缺省值=false)
-h, --help
获取init命令的帮助信息
--ignore-preflight-errors stringSlice
忽视检查项错误列表，列表中的每一个检查项如发生错误将被展示输出为警告，而非错误。 例如: 'IsPrivilegedUser,Swap'. 如填写为 'all' 则将忽视所有的检查项错误。
--kubernetes-version string     缺省值: "stable-1"
为control plane选择一个特定的Kubernetes版本。
--node-name string
指定节点的名称。
--pod-network-cidr string
指明pod网络可以使用的IP地址段。 如果设置了这个参数，control plane将会为每一个节点自动分配CIDRs。
--service-cidr string     缺省值: "10.96.0.0/12"
为service的虚拟IP地址另外指定IP地址段
--service-dns-domain string     缺省值: "cluster.local"
为services另外指定域名, 例如： "myorg.internal".
--skip-token-print
不打印出由 `kubeadm init` 命令生成的默认令牌。
--token string
这个令牌用于建立主从节点间的双向受信链接。格式为 [a-z0-9]{6}\.[a-z0-9]{16} - 示例： abcdef.0123456789abcdef
--token-ttl duration     缺省值: 24h0m0s
令牌被自动删除前的可用时长 (示例： 1s, 2m, 3h). 如果设置为 '0', 令牌将永不过期。
+ + + +### 从父命令继承的选项参数 + + + + + + + + + + + + + + + + + +
--rootfs string
[实验性的功能] 相对“真实”宿主机根目录的路径。
+ + + diff --git a/content/zh/docs/reference/setup-tools/kubeadm/kubeadm.md b/content/zh/docs/reference/setup-tools/kubeadm/kubeadm.md new file mode 100644 index 0000000000..5c0b44ab24 --- /dev/null +++ b/content/zh/docs/reference/setup-tools/kubeadm/kubeadm.md @@ -0,0 +1,33 @@ +--- +# title: Overview of kubeadm +title: kubeadm概述 +weight: 10 +--- + + +Kubeadm是一个工具，它提供了 `kubeadm init` 以及 `kubeadm join` 这两个命令作为快速创建kubernetes集群的最佳实践。 + + +kubeadm通过执行必要的操作来启动和运行一个最小可用的集群。它被故意设计为只关心启动集群，而不是之前的节点准备工作。同样的，诸如安装各种各样的可有可无的插件，例如Kubernetes 控制面板、监控解决方案以及特定云提供商的插件，这些都不在它负责的范围。 + + +相反，我们期望由一个基于kubeadm从更高层设计的更加合适的工具来做这些事情；并且，理想情况下，使用kubeadm作为所有部署的基础将会使得创建一个符合期望的集群变得容易。 + +## 接下可以做什么 + + +* [kubeadm init](/docs/reference/setup-tools/kubeadm/kubeadm-init) 启动一个Kubernetes主节点 + +* [kubeadm join](/docs/reference/setup-tools/kubeadm/kubeadm-join) 启动一个Kubernetes工作节点并且将其加入到集群 + +* [kubeadm upgrade](/docs/reference/setup-tools/kubeadm/kubeadm-upgrade) 更新一个Kubernetes集群到新版本 + +* [kubeadm config](/docs/reference/setup-tools/kubeadm/kubeadm-config) 如果你使用kubeadm v1.7.x或者更低版本，你需要对你的集群做一些配置以便使用 `kubeadm upgrade` 命令 + +* [kubeadm token](/docs/reference/setup-tools/kubeadm/kubeadm-token) 使用 `kubeadm join` 来管理令牌 + +* [kubeadm reset](/docs/reference/setup-tools/kubeadm/kubeadm-reset) 使用 `kubeadm init` 或者 `kubeadm join`来恢复对节点的改变 + +* [kubeadm version](/docs/reference/setup-tools/kubeadm/kubeadm-version) 打印出kubeadm版本 + +* [kubeadm alpha](/docs/reference/setup-tools/kubeadm/kubeadm-alpha) 预览一组可用的新功能以便从社区搜集反馈 From a0f97fe22782086dc339087ed987c5e89149b9a8 Mon Sep 17 00:00:00 2001 From: Youth Tsui Date: Sat, 17 Nov 2018 13:03:57 +0800 Subject: [PATCH 2/2] Fix with Reviewer's option --- .../kubeadm/generated/kubeadm_init.md | 24 +++++++++---------- .../reference/setup-tools/kubeadm/kubeadm.md | 20 ++++++++-------- 2 files changed, 22 insertions(+), 22 deletions(-) diff --git a/content/zh/docs/reference/setup-tools/kubeadm/generated/kubeadm_init.md b/content/zh/docs/reference/setup-tools/kubeadm/generated/kubeadm_init.md index 32e94830dd..1d31da5d96 100644 --- a/content/zh/docs/reference/setup-tools/kubeadm/generated/kubeadm_init.md +++ b/content/zh/docs/reference/setup-tools/kubeadm/generated/kubeadm_init.md @@ -1,13 +1,13 @@ -运行这个命令来搭建Kubernetes master节点 +运行此命令来搭建 Kubernetes master 节点 ### 简介 -运行这个命令来搭建Kubernetes主节点。 +运行此命令来搭建 Kubernetes 主节点。 ``` kubeadm init [flags] @@ -28,7 +28,7 @@ kubeadm init [flags] - API Server将要广播的监听地址。如指定为 `0.0.0.0` 将使用缺省的网卡地址。 + API Server 将要广播的监听地址。如指定为 `0.0.0.0` 将使用缺省的网卡地址。 @@ -37,7 +37,7 @@ kubeadm init [flags] - API Server绑定的端口 + API Server 绑定的端口 @@ -62,7 +62,7 @@ kubeadm init [flags] - kubeadm配置文件的路径。警告：配置文件的功能是实验性的。 + kubeadm 配置文件的路径。警告：配置文件的功能是实验性的。 @@ -71,7 +71,7 @@ kubeadm init [flags] - 指明要连接的CRI socket文件 + 指明要连接的 CRI socket 文件 @@ -87,7 +87,7 @@ kubeadm init [flags] - 键值对的集合，用来控制各种功能的开关。可选项有:
Auditing=true|false (当前为ALPHA状态 - 缺省值=false)
CoreDNS=true|false (缺省值=true)
DynamicKubeletConfig=true|false (当前为BETA状态 - 缺省值=false) + 键值对的集合，用来控制各种功能的开关。可选项有:
Auditing=true|false (当前为 ALPHA 状态 - 缺省值=false)
CoreDNS=true|false (缺省值=true)
DynamicKubeletConfig=true|false (当前为 BETA 状态 - 缺省值=false) @@ -95,7 +95,7 @@ kubeadm init [flags] - 获取init命令的帮助信息 + 获取 init 命令的帮助信息 @@ -112,7 +112,7 @@ kubeadm init [flags] - 为control plane选择一个特定的Kubernetes版本。 + 为 control plane 选择一个特定的 Kubernetes 版本。 @@ -128,7 +128,7 @@ kubeadm init [flags] - 指明pod网络可以使用的IP地址段。 如果设置了这个参数，control plane将会为每一个节点自动分配CIDRs。 + 指明 pod 网络可以使用的IP地址段。 如果设置了这个参数，control plane 将会为每一个节点自动分配 CIDRs。 @@ -137,7 +137,7 @@ kubeadm init [flags] - 为service的虚拟IP地址另外指定IP地址段 + 为 service 的虚拟IP地址另外指定IP地址段 @@ -146,7 +146,7 @@ kubeadm init [flags] - 为services另外指定域名, 例如： "myorg.internal". + 为 services 另外指定域名, 例如： "myorg.internal". diff --git a/content/zh/docs/reference/setup-tools/kubeadm/kubeadm.md b/content/zh/docs/reference/setup-tools/kubeadm/kubeadm.md index 5c0b44ab24..2076438564 100644 --- a/content/zh/docs/reference/setup-tools/kubeadm/kubeadm.md +++ b/content/zh/docs/reference/setup-tools/kubeadm/kubeadm.md @@ -1,33 +1,33 @@ --- # title: Overview of kubeadm -title: kubeadm概述 +title: kubeadm 概述 weight: 10 --- -Kubeadm是一个工具，它提供了 `kubeadm init` 以及 `kubeadm join` 这两个命令作为快速创建kubernetes集群的最佳实践。 +Kubeadm 是一个工具，它提供了 `kubeadm init` 以及 `kubeadm join` 这两个命令作为快速创建 kubernetes 集群的最佳实践。 -kubeadm通过执行必要的操作来启动和运行一个最小可用的集群。它被故意设计为只关心启动集群，而不是之前的节点准备工作。同样的，诸如安装各种各样的可有可无的插件，例如Kubernetes 控制面板、监控解决方案以及特定云提供商的插件，这些都不在它负责的范围。 +kubeadm 通过执行必要的操作来启动和运行一个最小可用的集群。它被故意设计为只关心启动集群，而不是准备节点环境的工作。同样的，诸如安装各种各样的可有可无的插件，例如 Kubernetes 控制面板、监控解决方案以及特定云提供商的插件，这些都不在它负责的范围。 -相反，我们期望由一个基于kubeadm从更高层设计的更加合适的工具来做这些事情；并且，理想情况下，使用kubeadm作为所有部署的基础将会使得创建一个符合期望的集群变得容易。 +相反，我们期望由一个基于 kubeadm 从更高层设计的更加合适的工具来做这些事情；并且，理想情况下，使用 kubeadm 作为所有部署的基础将会使得创建一个符合期望的集群变得容易。 ## 接下可以做什么 -* [kubeadm init](/docs/reference/setup-tools/kubeadm/kubeadm-init) 启动一个Kubernetes主节点 +* [kubeadm init](/docs/reference/setup-tools/kubeadm/kubeadm-init) 启动一个 Kubernetes 主节点 -* [kubeadm join](/docs/reference/setup-tools/kubeadm/kubeadm-join) 启动一个Kubernetes工作节点并且将其加入到集群 +* [kubeadm join](/docs/reference/setup-tools/kubeadm/kubeadm-join) 启动一个 Kubernetes 工作节点并且将其加入到集群 -* [kubeadm upgrade](/docs/reference/setup-tools/kubeadm/kubeadm-upgrade) 更新一个Kubernetes集群到新版本 +* [kubeadm upgrade](/docs/reference/setup-tools/kubeadm/kubeadm-upgrade) 更新一个 Kubernetes 集群到新版本 -* [kubeadm config](/docs/reference/setup-tools/kubeadm/kubeadm-config) 如果你使用kubeadm v1.7.x或者更低版本，你需要对你的集群做一些配置以便使用 `kubeadm upgrade` 命令 +* [kubeadm config](/docs/reference/setup-tools/kubeadm/kubeadm-config) 如果你使用 kubeadm v1.7.x 或者更低版本，你需要对你的集群做一些配置以便使用 `kubeadm upgrade` 命令 * [kubeadm token](/docs/reference/setup-tools/kubeadm/kubeadm-token) 使用 `kubeadm join` 来管理令牌 -* [kubeadm reset](/docs/reference/setup-tools/kubeadm/kubeadm-reset) 使用 `kubeadm init` 或者 `kubeadm join`来恢复对节点的改变 +* [kubeadm reset](/docs/reference/setup-tools/kubeadm/kubeadm-reset) 使用 `kubeadm init` 或者 `kubeadm join` 来恢复对节点的改变 -* [kubeadm version](/docs/reference/setup-tools/kubeadm/kubeadm-version) 打印出kubeadm版本 +* [kubeadm version](/docs/reference/setup-tools/kubeadm/kubeadm-version) 打印出 kubeadm 版本 * [kubeadm alpha](/docs/reference/setup-tools/kubeadm/kubeadm-alpha) 预览一组可用的新功能以便从社区搜集反馈