Switch language name 'zh' to 'zh-cn'

This is the first step to rename 'zh' to 'zh-cn'. There are several reasons why we rename the language name.

- The upstream docsy theme changed the language name, leading to many warnings during site build;
  The side-effect is that the i18n strings are no longer working.
- We believe renaming the language is the right thing to do, because this move can make room for other variants of Chinese language, such as 'zh-tw', 'zh-sg' etc.

There would be several follow-ups to this PR, such as fixing the intra-site links, adding redirects etc.

We will lock up changes to zh/zh-cn pages for the moment, until this one gets in.

This PR is based on commit cdad0a7342.
This commit is contained in:
Qiming Teng
2022-06-10 20:25:27 +08:00
parent 3d345b1816
commit c52818c03d
1347 changed files with 8 additions and 6 deletions
@@ -0,0 +1,142 @@
---
title: 其他工具
content_type: concept
weight: 80
no_list: true
---
<!--
title: Other Tools
reviewers:
- janetkuo
content_type: concept
weight: 80
no_list: true
-->
<!-- overview -->
<!--
Kubernetes contains several tools to help you work with the Kubernetes system.
-->
Kubernetes 包含多种工具来帮助你使用 Kubernetes 系统。
<!-- body -->
<!--
[`crictl`](https://github.com/kubernetes-sigs/cri-tools) is a command-line
interface for inspecting and debugging {{<glossary_tooltip term_id="cri" text="CRI">}}-compatible
container runtimes.
-->
## crictl
[`crictl`](https://github.com/kubernetes-sigs/cri-tools)
是用于检查和调试兼容 {{<glossary_tooltip term_id="cri" text="CRI">}} 的容器运行时的命令行接口。
<!--
## Dashboard
[`Dashboard`](/docs/tasks/access-application-cluster/web-ui-dashboard/), the web-based user interface of Kubernetes, allows you to deploy containerized applications
to a Kubernetes cluster, troubleshoot them, and manage the cluster and its resources itself.
-->
## 仪表盘
[`Dashboard`](/zh/docs/tasks/access-application-cluster/web-ui-dashboard/)
基于 Web 的 Kubernetes 用户界面,
允许你将容器化的应用程序部署到 Kubernetes 集群,
对它们进行故障排查,并管理集群及其资源本身。
<!--
## Helm
[Helm](https://helm.sh/) is a tool for managing packages of pre-configured
Kubernetes resources. These packages are known as _Helm charts_.
-->
## Helm
{{% thirdparty-content single="true" %}}
[Helm](https://helm.sh/)
是一个用于管理预配置 Kubernetes 资源包的工具。这些包被称为“Helm 图表”。
<!--
Use Helm to:
* Find and use popular software packaged as Kubernetes charts
* Share your own applications as Kubernetes charts
* Create reproducible builds of your Kubernetes applications
* Intelligently manage your Kubernetes manifest files
* Manage releases of Helm packages
-->
使用 Helm 来:
* 查找和使用打包为 Kubernetes 图表的流行软件
* 将你自己的应用程序共享为 Kubernetes 图表
* 为你的 Kubernetes 应用程序创建可重现的构建
* 智能管理你的 Kubernetes 清单文件
* 管理 Helm 包的发布
<!--
## Kompose
[`Kompose`](https://github.com/kubernetes/kompose) is a tool to help Docker Compose users move to Kubernetes.
-->
## Kompose
[`Kompose`](https://github.com/kubernetes/kompose)
是一个帮助 Docker Compose 用户迁移到 Kubernetes 的工具。
<!--
Use Kompose to:
* Translate a Docker Compose file into Kubernetes objects
* Go from local Docker development to managing your application via Kubernetes
* Convert v1 or v2 Docker Compose `yaml` files or [Distributed Application Bundles](https://docs.docker.com/compose/bundles/)
-->
使用 Kompose
* 将 Docker Compose 文件翻译成 Kubernetes 对象
* 从本地 Docker 开发转到通过 Kubernetes 管理你的应用程序
* 转换 Docker Compose v1 或 v2 版本的 `yaml` 文件或[分布式应用程序包](https://docs.docker.com/compose/bundles/)
## Kui
<!--
[`Kui`](https://github.com/kubernetes-sigs/kui) is a GUI tool that takes your normal
`kubectl` command line requests and responds with graphics.
-->
[`Kui`](https://github.com/kubernetes-sigs/kui)
是一个接受你标准的 `kubectl` 命令行请求并以图形响应的 GUI 工具。
<!--
Kui takes the normal `kubectl` command line requests and responds with graphics. Instead
of ASCII tables, Kui provides a GUI rendering with tables that you can sort.
-->
Kui 接受标准的 `kubectl` 命令行工具并以图形响应。
Kui 提供包含可排序表格的 GUI 渲染,而不是 ASCII 表格。
<!--
Kui lets you:
* Directly click on long, auto-generated resource names instead of copying and pasting
* Type in `kubectl` commands and see them execute, even sometimes faster than `kubectl` itself
* Query a {{< glossary_tooltip text="Job" term_id="job">}} and see its execution rendered
as a waterfall diagram
* Click through resources in your cluster using a tabbed UI
-->
Kui 让你能够:
* 直接点击长的、自动生成的资源名称,而不是复制和粘贴
* 输入 `kubectl` 命令并查看它们的执行,有时甚至比 `kubectl` 本身更快
* 查询 {{<glossary_tooltip text="Job" term_id="job">}} 并查看其执行渲染为瀑布图
* 使用选项卡式 UI 在集群中单击资源
## Minikube
<!--
[`minikube`](https://minikube.sigs.k8s.io/docs/) is a tool that
runs a single-node Kubernetes cluster locally on your workstation for
development and testing purposes.
-->
[`minikube`](https://minikube.sigs.k8s.io/docs/)
是一种在你的工作站上本地运行单节点 Kubernetes 集群的工具,用于开发和测试。
@@ -0,0 +1,151 @@
---
title: 从 Docker 命令行映射到 crictl
content_type: reference
---
<!--
title: Mapping from dockercli to crictl
content_type: reference
-->
{{% thirdparty-content %}}
{{<note>}}
<!--
This page is deprecated and will be removed in Kubernetes 1.27.
-->
此页面已被废弃,将在 Kubernetes 1.27 版本删除。
{{</note>}}
<!--
`crictl` is a command-line interface for {{<glossary_tooltip term_id="cri" text="CRI">}}-compatible container runtimes.
You can use it to inspect and debug container runtimes and applications on a
Kubernetes node. `crictl` and its source are hosted in the
[cri-tools](https://github.com/kubernetes-sigs/cri-tools) repository.
-->
`crictl` 是兼容 {{<glossary_tooltip term_id="cri" text="CRI">}}的容器运行时的一种命令行接口。
你可以使用它来在 Kubernetes 节点上检视和调试容器运行时和应用。
`crictl` 及其源代码都托管在
[cri-tools](https://github.com/kubernetes-sigs/cri-tools) 仓库中。
<!--
This page provides a reference for mapping common commands for the `docker`
command-line tool into the equivalent commands for `crictl`.
-->
本页面提供一份参考资料,用来将 `docker` 命令行工具的常用命令映射到
`crictl` 的等价命令。
<!--
## Mapping from docker CLI to crictl
-->
## 从 docker 命令行映射到 crictl {#mapping-from-docker-cli-to-crictl}
<!--
The exact versions for the mapping table are for `docker` CLI v1.40 and `crictl`
v1.19.0. This list is not exhaustive. For example, it doesn't include
experimental `docker` CLI commands.
-->
映射表格中列举的确切版本是 `docker` 命令行的 v1.40 版本和 `crictl` 的 v1.19.0 版本。
这一列表不是完备的。例如,其中并未包含实验性质的 `docker` 命令。
{{< note >}}
<!--
The output format of `crictl` is similar to `docker` CLI, despite some missing
columns for some CLI. Make sure to check output for the specific command if your
command output is being parsed programmatically.
-->
`crictl` 的输出格式类似于 `docker` 命令行,只是对于某些命令而言会有部分列缺失。
如果你的命令输出会被程序解析,请确保你认真查看了对应的命令输出。
{{< /note >}}
<!--
### Retrieve debugging information
-->
### 获得调试信息 {#retrieve-debugging-information}
{{< table caption="docker 命令行与 crictl 的映射 - 获得调试信息" >}}
<!--docker CLI | crictl | Description | Unsupported Features
-- | -- | -- | --
`attach` | `attach` | Attach to a running container | `--detach-keys`, `--sig-proxy`
`exec` | `exec` | Run a command in a running container | `--privileged`, `--user`, `--detach-keys`
`images` | `images` | List images |  
`info` | `info` | Display system-wide information |  
`inspect` | `inspect`, `inspecti` | Return low-level information on a container, image or task |  
`logs` | `logs` | Fetch the logs of a container | `--details`
`ps` | `ps` | List containers |  
`stats` | `stats` | Display a live stream of container(s) resource usage statistics | Column: NET/BLOCK I/O, PIDs
`version` | `version` | Show the runtime (Docker, ContainerD, or others) version information |  
-->
docker CLI | crictl | 描述 | 不支持的功能
-- | -- | -- | --
`attach` | `attach` | 挂接到某运行中的容器 | `--detach-keys`, `--sig-proxy`
`exec` | `exec` | 在运行中的容器内执行命令 | `--privileged`, `--user`, `--detach-keys`
`images` | `images` | 列举镜像 |  
`info` | `info` | 显示系统范围的信息 |  
`inspect` | `inspect`, `inspecti` | 返回容器、镜像或任务的底层信息 |  
`logs` | `logs` | 取回容器的日志数据 | `--details`
`ps` | `ps` | 列举容器 |  
`stats` | `stats` | 显示容器资源用量统计的动态数据流 | 列:NET/BLOCK I/O、PIDs
`version` | `version` | 显示运行时(Docker、ContainerD 或其他)的版本信息 |
{{< /table >}}
<!--
### Perform Changes
-->
### 执行变更 {#perform-changes}
{{< table caption="docker 命令行与 crictl 的映射 - 执行变更" >}}
<!--
docker cli | crictl | Description | Unsupported Features
-- | -- | -- | --
`create` | `create` | Create a new container |  
`kill` | `stop` (timeout = 0) | Kill one or more running container | `--signal`
`pull` | `pull` | Pull an image or a repository from a registry | `--all-tags`, `--disable-content-trust`
`rm` | `rm` | Remove one or more containers |  
`rmi` | `rmi` | Remove one or more images |  
`run` | `run` | Run a command in a new container |  
`start` | `start` | Start one or more stopped containers | `--detach-keys`
`stop` | `stop` | Stop one or more running containers |  
`update` | `update` | Update configuration of one or more containers | `--restart`, `--blkio-weight` and some other resource limit not supported by CRI.
-->
docker CLI | crictl | 描述 | 不支持的功能
-- | -- | -- | --
`create` | `create` | 创建一个新容器 |  
`kill` | `stop` (超时值为 0) | 杀死一个或多个运行中的容器 | `--signal`
`pull` | `pull` | 从某镜像库拉取镜像或仓库 | `--all-tags`, `--disable-content-trust`
`rm` | `rm` | 移除一个或者多个容器 |  
`rmi` | `rmi` | 移除一个或者多个镜像 |  
`run` | `run` | 在一个新的容器中执行命令 |  
`start` | `start` | 启动一个或多个已停止的容器 | `--detach-keys`
`stop` | `stop` | 停止一个或多个运行中的容器 |  
`update` | `update` | 更新一个或多个容器的配置 | `--restart``--blkio-weight` 以 CRI 所不支持的资源约束
{{< /table >}}
<!--
### Supported only in crictl
-->
### 仅被 crictl 支持的命令 {#supported-only-in-crictl}
{{< table caption="docker 命令行与 crictl 的映射 - 仅被 crictl 支持的命令" >}}
<!--
crictl | Description
-- | --
`imagefsinfo` | Return image filesystem info
`inspectp` | Display the status of one or more pods
`port-forward` | Forward local port to a pod
`pods` | List pods
`runp` | Run a new pod
`rmp` | Remove one or more pods
`stopp` | Stop one or more running pods
-->
crictl | 描述
-- | --
`imagefsinfo` | 返回镜像文件系统信息
`inspectp` | 显示一个或多个 Pod 的状态
`port-forward` | 将本地端口转发到 Pod
`pods` | 列举 Pod
`runp` | 运行一个新的 Pod
`rmp` | 删除一个或多个 Pod
`stopp` | 停止一个或多个运行中的 Pod
{{< /table >}}