diff --git a/content/zh-cn/docs/contribute/style/write-new-topic.md b/content/zh-cn/docs/contribute/style/write-new-topic.md index 18363fd0cc295..93afbd430a3b2 100644 --- a/content/zh-cn/docs/contribute/style/write-new-topic.md +++ b/content/zh-cn/docs/contribute/style/write-new-topic.md @@ -59,7 +59,7 @@ that you write. The docs site provides templates or new content pages. To create a new type of page, run `hugo new` with the path to the file you want to create. For example: --> -### 创建一个新页面{#creating-a-new-page} +### 创建一个新页面 {#creating-a-new-page} 为每个新页面选择其[内容类型](/zh-cn/docs/contribute/style/page-content-types/)。 文档站提供了模板或 [Hugo Archetypes](https://gohugo.io/content-management/archetypes/) 来创建新的内容页面。 @@ -225,13 +225,13 @@ reusable, and you want the reader to try it out themselves. 添加新的独立示例文件（如 YAML 文件）时，将代码放在 `/examples/` 的某个子目录中， -其中 `` 是该主题的语言。在主题文件中使用 `codenew` 短代码： +其中 `` 是该主题的语言。在主题文件中使用 `code_sample` 短代码： ```none -{{%/* codenew file="/my-example-yaml>" */%}} +{{%/* code_sample file="/my-example-yaml>" */%}} ``` -{{< note >}} 将新的 YAML 文件添加到 `/examples` 目录时，请确保该文件也在 `/examples_test.go` 文件中被引用。 当提交拉取请求时，网站的 Travis CI 会自动运行此测试用例，以确保所有示例都通过测试。 @@ -284,8 +284,8 @@ submitted to ensure all examples pass the tests. For an example of a topic that uses this technique, see [Running a Single-Instance Stateful Application](/docs/tasks/run-application/run-single-instance-stateful-application/). --> -有关使用此技术的主题的示例，请参见 -[运行单实例有状态的应用](/zh-cn/docs/tasks/run-application/run-single-instance-stateful-application/)。 +有关使用此技术的主题的示例， +请参见[运行单实例有状态的应用](/zh-cn/docs/tasks/run-application/run-single-instance-stateful-application/)。 -* 了解[使用页面内容类型](/zh-cn/docs/contribute/style/page-content-types/). -* 了解[创建 PR](/zh-cn/docs/contribute/new-content/open-a-pr/). - +* 了解[使用页面内容类型](/zh-cn/docs/contribute/style/page-content-types/)。 +* 了解[创建 PR](/zh-cn/docs/contribute/new-content/open-a-pr/)。 diff --git a/content/zh-cn/docs/setup/production-environment/tools/kubeadm/install-kubeadm.md b/content/zh-cn/docs/setup/production-environment/tools/kubeadm/install-kubeadm.md index 2073e54bf82fc..0d12d1e7cf3ac 100644 --- a/content/zh-cn/docs/setup/production-environment/tools/kubeadm/install-kubeadm.md +++ b/content/zh-cn/docs/setup/production-environment/tools/kubeadm/install-kubeadm.md @@ -30,6 +30,24 @@ see the [Creating a cluster with kubeadm](/docs/setup/production-environment/too 有关在执行此安装过程后如何使用 kubeadm 创建集群的信息， 请参见[使用 kubeadm 创建集群](/zh-cn/docs/setup/production-environment/tools/kubeadm/create-cluster-kubeadm/)。 + +本安装指南适用于 Kubernetes {{< skew currentVersion >}}。 +如果你想使用不同版本的 Kubernetes，请参阅以下页面： + + +- [为 Kubernetes {{< skew currentVersionAddMinor -1 "." >}} 安装 kubeadm](https://v{{< skew currentVersionAddMinor -1 "-" >}}.docs.kubernetes.io/docs/setup/production-environment/tools/kubeadm/install-kubeadm/) +- [为 Kubernetes {{< skew currentVersionAddMinor -2 "." >}} 安装 kubeadm](https://v{{< skew currentVersionAddMinor -2 "-" >}}.docs.kubernetes.io/docs/setup/production-environment/tools/kubeadm/install-kubeadm/) +- [为 Kubernetes {{< skew currentVersionAddMinor -3 "." >}} 安装 kubeadm](https://v{{< skew currentVersionAddMinor -3 "-" >}}.docs.kubernetes.io/docs/setup/production-environment/tools/kubeadm/install-kubeadm/) +- [为 Kubernetes {{< skew currentVersionAddMinor -4 "." >}} 安装 kubeadm](https://v{{< skew currentVersionAddMinor -4 "-" >}}.docs.kubernetes.io/docs/setup/production-environment/tools/kubeadm/install-kubeadm/) + ## {{% heading "prerequisites" %}} +每个 Kubernetes 小版本都有一个专用的软件包仓库。 +如果你想安装 {{< skew currentVersion >}} 以外的次要版本，请参阅所需次要版本的安装指南。 +官方 Kubernetes 软件包仓库提供 Kubernetes v1.24.0 及更高版本软件包的下载。 +{{< /note >}} + {{< tabs name="k8s_install" >}} {{% tab name="基于 Debian 的发行版" %}} @@ -335,9 +365,16 @@ These instructions are for Kubernetes {{< skew currentVersion >}}. ``` -3. 添加 Kubernetes `apt` 仓库： +3. 添加 Kubernetes `apt` 仓库。 + 请注意，此仓库仅包含适用于 Kubernetes {{< skew currentVersion >}} 的软件包； + 对于其他 Kubernetes 次要版本，则需要更改 URL 中的 Kubernetes 次要版本以匹配你所需的次要版本 + （你还应该检查正在阅读的安装文档是否为你计划安装的 Kubernetes 版本的文档）。 ```shell # 此操作会覆盖 /etc/apt/sources.list.d/kubernetes.list 中现存的所有配置。 @@ -379,7 +416,7 @@ you can create it by running `sudo mkdir -m 755 /etc/apt/keyrings` sudo sed -i 's/^SELINUX=enforcing$/SELINUX=permissive/' /etc/selinux/config ``` --> -1. 将 SELinux 设置为 `permissive` 模式: +1. 将 SELinux 设置为 `permissive` 模式： 以下指令适用于 Kubernetes {{< skew currentVersion >}}。 @@ -408,11 +445,19 @@ you can create it by running `sudo mkdir -m 755 /etc/apt/keyrings` 2. Add the Kubernetes `yum` repository. The `exclude` parameter in the repository definition ensures that the packages related to Kubernetes are not upgraded upon running `yum update` as there's a special procedure that - must be followed for upgrading Kubernetes. + must be followed for upgrading Kubernetes. Please note that this repository + have packages only for Kubernetes {{< skew currentVersion >}}; for other + Kubernetes minor versions, you need to change the Kubernetes minor version + in the URL to match your desired minor version (you should also check that + you are reading the documentation for the version of Kubernetes that you + plan to install). --> 2. 添加 Kubernetes 的 `yum` 仓库。在仓库定义中的 `exclude` 参数确保了与 Kubernetes 相关的软件包在运行 `yum update` 时不会升级，因为升级 - Kubernetes 需要遵循特定的过程。 + Kubernetes 需要遵循特定的过程。请注意，此仓库仅包含适用于 + Kubernetes {{< skew currentVersion >}} 的软件包； + 对于其他 Kubernetes 次要版本，则需要更改 URL 中的 Kubernetes 次要版本以匹配你所需的次要版本 + （你还应该检查正在阅读的安装文档是否为你计划安装的 Kubernetes 版本的文档）。 ```shell # 此操作会覆盖 /etc/yum.repos.d/kubernetes.repo 中现存的所有配置 @@ -494,10 +539,10 @@ cd $DOWNLOAD_DIR sudo curl -L --remote-name-all https://dl.k8s.io/release/${RELEASE}/bin/linux/${ARCH}/{kubeadm,kubelet} sudo chmod +x {kubeadm,kubelet} -RELEASE_VERSION="v0.15.1" -curl -sSL "https://raw.githubusercontent.com/kubernetes/release/${RELEASE_VERSION}/cmd/kubepkg/templates/latest/deb/kubelet/lib/systemd/system/kubelet.service" | sed "s:/usr/bin:${DOWNLOAD_DIR}:g" | sudo tee /etc/systemd/system/kubelet.service +RELEASE_VERSION="v0.16.2" +curl -sSL "https://raw.githubusercontent.com/kubernetes/release/${RELEASE_VERSION}/cmd/krel/templates/latest/kubelet/kubelet.service" | sed "s:/usr/bin:${DOWNLOAD_DIR}:g" | sudo tee /etc/systemd/system/kubelet.service sudo mkdir -p /etc/systemd/system/kubelet.service.d -curl -sSL "https://raw.githubusercontent.com/kubernetes/release/${RELEASE_VERSION}/cmd/kubepkg/templates/latest/deb/kubeadm/10-kubeadm.conf" | sed "s:/usr/bin:${DOWNLOAD_DIR}:g" | sudo tee /etc/systemd/system/kubelet.service.d/10-kubeadm.conf +curl -sSL "https://raw.githubusercontent.com/kubernetes/release/${RELEASE_VERSION}/cmd/krel/templates/latest/kubeadm/10-kubeadm.conf" | sed "s:/usr/bin:${DOWNLOAD_DIR}:g" | sudo tee /etc/systemd/system/kubelet.service.d/10-kubeadm.conf ``` {{< note >}} @@ -574,8 +619,8 @@ If you are running into difficulties with kubeadm, please consult our --> ## 故障排查 {#troubleshooting} -如果你在使用 kubeadm 时遇到困难，请参阅我们的 -[故障排查文档](/zh-cn/docs/setup/production-environment/tools/kubeadm/troubleshooting-kubeadm/)。 +如果你在使用 kubeadm 时遇到困难， +请参阅我们的[故障排查文档](/zh-cn/docs/setup/production-environment/tools/kubeadm/troubleshooting-kubeadm/)。 ## {{% heading "whatsnext" %}} diff --git a/content/zh-cn/docs/setup/production-environment/tools/kubeadm/kubelet-integration.md b/content/zh-cn/docs/setup/production-environment/tools/kubeadm/kubelet-integration.md index bc73abbaca3dd..df8c23b663742 100644 --- a/content/zh-cn/docs/setup/production-environment/tools/kubeadm/kubelet-integration.md +++ b/content/zh-cn/docs/setup/production-environment/tools/kubeadm/kubelet-integration.md @@ -222,7 +222,8 @@ In addition to the flags used when starting the kubelet, the file also contains parameters such as the cgroup driver and whether to use a different container runtime socket (`--cri-socket`). --> -除了启动 kubelet 时所使用的标志外，该文件还包含动态参数，例如 cgroup 驱动程序以及是否使用其他容器运行时套接字（`--cri-socket`）。 +除了启动 kubelet 时所使用的标志外，该文件还包含动态参数，例如 cgroup +驱动程序以及是否使用其他容器运行时套接字（`--cri-socket`）。 当 `/etc/kubernetes/kubelet.conf` 文件被写入后，kubelet 就完成了 TLS 引导过程。 -Kubeadm 在完成 TLS 引导过程后将删除 `/etc/kubernetes/bootstrap-kubelet.conf` 文件。 +kubeadm 在完成 TLS 引导过程后将删除 `/etc/kubernetes/bootstrap-kubelet.conf` 文件。 -通过 `kubeadm` [DEB 包](https://github.com/kubernetes/release/blob/master/cmd/kubepkg/templates/latest/deb/kubeadm/10-kubeadm.conf) -或者 [RPM 包](https://github.com/kubernetes/release/blob/master/cmd/kubepkg/templates/latest/rpm/kubeadm/10-kubeadm.conf) -安装的配置文件被写入 `/etc/systemd/system/kubelet.service.d/10-kubeadm.conf` 并由 systemd 使用。 -它对原来的 [RPM 版本 `kubelet.service`](https://github.com/kubernetes/release/blob/master/cmd/kubepkg/templates/latest/rpm/kubelet/kubelet.service) -或者 [DEB 版本 `kubelet.service`](https://github.com/kubernetes/release/blob/master/cmd/kubepkg/templates/latest/deb/kubelet/lib/systemd/system/kubelet.service) -作了增强： +通过 `kubeadm` [包](https://github.com/kubernetes/release/blob/cd53840/cmd/krel/templates/latest/kubeadm/10-kubeadm.conf) +安装的配置文件被写入 `/etc/systemd/system/kubelet.service.d/10-kubeadm.conf` +并由 systemd 使用。它对原来的 +[`kubelet.service`](https://github.com/kubernetes/release/blob/cd53840/cmd/krel/templates/latest/kubelet/kubelet.service) 作了增强： {{< note >}} 下面的内容只是一个例子。如果你不想使用包管理器， -请遵循([没有包管理器](/zh-cn/docs/setup/production-environment/tools/kubeadm/install-kubeadm/#k8s-install-2)) +请遵循（[没有包管理器](/zh-cn/docs/setup/production-environment/tools/kubeadm/install-kubeadm/#k8s-install-2)） 章节的指南。 {{< /note >}}