kubectl 备忘单

    你还可以在补全时为 kubectl 使用一个速记别名：

    1. alias k=kubectl
    2. complete -o default -F __start_kubectl k

    ZSH

    1. source <(kubectl completion zsh)  # 在 zsh 中设置当前 shell 的自动补全
    2. echo '[[ $commands[kubectl] ]] && source <(kubectl completion zsh)' >> ~/.zshrc # 在你的 zsh shell 中永久地添加自动补全

    我们经常用到 --all-namespaces 参数，你应该要知道它的简写：

    kubectl -A

    Kubectl 上下文和配置

    设置 kubectl 与哪个 Kubernetes 集群进行通信并修改配置信息。 查看 文档获取配置文件详细信息。

    1. kubectl config view # 显示合并的 kubeconfig 配置。
    3. # 同时使用多个 kubeconfig 文件并查看合并的配置
    4. KUBECONFIG=~/.kube/config:~/.kube/kubconfig2
    6. kubectl config view
    8. # 获取 e2e 用户的密码
    9. kubectl config view -o jsonpath='{.users[?(@.name == "e2e")].user.password}'
    11. kubectl config view -o jsonpath='{.users[].name}'    # 显示第一个用户
    12. kubectl config view -o jsonpath='{.users[*].name}'   # 获取用户列表
    13. kubectl config get-contexts                          # 显示上下文列表
    14. kubectl config current-context                       # 展示当前所处的上下文
    15. kubectl config use-context my-cluster-name           # 设置默认的上下文为 my-cluster-name
    17. kubectl config set-cluster my-cluster-name           # 在 kubeconfig 中设置集群条目
    19. # 在 kubeconfig 中配置代理服务器的 URL，以用于该客户端的请求
    20. kubectl config set-cluster my-cluster-name --proxy-url=my-proxy-url
    22. # 添加新的用户配置到 kubeconf 中，使用 basic auth 进行身份认证
    23. kubectl config set-credentials kubeuser/foo.kubernetes.com --username=kubeuser --password=kubepassword
    25. # 在指定上下文中持久性地保存名字空间，供所有后续 kubectl 命令使用
    26. kubectl config set-context --current --namespace=ggckad-s2
    28. # 使用特定的用户名和名字空间设置上下文
    29. kubectl config set-context gce --user=cluster-admin --namespace=foo \
    30.   && kubectl config use-context gce
    32. kubectl config unset users.foo                       # 删除用户 foo
    34. # 设置或显示 context / namespace 的短别名
    35. # （仅适用于 bash 和 bash 兼容的 shell，在使用 kn 设置命名空间之前要先设置 current-context）
    36. alias kx='f() { [ "$1" ] && kubectl config use-context $1 || kubectl config current-context ; } ; f'
    37. alias kn='f() { [ "$1" ] && kubectl config set-context --current --namespace $1 || kubectl config view --minify | grep namespace | cut -d" " -f6 ; } ; f'

    Kubectl apply

    创建对象

    Kubernetes 配置可以用 YAML 或 JSON 定义。可以使用的文件扩展名有 .yaml、.yml 和 .json。

    1. kubectl apply -f ./my-manifest.yaml           # 创建资源
    2. kubectl apply -f ./my1.yaml -f ./my2.yaml     # 使用多个文件创建
    3. kubectl apply -f ./dir                        # 基于目录下的所有清单文件创建资源
    4. kubectl apply -f https://git.io/vPieo         # 从 URL 中创建资源
    5. kubectl create deployment nginx --image=nginx # 启动单实例 nginx
    7. # 创建一个打印 “Hello World” 的 Job
    8. kubectl create job hello --image=busybox:1.28 -- echo "Hello World" 
    10. # 创建一个打印 “Hello World” 间隔1分钟的 CronJob
    11. kubectl create cronjob hello --image=busybox:1.28   --schedule="*/1 * * * *" -- echo "Hello World"    
    13. kubectl explain pods                          # 获取 pod 清单的文档说明
    15. # 从标准输入创建多个 YAML 对象
    16. kubectl apply -f - <<EOF
    17. apiVersion: v1
    18. kind: Pod
    19. metadata:
    20.   name: busybox-sleep
    21. spec:
    22.   containers:
    23.   - name: busybox
    24.     image: busybox:1.28
    25.     args:
    26.     - sleep
    27.     - "1000000"
    28. ---
    29. apiVersion: v1
    30. kind: Pod
    31. metadata:
    32.   name: busybox-sleep-less
    33.   containers:
    34.   - name: busybox
    35.     image: busybox:1.28
    36.     args:
    37.     - sleep
    38.     - "1000"
    39. EOF
    41. # 创建有多个 key 的 Secret
    42. kubectl apply -f - <<EOF
    43. apiVersion: v1
    44. kind: Secret
    45. metadata:
    46.   name: mysecret
    48. data:
    49.   password: $(echo -n "s33msi4" | base64 -w0)
    50.   username: $(echo -n "jane" | base64 -w0)
    51. EOF

    查看和查找资源

    1. # get 命令的基本输出
    2. kubectl get services                          # 列出当前命名空间下的所有 services
    3. kubectl get pods --all-namespaces             # 列出所有命名空间下的全部的 Pods
    4. kubectl get pods -o wide                      # 列出当前命名空间下的全部 Pods，并显示更详细的信息
    5. kubectl get deployment my-dep                 # 列出某个特定的 Deployment
    6. kubectl get pods                              # 列出当前命名空间下的全部 Pods
    7. kubectl get pod my-pod -o yaml                # 获取一个 pod 的 YAML
    9. # describe 命令的详细输出
    10. kubectl describe nodes my-node
    11. kubectl describe pods my-pod
    13. # 列出当前名字空间下所有 Services，按名称排序
    14. kubectl get services --sort-by=.metadata.name
    16. # 列出 Pods，按重启次数排序
    17. kubectl get pods --sort-by='.status.containerStatuses[0].restartCount'
    19. # 列举所有 PV 持久卷，按容量排序
    20. kubectl get pv --sort-by=.spec.capacity.storage
    22. # 获取包含 app=cassandra 标签的所有 Pods 的 version 标签
    23. kubectl get pods --selector=app=cassandra -o \
    24.   jsonpath='{.items[*].metadata.labels.version}'
    26. # 检索带有 “.” 键值，例： 'ca.crt'
    27. kubectl get configmap myconfig \
    28.   -o jsonpath='{.data.ca\.crt}'
    30. # 检索一个 base64 编码的值，其中的键名应该包含减号而不是下划线。
    31. kubectl get secret my-secret --template='{{index .data "key-name-with-dashes"}}'
    33. # 获取所有工作节点（使用选择器以排除标签名称为 'node-role.kubernetes.io/control-plane' 的结果）
    34. kubectl get node --selector='!node-role.kubernetes.io/control-plane'
    36. # 获取当前命名空间中正在运行的 Pods
    37. kubectl get pods --field-selector=status.phase=Running
    39. # 获取全部节点的 ExternalIP 地址
    40. kubectl get nodes -o jsonpath='{.items[*].status.addresses[?(@.type=="ExternalIP")].address}'
    42. # 列出属于某个特定 RC 的 Pods 的名称
    43. # 在转换对于 jsonpath 过于复杂的场合，"jq" 命令很有用；可以在 https://stedolan.github.io/jq/ 找到它。
    44. sel=${$(kubectl get rc my-rc --output=json | jq -j '.spec.selector | to_entries | .[] | "\(.key)=\(.value),"')%?}
    45. echo $(kubectl get pods --selector=$sel --output=jsonpath={.items..metadata.name})
    47. # 显示所有 Pods 的标签（或任何其他支持标签的 Kubernetes 对象）
    48. kubectl get pods --show-labels
    50. # 检查哪些节点处于就绪状态
    51. JSONPATH='{range .items[*]}{@.metadata.name}:{range @.status.conditions[*]}{@.type}={@.status};{end}{end}' \
    52.  && kubectl get nodes -o jsonpath="$JSONPATH" | grep "Ready=True"
    54. # 不使用外部工具来输出解码后的 Secret
    55. kubectl get secret my-secret -o go-template='{{range $k,$v := .data}}{{"### "}}{{$k}}{{"\n"}}{{$v|base64decode}}{{"\n\n"}}{{end}}'
    57. # 列出被一个 Pod 使用的全部 Secret
    58. kubectl get pods -o json | jq '.items[].spec.containers[].env[]?.valueFrom.secretKeyRef.name' | grep -v null | sort | uniq
    60. # 列举所有 Pods 中初始化容器的容器 ID（containerID）
    61. # 可用于在清理已停止的容器时避免删除初始化容器
    62. kubectl get pods --all-namespaces -o jsonpath='{range .items[*].status.initContainerStatuses[*]}{.containerID}{"\n"}{end}' | cut -d/ -f3
    64. # 列出事件（Events），按时间戳排序
    65. kubectl get events --sort-by=.metadata.creationTimestamp
    67. # 列出所有警告事件
    68. kubectl events --types=Warning
    70. # 比较当前的集群状态和假定某清单被应用之后的集群状态
    71. kubectl diff -f ./my-manifest.yaml
    73. # 生成一个句点分隔的树，其中包含为节点返回的所有键
    74. # 在复杂的嵌套JSON结构中定位键时非常有用
    75. kubectl get nodes -o json | jq -c 'paths|join(".")'
    76. # 生成一个句点分隔的树，其中包含为pod等返回的所有键
    77. kubectl get pods -o json | jq -c 'paths|join(".")'
    79. # 假设你的 Pods 有默认的容器和默认的名字空间，并且支持 'env' 命令，可以使用以下脚本为所有 Pods 生成 ENV 变量。
    80. # 该脚本也可用于在所有的 Pods 里运行任何受支持的命令，而不仅仅是 'env'。 
    81. for pod in $(kubectl get po --output=jsonpath={.items..metadata.name}); do echo $pod && kubectl exec -it $pod -- env; done
    83. # 获取一个 Deployment 的 status 子资源
    84. kubectl get deployment nginx-deployment --subresource=status

    部分更新资源

    1. # 部分更新某节点
    2. kubectl patch node k8s-node-1 -p '{"spec":{"unschedulable":true}}'
    4. # 更新容器的镜像；spec.containers[*].name 是必须的。因为它是一个合并性质的主键。
    5. kubectl patch pod valid-pod -p '{"spec":{"containers":[{"name":"kubernetes-serve-hostname","image":"new image"}]}}'
    7. # 使用带位置数组的 JSON patch 更新容器的镜像
    8. kubectl patch pod valid-pod --type='json' -p='[{"op": "replace", "path": "/spec/containers/0/image", "value":"new image"}]'
    10. # 使用带位置数组的 JSON patch 禁用某 Deployment 的 livenessProbe
    13. # 在带位置数组中添加元素
    14. kubectl patch sa default --type='json' -p='[{"op": "add", "path": "/secrets/1", "value": {"name": "whatever" } }]'
    16. # 通过修正 scale 子资源来更新 Deployment 的副本数
    17. kubectl patch deployment nginx-deployment --subresource='scale' --type='merge' -p '{"spec":{"replicas":2}}'

    编辑资源

    使用你偏爱的编辑器编辑 API 资源。

    1. kubectl edit svc/docker-registry                      # 编辑名为 docker-registry 的服务
    2. KUBE_EDITOR="nano" kubectl edit svc/docker-registry   # 使用其他编辑器

    对资源进行伸缩

    1. kubectl scale --replicas=3 rs/foo                                 # 将名为 'foo' 的副本集伸缩到 3 副本
    2. kubectl scale --replicas=3 -f foo.yaml                            # 将在 "foo.yaml" 中的特定资源伸缩到 3 个副本
    3. kubectl scale --current-replicas=2 --replicas=3 deployment/mysql  # 如果名为 mysql 的 Deployment 的副本当前是 2，那么将它伸缩到 3
    4. kubectl scale --replicas=5 rc/foo rc/bar rc/baz                   # 伸缩多个副本控制器

    删除资源

    1. kubectl delete -f ./pod.json                                              # 删除在 pod.json 中指定的类型和名称的 Pod
    2. kubectl delete pod unwanted --now                                         # 删除 Pod 且无宽限期限（无优雅时段）
    3. kubectl delete pod,service baz foo                                        # 删除名称为 "baz" 和 "foo" 的 Pod 和服务
    4. kubectl delete pods,services -l name=myLabel                              # 删除包含 name=myLabel 标签的 pods 和服务
    5. kubectl -n my-ns delete pod,svc --all                                     # 删除在 my-ns 名字空间中全部的 Pods 和服务
    6. # 删除所有与 pattern1 或 pattern2 awk 模式匹配的 Pods
    7. kubectl get pods  -n mynamespace --no-headers=true | awk '/pattern1|pattern2/{print $1}' | xargs  kubectl delete -n mynamespace pod
    1. kubectl logs my-pod                                 # 获取 pod 日志（标准输出）
    2. kubectl logs -l name=myLabel                        # 获取含 name=myLabel 标签的 Pods 的日志（标准输出）
    3. kubectl logs my-pod --previous                      # 获取上个容器实例的 pod 日志（标准输出）
    4. kubectl logs my-pod -c my-container                 # 获取 Pod 容器的日志（标准输出, 多容器场景）
    5. kubectl logs -l name=myLabel -c my-container        # 获取含 name=myLabel 标签的 Pod 容器日志（标准输出, 多容器场景）
    6. kubectl logs my-pod -c my-container --previous      # 获取 Pod 中某容器的上个实例的日志（标准输出, 多容器场景）
    7. kubectl logs -f my-pod                              # 流式输出 Pod 的日志（标准输出）
    8. kubectl logs -f my-pod -c my-container              # 流式输出 Pod 容器的日志（标准输出, 多容器场景）
    9. kubectl logs -f -l name=myLabel --all-containers    # 流式输出含 name=myLabel 标签的 Pod 的所有日志（标准输出）
    10. kubectl run -i --tty busybox --image=busybox:1.28 -- sh  # 以交互式 Shell 运行 Pod
    11. kubectl run nginx --image=nginx -n mynamespace      # 在 “mynamespace” 命名空间中运行单个 nginx Pod
    12. kubectl run nginx --image=nginx --dry-run=client -o yaml > pod.yaml
    13.                                                     # 为运行 nginx Pod 生成规约并将其写入到名为 pod.yaml 的文件
    15. kubectl attach my-pod -i                            # 挂接到一个运行的容器中
    16. kubectl port-forward my-pod 5000:6000               # 在本地计算机上侦听端口 5000 并转发到 my-pod 上的端口 6000
    17. kubectl exec my-pod -- ls /                         # 在已有的 Pod 中运行命令（单容器场景）
    18. kubectl exec --stdin --tty my-pod -- /bin/sh        # 使用交互 shell 访问正在运行的 Pod (一个容器场景)
    19. kubectl exec my-pod -c my-container -- ls /         # 在已有的 Pod 中运行命令（多容器场景）
    20. kubectl top pod POD_NAME --containers               # 显示给定 Pod 和其中容器的监控数据
    21. kubectl top pod POD_NAME --sort-by=cpu              # 显示给定 Pod 的指标并且按照 'cpu' 或者 'memory' 排序

    从容器中复制文件和目录

    说明：

    kubectl cp 要求容器镜像中存在 “tar” 二进制文件。如果 “tar” 不存在，kubectl cp 将失败。 对于进阶用例，例如符号链接、通配符扩展或保留文件权限，请考虑使用 kubectl exec。

    1. tar cf - /tmp/foo | kubectl exec -i -n my-namespace my-pod -- tar xf - -C /tmp/bar  # 将 /tmp/foo 本地文件复制到远程 “my-namespace” 命名空间中 pod 中的 /tmp/bar
    2. kubectl exec -n my-namespace my-pod -- tar cf - /tmp/foo | tar xf - -C /tmp/bar    # 将 /tmp/foo 从远程 pod 复制到本地 /tmp/bar

    与 Deployments 和 Services 进行交互

    1. kubectl logs deploy/my-deployment                         # 获取一个 Deployment 的 Pod 的日志（单容器例子）
    2. kubectl logs deploy/my-deployment -c my-container         # 获取一个 Deployment 的 Pod 的日志（多容器例子）
    4. kubectl port-forward svc/my-service 5000                  # 侦听本地端口 5000 并转发到 Service 后端端口 5000
    5. kubectl port-forward svc/my-service 5000:my-service-port  # 侦听本地端口 5000 并转发到名字为 <my-service-port> 的 Service 目标端口
    7. kubectl port-forward deploy/my-deployment 5000:6000       # 侦听本地端口 5000 并转发到 <my-deployment> 创建的 Pod 里的端口 6000
    8. kubectl exec deploy/my-deployment -- ls                   # 在 Deployment 里的第一个 Pod 的第一个容器里运行命令（单容器和多容器例子）

    与节点和集群进行交互

    1. kubectl cordon my-node                                                # 标记 my-node 节点为不可调度
    2. kubectl drain my-node                                                 # 对 my-node 节点进行清空操作，为节点维护做准备
    3. kubectl uncordon my-node                                              # 标记 my-node 节点为可以调度
    4. kubectl top node my-node                                              # 显示给定节点的度量值
    5. kubectl cluster-info                                                  # 显示主控节点和服务的地址
    6. kubectl cluster-info dump                                             # 将当前集群状态转储到标准输出
    7. kubectl cluster-info dump --output-directory=/path/to/cluster-state   # 将当前集群状态输出到 /path/to/cluster-state
    9. # 查看当前节点上存在的现有污点。
    10. kubectl get nodes -o='custom-columns=NodeName:.metadata.name,TaintKey:.spec.taints[*].key,TaintValue:.spec.taints[*].value,TaintEffect:.spec.taints[*].effect'
    12. # 如果已存在具有指定键和效果的污点，则替换其值为指定值。
    13. kubectl taint nodes foo dedicated=special-user:NoSchedule

    资源类型

    1. kubectl api-resources

    用于探索 API 资源的其他操作：

    1. kubectl api-resources --namespaced=true      # 所有命名空间作用域的资源
    2. kubectl api-resources --namespaced=false     # 所有非命名空间作用域的资源
    3. kubectl api-resources -o name                # 用简单格式列举所有资源（仅显示资源名称）
    4. kubectl api-resources -o wide                # 用扩展格式列举所有资源（又称 "wide" 格式）
    5. kubectl api-resources --verbs=list,get       # 支持 "list" 和 "get" 请求动词的所有资源
    6. kubectl api-resources --api-group=extensions # "extensions" API 组中的所有资源

    要以特定格式将详细信息输出到终端窗口，将 -o（或者 --output）参数添加到支持的 kubectl 命令中。

    使用 -o=custom-columns 的示例：

    有关更多示例，请参看 kubectl 参考文档。

    Kubectl 日志输出详细程度和调试

    详细程度描述
    —v=0用于那些应该 始终 对运维人员可见的信息，因为这些信息一般很有用。
    —v=1如果你不想要看到冗余信息，此值是一个合理的默认日志级别。
    —v=2输出有关服务的稳定状态的信息以及重要的日志消息，这些信息可能与系统中的重大变化有关。这是建议大多数系统设置的默认日志级别。
    —v=3包含有关系统状态变化的扩展信息。
    —v=4包含调试级别的冗余信息。
    —v=5跟踪级别的详细程度。
    —v=6显示所请求的资源。
    —v=7显示 HTTP 请求头。
    —v=8显示 HTTP 请求内容。
    —v=9显示 HTTP 请求内容而且不截断内容。

    接下来

    • 参阅 ，进一步了解 JsonPath。
    • 参阅 选项。
    • 参阅 kubectl 使用约定来理解如何在可复用的脚本中使用它。
    • 查看社区中其他的 。