diff --git a/content/zh-cn/docs/home/_index.md b/content/zh-cn/docs/home/_index.md index 738ee19bb4..0a8d131abf 100644 --- a/content/zh-cn/docs/home/_index.md +++ b/content/zh-cn/docs/home/_index.md @@ -18,11 +18,13 @@ menu: # Kubernetes is an open source container orchestration engine for automating deployment, scaling, and management of containerized applications. The open source project is hosted by the Cloud Native Computing Foundation. description: > Kubernetes 是一个开源的容器编排引擎,用来对容器化应用进行自动部署、 扩缩和管理。此开源项目由云原生计算基金会(CNCF)托管。 + # overview: # Kubernetes is an open source container orchestration engine for automating deployment, scaling, and management of containerized applications. The open source project is hosted by the Cloud Native Computing Foundation (CNCF). overview: Kubernetes 是一个开源的容器编排引擎,用来对容器化应用进行自动化部署、 扩缩和管理。该项目托管在 CNCF。 -# cards: + +cards: # - name: concepts # title: "Understand Kubernetes" # description: "Learn about Kubernetes and its fundamental concepts." @@ -33,6 +35,16 @@ overview: # description: "Follow tutorials to learn how to deploy applications in Kubernetes." # button: "View Tutorials" # button_path: "/docs/tutorials" +- name: concepts + title: "了解 Kubernetes" + description: "了解 Kubernetes 及其基础概念。" + button: "查看概念" + button_path: "/zh-cn/docs/concepts" +- name: tutorials + title: "尝试 Kubernetes" + description: "按照教程学习如何在 Kubernetes 上部署应用。" + button: "查看教程" + button_path: "/zh-cn/docs/tutorials" # - name: setup # title: "Set up a K8s cluster" # description: "Get Kubernetes running based on your resources and needs." @@ -43,6 +55,16 @@ overview: # description: "Look up common tasks and how to perform them using a short sequence of steps." # button: "View Tasks" # button_path: "/docs/tasks" +- name: setup + title: "安裝 K8s 集群" + description: "基于你的资源情况和需要运行 Kubernetes。" + button: "安装 Kubernetes" + button_path: "/zh-cn/docs/setup" +- name: tasks + title: "了解如何使用 Kubernetes" + description: "查看常见任务以及如何使用简单步骤执行它们。" + button: "查看任务" + button_path: "/zh-cn/docs/tasks" # - name: training # title: "Training" # description: "Get certified in Kubernetes and make your cloud native projects successful!" @@ -53,40 +75,6 @@ overview: # description: Browse terminology, command line syntax, API resource types, and setup tool documentation. # button: View Reference # button_path: /docs/reference -# - name: contribute -# title: Contribute to the docs -# description: Anyone can contribute, whether you’re new to the project or you’ve been around a long time. -# button: Contribute to the docs -# button_path: /docs/contribute -# - name: release-notes -# title: K8s Release Notes -# description: If you are installing Kubernetes or upgrading to the newest version, refer to the current release notes. -# button: "Download Kubernetes" -# button_path: "/zh-cn/docs/setup/release/notes" -# - name: about -# title: About the documentation -# description: This website contains documentation for the current and previous 4 versions of Kubernetes. -cards: -- name: concepts - title: "了解 Kubernetes" - description: "了解 Kubernetes 和其基础概念。" - button: "查看概念" - button_path: "/zh-cn/docs/concepts" -- name: tutorials - title: "尝试 Kubernetes" - description: "按照教程学习如何在 Kubernetes 上部署应用。" - button: "查看教程" - button_path: "/zh-cn/docs/tutorials" -- name: setup - title: "设置 K8s 集群" - description: "按照你的资源情况和需求运行 Kubernetes。" - button: "设置 Kubernetes" - button_path: "/zh-cn/docs/setup" -- name: tasks - title: "了解如何使用 Kubernetes" - description: "查看常见任务以及如何使用简单步骤执行它们。" - button: "查看任务" - button_path: "/zh-cn/docs/tasks" - name: training title: "培训" description: "通过 Kubernetes 认证,助你的云原生项目成功!" @@ -97,16 +85,29 @@ cards: description: 浏览术语、命令行语法、API 资源类型和安装工具文档。 button: 查看参考 button_path: /zh-cn/docs/reference +# - name: contribute +# title: Contribute to the docs +# description: Anyone can contribute, whether you’re new to the project or you’ve been around a long time. +# button: Contribute to the docs +# button_path: /docs/contribute +# - name: release-notes +# title: K8s Release Notes +# description: If you are installing Kubernetes or upgrading to the newest version, refer to the current release notes. +# button: "Download Kubernetes" +# button_path: "/zh-cn/docs/setup/release/notes" - name: contribute title: 为文档作贡献 description: 任何人,无论对该项目熟悉与否,都能贡献自己的力量。 button: 为文档作贡献 button_path: /zh-cn/docs/contribute -- name: release-notes - title: K8s 发布说明 - description: 如果你正在安装或升级 Kubernetes,最好参考最新的发布说明。 +- name: Download + title: 下载 Kubernetes + description: 安装 Kubernetes 或将其升级到最新版本。 button: "下载 Kubernetes" button_path: "/releases/download" +# - name: about +# title: About the documentation +# description: This website contains documentation for the current and previous 4 versions of Kubernetes. - name: about title: 关于文档 description: 本网站包含了当前及前 4 个版本的 Kubernetes 文档。 diff --git a/content/zh-cn/docs/tasks/tools/_index.md b/content/zh-cn/docs/tasks/tools/_index.md index b112852e59..5497937cdb 100644 --- a/content/zh-cn/docs/tasks/tools/_index.md +++ b/content/zh-cn/docs/tasks/tools/_index.md @@ -47,7 +47,7 @@ kubectl 可安装在各种 Linux 平台、 macOS 和 Windows 上。 ## kind -[`kind`](https://kind.sigs.k8s.io/docs/) 让你能够在本地计算机上运行 Kubernetes。 +[`kind`](https://kind.sigs.k8s.io/) 让你能够在本地计算机上运行 Kubernetes。 `kind` 要求你安装并配置好 [Docker](https://docs.docker.com/get-docker/)。 -kind [快速入门](https://kind.sigs.k8s.io/docs/user/quick-start/)页面展示了开始使用 +kind 的 [Quick Start](https://kind.sigs.k8s.io/docs/user/quick-start/) 页面展示开始使用 `kind` 所需要完成的操作。 与 `kind` 类似,[`minikube`](https://minikube.sigs.k8s.io/) 是一个工具, 能让你在本地运行 Kubernetes。 -`minikube` 在你的个人计算机(包括 Windows、macOS 和 Linux PC)上运行一个一体化(all-in-one)或多节点的本地 -Kubernetes 集群,以便你来尝试 Kubernetes 或者开展每天的开发工作。 +`minikube` 在你的个人计算机(包括 Windows、macOS 和 Linux PC)上运行一个一体化(all-in-one) +或多节点的本地 Kubernetes 集群,以便你来尝试 Kubernetes 或者开展每天的开发工作。 如果你关注如何安装此工具,可以按官方的 [Get Started!](https://minikube.sigs.k8s.io/docs/start/)指南操作。 @@ -125,3 +125,4 @@ Once installed, you can use it to [create a cluster](/docs/setup/production-envi 查看 kubeadm 安装指南 + diff --git a/content/zh-cn/docs/tasks/tools/included/_index.md b/content/zh-cn/docs/tasks/tools/included/_index.md index 0b1291134b..aa3c87ea95 100644 --- a/content/zh-cn/docs/tasks/tools/included/_index.md +++ b/content/zh-cn/docs/tasks/tools/included/_index.md @@ -3,12 +3,18 @@ title: "内含的工具" description: "在页面 kubectl-installs-*.md 中包含的代码片段" headless: true toc_hide: true +_build: + list: never + render: never + publishResources: false --- diff --git a/content/zh-cn/docs/tasks/tools/included/kubectl-convert-overview.md b/content/zh-cn/docs/tasks/tools/included/kubectl-convert-overview.md index 21d6556331..994a33d0e4 100644 --- a/content/zh-cn/docs/tasks/tools/included/kubectl-convert-overview.md +++ b/content/zh-cn/docs/tasks/tools/included/kubectl-convert-overview.md @@ -3,15 +3,17 @@ title: "kubectl-convert 概述" description: >- 一个 kubectl 插件,允许你将清单从一个 Kubernetes API 版本转换到不同的版本。 headless: true +_build: + list: never + render: never + publishResources: false --- 一个 Kubernetes 命令行工具 `kubectl` 的插件,允许你将清单在不同 API 版本间转换。 这对于将清单迁移到新的 Kubernetes 发行版上未被废弃的 API 版本时尤其有帮助。 -更多信息请访问 [迁移到非弃用 API](/zh-cn/docs/reference/using-api/deprecation-guide/#migrate-to-non-deprecated-apis) +更多信息请访问[迁移到非弃用 API](/zh-cn/docs/reference/using-api/deprecation-guide/#migrate-to-non-deprecated-apis) diff --git a/content/zh-cn/docs/tasks/tools/included/kubectl-whats-next.md b/content/zh-cn/docs/tasks/tools/included/kubectl-whats-next.md index 6d8a9a136d..4c5fe19515 100644 --- a/content/zh-cn/docs/tasks/tools/included/kubectl-whats-next.md +++ b/content/zh-cn/docs/tasks/tools/included/kubectl-whats-next.md @@ -2,13 +2,15 @@ title: "后续内容" description: "安装 kubectl 之后,还可以做些什么?" headless: true +_build: + list: never + render: never + publishResources: false --- -* [安装 Minikube](https://minikube.sigs.k8s.io/docs/start/) -* 有关创建集群的更多信息,请参阅[入门指南](/zh-cn/docs/setup/). -* [学习如何启动并对外公开你的应用程序。](/zh-cn/docs/tasks/access-application-cluster/service-access-application-cluster/) -* 如果你需要访问其他人创建的集群,请参阅 - [共享集群接入文档](/zh-cn/docs/tasks/access-application-cluster/configure-access-multiple-clusters/). -* 阅读 [kubectl 参考文档](/zh-cn/docs/reference/kubectl/kubectl/) +* [安装 Minikube](https://minikube.sigs.k8s.io/docs/start/)。 +* 有关创建集群的更多信息,请参阅[入门指南](/zh-cn/docs/setup/)。 +* [学习如何启动并对外公开你的应用程序](/zh-cn/docs/tasks/access-application-cluster/service-access-application-cluster/)。 +* 如果你需要访问其他人创建的集群, + 请参阅[共享集群接入文档](/zh-cn/docs/tasks/access-application-cluster/configure-access-multiple-clusters/)。 +* 阅读 [kubectl 参考文档](/zh-cn/docs/reference/kubectl/kubectl/)。 + diff --git a/content/zh-cn/docs/tasks/tools/included/optional-kubectl-configs-bash-linux.md b/content/zh-cn/docs/tasks/tools/included/optional-kubectl-configs-bash-linux.md index d16a6220bc..f4d2a55c0d 100644 --- a/content/zh-cn/docs/tasks/tools/included/optional-kubectl-configs-bash-linux.md +++ b/content/zh-cn/docs/tasks/tools/included/optional-kubectl-configs-bash-linux.md @@ -2,6 +2,11 @@ title: "Linux 系统中的 Bash 自动补全功能" description: "Linux 系统中 Bash 自动补全功能的一些可选配置。" headless: true +_build: + list: never + render: never + publishResources: false + --- 两种方式的效果相同。重新加载 Shell 后,kubectl 自动补全功能即可生效。 -若要在当前 Shell 会话中启用 Bash 补全功能,需要运行 `exec bash` 命令: +若要在当前 Shell 会话中启用 Bash 补全功能,源引 `~/.bashrc` 文件: ```bash -exec bash +source ~/.bashrc ``` diff --git a/content/zh-cn/docs/tasks/tools/included/optional-kubectl-configs-pwsh.md b/content/zh-cn/docs/tasks/tools/included/optional-kubectl-configs-pwsh.md index 9cbf851b4f..02eaea3db4 100644 --- a/content/zh-cn/docs/tasks/tools/included/optional-kubectl-configs-pwsh.md +++ b/content/zh-cn/docs/tasks/tools/included/optional-kubectl-configs-pwsh.md @@ -2,13 +2,15 @@ title: "PowerShell 自动补全" description: "powershell 自动补全的一些可选配置。" headless: true +_build: + list: never + render: never + publishResources: false --- -使用命令 `kubectl completion powershell` 生成 PowerShell 的 kubectl 自动补全脚本。 +你可以使用命令 `kubectl completion powershell` 生成 PowerShell 的 kubectl 自动补全脚本。 -如果需要自动补全在所有 shell 会话中生效,请将以下命令添加到 `$PROFILE` 文件中: +如果需要自动补全在所有 Shell 会话中生效,请将以下命令添加到 `$PROFILE` 文件中: ```powershell kubectl completion powershell | Out-String | Invoke-Expression @@ -32,7 +34,7 @@ This command will regenerate the auto-completion script on every PowerShell star -如果需要将自动补全脚本直接添加到 `$PROFILE` 文件中,请在 PowerShell 终端运行以下命令: +如果需要将自动补全脚本直接添加到 `$PROFILE` 文件中,请在 PowerShell 命令行运行以下命令: ```powershell kubectl completion powershell >> $PROFILE @@ -41,4 +43,4 @@ kubectl completion powershell >> $PROFILE -完成上述操作后重启 shell,kubectl的自动补全就可以工作了。 +完成上述操作后重启 Shell,kubectl 的自动补全就可以工作了。 diff --git a/content/zh-cn/docs/tasks/tools/included/optional-kubectl-configs-zsh.md b/content/zh-cn/docs/tasks/tools/included/optional-kubectl-configs-zsh.md index 9a40a829aa..a5e8c00faa 100644 --- a/content/zh-cn/docs/tasks/tools/included/optional-kubectl-configs-zsh.md +++ b/content/zh-cn/docs/tasks/tools/included/optional-kubectl-configs-zsh.md @@ -2,13 +2,15 @@ title: "zsh 自动补全" description: "zsh 自动补全的一些可选配置" headless: true +_build: + list: never + render: never + publishResources: false --- kubectl 通过命令 `kubectl completion zsh` 生成 Zsh 自动补全脚本。 -在 shell 中导入(Sourcing)该自动补全脚本,将启动 kubectl 自动补全功能。 +在 Shell 中导入(Sourcing)该自动补全脚本,将启动 kubectl 自动补全功能。 -为了在所有的 shell 会话中实现此功能,请将下面内容加入到文件 `~/.zshrc` 中。 +为了在所有的 Shell 会话中实现此功能,请将下面内容加入到文件 `~/.zshrc` 中。 ```zsh source <(kubectl completion zsh) @@ -36,10 +38,13 @@ After reloading your shell, kubectl autocompletion should be working. If you get an error like `complete:13: command not found: compdef`, then add the following to the beginning of your `~/.zshrc` file: If you get an error like `2: command not found: compdef`, then add the following to the beginning of your `~/.zshrc` file: --> -重新加载 shell 后,kubectl 自动补全功能将立即生效。 +重新加载 Shell 后,kubectl 自动补全功能将立即生效。 + +如果你收到 `2: command not found: compdef` 这样的错误提示,那请将下面内容添加到 +`~/.zshrc` 文件的开头: -如果你收到 `2: command not found: compdef` 这样的错误提示,那请将下面内容添加到 `~/.zshrc` 文件的开头: ```zsh autoload -Uz compinit compinit ``` + diff --git a/content/zh-cn/docs/tasks/tools/install-kubectl-macos.md b/content/zh-cn/docs/tasks/tools/install-kubectl-macos.md index b02aa806a6..c6be2f3480 100644 --- a/content/zh-cn/docs/tasks/tools/install-kubectl-macos.md +++ b/content/zh-cn/docs/tasks/tools/install-kubectl-macos.md @@ -58,6 +58,7 @@ The following methods exist for installing kubectl on macOS: - [可选的 kubectl 配置和插件](#optional-kubectl-configurations-and-plugins) - [启用 shell 自动补全功能](#enable-shell-autocompletion) - [安装 `kubectl convert` 插件](#install-kubectl-convert-plugin) + @@ -426,3 +427,4 @@ kubectl 为 Bash、Zsh、Fish 和 PowerShell 提供自动补全功能,可以 ## {{% heading "whatsnext" %}} {{< include "included/kubectl-whats-next.md" >}} +