From 3ecbb41a7e8a0f85e871e29dbd674a22a0202149 Mon Sep 17 00:00:00 2001 From: Qiming Teng Date: Thu, 5 Oct 2023 10:58:36 +0800 Subject: [PATCH] [zh] Fix some links in the zh-cn localization site --- .../cluster-administration/flow-control.md | 2 +- .../docs/concepts/configuration/configmap.md | 7 +++-- .../zh-cn/docs/concepts/containers/images.md | 2 +- .../node-pressure-eviction.md | 4 +-- .../service-traffic-policy.md | 4 +-- .../new-content/blogs-case-studies.md | 2 +- .../extensible-admission-controllers.md | 4 +-- .../docs/reference/access-authn-authz/rbac.md | 2 +- .../feature-gates.md | 16 +++++------- .../labels-annotations-taints/_index.md | 22 +++++++++------- .../reference/setup-tools/kubeadm/_index.md | 17 +++++++++--- .../assign-memory-resource.md | 2 +- .../resize-container-resources.md | 2 +- .../configure-pod-container/static-pod.md | 2 +- .../docs/tasks/debug/debug-cluster/audit.md | 5 ++-- .../configure-multiple-schedulers.md | 26 ++++++++++--------- .../stateful-application/cassandra.md | 2 +- .../stateful-application/zookeeper.md | 2 +- 18 files changed, 68 insertions(+), 55 deletions(-) diff --git a/content/zh-cn/docs/concepts/cluster-administration/flow-control.md b/content/zh-cn/docs/concepts/cluster-administration/flow-control.md index fb42b73c3c831..f89a00b848f5b 100644 --- a/content/zh-cn/docs/concepts/cluster-administration/flow-control.md +++ b/content/zh-cn/docs/concepts/cluster-administration/flow-control.md @@ -1413,7 +1413,7 @@ the [enhancement proposal](https://github.com/kubernetes/enhancements/tree/maste - You can make suggestions and feature requests via [SIG API Machinery](https://github.com/kubernetes/community/tree/master/sig-api-machinery) or the feature's [slack channel](https://kubernetes.slack.com/messages/api-priority-and-fairness). --> -- 你可以查阅流控[参考文档](/zh-cn/docs/reference/flow-control/)了解有关故障排查的更多信息。 +- 你可以查阅流控[参考文档](/zh-cn/docs/reference/debug-cluster/flow-control/)了解有关故障排查的更多信息。 - 有关 API 优先级和公平性的设计细节的背景信息， 请参阅[增强提案](https://github.com/kubernetes/enhancements/tree/master/keps/sig-api-machinery/1040-priority-and-fairness)。 - 你可以通过 [SIG API Machinery](https://github.com/kubernetes/community/tree/master/sig-api-machinery/) diff --git a/content/zh-cn/docs/concepts/configuration/configmap.md b/content/zh-cn/docs/concepts/configuration/configmap.md index 9bc05ed250703..028659c896f71 100644 --- a/content/zh-cn/docs/concepts/configuration/configmap.md +++ b/content/zh-cn/docs/concepts/configuration/configmap.md @@ -61,7 +61,7 @@ ConfigMap 在设计上不是用来保存大量数据的。在 ConfigMap 中保 ## ConfigMap 对象 -ConfigMap 是一个 API [对象](/zh-cn/docs/concepts/overview/working-with-objects/kubernetes-objects/)， -让你可以存储其他对象所需要使用的配置。 +ConfigMap 是一个让你可以存储其他对象所需要使用的配置的 {{< glossary_tooltip text="API 对象" term_id="object" >}}。 和其他 Kubernetes 对象都有一个 `spec` 不同的是，ConfigMap 使用 `data` 和 `binaryData` 字段。这些字段能够接收键-值对作为其取值。`data` 和 `binaryData` 字段都是可选的。`data` 字段设计用来保存 UTF-8 字符串，而 `binaryData` @@ -190,7 +189,7 @@ Here's an example Pod that uses values from `game-demo` to configure a Pod: 下面是一个 Pod 的示例，它通过使用 `game-demo` 中的值来配置一个 Pod： -{{% code file="configmap/configure-pod.yaml" %}} +{{% code_sample file="configmap/configure-pod.yaml" %}} -* 请阅读[拓扑感知路由](/zh-cn/docs/concepts/services-networking/topology-aware-hints) +* 请阅读[拓扑感知路由](/zh-cn/docs/concepts/services-networking/topology-aware-routing/) * 请阅读 [Service 的外部流量策略](/zh-cn/docs/tasks/access-application-cluster/create-external-load-balancer/#preserving-the-client-source-ip) -* 遵循[使用 Service 连接到应用](/zh-cn/docs/tutorials/services/connect-applications-service/)教程 \ No newline at end of file +* 遵循[使用 Service 连接到应用](/zh-cn/docs/tutorials/services/connect-applications-service/)教程 diff --git a/content/zh-cn/docs/contribute/new-content/blogs-case-studies.md b/content/zh-cn/docs/contribute/new-content/blogs-case-studies.md index 8038e1ea2f59d..a19821a252a28 100644 --- a/content/zh-cn/docs/contribute/new-content/blogs-case-studies.md +++ b/content/zh-cn/docs/contribute/new-content/blogs-case-studies.md @@ -100,7 +100,7 @@ To submit a blog post, follow these steps: --> 要提交博文，你可以遵从以下步骤： -1. 如果你还未签署 CLA，请先[签署 CLA](https://kubernetes.io/docs/contribute/start/#sign-the-cla)。 +1. 如果你还未签署 CLA，请先[签署 CLA](/zh-cn/docs/contribute/start/#sign-the-cla)。 2. 查阅[网站仓库](https://github.com/kubernetes/website/tree/master/content/en/blog/_posts)中现有博文的 Markdown 格式。 3. 在你所选的文本编辑器中撰写你的博文。 4. 在第 2 步的同一链接上，点击 **Create new file** 按钮。 diff --git a/content/zh-cn/docs/reference/access-authn-authz/extensible-admission-controllers.md b/content/zh-cn/docs/reference/access-authn-authz/extensible-admission-controllers.md index e3fcac575eed3..5bf989c8f5e6d 100644 --- a/content/zh-cn/docs/reference/access-authn-authz/extensible-admission-controllers.md +++ b/content/zh-cn/docs/reference/access-authn-authz/extensible-admission-controllers.md @@ -605,7 +605,7 @@ request: # dryRun 表示 API 请求正在以 `dryrun` 模式运行，并且将不会保留。 # 带有副作用的 Webhook 应该避免在 dryRun 为 true 时激活这些副作用。 - # 有关更多详细信息，请参见 http://k8s.io/docs/reference/using-api/api-concepts/#make-a-dry-run-request + # 有关更多详细信息，请参见 http://k8s.io/zh-cn/docs/reference/using-api/api-concepts/#make-a-dry-run-request dryRun: False ``` @@ -1173,7 +1173,7 @@ webhook to be called. 如果你需要细粒度地过滤请求，你可以为 Webhook 定义**匹配条件**。 如果你发现匹配规则、`objectSelectors` 和 `namespaceSelectors` 仍然不能提供你想要的何时进行 HTTP 调用的过滤条件，那么添加这些条件会很有用。 -匹配条件是 [CEL 表达式](/docs/reference/using-api/cel/)。 +匹配条件是 [CEL 表达式](/zh-cn/docs/reference/using-api/cel/)。 所有匹配条件都必须为 true 才能调用 Webhook。 ### Alpha 和 Beta 状态的特性门控 {#feature-gates-for-alpha-or-beta-features} -{{< table caption="处于 Alpha 或 Beta 状态的特性门控" >}} +{{< table caption="处于 Alpha 或 Beta 状态的特性门控" sortable="true" >}} ### 已毕业和已废弃的特性门控 {#feature-gates-for-graduated-or-deprecated-features} -{{< table caption="已毕业或不推荐使用的特性门控" >}} +{{< table caption="已毕业或不推荐使用的特性门控" sortable="true" >}} -* 默认启用。 +* 通常默认启用。Beta API 组[默认是被禁用的](https://github.com/kubernetes/enhancements/tree/master/keps/sig-architecture/3136-beta-apis-off-by-default)。 * 该特性已经经过良好测试。启用该特性是安全的。 * 尽管详细信息可能会更改，但不会放弃对整体特性的支持。 * 对象的架构或语义可能会在随后的 Beta 或稳定版本中以不兼容的方式更改。 @@ -720,8 +720,6 @@ Each feature gate is designed for enabling/disabling a specific feature: - `DevicePluginCDIDevices`: Enable support to CDI device IDs in the [Device Plugin](/docs/concepts/extend-kubernetes/compute-storage-net/device-plugins/) API. --> -- `DevicePluginCDIDevices`: Enable support to CDI device IDs in the - [Device Plugin](/docs/concepts/extend-kubernetes/compute-storage-net/device-plugins/) API. - `DefaultHostNetworkHostPortsInPodTemplates`：更改何时分配 `PodSpec.containers[*].ports[*].hostPort` 的默认值。 默认仅在 Pod 中设置默认值。启用此特性意味着即使在嵌套的 PodSpec（例如 Deployment 中）中也会分配默认值， 这是以前的默认行为。 @@ -962,7 +960,7 @@ Each feature gate is designed for enabling/disabling a specific feature: - `KMSv2`：启用 KMS v2 API 以实现静态加密。 详情参见[使用 KMS 驱动进行数据加密](/zh-cn/docs/tasks/administer-cluster/kms-provider)。 - `KMSv2KDF`：启用 KMS v2 以生成一次性数据加密密钥。 - 详情参见[使用 KMS 提供程序进行数据加密](/docs/tasks/administer-cluster/kms-provider)。 + 详情参见[使用 KMS 提供程序进行数据加密](/zh-cn/docs/tasks/administer-cluster/kms-provider)。 如果 `KMSv2` 特性门控在你的集群未被启用 ，则 `KMSv2KDF` 特性门控的值不会产生任何影响。 - `KubeProxyDrainingTerminatingNodes`：为 `externalTrafficPolicy: Cluster` 服务实现正终止节点的连接排空。 - `TopologyAwareHints`： 在 EndpointSlices 中启用基于拓扑提示的拓扑感知路由。 - 更多详细信息可参见[拓扑感知提示](/zh-cn/docs/concepts/services-networking/topology-aware-hints/)。 + 更多详细信息可参见[拓扑感知路由](/zh-cn/docs/concepts/services-networking/topology-aware-routing/)。 - `TopologyManager`：启用一种机制来协调 Kubernetes 不同组件的细粒度硬件资源分配。 详见[控制节点上的拓扑管理策略](/zh-cn/docs/tasks/administer-cluster/topology-manager/)。 - `TopologyManagerPolicyAlphaOptions`：允许微调拓扑管理器策略的实验性的、Alpha 质量的选项。 @@ -1351,7 +1349,7 @@ Each feature gate is designed for enabling/disabling a specific feature: --> - `TopologyManagerPolicyOptions`：允许微调拓扑管理器策略。 - `UnknownVersionInteroperabilityProxy`：存在多个不同版本的 kube-apiserver 时将资源请求代理到正确的对等 kube-apiserver。 - 详细信息请参阅[混合版本代理](/docs/concepts/architecture/mixed-version-proxy/)。 + 详细信息请参阅[混合版本代理](/zh-cn/docs/concepts/architecture/mixed-version-proxy/)。 - `UserNamespacesSupport`：为 Pod 启用用户名字空间支持。 在 Kubernetes v1.28 之前，此特性门控被命名为 `UserNamespacesStatelessPodsSupport`。 类别：标签 @@ -515,8 +516,8 @@ for this label to be added to pods. 更多细节参阅 StatefulSet 主题中的 [Pod 索引标签](/zh-cn/docs/concepts/workloads/controllers/statefulset/#pod-index-label)。 -请注意，[PodIndexLabel](/zh-cn/docs/reference/command-line-tools-reference/feature-gates.md) 特性门控必须被启用， -才能将此标签添加到 Pod 上。 +请注意，[PodIndexLabel](/zh-cn/docs/reference/command-line-tools-reference/feature-gates/) +特性门控必须被启用，才能将此标签添加到 Pod 上。 -请注意，[PodIndexLabel](/zh-cn/docs/reference/command-line-tools-reference/feature-gates.md) 特性门控必须被启用， -才能将其添加为 Pod 的**标签**，否则它只会用作注解。 +请注意，[PodIndexLabel](/zh-cn/docs/reference/command-line-tools-reference/feature-gates/) +特性门控必须被启用，才能将其添加为 Pod 的**标签**，否则它只会用作注解。 ### batch.kubernetes.io/cronjob-scheduled-timestamp diff --git a/content/zh-cn/docs/reference/setup-tools/kubeadm/_index.md b/content/zh-cn/docs/reference/setup-tools/kubeadm/_index.md index 36e69e23422e1..c02d44f2f8738 100644 --- a/content/zh-cn/docs/reference/setup-tools/kubeadm/_index.md +++ b/content/zh-cn/docs/reference/setup-tools/kubeadm/_index.md @@ -4,9 +4,20 @@ weight: 10 no_list: true content_type: concept card: - name: reference - weight: 40 + title: kubeadm 命令参考 + name: setup + weight: 80 --- + @@ -71,7 +82,7 @@ To install kubeadm, see the [installation guide](/docs/setup/production-environm 用于恢复通过 `kubeadm init` 或者 `kubeadm join` 命令对节点进行的任何变更 * [kubeadm certs](/zh-cn/docs/reference/setup-tools/kubeadm/kubeadm-certs) 用于管理 Kubernetes 证书 -* [kubeadm kubeconfig](/docs/reference/setup-tools/kubeadm/kubeadm-kubeconfig) +* [kubeadm kubeconfig](/zh-cn/docs/reference/setup-tools/kubeadm/kubeadm-kubeconfig) 用于管理 kubeconfig 文件 * [kubeadm version](/zh-cn/docs/reference/setup-tools/kubeadm/kubeadm-version) 用于打印 kubeadm 的版本信息 diff --git a/content/zh-cn/docs/tasks/configure-pod-container/assign-memory-resource.md b/content/zh-cn/docs/tasks/configure-pod-container/assign-memory-resource.md index 1dcdb4e68479d..3ef7d54e2355d 100644 --- a/content/zh-cn/docs/tasks/configure-pod-container/assign-memory-resource.md +++ b/content/zh-cn/docs/tasks/configure-pod-container/assign-memory-resource.md @@ -555,4 +555,4 @@ kubectl delete namespace mem-example * [为命名空间配置内存和 CPU 配额](/zh-cn/docs/tasks/administer-cluster/manage-resources/quota-memory-cpu-namespace/) * [配置命名空间下 Pod 总数](/zh-cn/docs/tasks/administer-cluster/manage-resources/quota-pod-namespace/) * [配置 API 对象配额](/zh-cn/docs/tasks/administer-cluster/quota-api-object/) -* [调整分配给容器的 CPU 和内存资源的大小](/docs/tasks/configure-pod-container/resize-container-resources/) +* [调整分配给容器的 CPU 和内存资源的大小](/zh-cn/docs/tasks/configure-pod-container/resize-container-resources/) diff --git a/content/zh-cn/docs/tasks/configure-pod-container/resize-container-resources.md b/content/zh-cn/docs/tasks/configure-pod-container/resize-container-resources.md index b3f74b9341177..8eaa836506d49 100644 --- a/content/zh-cn/docs/tasks/configure-pod-container/resize-container-resources.md +++ b/content/zh-cn/docs/tasks/configure-pod-container/resize-container-resources.md @@ -352,7 +352,7 @@ kubectl delete namespace qos-example * [为容器和 Pod 分配内存资源](/zh-cn/docs/tasks/configure-pod-container/assign-memory-resource/) -* [为容器和 Pod 分配 CPU 资源](/docs/tasks/configure-pod-container/assign-cpu-resource/) +* [为容器和 Pod 分配 CPU 资源](/zh-cn/docs/tasks/configure-pod-container/assign-cpu-resource/) * [为控制面组件生成静态 Pod 清单](/zh-cn/docs/reference/setup-tools/kubeadm/implementation-details/#generate-static-pod-manifests-for-control-plane-components) * [为本地 etcd 生成静态 Pod 清单](/zh-cn/docs/reference/setup-tools/kubeadm/implementation-details/#generate-static-pod-manifest-for-local-etcd) -* [使用 `crictl` 对 Kubernetes 节点进行调试](/docs/tasks/debug/debug-cluster/crictl/) +* [使用 `crictl` 对 Kubernetes 节点进行调试](/zh-cn/docs/tasks/debug/debug-cluster/crictl/) * 更多细节请参阅 [`crictl`](https://github.com/kubernetes-sigs/cri-tools) * [从 `docker` CLI 命令映射到 `crictl`](/zh-cn/docs/reference/tools/map-crictl-dockercli/) * [将 etcd 实例设置为由 kubelet 管理的静态 Pod](/zh-cn/docs/setup/production-environment/tools/kubeadm/setup-ha-etcd-with-kubeadm/) diff --git a/content/zh-cn/docs/tasks/debug/debug-cluster/audit.md b/content/zh-cn/docs/tasks/debug/debug-cluster/audit.md index df8f2be37e8e4..cca70a6c51cee 100644 --- a/content/zh-cn/docs/tasks/debug/debug-cluster/audit.md +++ b/content/zh-cn/docs/tasks/debug/debug-cluster/audit.md @@ -451,5 +451,6 @@ By default truncate is disabled in both `webhook` and `log`, a cluster administr --> * 进一步了解 [Mutating webhook 审计注解](/zh-cn/docs/reference/access-authn-authz/extensible-admission-controllers/#mutating-webhook-auditing-annotations)。 * 通过阅读审计配置参考，进一步了解 - [`Event`](/docs/reference/config-api/apiserver-audit.v1/#audit-k8s-io-v1-Event) - 和 [`Policy`](/docs/reference/config-api/apiserver-audit.v1/#audit-k8s-io-v1-Policy) 资源的信息。 \ No newline at end of file + [`Event`](/zh-cn/docs/reference/config-api/apiserver-audit.v1/#audit-k8s-io-v1-Event) + 和 [`Policy`](/zh-cn/docs/reference/config-api/apiserver-audit.v1/#audit-k8s-io-v1-Policy) 资源的信息。 + diff --git a/content/zh-cn/docs/tasks/extend-kubernetes/configure-multiple-schedulers.md b/content/zh-cn/docs/tasks/extend-kubernetes/configure-multiple-schedulers.md index efc289bef00f3..19bd491ddba15 100644 --- a/content/zh-cn/docs/tasks/extend-kubernetes/configure-multiple-schedulers.md +++ b/content/zh-cn/docs/tasks/extend-kubernetes/configure-multiple-schedulers.md @@ -113,7 +113,7 @@ Deployment 管理一个 [ReplicaSet](/zh-cn/docs/concepts/workloads/controllers/ ReplicaSet 再管理 Pod，从而使调度器能够免受一些故障的影响。 以下是 Deployment 配置，将其保存为 `my-scheduler.yaml`： -{{% code file="admin/sched/my-scheduler.yaml" %}} +{{% code_sample file="admin/sched/my-scheduler.yaml" %}} +在前面提到的调度器配置中，你的调度器呈现为一个 +[KubeSchedulerProfile](/zh-cn/docs/reference/config-api/kube-scheduler-config.v1beta3/#kubescheduler-config-k8s-io-v1beta3-KubeSchedulerProfile)。 + {{< note >}} + -在前面提到的调度器配置中，你的调度器通过 [KubeSchedulerProfile](/docs/reference/config-api/kube-scheduler-config.v1beta3/#kubescheduler-config-k8s-io-v1beta3-KubeSchedulerProfile) 进行实现。 -{{< note >}} 要确定一个调度器是否可以调度特定的 Pod，PodTemplate 或 Pod 清单中的 `spec.schedulerName` 字段必须匹配 `KubeSchedulerProfile` 中的 `schedulerName` 字段。 -所有运行在集群中的调度器必须拥有唯一的名称。 +运行在集群中的所有调度器必须拥有唯一的名称。 {{< /note >}} -还要注意，我们创建了一个专用服务账号 `my-scheduler` 并将集群角色 `system:kube-scheduler` +还要注意，我们创建了一个专用的服务账号 `my-scheduler` 并将集群角色 `system:kube-scheduler` 绑定到它，以便它可以获得与 `kube-scheduler` 相同的权限。 -请参阅 [kube-scheduler 文档](/docs/reference/command-line-tools-reference/kube-scheduler/) -获取其他命令行参数以及 [Scheduler 配置参考](/docs/reference/config-api/kube-scheduler-config.v1beta3/) +请参阅 [kube-scheduler 文档](/zh-cn/docs/reference/command-line-tools-reference/kube-scheduler/) +获取其他命令行参数以及 [Scheduler 配置参考](/zh-cn/docs/reference/config-api/kube-scheduler-config.v1beta3/) 获取自定义 `kube-scheduler` 配置的详细说明。 - Pod spec 没有任何调度器名称 - {{% code file="admin/sched/pod1.yaml" %}} + {{% code_sample file="admin/sched/pod1.yaml" %}} - Pod spec 设置为 `default-scheduler` - {{% code file="admin/sched/pod2.yaml" %}} + {{% code_sample file="admin/sched/pod2.yaml" %}} - Pod spec 设置为 `my-scheduler` - {{% code file="admin/sched/pod3.yaml" %}} + {{% code_sample file="admin/sched/pod3.yaml" %}} -* 了解如何[扩缩 StatefulSet](/docs/tasks/run-application/scale-stateful-set/)。 +* 了解如何[扩缩 StatefulSet](/zh-cn/docs/tasks/run-application/scale-stateful-set/)。 * 了解有关 [**KubernetesSeedProvider**](https://github.com/kubernetes/examples/blob/master/cassandra/java/src/main/java/io/k8s/cassandra/KubernetesSeedProvider.java) 的更多信息 * 查看更多自定义 [Seed Provider Configurations](https://git.k8s.io/examples/cassandra/java/README.md) diff --git a/content/zh-cn/docs/tutorials/stateful-application/zookeeper.md b/content/zh-cn/docs/tutorials/stateful-application/zookeeper.md index a7c9a1c6914c5..0a0674d14be54 100644 --- a/content/zh-cn/docs/tutorials/stateful-application/zookeeper.md +++ b/content/zh-cn/docs/tutorials/stateful-application/zookeeper.md @@ -770,7 +770,7 @@ Use the command below to get the logging configuration from one of Pods in the ` ### 配置日志 {#configuring-logging} `zkGenConfig.sh` 脚本产生的一个文件控制了 ZooKeeper 的日志行为。 -ZooKeeper 使用了 [Log4j](http://logging.apache.org/log4j/2.x/) +ZooKeeper 使用了 [Log4j](https://logging.apache.org/log4j/2.x/) 并默认使用基于文件大小和时间的滚动文件追加器作为日志配置。 从 `zk` StatefulSet 的一个 Pod 中获取日志配置。