From 61ee18e87b99c0d3e568d8702c00747e6ea391fc Mon Sep 17 00:00:00 2001 From: chenrui Date: Wed, 20 Mar 2019 20:55:36 -0400 Subject: [PATCH] Fix relative links issue in zh content (#13312) * `http://kubernetes.io/docs/` -> `/docs/` * `https://kubernetes.io/docs/` -> `/docs/` --- .../2018-05-01-developing-on-kubernetes.md | 4 +-- .../zh/docs/concepts/configuration/secret.md | 4 +-- .../docs/concepts/containers/runtime-class.md | 4 +-- .../docs/concepts/overview/kubernetes-api.md | 12 +++---- .../generate-ref-docs/federation-api.md | 8 ++--- .../kubernetes-components.md | 4 +-- content/zh/docs/contribute/localization.md | 20 +++++------ .../docs/contribute/style/write-new-topic.md | 4 +-- .../ubuntu/installation.md | 4 +-- .../getting-started-guides/ubuntu/rancher.md | 4 +-- .../ubuntu/troubleshooting.md | 4 +-- .../getting-started-guides/windows/_index.md | 8 ++--- .../reference/glossary/aggregation-layer.md | 5 ++- .../glossary/cloud-controller-manager.md | 4 +-- content/zh/docs/reference/glossary/cni.md | 11 +++---- .../zh/docs/reference/glossary/configmap.md | 4 +-- content/zh/docs/reference/glossary/csi.md | 9 +++-- .../zh/docs/reference/glossary/flexvolume.md | 8 ++--- .../zh/docs/reference/glossary/replica-set.md | 4 +-- content/zh/docs/reference/glossary/secret.md | 6 ++-- content/zh/docs/reference/kubectl/kubectl.md | 4 +-- .../kubeadm/generated/kubeadm_token.md | 7 ++-- .../setup-tools/kubeadm/kubeadm-init.md | 8 ++--- .../setup-tools/kubefed/kubefed_join.md | 4 +-- .../independent/create-cluster-kubeadm.md | 18 ++++------ .../administer-cluster/out-of-resource.md | 4 +-- .../tasks/debug-application-cluster/audit.md | 2 +- .../core-metrics-pipeline.md | 4 +-- .../local-debugging.md | 6 ++-- .../install-service-catalog-using-sc.md | 4 +-- .../tutorials/kubernetes-basics/_index.html | 2 +- .../kubernetes-basics/scale-intro.html | 4 +-- .../kubernetes-basics/scale/scale-intro.html | 10 +++--- .../object-management.md | 4 +-- .../stateful-application/cassandra.md | 5 ++- .../mysql-wordpress-persistent-volume.md | 33 +++++++++---------- content/zh/includes/partner-script.js | 2 +- 37 files changed, 117 insertions(+), 135 deletions(-) diff --git a/content/zh/blog/_posts/2018-05-01-developing-on-kubernetes.md b/content/zh/blog/_posts/2018-05-01-developing-on-kubernetes.md index 66e3afad12..5d31031ec7 100644 --- a/content/zh/blog/_posts/2018-05-01-developing-on-kubernetes.md +++ b/content/zh/blog/_posts/2018-05-01-developing-on-kubernetes.md @@ -54,10 +54,10 @@ A number of tools support pure offline development including Minikube, Docker fo 许多工具支持纯 offline 开发，包括 Minikube、Docker（Mac 版/Windows 版）、Minishift 以及下文中我们将详细讨论的几种。有时，比如说在一个微服务系统中，已经有若干微服务在运行，proxied 模式（通过转发把数据流传进传出集群）就非常合适，Telepresence 就是此类工具的一个实例。live 模式，本质上是您基于一个远程集群进行构建和部署。最后，纯 online 模式意味着您的开发环境和运行集群都是远程的，典型的例子是 [Eclipse Che](https://www.eclipse.org/che/docs/kubernetes-single-user.html) 或者 [Cloud 9](https://github.com/errordeveloper/k9c)。现在让我们仔细看看离线开发的基础：在本地运行 Kubernetes。 -[Minikube](https://kubernetes.io/docs/getting-started-guides/minikube/) 在更加喜欢于本地 VM 上运行 Kubernetes 的开发人员中，非常受欢迎。不久前，Docker 的 [Mac](https://docs.docker.com/docker-for-mac/kubernetes/) 版和 [Windows](https://docs.docker.com/docker-for-windows/kubernetes/) 版，都试验性地开始自带 Kubernetes（需要下载 “edge” 安装包）。在两者之间，以下原因也许会促使您选择 Minikube 而不是 Docker 桌面版： +[Minikube](/docs/getting-started-guides/minikube/) 在更加喜欢于本地 VM 上运行 Kubernetes 的开发人员中，非常受欢迎。不久前，Docker 的 [Mac](https://docs.docker.com/docker-for-mac/kubernetes/) 版和 [Windows](https://docs.docker.com/docker-for-windows/kubernetes/) 版，都试验性地开始自带 Kubernetes（需要下载 “edge” 安装包）。在两者之间，以下原因也许会促使您选择 Minikube 而不是 Docker 桌面版： {{< note >}} 建议将 RuntimeClass 写操作（create、update、patch 和 delete）限定于集群管理员使用。 -通常这是默认配置。参阅[授权概述](https://kubernetes.io/docs/reference/access-authn-authz/authorization/)了解更多信息。 +通常这是默认配置。参阅[授权概述](/docs/reference/access-authn-authz/authorization/)了解更多信息。 {{< /note >}} -当 Markdown 文件放入 `kubernetes/website` 仓库的本地目录中后，你就可以创建 [PR](https://kubernetes.io/docs/home/contribute/create-pull-request/) 将它们提交到 `kubernetes/website`。 +当 Markdown 文件放入 `kubernetes/website` 仓库的本地目录中后，你就可以创建 [PR](/docs/home/contribute/create-pull-request/) 将它们提交到 `kubernetes/website`。 -`k/website` 的贡献者必须[创建一个分支](https://kubernetes.io/docs/contribute/start/#improve-existing-content)，从创建拉取请求。对于本地化，我们还要求： +`k/website` 的贡献者必须[创建一个分支](/docs/contribute/start/#improve-existing-content)，从创建拉取请求。对于本地化，我们还要求： 描述 | 网址 -----|----- -主页 | [所有标题和副标题网址](https://kubernetes.io/docs/home/) -安装 | [所有标题和副标题网址](https://kubernetes.io/docs/setup/) -教程 | [Kubernetes 基础](https://kubernetes.io/docs/tutorials/kubernetes-basics/), [Hello Minikube](https://kubernetes.io/docs/tutorials/stateless-application/hello-minikube/) +主页 | [所有标题和副标题网址](/docs/home/) +安装 | [所有标题和副标题网址](/docs/setup/) +教程 | [Kubernetes 基础](/docs/tutorials/kubernetes-basics/), [Hello Minikube](/docs/tutorials/stateless-application/hello-minikube/) 网站字符串 | [新的本地化 TOML 文件中的所有网站字符串](https://github.com/kubernetes/website/tree/master/i18n) -翻译后的文档必须保存在自己的 `content/**/` 子目录中，否则将遵循与英文源相同的 URL 路径。例如，要准备将 [Kubernetes 基础](https://kubernetes.io/docs/tutorials/kubernetes-basics/) 教程翻译为德语，请在 `content/de/` 文件夹下创建一个子文件夹并复制英文源： +翻译后的文档必须保存在自己的 `content/**/` 子目录中，否则将遵循与英文源相同的 URL 路径。例如，要准备将 [Kubernetes 基础](/docs/tutorials/kubernetes-basics/) 教程翻译为德语，请在 `content/de/` 文件夹下创建一个子文件夹并复制英文源： ```shell mkdir -p content/de/docs/tutorials diff --git a/content/zh/docs/contribute/style/write-new-topic.md b/content/zh/docs/contribute/style/write-new-topic.md index 6a6be67e8c..82378bf1be 100644 --- a/content/zh/docs/contribute/style/write-new-topic.md +++ b/content/zh/docs/contribute/style/write-new-topic.md @@ -110,7 +110,7 @@ URL for the topic, for example: 选择一个标题，标题中包含了要通过搜索引擎要查找的关键字。创建一个文件名，使用标题中由连字符分隔的单词。例如，标题为[使用 HTTP 代理访问 Kubernetes API](/docs/tasks/access-kubernetes-api/http-proxy-access-api/) 的主题的文件名为 `http-proxy-access-api.md`。你不需要在文件名中加上 "kubernetes"，因为 "kubernetes" 已经在主题的 URL 中了，例如： - http://kubernetes.io/docs/tasks/access-kubernetes-api/http-proxy-access-api/ + /docs/tasks/access-kubernetes-api/http-proxy-access-api/ -下一步是在本地机器上安装 kubectl 客户端。在 Ubuntu 上推荐的安装方式是使用 kubectl snap ([https://kubernetes.io/docs/tasks/tools/install-kubectl/#install-with-snap-on-ubuntu](https://kubernetes.io/docs/tasks/tools/install-kubectl/#install-with-snap-on-ubuntu))。 +下一步是在本地机器上安装 kubectl 客户端。在 Ubuntu 上推荐的安装方式是使用 kubectl snap ([/docs/tasks/tools/install-kubectl/#install-with-snap-on-ubuntu](/docs/tasks/tools/install-kubectl/#install-with-snap-on-ubuntu))。 可以运行下面的命令便可以控制 kubernetes 集群了： diff --git a/content/zh/docs/getting-started-guides/ubuntu/rancher.md b/content/zh/docs/getting-started-guides/ubuntu/rancher.md index 041cede7ce..095b4c92fe 100644 --- a/content/zh/docs/getting-started-guides/ubuntu/rancher.md +++ b/content/zh/docs/getting-started-guides/ubuntu/rancher.md @@ -29,9 +29,9 @@ content_template: templates/task 本文假设你有一个已经通过 Juju 部署、正在运行的集群。 - + -有关使用 juju 部署 Kubernetes 集群的完整指导，请参考 [https://kubernetes.io/docs/getting-started-guides/ubuntu/installation/](https://kubernetes.io/docs/getting-started-guides/ubuntu/installation/)。 +有关使用 juju 部署 Kubernetes 集群的完整指导，请参考 [/docs/getting-started-guides/ubuntu/installation/](/docs/getting-started-guides/ubuntu/installation/)。 {{% /capture %}} diff --git a/content/zh/docs/getting-started-guides/ubuntu/troubleshooting.md b/content/zh/docs/getting-started-guides/ubuntu/troubleshooting.md index dcc97d6eeb..be76e9eb91 100644 --- a/content/zh/docs/getting-started-guides/ubuntu/troubleshooting.md +++ b/content/zh/docs/getting-started-guides/ubuntu/troubleshooting.md @@ -264,9 +264,9 @@ To deploy using helm, you will need to follow these steps: --> ## 日志和监控 +Please read over the [logging](/docs/getting-started-guides/ubuntu/logging/) page for more information. --> 默认情况下， Kubernetes 没有节点的日志聚合，每个节点都是本地保存日志。 -请参阅[日志](https://kubernetes.io/docs/getting-started-guides/ubuntu/logging/)文档，获取更多信息。 +请参阅[日志](/docs/getting-started-guides/ubuntu/logging/)文档，获取更多信息。 {{% /capture %}} diff --git a/content/zh/docs/getting-started-guides/windows/_index.md b/content/zh/docs/getting-started-guides/windows/_index.md index 54fabd40b8..343feaafcb 100644 --- a/content/zh/docs/getting-started-guides/windows/_index.md +++ b/content/zh/docs/getting-started-guides/windows/_index.md @@ -559,11 +559,11 @@ Use your preferred method to start Kubernetes cluster on Linux. Please note that ## Support for kubeadm join --> -如果您的群集是由[kubeadm](https://kubernetes.io/docs/setup/independent/create-cluster-kubeadm/)，创建的 +如果您的群集是由[kubeadm](/docs/setup/independent/create-cluster-kubeadm/)，创建的 使用上面列出的方法之一正确地设置网络(网络是在 kubeadm 之外设置的)，您可以使用 kubeadm 向集群添加 Windows 节点。在较高的级别上，首先必须使用 kubeadm(Linux) 初始化主节点，然后设置基于 CNI 的网络(在 kubeadm 之外)，最后开始将 Windows 或 Linux 工作节点连接到集群。如需其他文件和参考资料，请访问上文的 kubeadm 链接。 @@ -575,9 +575,9 @@ The kubeadm binary can be found at [Kubernetes Releases](https://github.com/kube `kubeadm.exe join --token : --discovery-token-ca-cert-hash sha256:` -有关更多详细信息请参阅[加入您的节点](https://kubernetes.io/docs/setup/independent/create-cluster-kubeadm/#joining-your-nodes)。 +有关更多详细信息请参阅[加入您的节点](/docs/setup/independent/create-cluster-kubeadm/#joining-your-nodes)。 ## 支持的功能 diff --git a/content/zh/docs/reference/glossary/aggregation-layer.md b/content/zh/docs/reference/glossary/aggregation-layer.md index 3aeb0db5a6..982c7ef3a2 100644 --- a/content/zh/docs/reference/glossary/aggregation-layer.md +++ b/content/zh/docs/reference/glossary/aggregation-layer.md @@ -39,8 +39,7 @@ tags: -当您配置了 {{< glossary_tooltip text="Kubernetes API Server" term_id="kube-apiserver" >}} 来 [支持额外的 API](https://kubernetes.io/docs/tasks/access-kubernetes-api/configure-aggregation-layer/)，您就可以在 Kubernetes API 中增加 `APIService` 对象来 "申领（Claim）" 一个 URL 路径。 - +当您配置了 {{< glossary_tooltip text="Kubernetes API Server" term_id="kube-apiserver" >}} 来 [支持额外的 API](/docs/tasks/access-kubernetes-api/configure-aggregation-layer/)，您就可以在 Kubernetes API 中增加 `APIService` 对象来 "申领（Claim）" 一个 URL 路径。 diff --git a/content/zh/docs/reference/glossary/cloud-controller-manager.md b/content/zh/docs/reference/glossary/cloud-controller-manager.md index 4188db8bd6..b6254d7ce9 100755 --- a/content/zh/docs/reference/glossary/cloud-controller-manager.md +++ b/content/zh/docs/reference/glossary/cloud-controller-manager.md @@ -2,7 +2,7 @@ title: 云控制器管理器 id: cloud-controller-manager date: 2018-04-12 -full_link: https://kubernetes.io/docs/tasks/administer-cluster/running-cloud-controller/ +full_link: /docs/tasks/administer-cluster/running-cloud-controller/ short_description: > 云控制器管理器是 1.8 的 alpha 特性。在未来发布的版本中，这是将 Kubernetes 与任何其他云集成的最佳方式。 @@ -18,7 +18,7 @@ tags: title: Cloud Controller Manager id: cloud-controller-manager date: 2018-04-12 -full_link: https://kubernetes.io/docs/tasks/administer-cluster/running-cloud-controller/ +full_link: /docs/tasks/administer-cluster/running-cloud-controller/ short_description: > Cloud Controller Manager is an alpha feature in 1.8. In upcoming releases it will be the preferred way to integrate Kubernetes with any cloud. diff --git a/content/zh/docs/reference/glossary/cni.md b/content/zh/docs/reference/glossary/cni.md index ecdb1bdd37..361a7f0911 100644 --- a/content/zh/docs/reference/glossary/cni.md +++ b/content/zh/docs/reference/glossary/cni.md @@ -2,7 +2,7 @@ title: CNI (容器网络接口) id: cni date: 2018-05-25 -full_link: https://kubernetes.io/docs/concepts/extend-kubernetes/compute-storage-net/network-plugins/#cni +full_link: /docs/concepts/extend-kubernetes/compute-storage-net/network-plugins/#cni short_description: > 容器网络接口 (CNI) 插件是遵循 appc/CNI 协议的一类网络插件。 @@ -17,7 +17,7 @@ tags: title: CNI (Container network interface) id: cni date: 2018-05-25 -full_link: https://kubernetes.io/docs/concepts/extend-kubernetes/compute-storage-net/network-plugins/#cni +full_link: /docs/concepts/extend-kubernetes/compute-storage-net/network-plugins/#cni short_description: > Container network interface (CNI) plugins are a type of Network plugin that adheres to the appc/CNI specification. @@ -37,9 +37,8 @@ tags: -* 想了解 Kubernetes 和 CNI 请参考 ["网络插件"](https://kubernetes.io/docs/concepts/extend-kubernetes/compute-storage-net/network-plugins/#cni)。 - +* 想了解 Kubernetes 和 CNI 请参考 ["网络插件"](/docs/concepts/extend-kubernetes/compute-storage-net/network-plugins/#cni)。 diff --git a/content/zh/docs/reference/glossary/configmap.md b/content/zh/docs/reference/glossary/configmap.md index 61d9371117..d3d0945cdc 100644 --- a/content/zh/docs/reference/glossary/configmap.md +++ b/content/zh/docs/reference/glossary/configmap.md @@ -35,7 +35,7 @@ tags: -ConfigMap 将您的环境配置信息和 {{< glossary_tooltip text="容器镜像" term_id="container" >}} 解耦，便于应用配置的修改。当您需要储存机密信息时可以使用 [Secret](https://kubernetes.io/docs/concepts/configuration/secret/) 对象。 +ConfigMap 将您的环境配置信息和 {{< glossary_tooltip text="容器镜像" term_id="container" >}} 解耦，便于应用配置的修改。当您需要储存机密信息时可以使用 [Secret](/docs/concepts/configuration/secret/) 对象。 diff --git a/content/zh/docs/reference/glossary/csi.md b/content/zh/docs/reference/glossary/csi.md index 401b42d85a..afacbf8f1d 100644 --- a/content/zh/docs/reference/glossary/csi.md +++ b/content/zh/docs/reference/glossary/csi.md @@ -2,7 +2,7 @@ title: 容器存储接口 (CSI) id: csi date: 2018-06-25 -full_link: https://kubernetes.io/docs/concepts/storage/volumes/#csi +full_link: /docs/concepts/storage/volumes/#csi short_description: > 容器存储接口 （CSI）定义了存储系统暴露给容器的标准接口。 @@ -17,7 +17,7 @@ tags: title: Container Storage Interface (CSI) id: csi date: 2018-06-25 -full_link: https://kubernetes.io/docs/concepts/storage/volumes/#csi +full_link: /docs/concepts/storage/volumes/#csi short_description: > The Container Storage Interface (CSI) defines a standard interface to expose storage systems to containers. @@ -38,12 +38,11 @@ tags: CSI 允许存储驱动提供商为 Kubernetes 创建定制化的存储插件，而无需将这些插件的代码添加到 Kubernetes 代码仓库（外部插件）。要使用某个存储提供商的 CSI 驱动，你首先要[将它部署到你的集群上](https://kubernetes-csi.github.io/docs/Setup.html)。然后你才能创建使用该 CSI 驱动的 {{< glossary_tooltip text="Storage Class" term_id="storage-class" >}} 。 -* [Kubernetes 文档中关于 CSI 的描述](https://kubernetes.io/docs/concepts/storage/volumes/#csi) +* [Kubernetes 文档中关于 CSI 的描述](/docs/concepts/storage/volumes/#csi) * [可用的 CSI 驱动列表](https://kubernetes-csi.github.io/docs/Drivers.html) - diff --git a/content/zh/docs/reference/glossary/flexvolume.md b/content/zh/docs/reference/glossary/flexvolume.md index 8603da3ffd..5cb6b7b9e4 100644 --- a/content/zh/docs/reference/glossary/flexvolume.md +++ b/content/zh/docs/reference/glossary/flexvolume.md @@ -2,7 +2,7 @@ title: Flexvolume id: flexvolume date: 2018-06-25 -full_link: https://kubernetes.io/docs/concepts/storage/volumes/#flexvolume +full_link: /docs/concepts/storage/volumes/#flexvolume short_description: > Flexvolume 是创建 out-of-tree 卷插件的一种接口。 {{< glossary_tooltip text="容器存储接口（CSI）" term_id="csi" >}} 是比 Flexvolume 更新的接口，它解决了 Flexvolumes 的一些问题。 @@ -17,7 +17,7 @@ tags: title: Flexvolume id: flexvolume date: 2018-06-25 -full_link: https://kubernetes.io/docs/concepts/storage/volumes/#flexvolume +full_link: /docs/concepts/storage/volumes/#flexvolume short_description: > Flexvolume is an interface for creating out-of-tree volume plugins. The {{< glossary_tooltip text="Container Storage Interface" term_id="csi" >}} is a newer interface which addresses several problems with Flexvolumes. @@ -41,11 +41,11 @@ FlexVolume 驱动程序的二进制文件和依赖项必须安装在主机上。 如果可能的话，SIG Storage 建议实现 {{< glossary_tooltip text="CSI" term_id="csi" >}} 驱动程序，因为它解决了 Flexvolumes 的限制。 -* [Kubernetes 文档中的 Flexvolume](https://kubernetes.io/docs/concepts/storage/volumes/#flexvolume) +* [Kubernetes 文档中的 Flexvolume](/docs/concepts/storage/volumes/#flexvolume) * [更多关于 Flexvolumes 的信息](https://github.com/kubernetes/community/blob/master/contributors/devel/flexvolume.md) * [存储供应商的卷插件 FAQ](https://github.com/kubernetes/community/blob/master/sig-storage/volume-plugin-faq.md) diff --git a/content/zh/docs/reference/glossary/replica-set.md b/content/zh/docs/reference/glossary/replica-set.md index b762c6b80e..5f394133b6 100755 --- a/content/zh/docs/reference/glossary/replica-set.md +++ b/content/zh/docs/reference/glossary/replica-set.md @@ -2,7 +2,7 @@ title: ReplicaSet id: replica-set date: 2018-04-12 -full_link: https://kubernetes.io/docs/concepts/workloads/controllers/replicaset/ +full_link: /docs/concepts/workloads/controllers/replicaset/ short_description: > ReplicaSet 是下一代副本控制器。 @@ -18,7 +18,7 @@ tags: title: ReplicaSet id: replica-set date: 2018-04-12 -full_link: https://kubernetes.io/docs/concepts/workloads/controllers/replicaset/ +full_link: /docs/concepts/workloads/controllers/replicaset/ short_description: > ReplicaSet is the next-generation Replication Controller. diff --git a/content/zh/docs/reference/glossary/secret.md b/content/zh/docs/reference/glossary/secret.md index 4b69aa58f4..a43dbb6ece 100755 --- a/content/zh/docs/reference/glossary/secret.md +++ b/content/zh/docs/reference/glossary/secret.md @@ -37,9 +37,9 @@ tags: -Secret 允许用户对如何使用敏感信息进行更多的控制，并减少信息意外暴露的风险，包括静态[加密](https://kubernetes.io/docs/tasks/administer-cluster/encrypt-data/#ensure-all-secrets-are-encrypted)。 +Secret 允许用户对如何使用敏感信息进行更多的控制，并减少信息意外暴露的风险，包括静态[加密](/docs/tasks/administer-cluster/encrypt-data/#ensure-all-secrets-are-encrypted)。 {{< glossary_tooltip text="Pod" term_id="pod" >}} 通过挂载卷中的文件的方式引用 Secret，或者通过 kubelet 为 pod 拉取镜像时引用。 -Secret 非常适合机密数据使用，而 [ConfigMaps](https://kubernetes.io/docs/tasks/configure-pod-container/configure-pod-configmap/) 适用于非机密数据。 +Secret 非常适合机密数据使用，而 [ConfigMaps](/docs/tasks/configure-pod-container/configure-pod-configmap/) 适用于非机密数据。 diff --git a/content/zh/docs/reference/kubectl/kubectl.md b/content/zh/docs/reference/kubectl/kubectl.md index b426430d24..dc8263fea9 100644 --- a/content/zh/docs/reference/kubectl/kubectl.md +++ b/content/zh/docs/reference/kubectl/kubectl.md @@ -14,13 +14,13 @@ kubectl 用来控制 Kubernetes 集群管理器 kubectl controls the Kubernetes cluster manager. -Find more information at: https://kubernetes.io/docs/reference/kubectl/overview/ +Find more information at: /docs/reference/kubectl/overview/ --> ### 摘要 kubectl 用来控制 Kubernetes 集群管理器。 -更多信息参见 https://kubernetes.io/docs/reference/kubectl/overview/ +更多信息参见 /docs/reference/kubectl/overview/ ``` kubectl [flags] diff --git a/content/zh/docs/reference/setup-tools/kubeadm/generated/kubeadm_token.md b/content/zh/docs/reference/setup-tools/kubeadm/generated/kubeadm_token.md index c32c897771..d378bc86dd 100644 --- a/content/zh/docs/reference/setup-tools/kubeadm/generated/kubeadm_token.md +++ b/content/zh/docs/reference/setup-tools/kubeadm/generated/kubeadm_token.md @@ -43,10 +43,10 @@ What is a bootstrap token more exactly? 您可以在此处阅读有关引导令牌（bootstrap token）的更多信息： - https://kubernetes.io/docs/admin/bootstrap-tokens/ + /docs/admin/bootstrap-tokens/ ``` kubeadm token [flags] @@ -123,6 +123,3 @@ kubeadm token [flags] - - - diff --git a/content/zh/docs/reference/setup-tools/kubeadm/kubeadm-init.md b/content/zh/docs/reference/setup-tools/kubeadm/kubeadm-init.md index 503767b657..b97946879c 100644 --- a/content/zh/docs/reference/setup-tools/kubeadm/kubeadm-init.md +++ b/content/zh/docs/reference/setup-tools/kubeadm/kubeadm-init.md @@ -359,8 +359,8 @@ using an external CRI implementation. --> 默认情况下, `kubeadm` 基于机器的 host 地址分配一个节点名称。你可以使用 `--node-name` 参数覆盖这个设置。 - -这个参数会向 kubelet 传递相应的 [`--hostname-override`](https://kubernetes.io/docs/reference/command-line-tools-reference/kubelet/#options) 参数。 + +这个参数会向 kubelet 传递相应的 [`--hostname-override`](/docs/reference/command-line-tools-reference/kubelet/#options) 参数。 注意覆盖主机名称可能会 [干扰到云服务提供商](https://github.com/kubernetes/website/pull/8873)。 @@ -394,8 +394,8 @@ without manual intervention. This and other limitations are expected to be resolved before self-hosting graduates from alpha. --> 1.8 版本中的自托管功能有一些重要的限制。特别的, 一个自托管的集群如果不手动介入的话 _不能够从主节点的重新启动中恢复_ 。 这个以及其它的一些限制被期望在自托管功能从 alpha 状态毕业前解决。 - -默认情况下, self-hosted 控制平面 Pods 依赖位于 [`hostPath`](https://kubernetes.io/docs/concepts/storage/volumes/#hostpath) 数据卷中的证书。除了初始化创建证书的过程, 这些证书不被 kubeadm 管理。你可以使用 `--feature-gates=StoreCertsInSecrets=true` 参数来启用一个试验性的模式，在这个模式中控制平面证书从 Secrets 加载。 这要求对你的集群进行非常小心的对鉴权和授权配置的控制, 并且可能并不适合你的环境。 + +默认情况下, self-hosted 控制平面 Pods 依赖位于 [`hostPath`](/docs/concepts/storage/volumes/#hostpath) 数据卷中的证书。除了初始化创建证书的过程, 这些证书不被 kubeadm 管理。你可以使用 `--feature-gates=StoreCertsInSecrets=true` 参数来启用一个试验性的模式，在这个模式中控制平面证书从 Secrets 加载。 这要求对你的集群进行非常小心的对鉴权和授权配置的控制, 并且可能并不适合你的环境。 {{< caution >}} ## 目标 -* 安装只有一个主节点的集群或[高可用集群](https://kubernetes.io/docs/setup/independent/high-availability/)。 +* 安装只有一个主节点的集群或[高可用集群](/docs/setup/independent/high-availability/)。 * 在集群上安装 Pod 网络，以便您的 Pod 可以相互通信。 -度量服务器通过 [Kubernetes 聚合器](https://kubernetes.io/docs/concepts/api-extension/apiserver-aggregation/)在主 API 服务器中注册，该聚合器是在 Kubernetes 1.7 版本中引入的。 +度量服务器通过 [Kubernetes 聚合器](/docs/concepts/api-extension/apiserver-aggregation/)在主 API 服务器中注册，该聚合器是在 Kubernetes 1.7 版本中引入的。 Kubernetes 应用程序通常由多个独立的服务组成，每个服务都在自己的容器中运行。 -在远端的 Kubernetes 集群上开发和调试这些服务可能很麻烦，需要[在运行的容器上打开 shell](https://kubernetes.io/docs/tasks/debug-application-cluster/get-shell-running-container/)，然后在远端 shell 中运行您所需的工具。 +在远端的 Kubernetes 集群上开发和调试这些服务可能很麻烦，需要[在运行的容器上打开 shell](/docs/tasks/debug-application-cluster/get-shell-running-container/)，然后在远端 shell 中运行您所需的工具。

扩缩应用程序

- -

在之前的模块中，我们创建了一个 Deployment，然后通过 Service让其可以开放访问。Deployment 仅为跑这个应用程序创建了一个 Pod。 当流量增加时，我们需要扩容应用程序满足用户需求。

+

在之前的模块中，我们创建了一个 Deployment，然后通过 Service让其可以开放访问。Deployment 仅为跑这个应用程序创建了一个 Pod。 当流量增加时，我们需要扩容应用程序满足用户需求。

扩缩 是通过改变 Deployment 中的副本数量来实现的。

@@ -95,8 +95,8 @@ weight: 10
-

扩展 Deployment 将创建新的 Pods，并将资源调度请求分配到有可用资源的节点上，收缩 会将 Pods 数量减少至所需的状态。Kubernetes 还支持 Pods 的自动缩放，但这并不在本教程的讨论范围内。将 Pods 数量收缩到0也是可以的，但这会终止 Deployment 上所有已经部署的 Pods。

+ autoscaling of Pods, but it is outside of the scope of this tutorial. Scaling to zero is also possible, and it will terminate all Pods of the specified Deployment.

--> +

扩展 Deployment 将创建新的 Pods，并将资源调度请求分配到有可用资源的节点上，收缩 会将 Pods 数量减少至所需的状态。Kubernetes 还支持 Pods 的自动缩放，但这并不在本教程的讨论范围内。将 Pods 数量收缩到0也是可以的，但这会终止 Deployment 上所有已经部署的 Pods。

diff --git a/content/zh/docs/tutorials/object-management-kubectl/object-management.md b/content/zh/docs/tutorials/object-management-kubectl/object-management.md index 85d95adfc4..04e18e03ab 100644 --- a/content/zh/docs/tutorials/object-management-kubectl/object-management.md +++ b/content/zh/docs/tutorials/object-management-kubectl/object-management.md @@ -57,7 +57,7 @@ kubectl create deployment nginx --image nginx 在命令式对象配置中，`kubectl` 命令指定操作(创建，替换等)，可选标志和至少一个文件名称。指定的文件必须包含对象的完整定义以 YAML 或 JSON 格式。 -请参阅[参考资源](https://kubernetes.io/docs/resources-reference/v1.6/) +请参阅[参考资源](/docs/resources-reference/v1.6/) 查看有关对象定义的更多细节。 **警告:** 命令式 `replace` 命令用新提供的命令替换现有资源规格，将对配置文件中缺少的对象的所有更改都丢弃。这种方法不应更新与配置文件无关的资源类型。例如，`LoadBalancer` 类型的服务使其 `externalIPs` 字段与集群的配置无关。 @@ -149,5 +149,3 @@ kubectl apply -R -f configs/ {{< comment >}} {{< /comment >}} {{% /capture %}} - - diff --git a/content/zh/docs/tutorials/stateful-application/cassandra.md b/content/zh/docs/tutorials/stateful-application/cassandra.md index 91bd0d1833..40c81dc117 100644 --- a/content/zh/docs/tutorials/stateful-application/cassandra.md +++ b/content/zh/docs/tutorials/stateful-application/cassandra.md @@ -38,7 +38,7 @@ title: “示例：使用 Stateful Sets 部署 Cassandra” ## 准备工作 -本示例假设你已经安装运行了一个 Kubernetes集群（版本 >=1.2），并且还在某个路径下安装了 [`kubectl`](https://kubernetes.io/docs/tasks/tools/install-kubectl/) 命令行工具。请查看 [getting started guides](https://kubernetes.io/docs/getting-started-guides/) 获取关于你的平台的安装说明。 +本示例假设你已经安装运行了一个 Kubernetes集群（版本 >=1.2），并且还在某个路径下安装了 [`kubectl`](/docs/tasks/tools/install-kubectl/) 命令行工具。请查看 [getting started guides](/docs/getting-started-guides/) 获取关于你的平台的安装说明。 本示例还需要一些代码和配置文件。为了避免手动输入，你可以 `git clone` Kubernetes 源到你本地。 @@ -176,7 +176,7 @@ cassandra None 9042/TCP 45s ## 步骤2：使用 StatefulSet 创建 Cassandra Ring环 -StatefulSets（以前叫做 PetSets）特性在 Kubernetes 1.5 中升级为一个 Beta 组件。在集群环境中部署类似于 Cassandra 的有状态分布式应用是一项具有挑战性的工作。我们实现了StatefulSet，极大的简化了这个过程。本示例使用了 StatefulSet 的多个特性，但其本身超出了本文的范围。[请参考 Stateful Set 文档。](https://kubernetes.io/docs/concepts/workloads/controllers/statefulset/) +StatefulSets（以前叫做 PetSets）特性在 Kubernetes 1.5 中升级为一个 Beta 组件。在集群环境中部署类似于 Cassandra 的有状态分布式应用是一项具有挑战性的工作。我们实现了StatefulSet，极大的简化了这个过程。本示例使用了 StatefulSet 的多个特性，但其本身超出了本文的范围。[请参考 Stateful Set 文档。](/docs/concepts/workloads/controllers/statefulset/) 以下是StatefulSet 的清单文件，用于创建一个由三个 pods 组成的 Cassandra ring环。 @@ -848,4 +848,3 @@ $ kubectl delete daemonset cassandra [!Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/cassandra/README.md?pixel)]() - diff --git a/content/zh/docs/tutorials/stateful-application/mysql-wordpress-persistent-volume.md b/content/zh/docs/tutorials/stateful-application/mysql-wordpress-persistent-volume.md index 3ce1c6f775..2c091a11c9 100644 --- a/content/zh/docs/tutorials/stateful-application/mysql-wordpress-persistent-volume.md +++ b/content/zh/docs/tutorials/stateful-application/mysql-wordpress-persistent-volume.md @@ -13,11 +13,11 @@ approvers: 展示的 Kubernetes 概念： -* [Persistent Volumes](https://kubernetes.io/docs/concepts/storage/persistent-volumes/) 定义持久化磁盘（磁盘生命周期不和 Pods 绑定）。 -* [Services](https://kubernetes.io/docs/concepts/services-networking/service/) 使得 Pods 能够找到其它 Pods。 -* [External Load Balancers](https://kubernetes.io/docs/concepts/services-networking/service/#type-loadbalancer) 对外暴露 Services。 -* [Deployments](http://kubernetes.io/docs/user-guide/deployments/) 确保 Pods 持续运行。 -* [Secrets](http://kubernetes.io/docs/user-guide/secrets/) 保存敏感密码信息。 +* [Persistent Volumes](/docs/concepts/storage/persistent-volumes/) 定义持久化磁盘（磁盘生命周期不和 Pods 绑定）。 +* [Services](/docs/concepts/services-networking/service/) 使得 Pods 能够找到其它 Pods。 +* [External Load Balancers](/docs/concepts/services-networking/service/#type-loadbalancer) 对外暴露 Services。 +* [Deployments](/docs/user-guide/deployments/) 确保 Pods 持续运行。 +* [Secrets](/docs/user-guide/secrets/) 保存敏感密码信息。 ## 快速入门 @@ -66,18 +66,18 @@ kubectl create -f https://raw.githubusercontent.com/kubernetes/examples/master/m Kubernetes本质是模块化的，可以在各种环境中运行。但并不是所有集群都相同。此处是本示例的一些要求： * 需要 1.2 版本以上的 Kubernetes，以使用更新的特性，例如 PV Claims 和 Deployments。运行 `kubectl version` 来查看你的集群版本。 * [Cluster DNS](https://github.com/kubernetes/dns) 将被用于服务发现。 -* 一个 [external load balancer](https://kubernetes.io/docs/concepts/services-networking/service/#type-loadbalancer) 将被用于接入 WordPress。 -* 使用了 [Persistent Volume Claims](https://kubernetes.io/docs/concepts/storage/persistent-volumes/#persistentvolumeclaims)。你必须创建集群中需要的 Persistent Volumes。本示例将展示两种类型的 volume 的创建方法，但是任何类型的 volume 都是足够使用的。 +* 一个 [external load balancer](/docs/concepts/services-networking/service/#type-loadbalancer) 将被用于接入 WordPress。 +* 使用了 [Persistent Volume Claims](/docs/concepts/storage/persistent-volumes/#persistentvolumeclaims)。你必须创建集群中需要的 Persistent Volumes。本示例将展示两种类型的 volume 的创建方法，但是任何类型的 volume 都是足够使用的。 -查阅 [Getting Started Guide](http://kubernetes.io/docs/getting-started-guides/)，搭建一个集群并安装 [kubectl](http://kubernetes.io/docs/user-guide/prereqs/) 命令行工具。 +查阅 [Getting Started Guide](/docs/getting-started-guides/)，搭建一个集群并安装 [kubectl](/docs/user-guide/prereqs/) 命令行工具。 ## 决定在哪里存储你的数据 -MySQL 和 WordPress 各自使用一个 [Persistent Volume](https://kubernetes.io/docs/concepts/storage/persistent-volumes/) 来存储自己的数据。我们将使用一个 Persistent Volume Claim 来取得一个可用的持久化存储。本示例覆盖了 HostPath 和 -GCEPersistentDisk 卷类型。你可以从两者中选择一个，或者查看 [Persistent Volumes的类型](https://kubernetes.io/docs/concepts/storage/persistent-volumes/#types-of-persistent-volumes)。 +MySQL 和 WordPress 各自使用一个 [Persistent Volume](/docs/concepts/storage/persistent-volumes/) 来存储自己的数据。我们将使用一个 Persistent Volume Claim 来取得一个可用的持久化存储。本示例覆盖了 HostPath 和 +GCEPersistentDisk 卷类型。你可以从两者中选择一个，或者查看 [Persistent Volumes的类型](/docs/concepts/storage/persistent-volumes/#types-of-persistent-volumes)。 ### Host Path @@ -112,7 +112,7 @@ kubectl create -f $KUBE_REPO/mysql-wordpress-pd/local-volumes.yaml ### GCE Persistent Disk -如果在 [Google Compute Engine](http://kubernetes.io/docs/getting-started-guides/gce/) 上运行集群，你可以使用这个存储选项。 +如果在 [Google Compute Engine](/docs/getting-started-guides/gce/) 上运行集群，你可以使用这个存储选项。 创建两个永久磁盘。你需要在和 Kubernetes 集群相同的 [GCE zone](https://cloud.google.com/compute/docs/zones) 中创建这些磁盘。默认的安装脚本将在 `us-central1-b` zone 中创建集群，就像你在 [config-default.sh](https://git.k8s.io/kubernetes/cluster/gce/config-default.sh) 文件中看到的。替换下面的 `` 为合适的 zone。`wordpress-1` 和 `wordpress-2` 的名字必须和 [gce-volumes.yaml](https://git.k8s.io/examples/mysql-wordpress-pd/gce-volumes.yaml) 指定的 `pdName` 字段匹配。 @@ -134,7 +134,7 @@ kubectl create -f $KUBE_REPO/mysql-wordpress-pd/gce-volumes.yaml ## 创建 MySQL 密码 Secret -使用一个 [Secret](http://kubernetes.io/docs/user-guide/secrets/) 对象存储 MySQL 密码。首先，创建一个名为 `password.txt` 的文件(和 wordpress 示例文件在相同的文件夹)，并且将你的密码保存于其中。请确保密码文件的结尾没有空行。如果你的编辑器添加了一个，开始的 `tr` 命令将会删除这个空行。然后，创建这个 Secret 对象。 +使用一个 [Secret](/docs/user-guide/secrets/) 对象存储 MySQL 密码。首先，创建一个名为 `password.txt` 的文件(和 wordpress 示例文件在相同的文件夹)，并且将你的密码保存于其中。请确保密码文件的结尾没有空行。如果你的编辑器添加了一个，开始的 `tr` 命令将会删除这个空行。然后，创建这个 Secret 对象。 ```shell tr --delete '\n' .strippedpassword.txt && mv .strippedpassword.txt password.txt @@ -318,11 +318,10 @@ kubectl delete pv wordpress-pv-1 wordpress-pv-2 ## 接下来的步骤 -* [Introspection and Debugging](http://kubernetes.io/docs/user-guide/introspection-and-debugging/) -* [Jobs](http://kubernetes.io/docs/user-guide/jobs/) may be useful to run SQL queries. -* [Exec](http://kubernetes.io/docs/user-guide/getting-into-containers/) -* [Port Forwarding](http://kubernetes.io/docs/user-guide/connecting-to-applications-port-forward/) +* [Introspection and Debugging](/docs/user-guide/introspection-and-debugging/) +* [Jobs](/docs/user-guide/jobs/) may be useful to run SQL queries. +* [Exec](/docs/user-guide/getting-into-containers/) +* [Port Forwarding](/docs/user-guide/connecting-to-applications-port-forward/) [![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/examples/mysql-wordpress-pd/README.md?pixel)]() - diff --git a/content/zh/includes/partner-script.js b/content/zh/includes/partner-script.js index 25c13ef3c5..499dc3f2e3 100644 --- a/content/zh/includes/partner-script.js +++ b/content/zh/includes/partner-script.js @@ -1061,7 +1061,7 @@ type: 3, name: 'Weaveworks', logo: 'weave_works', - link: 'https://kubernetes.io/docs/setup/independent/create-cluster-kubeadm/', + link: '/docs/setup/independent/create-cluster-kubeadm/', blurb: 'Weaveworks - kubeadm' }, {