[zh] Resync tasks/tools pages

pull/39402/head
Qiming Teng 2023-02-12 13:45:31 +08:00
parent 4feea9cc56
commit 3babf09e1a
9 changed files with 98 additions and 71 deletions

View File

@ -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 (<a href="https://www.cncf.io/about">CNCF</a>).
overview:
Kubernetes 是一个开源的容器编排引擎,用来对容器化应用进行自动化部署、 扩缩和管理。该项目托管在 <a href="https://www.cncf.io/about">CNCF</a>
# 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 youre new to the project or youve 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 youre new to the project or youve 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 文档。

View File

@ -47,7 +47,7 @@ kubectl 可安装在各种 Linux 平台、 macOS 和 Windows 上。
## kind
<!--
[`kind`](https://kind.sigs.k8s.io/docs/) lets you run Kubernetes on
[`kind`](https://kind.sigs.k8s.io/) lets you run Kubernetes on
your local computer. This tool requires that you have
[Docker](https://docs.docker.com/get-docker/) installed and configured.
@ -56,10 +56,10 @@ shows you what you need to do to get up and running with kind.
<a class="btn btn-primary" href="https://kind.sigs.k8s.io/docs/user/quick-start/" role="button" aria-label="View kind Quick Start Guide">View kind Quick Start Guide</a>
-->
[`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` 所需要完成的操作。
<a class="btn btn-primary" href="https://kind.sigs.k8s.io/docs/user/quick-start/"
@ -81,8 +81,8 @@ on getting the tool installed.
-->
`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
<a class="btn btn-primary" href="/zh-cn/docs/setup/production-environment/tools/kubeadm/install-kubeadm/"
role="button" aria-label="查看 kubeadm 安装指南">查看 kubeadm 安装指南</a>

View File

@ -3,12 +3,18 @@ title: "内含的工具"
description: "在页面 kubectl-installs-*.md 中包含的代码片段"
headless: true
toc_hide: true
_build:
list: never
render: never
publishResources: false
---
<!--
---
title: "Tools Included"
description: "Snippets to be included in the main kubectl-installs-*.md pages."
headless: true
toc_hide: true
---
_build:
list: never
render: never
publishResources: false
-->

View File

@ -3,15 +3,17 @@ title: "kubectl-convert 概述"
description: >-
一个 kubectl 插件,允许你将清单从一个 Kubernetes API 版本转换到不同的版本。
headless: true
_build:
list: never
render: never
publishResources: false
---
<!--
---
title: "kubectl-convert overview"
description: >-
A kubectl plugin that allows you to convert manifests from one version
of a Kubernetes API to a different version.
headless: true
---
-->
<!--
@ -21,4 +23,4 @@ For more info, visit [migrate to non deprecated apis](/docs/reference/using-api/
-->
一个 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)

View File

@ -2,13 +2,15 @@
title: "后续内容"
description: "安装 kubectl 之后,还可以做些什么?"
headless: true
_build:
list: never
render: never
publishResources: false
---
<!--
---
title: "What's next?"
description: "What's next after installing kubectl."
headless: true
---
-->
<!--
@ -19,9 +21,10 @@ headless: true
[Sharing Cluster Access document](/docs/tasks/access-application-cluster/configure-access-multiple-clusters/).
* Read the [kubectl reference docs](/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/)
* [安装 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/)。

View File

@ -2,6 +2,11 @@
title: "Linux 系统中的 Bash 自动补全功能"
description: "Linux 系统中 Bash 自动补全功能的一些可选配置。"
headless: true
_build:
list: never
render: never
publishResources: false
---
<!--
title: "bash auto-completion on Linux"
@ -96,11 +101,11 @@ bash-completion 负责导入 `/etc/bash_completion.d` 目录中的所有补全
<!--
Both approaches are equivalent. After reloading your shell, kubectl autocompletion should be working.
To enable bash autocompletion in current session of shell, run `exec bash`:
To enable bash autocompletion in current session of shell, source the ~/.bashrc file:
-->
两种方式的效果相同。重新加载 Shell 后kubectl 自动补全功能即可生效。
若要在当前 Shell 会话中启用 Bash 补全功能,需要运行 `exec bash` 命令
若要在当前 Shell 会话中启用 Bash 补全功能,源引 `~/.bashrc` 文件
```bash
exec bash
source ~/.bashrc
```

View File

@ -2,13 +2,15 @@
title: "PowerShell 自动补全"
description: "powershell 自动补全的一些可选配置。"
headless: true
_build:
list: never
render: never
publishResources: false
---
<!--
---
title: "PowerShell auto-completion"
description: "Some optional configuration for powershell auto-completion."
headless: true
---
-->
<!--
@ -16,9 +18,9 @@ The kubectl completion script for PowerShell can be generated with the command `
To do so in all your shell sessions, add the following line to your `$PROFILE` file:
-->
使用命令 `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
<!--
To add the generated script to your `$PROFILE` file, run the following line in your powershell prompt:
-->
如果需要将自动补全脚本直接添加到 `$PROFILE` 文件中,请在 PowerShell 终端运行以下命令:
如果需要将自动补全脚本直接添加到 `$PROFILE` 文件中,请在 PowerShell 命令行运行以下命令:
```powershell
kubectl completion powershell >> $PROFILE
@ -41,4 +43,4 @@ kubectl completion powershell >> $PROFILE
<!--
After reloading your shell, kubectl autocompletion should be working.
-->
完成上述操作后重启 shellkubectl的自动补全就可以工作了。
完成上述操作后重启 Shellkubectl 的自动补全就可以工作了。

View File

@ -2,13 +2,15 @@
title: "zsh 自动补全"
description: "zsh 自动补全的一些可选配置"
headless: true
_build:
list: never
render: never
publishResources: false
---
<!--
---
title: "zsh auto-completion"
description: "Some optional configuration for zsh auto-completion."
headless: true
---
-->
<!--
@ -17,9 +19,9 @@ The kubectl completion script for Zsh can be generated with the command `kubectl
To do so in all your shell sessions, add the following to your `~/.zshrc` file:
-->
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
```

View File

@ -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)
<!--
### Install kubectl binary with curl on macOS
-->
@ -426,3 +427,4 @@ kubectl 为 Bash、Zsh、Fish 和 PowerShell 提供自动补全功能,可以
## {{% heading "whatsnext" %}}
{{< include "included/kubectl-whats-next.md" >}}