diff --git a/content/zh-cn/docs/reference/kubectl/_index.md b/content/zh-cn/docs/reference/kubectl/_index.md
index 7e80378ffc39b..42446e5a20193 100644
--- a/content/zh-cn/docs/reference/kubectl/_index.md
+++ b/content/zh-cn/docs/reference/kubectl/_index.md
@@ -52,7 +52,8 @@ For details about each command, including all the supported flags and subcommand
有关安装说明,请参见[安装 kubectl](/zh-cn/docs/tasks/tools/#kubectl);
@@ -81,8 +82,8 @@ where `command`, `TYPE`, `NAME`, and `flags` are:
其中 `command`、`TYPE`、`NAME` 和 `flags` 分别是:
* `NAME`:指定资源的名称。名称区分大小写。
如果省略名称,则显示所有资源的详细信息。例如:`kubectl get pods`。
@@ -112,16 +115,17 @@ for example `create`, `get`, `describe`, `delete`.
* 要按类型和名称指定资源:
@@ -138,7 +142,8 @@ for example `create`, `get`, `describe`, `delete`.
例子:`kubectl get -f ./pod.yaml`
* `flags`: 指定可选的参数。例如,可以使用 `-s` 或 `--server` 参数指定
Kubernetes API 服务器的地址和端口。
@@ -161,7 +166,10 @@ If you need help, run `kubectl help` from the terminal window.
## 集群内身份验证和命名空间覆盖 {#in-cluster-authentication-and-namespace-overrides}
默认情况下,`kubectl` 命令首先确定它是否在 Pod 中运行,从而被视为在集群中运行。
它首先检查 `KUBERNETES_SERVICE_HOST` 和 `KUBERNETES_SERVICE_PORT` 环境变量以及
@@ -169,7 +177,9 @@ By default `kubectl` will first determine if it is running within a pod, and thu
如果三个条件都被满足,则假定在集群内进行身份验证。
为保持向后兼容性,如果在集群内身份验证期间设置了 `POD_NAMESPACE`
环境变量,它将覆盖服务帐户令牌中的默认命名空间。
@@ -181,7 +191,11 @@ To maintain backwards compatibility, if the `POD_NAMESPACE` environment variable
**`POD_NAMESPACE` 环境变量**
如果设置了 `POD_NAMESPACE` 环境变量,对命名空间资源的 CLI 操作对象将使用该变量值作为默认值。
例如,如果该变量设置为 `seattle`,`kubectl get pods` 将返回 `seattle` 命名空间中的 Pod。
@@ -269,7 +283,7 @@ Operation | Syntax | Description
`edit` | kubectl edit (-f FILENAME | TYPE NAME | TYPE/NAME) [flags]
| Edit and update the definition of one or more resources on the server by using the default editor.
`events` | `kubectl events` | List events
`exec` | `kubectl exec POD [-c CONTAINER] [-i] [-t] [flags] [-- COMMAND [args...]]` | Execute a command against a container in a pod.
-`explain` | `kubectl explain [--recursive=false] [flags]` | Get documentation of various resources. For instance pods, nodes, services, etc.
+`explain` | `kubectl explain TYPE [--recursive=false] [flags]` | Get documentation of various resources. For instance pods, nodes, services, etc.
`expose` | kubectl expose (-f FILENAME | TYPE NAME | TYPE/NAME) [--port=port] [--protocol=TCP|UDP] [--target-port=number-or-name] [--name=name] [--external-ip=external-ip-of-service] [--type=type] [flags]
| Expose a replication controller, service, or pod as a new Kubernetes service.
`get` | kubectl get (-f FILENAME | TYPE [NAME | /NAME | -l label]) [--watch] [--sort-by=FIELD] [[-o | --output]=OUTPUT_FORMAT] [flags]
| List one or more resources.
`kustomize` | `kubectl kustomize
kubectl scale (-f FILENAME | TYPE NAME | TYPE/NAME) --replicas=COUNT [--resource-version=version] [--current-replicas=count] [flags]
| Update the size of the specified replication controller.
`set` | `kubectl set SUBCOMMAND [options]` | Configure application resources.
`taint` | `kubectl taint NODE NAME KEY_1=VAL_1:TAINT_EFFECT_1 ... KEY_N=VAL_N:TAINT_EFFECT_N [options]` | Update the taints on one or more nodes.
-`top` | `kubectl top [flags] [options]` | Display Resource (CPU/Memory/Storage) usage.
+`top` | `kubectl top (POD | NODE) [flags] [options]` | Display Resource (CPU/Memory/Storage) usage.
`uncordon` | `kubectl uncordon NODE [options]` | Mark node as schedulable.
`version` | `kubectl version [--client] [flags]` | Display the Kubernetes version running on the client and server.
`wait` | kubectl wait ([-f FILENAME] | resource.group/resource.name | resource.group [(-l label | --all)]) [--for=delete|--for condition=available] [options]
| Experimental: Wait for a specific condition on one or many resources.
@@ -316,8 +330,8 @@ Operation | Syntax | Description
`edit` | kubectl edit (-f FILENAME | TYPE NAME | TYPE/NAME) [flags]
| 使用默认编辑器编辑和更新服务器上一个或多个资源的定义。
`events` | `kubectl events` | 列举事件。
`exec` | `kubectl exec POD [-c CONTAINER] [-i] [-t] [flags] [-- COMMAND [args...]]` | 对 Pod 中的容器执行命令。
-`explain` | `kubectl explain [--recursive=false] [flags]` | 获取多种资源的文档。例如 Pod、Node、Service 等。
-`expose` | kubectl expose (-f FILENAME | TYPE NAME | TYPE/NAME) [--port=port] [--protocol=TCP|UDP] [--target-port=number-or-name] [--name=name] [--external-ip=external-ip-of-service] [--type=type] [flags]
| 将副本控制器、服务或 Pod 作为新的 Kubernetes 服务暴露。
+`explain` | `kubectl explain TYPE [--recursive=false] [flags]` | 获取多种资源的文档。例如 Pod、Node、Service 等。
+`expose` | kubectl expose (-f FILENAME | TYPE NAME | TYPE/NAME) [--port=port] [--protocol=TCP|UDP] [--target-port=number-or-name] [--name=name] [--external-ip=external-ip-of-service] [--type=type] [flags]
| 将副本控制器、Service 或 Pod 作为新的 Kubernetes 服务暴露。
`get` | kubectl get (-f FILENAME | TYPE [NAME | /NAME | -l label]) [--watch] [--sort-by=FIELD] [[-o | --output]=OUTPUT_FORMAT] [flags]
| 列出一个或多个资源。
`kustomize` | kubectl kustomize [flags] [options]`
| 列出从 kustomization.yaml 文件中的指令生成的一组 API 资源。参数必须是包含文件的目录的路径,或者是 git 存储库 URL,其路径后缀相对于存储库根目录指定了相同的路径。
`label` | kubectl label (-f FILENAME | TYPE NAME | TYPE/NAME) KEY_1=VAL_1 ... KEY_N=VAL_N [--overwrite] [--all] [--resource-version=version] [flags]
| 添加或更新一个或多个资源的标签。
@@ -333,7 +347,7 @@ Operation | Syntax | Description
`scale` | kubectl scale (-f FILENAME | TYPE NAME | TYPE/NAME) --replicas=COUNT [--resource-version=version] [--current-replicas=count] [flags]
| 更新指定副本控制器的大小。
`set` | `kubectl set SUBCOMMAND [options]` | 配置应用资源。
`taint` | `kubectl taint NODE NAME KEY_1=VAL_1:TAINT_EFFECT_1 ... KEY_N=VAL_N:TAINT_EFFECT_N [options]` | 更新一个或多个节点上的污点。
-`top` | `kubectl top [flags] [options]` | 显示资源(CPU、内存、存储)的使用情况。
+`top` | `kubectl top (POD | NODE) [flags] [options]` | 显示资源(CPU、内存、存储)的使用情况。
`uncordon` | `kubectl uncordon NODE [options]` | 将节点标记为可调度。
`version` | `kubectl version [--client] [flags]` | 显示运行在客户端和服务器上的 Kubernetes 版本。
`wait` | kubectl wait ([-f FILENAME] | resource.group/resource.name | resource.group [(-l label | --all)]) [--for=delete|--for condition=available] [options]
| 实验特性:等待一种或多种资源的特定状况。
@@ -428,7 +442,9 @@ The following table includes a list of all the supported resource types and thei
## 输出选项 {#output-options}
有关如何格式化或排序某些命令的输出的信息,请参阅以下章节。有关哪些命令支持不同输出选项的详细信息,
请参阅 [kubectl](/zh-cn/docs/reference/kubectl/kubectl/) 参考文档。
@@ -439,7 +455,9 @@ Use the following sections for information about how you can format or sort the
### 格式化输出 {#formatting-output}
所有 `kubectl` 命令的默认输出格式都是人类可读的纯文本格式。要以特定格式在终端窗口输出详细信息,
可以将 `-o` 或 `--output` 参数添加到受支持的 `kubectl` 命令中。
@@ -470,16 +488,16 @@ Output format | Description
`-o wide` | Output in the plain-text format with any additional information. For pods, the node name is included.
`-o yaml` | Output a YAML formatted API object.
-->
-输出格式 | 描述
---------------| -----------
-`-o custom-columns=