Kubectl get/describe 命令：查询 K8s 资源详情

各位船长，扬帆起航！Kubectl get/describe 命令：K8s 资源寻宝指南

各位船长，欢迎来到今天的 Kubernetes 寻宝课堂！我是你们的向导，人称“K8s 导航员”，今天我们将深入探索 K8s 世界的两大法宝——kubectl get 和 kubectl describe 命令。

想象一下，你是一位经验丰富的海盗船长，刚刚驶入一片未知的海域——你的 Kubernetes 集群。到处都是漂浮的资源，像一个个孤岛，你需要找到它们，了解它们，才能建立你的帝国。kubectl get 和 kubectl describe 就是你手中的望远镜和航海日志，让你洞悉一切！

第一章：望远镜的秘密——kubectl get 命令

kubectl get 命令，就像你手中的高倍望远镜，能够让你快速扫描 Kubernetes 集群中的各种资源。它能告诉你资源的名字、状态，就像告诉你远处岛屿的名字和大致情况。

1.1 语法结构：简洁明了，一目了然

kubectl get 命令的语法非常简单：

kubectl get <资源类型> [资源名称] [选项]

• <资源类型>: 这是你想要看到的资源种类，比如 pod、service、deployment 等等。 就像你要寻找的是岛屿、沉船还是海怪一样。
• [资源名称]: 这是可选的，如果你想查看特定资源，就加上它的名字。 比如你想找到具体哪个岛屿，就填上它的名字。
• [选项]: 这也是可选的，你可以通过选项来控制输出格式、筛选结果等等。 就像望远镜的各种调节旋钮，让你看得更清楚。

1.2 常用资源类型：K8s 世界的居民

Kubernetes 世界里住着各种各样的居民，kubectl get 命令可以让你快速了解它们：

资源类型	描述	举例
pods	Kubernetes 中最小的可部署单元，通常包含一个或多个容器。 就像一个个漂浮的集装箱，里面装着你的应用程序。	kubectl get pods
services	用于暴露应用的方式，提供稳定的访问入口。 就像灯塔，指引着流量的方向。	kubectl get services
deployments	用于管理 Pods 的部署和更新，确保应用的高可用性。 就像舰队，保证你的应用程序始终在线。	kubectl get deployments
replicasets	用于管理 Pods 的副本数量，保证应用的伸缩性。 就像克隆军队，快速复制你的 Pods。	kubectl get replicasets
nodes	Kubernetes 集群中的工作节点，运行着 Pods。 就像岛屿，承载着你的应用程序。	kubectl get nodes
namespaces	用于隔离 Kubernetes 集群中的资源。 就像不同的海域，隔离着不同的资源。	kubectl get namespaces
configmaps	用于存储配置数据，方便应用程序读取。 就像藏宝图，指引着应用程序找到正确的配置。	kubectl get configmaps
secrets	用于存储敏感数据，比如密码、密钥等。 就像保险箱，保护着你的秘密。	kubectl get secrets
ingresses	用于暴露 HTTP 和 HTTPS 服务到集群外部。 就像港口，让外部流量可以访问你的应用程序。	kubectl get ingresses
jobs	用于执行一次性任务。 就像一次性的任务，比如数据备份。	kubectl get jobs
cronjobs	用于执行定时任务。 就像定时炸弹，定时执行你的任务。 💣	kubectl get cronjobs

1.3 常用选项：让望远镜更强大

• -o wide: 展示更详细的信息，比如 Node 信息、IP 地址等。 就像给望远镜加个广角镜，看得更全面。
• -n <namespace>: 指定命名空间。 就像指定海域，只看特定海域的资源。
• --all-namespaces: 查看所有命名空间下的资源。 就像环球航行，看遍所有海域的资源。
• -l <label selector>: 根据标签筛选资源。 就像根据旗帜颜色筛选船只，只看特定颜色的船只。
• -w: 监听资源变化。 就像雷达，时刻监控着资源的变化。
• -o yaml 或 -o json: 以 YAML 或 JSON 格式输出结果，方便自动化处理。 就像把海图转换为电子格式，方便计算机分析。
• --sort-by='{.metadata.creationTimestamp}': 按创建时间排序，方便查找最新创建的资源。

1.4 实例演练：实战出真知

• 查看所有 Pods：

  kubectl get pods

  这条命令会列出当前命名空间下的所有 Pods 的信息，包括名称、状态、重启次数、运行时间等。

• 查看指定命名空间下的 Pods：

  kubectl get pods -n kube-system

  这条命令会列出 kube-system 命名空间下的所有 Pods 的信息。

• 查看所有命名空间下的 Pods：

  kubectl get pods --all-namespaces

  这条命令会列出所有命名空间下的所有 Pods 的信息。

• 查看指定 Deployment 的详细信息：

  kubectl get deployment my-deployment -o wide

  这条命令会列出名为 my-deployment 的 Deployment 的详细信息，包括 Node 信息、IP 地址等。

• 根据标签筛选 Pods：

  kubectl get pods -l app=my-app

  这条命令会列出所有标签为 app=my-app 的 Pods 的信息。

• 监听 Pods 的变化：

  kubectl get pods -w

  这条命令会持续监听 Pods 的变化，当 Pods 的状态发生改变时，会立即输出新的信息。

1.5 注意事项：避开暗礁，安全航行

• 确保你已经配置了正确的 Kubernetes 集群连接信息。
• 不同的用户可能具有不同的权限，你可能无法查看所有资源。
• 资源类型的大小写敏感，比如 pods 和 Pods 是不同的。

第二章：航海日志的奥秘——kubectl describe 命令

kubectl describe 命令，就像你手中的航海日志，它会告诉你关于某个资源的更详细的信息。它会告诉你资源的配置、事件、状态，就像告诉你岛屿的地形、动植物、历史故事一样。

2.1 语法结构：深入挖掘，层层剖析

kubectl describe 命令的语法也很简单：

kubectl describe <资源类型> <资源名称> [-n <namespace>]

• <资源类型>: 这是你想要查看的资源种类，和 kubectl get 命令一样。
• <资源名称>: 这是你想要查看的资源的名字。
• [-n <namespace>]: 这是可选的，如果你想查看特定命名空间下的资源，就加上这个选项。

2.2 信息解读：抽丝剥茧，还原真相

kubectl describe 命令会输出大量的资源信息，我们需要学会解读这些信息，才能真正了解资源的状况。

• Name: 资源的名字。
• Namespace: 资源所在的命名空间。
• Labels: 资源的标签。
• Annotations: 资源的注解。
• CreationTimestamp: 资源的创建时间。
• Status: 资源的状态。
• Conditions: 资源的状态条件。
• Events: 资源相关的事件，比如创建、更新、删除等。

2.3 实例演练：拨开迷雾，见证真相

• 查看 Pod 的详细信息：

  kubectl describe pod my-pod

  这条命令会输出名为 my-pod 的 Pod 的详细信息，包括容器信息、状态、事件等。

• 查看 Deployment 的详细信息：

  kubectl describe deployment my-deployment

  这条命令会输出名为 my-deployment 的 Deployment 的详细信息，包括副本数、更新策略、事件等。

• 查看 Service 的详细信息：

  kubectl describe service my-service

  这条命令会输出名为 my-service 的 Service 的详细信息，包括端口、选择器、外部 IP 等。

• 查看 Node 的详细信息：

  kubectl describe node my-node

  这条命令会输出名为 my-node 的 Node 的详细信息，包括 CPU、内存、磁盘等资源使用情况、状态、事件等。

2.4 案例分析：解决疑难杂症

假设你发现一个 Pod 一直处于 Pending 状态，无法启动，你可以使用 kubectl describe pod <pod-name> 命令来查看该 Pod 的详细信息，重点关注以下几个方面：

• Events: 查看是否有相关的错误事件，比如镜像拉取失败、资源不足等。
• Conditions: 查看是否有 Unschedulable 条件，表示 Pod 无法被调度到任何 Node 上。
• Node: 查看 Pod 是否已经被调度到某个 Node 上。

通过分析这些信息，你可以找到 Pod 无法启动的原因，并采取相应的措施。比如，如果是因为镜像拉取失败，你可以检查镜像名称是否正确、镜像仓库是否可访问；如果是因为资源不足，你可以增加 Node 的资源或者减少 Pod 的资源需求。

2.5 注意事项：细致观察，谨慎判断

• kubectl describe 命令输出的信息量很大，需要耐心阅读，仔细分析。
• 关注 Events 部分，它可以帮助你快速定位问题。
• 结合其他工具，比如 kubectl logs 命令，可以更好地了解应用程序的运行状况。

第三章：寻宝秘籍：最佳实践

• 善用别名：提高效率

  你可以为常用的 kubectl 命令创建别名，比如：

  alias k='kubectl'
  alias kg='kubectl get'
  alias kd='kubectl describe'

  这样，你就可以使用 k, kg, kd 来代替 kubectl, kubectl get, kubectl describe 命令，大大提高效率。

• 结合管道：灵活筛选

  你可以结合 grep、awk 等命令，对 kubectl 命令的输出进行筛选和处理，比如：

  kubectl get pods -o wide | grep Running | awk '{print $1, $6}'

  这条命令会列出所有状态为 Running 的 Pod 的名称和所在的 Node。

• 自动化脚本：解放双手

  你可以将常用的 kubectl 命令编写成脚本，实现自动化运维，比如：

  #!/bin/bash
  # 检查所有 Pod 的状态
  for pod in $(kubectl get pods -o name); do
    echo "Checking pod: $pod"
    kubectl describe $pod | grep -i "Error|Warning"
  done

  这条脚本会检查所有 Pod 的状态，并输出包含 "Error" 或 "Warning" 关键词的信息。

第四章：进阶之路：更上一层楼

• 了解 Kubernetes API：深入本质

  kubectl 命令只是 Kubernetes API 的一个客户端，了解 Kubernetes API 的底层原理，可以让你更好地理解 kubectl 命令的工作方式。

• 学习 JSONPath：精确提取

  JSONPath 是一种用于查询 JSON 数据的语言，你可以使用 JSONPath 来精确提取 kubectl 命令输出的 JSON 数据。

• 探索 Kubectl 插件：扩展功能

  Kubectl 插件可以扩展 kubectl 命令的功能，比如 kubectl krew 是一个 Kubernetes 插件管理器，可以方便地安装和管理其他 Kubectl 插件。

总结：扬帆远航，征服 K8s 世界！

各位船长，通过今天的学习，我们已经掌握了 kubectl get 和 kubectl describe 这两大法宝，现在你可以像一位经验丰富的海盗船长一样，自由地探索 Kubernetes 集群，了解资源的状况，解决疑难杂症。

记住，学习永无止境，不断探索，不断实践，你终将征服 K8s 世界！ 🚀

祝各位船长，一路顺风！ 🌊