From a850c5356b5c3cecb39eba723b647aaad0ac0821 Mon Sep 17 00:00:00 2001 From: chenrui Date: Sat, 1 Dec 2018 10:57:50 +0800 Subject: [PATCH] zh-trans: update docs/reference/kubectl/kubectl.md (#11402) * zh-trans: update docs/reference/kubectl/kubectl.md * Updates per PR comments --- content/zh/docs/reference/kubectl/kubectl.md | 536 +++++++++++++------ 1 file changed, 386 insertions(+), 150 deletions(-) diff --git a/content/zh/docs/reference/kubectl/kubectl.md b/content/zh/docs/reference/kubectl/kubectl.md index 052ce700a6..b426430d24 100644 --- a/content/zh/docs/reference/kubectl/kubectl.md +++ b/content/zh/docs/reference/kubectl/kubectl.md @@ -7,172 +7,408 @@ notitle: true -kubectl Բٿ Kubernetes Ⱥ +kubectl 用来控制 Kubernetes 集群管理器 -### +### 摘要 -kubectl Բٿ Kubernetes Ⱥ +kubectl 用来控制 Kubernetes 集群管理器。 -ȡϢʣhttps://kubernetes.io/docs/reference/kubectl/overview/ +更多信息参见 https://kubernetes.io/docs/reference/kubectl/overview/ ``` kubectl [flags] ``` - -### ѡ -``` - --alsologtostderr ͬʱ־׼̨ļ - --as string ָûִв - --as-group stringArray ģ飬ʹʶָ顣 - --cache-dir string Ĭ HTTP Ŀ¼Ĭֵ "/home/username/.kube/http-cache" - --certificate-authority string ڽ֤Ȩ .cert ļ· - --client-certificate string TLS ʹõĿͻ֤· - --client-key string TLS ʹõĿͻԿļ· - --cluster string ָҪʹõ kubeconfig ļмȺ - --context string ָҪʹõ kubeconfig ļ - -h, --help kubectl - --insecure-skip-tls-verify ֵΪ true򲻻֤Чԡ ⽫ʹHTTPSӲȫ - --kubeconfig string CLI ʹõ kubeconfig ļ· - --log-backtrace-at traceLocation ־ȳ涨ʱԶջϢĬֵ0 - --log-dir string Ϊգ־ļдĿ¼ - --logtostderr ־׼̨ļ - --match-server-version Ҫͻ˰汾ͷ˰汾ƥ - -n, --namespace string ڣCLI ʹôռ - --request-timeout string һ򵥷ǰĵȴʱ䣬ֵҪӦʱ䵥λ(磺1s, 2m, 3h)ֵΪʱ (Ĭֵ "0") - -s, --server string Kubernetes API server ĵַͶ˿ - --stderrthreshold severity ڻڴֵ־׼̨Ĭֵ2 - --token string API server ֤ij - --user string ָʹõ kubeconfig ļеû - -v, --v Level ָ־־ - --vmodule moduleSpec ָ־ģ飬ʽ£pattern=Nʹöŷָ -``` - -### + + --allow-verification-with-non-compliant-keys + + + + + 允许 `SignatureVerifier` 使用和 RFC6962 技术上不兼容的键值。 + -* [kubectl alpha](kubectl_alpha.md) - alpha -* [kubectl annotate](kubectl_annotate.md) - Դע -* [kubectl api-resources](kubectl_api-resources.md) - ڷϴӡֵ֧ API Դ -* [kubectl api-versions](kubectl_api-versions.md) - "group/version" ʽڷϴӡֵ֧ API 汾 -* [kubectl apply](kubectl_apply.md) - ͨļ׼뽫ӸԴ -* [kubectl attach](kubectl_attach.md) - ӵе -* [kubectl auth](kubectl_auth.md) - Ȩ -* [kubectl autoscale](kubectl_autoscale.md) - Զչ Deployment, ReplicaSet ReplicationController -* [kubectl certificate](kubectl_certificate.md) - ޸֤Դ -* [kubectl cluster-info](kubectl_cluster-info.md) - չʾȺϢ -* [kubectl completion](kubectl_completion.md) - Ϊ shell ɴ루 bash zsh -* [kubectl config](kubectl_config.md) - ޸ kubeconfig ļ -* [kubectl convert](kubectl_convert.md) - ڲͬ API 汾֮תļ -* [kubectl cordon](kubectl_cordon.md) - node ڵΪɵ -* [kubectl cp](kubectl_cp.md) - ļĿ¼ҲɽļĿ¼Ƶ -* [kubectl create](kubectl_create.md) - ͨļ׼봴Դ -* [kubectl delete](kubectl_delete.md) - ͨļ׼룬ԴƻԴͱǩѡɾԴ -* [kubectl describe](kubectl_describe.md) - ʾضԴԴϸϢ -* [kubectl drain](kubectl_drain.md) - ΪάҪǰnodeڵ -* [kubectl edit](kubectl_edit.md) - ڷ༭Դ -* [kubectl exec](kubectl_exec.md) - ˳ -* [kubectl explain](kubectl_explain.md) - Դĵ -* [kubectl expose](kubectl_expose.md) - ȡ replication controller, service, deployment pod ԴΪµ Kubernetes ¶ -* [kubectl get](kubectl_get.md) - չʾһԴ -* [kubectl label](kubectl_label.md) - Դǩ -* [kubectl logs](kubectl_logs.md) - Ϊ pod еӡ־ -* [kubectl options](kubectl_options.md) - ӡ̳еıʶб -* [kubectl patch](kubectl_patch.md) - ʹսԺϲԴֶ -* [kubectl plugin](kubectl_plugin.md) - в -* [kubectl port-forward](kubectl_port-forward.md) - pod һض˿ -* [kubectl proxy](kubectl_proxy.md) - Ϊ Kubernetes API server д -* [kubectl replace](kubectl_replace.md) - ͨļ׼滻Դ -* [kubectl rollout](kubectl_rollout.md) - Դչʾ -* [kubectl run](kubectl_run.md) - ڼȺָ -* [kubectl scale](kubectl_scale.md) - Deployment, ReplicaSet, Replication Controller Job ¸ģ -* [kubectl set](kubectl_set.md) - ض -* [kubectl taint](kubectl_taint.md) - һ node ڵ۵Ϣ -* [kubectl top](kubectl_top.md) - չʾԴ (CPU/Memory/Storage) ʹϢ -* [kubectl uncordon](kubectl_uncordon.md) - node ڵΪɵ -* [kubectl version](kubectl_version.md) - ӡͻ˺ͷ˰汾Ϣ -* [kubectl wait](kubectl_wait.md) - : һԴϵȴ + + --alsologtostderr + + + + + 同时将日志写到标准输出和文件中 + - -######2018616գͨspf13/cobraԶ + + --as string + + + + + 执行操作时假冒的用户名 + + + --as-group stringArray + + + + + 执行操作时假冒的组名。此参数可以多次使用，以设置多个组名。 + + + + --azure-container-registry-config string + + + + + Azure 容器仓库配置信息文件的路径。 + + + + + --cache-dir string     默认值： "$HOME/.kube/http-cache" + + + + + 默认的 HTTP 缓存路径 + + + + --certificate-authority string + + + + + CA 证书机构的证书文件路径 + + + + --client-certificate string + + + + + TLS 的客户端证书的文件路径 + + + + --client-key string + + + + + TLS 客户端密钥文件的路径 + + + + + --cloud-provider-gce-lb-src-cidrs cidrs     默认值: 130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16 + + + + + 在 GCE 防火墙中开放的 CIDRs，用于负载均衡器流量代理和健康检查。 + + + + --cluster string + + + + + 所要使用的 kubeconfig 集群名 + + + + --context string + + + + + 所要使用的 kubeconfig 上下文名 + + + + + --default-not-ready-toleration-seconds int     默认值：300 + + + + + 针对 `notReady:NoExecute` 污点的容忍时间（`tolerationSeconds`）；对于没有设置该容忍度的 Pods，Kubernetes 会添加此容忍度设置。 + + + + + --default-unreachable-toleration-seconds int     容忍度：300 + + + + + 针对 `unreachable:NoExecute` 污点的容忍时间（`tolerationSeconds`）；对于没有设置该容忍度的 Pods，Kubernetes 会添加此容忍度设置。 + + + + -h, --help + + + + + kubectl 帮助选项 + + + + --insecure-skip-tls-verify + + + + + 如果设置为 true，kubectl 将不会验证服务器的证书。这样设置时，HTTPS 链接将不安全。 + + + + --kubeconfig string + + + + kubeconfig 的文件路径，供 CLI 请求之用。 + + + + + --log-backtrace-at traceLocation     默认值：:0 + + + + 格式为“file:N”；在为文件 file 的第 N 行打印日志时，打印调用堆栈的跟踪信息。 + + + + --log-dir string + + + + + 如果此参数不为空，将在所指定的路径下保存日志文件。 + + + + + --log-flush-frequency duration     默认值：5s + + + + + 清刷日志数据的最大间隔秒数。 + + + + + --logtostderr     默认值：true + + + + + 将日志输出到标准错误输出而非文件中。 + + + + --match-server-version + + + + + 要求服务器的版本和客户端版本一致 + + + + -n, --namespace string + + + + + 此参数如果设置，用来控制 CLI 请求的名字空间范畴 + + + + + --request-timeout string     默认值："0" + + + + + 放弃单个服务请求前的等待时间。非零数值必须要包含时间单位（例如，1s，2m，3h）。零值意味着不会发生请求超时。 + + + + -s, --server string + + + + + Kubernetes API 服务器的地址和端口 + + + + + --stderrthreshold severity     默认值：2 + + + + + 严重级别整数值；严重级别高于或等于此值的日志都将会输出到标准错误输出 + + + + --token string + + + + + 持有者令牌（Bearer Token），用于向 API 服务器认证身份 + + + + --user string + + + + + 所要使用的 kubeconfig 用户名 + + + + -v, --v Level + + + + + 设定日志输出的等级 + + + + --version version[=true] + + + + + 打印版本信息，然后退出 + + + + --vmodule moduleSpec + + + + + 逗号分隔的字符串表，每个元素都是 pattern=N 格式，用于基于文件名进行过滤的日志设置 + + + + + + + +### 更多资源 + + +* [kubectl alpha](kubectl_alpha.md) - kubectl alpha 功能 + +* [kubectl annotate](kubectl_annotate.md) - 更新资源所关联的注解 + +* [kubectl api-resources](kubectl_api-resources.md) - 打印服务器上所支持的 API 资源 + +* [kubectl api-versions](kubectl_api-versions.md) - 以“组/版本”的格式输出服务端支持的 API 版本 + +* [kubectl apply](kubectl_apply.md) - 基于文件名或标准输入，将新的配置应用到资源上 + +* [kubectl attach](kubectl_attach.md) - 连接到一个正在运行的容器 + +* [kubectl auth](kubectl_auth.md) - 检视授权信息 + +* [kubectl autoscale](kubectl_autoscale.md) - 对一个资源对象（ Deployment、ReplicaSet 或 ReplicationController ）进行扩缩 + +* [kubectl certificate](kubectl_certificate.md) - 修改证书资源 + +* [kubectl cluster-info](kubectl_cluster-info.md) - 显示集群信息 + +* [kubectl completion](kubectl_completion.md) - 根据已经给出的 Shell（bash 或 zsh），输出 Shell 补全后的代码 + +* [kubectl config](kubectl_config.md) - 修改 kubeconfig 配置文件 + +* [kubectl convert](kubectl_convert.md) - 在不同的 API 版本之间转换配置文件 + +* [kubectl cordon](kubectl_cordon.md) - 标记节点为不可调度的 + +* [kubectl cp](kubectl_cp.md) - 将文件和路径拷入/拷出容器。 + +* [kubectl create](kubectl_create.md) - 通过文件或标准输入来创建资源 + +* [kubectl delete](kubectl_delete.md) - 通过文件名、标准输入、资源和名字删除资源，或者通过资源和标签选择器来删除资源 + +* [kubectl describe](kubectl_describe.md) - 显示某个资源或某组资源的详细信息 + +* [kubectl drain](kubectl_drain.md) - 腾空节点，准备维护 + +* [kubectl edit](kubectl_edit.md) - 修改服务器上的某资源 + +* [kubectl exec](kubectl_exec.md) - 在容器中执行命令 + +* [kubectl explain](kubectl_explain.md) - 显示资源说明 + +* [kubectl expose](kubectl_expose.md) - 给定副本控制器、服务、Deployment 或 Pod，将其暴露为新的 kubernetes Service + +* [kubectl get](kubectl_get.md) - 显示一个或者多个资源信息 + +* [kubectl label](kubectl_label.md) - 更新资源的标签 + +* [kubectl logs](kubectl_logs.md) - 输出 pod 中某容器的日志 + +* [kubectl options](kubectl_options.md) - 打印所有命令都支持的共有参数列表 + +* [kubectl patch](kubectl_patch.md) - 基于策略性合并修补（Stategic Merge Patch）规则更新某资源中的字段 + +* [kubectl plugin](kubectl_plugin.md) - 运行命令行插件 + +* [kubectl port-forward](kubectl_port-forward.md) - 将一个或者多个本地端口转发到 pod + +* [kubectl proxy](kubectl_proxy.md) - 运行一个 kubernetes API 服务器代理 + +* [kubectl replace](kubectl_replace.md) - 基于文件名或标准输入替换资源 + +* [kubectl rollout](kubectl_rollout.md) - 管理资源的上线 + +* [kubectl run](kubectl_run.md) - 在集群中使用指定镜像启动容器 + +* [kubectl scale](kubectl_scale.md) - 为一个 Deployment、ReplicaSet、ReplicationController 或 Job 设置一个新的规模尺寸值 + +* [kubectl set](kubectl_set.md) - 在资源对象设置特定的功能 + +* [kubectl taint](kubectl_taint.md) - 在一个或者多个节点上更新污点配置 + +* [kubectl top](kubectl_top.md) - 显示资源（CPU /内存/存储）使用率 + +* [kubectl uncordon](kubectl_uncordon.md) - 标记节点为可调度的 + +* [kubectl version](kubectl_version.md) - 打印客户端和服务器的版本信息 + +* [kubectl wait](kubectl_wait.md) - 实验性：等待一个或多个资源达到某种状态