容器与云原生 / 系统课时

kubectl 基础操作

kubectl 基础操作

本课用一组可直接执行的命令,完成资源查询、创建、描述、删除、上下文切换与命名空间管理,并建立“先确认目标,再执行变更,最后验证结果”的安全操作习惯。

学习目标

  • 使用 kubectl get 和 describe 查看资源状态
  • 使用命令式方式创建、修改与删除测试资源
  • 正确切换上下文和命名空间,避免操作错误集群

先确认当前集群与命名空间

kubectl 会把请求发送到当前上下文指定的 API Server。执行任何创建或删除操作前,应先确认当前上下文、集群地址和默认命名空间。

bash
kubectl config current-context
kubectl config view --minify

预期输出

text
<CONTEXT_NAME>
apiVersion: v1
clusters:
- cluster:
    server: https://<API_SERVER>:<PORT>
...

<CONTEXT_NAME>、<API_SERVER> 和 <PORT> 会随环境变化。若输出的集群不是目标环境,应先切换上下文,不要继续执行变更命令。

查询与定位资源

get 适合快速查看资源列表,describe 适合检查事件、调度结果和容器状态。下面先查看节点,再查看所有命名空间中的 Pod,最后定位某个 Pod 的详细信息。

bash
kubectl get nodes -o wide
kubectl get pods -A
kubectl describe pod <POD_NAME> -n <NAMESPACE>

预期输出

text
NAME       STATUS   ROLES           AGE   VERSION   INTERNAL-IP
<NODE>     Ready    control-plane   <AGE> <VERSION> <IP>

NAMESPACE   NAME         READY   STATUS    RESTARTS   AGE
<NAMESPACE> <POD_NAME>   1/1     Running   0          <AGE>

Name:         <POD_NAME>
Namespace:    <NAMESPACE>
Status:       Running
Events:       <EVENTS>

当 Pod 不是 Running 时,优先查看 Events。镜像拉取失败、探针失败、资源不足和调度失败通常都会留下明确事件。

创建并验证测试资源

下面创建一个名为 demo-nginx 的 Deployment,并立即查看 Deployment 与 Pod。命令式创建适合学习和临时验证,正式环境更推荐保存 YAML 后使用声明式管理。

bash
kubectl create deployment demo-nginx --image=nginx:1.27 -n default
kubectl rollout status deployment/demo-nginx -n default
kubectl get deployment,pod -n default -l app=demo-nginx

预期输出

text
deployment.apps/demo-nginx created
deployment "demo-nginx" successfully rolled out
NAME                         READY   UP-TO-DATE   AVAILABLE   AGE
deployment.apps/demo-nginx   1/1     1            1           <AGE>

NAME                              READY   STATUS    RESTARTS   AGE
pod/demo-nginx-<ID>               1/1     Running   0          <AGE>

<AGE> 和 <ID> 是动态值。若 rollout status 长时间未完成,可再次执行 describe pod 查看失败原因。

管理命名空间

命名空间用于隔离同一集群中的资源名称和管理边界。下面创建 training 命名空间,并将当前上下文的默认命名空间切换为它。

bash
kubectl create namespace training
kubectl config set-context --current --namespace=training
kubectl config view --minify -o jsonpath='{..namespace}'; echo

预期输出

text
namespace/training created
Context "<CONTEXT_NAME>" modified.
training

切换默认命名空间后,未显式写 -n 的命令都会作用于 training。排查“资源明明存在却查询不到”时,应先检查当前命名空间。

切换上下文与安全删除

先列出可用上下文,再切换到目标上下文。删除资源前使用 get 精确确认名称和命名空间,避免因同名资源或环境错误造成误删。

bash
kubectl config get-contexts
kubectl config use-context <TARGET_CONTEXT>
kubectl config current-context
kubectl config use-context <ORIGINAL_CONTEXT>
kubectl get deployment demo-nginx -n default
kubectl delete deployment demo-nginx -n default

预期输出

text
CURRENT   NAME                 CLUSTER            AUTHINFO           NAMESPACE
*         <ORIGINAL_CONTEXT>   <CLUSTER>          <USER>             training
          <TARGET_CONTEXT>     <TARGET_CLUSTER>   <TARGET_USER>      default

Switched to context "<TARGET_CONTEXT>".
<TARGET_CONTEXT>
Switched to context "<ORIGINAL_CONTEXT>".
NAME         READY   UP-TO-DATE   AVAILABLE   AGE
demo-nginx   1/1     1            1           <AGE>
deployment.apps "demo-nginx" deleted

上下文切换会改变后续所有命令的目标集群。生产环境操作时,建议在终端提示符中显示当前上下文,并为高风险删除操作保留人工确认。

本课总结

  • 执行变更前先确认当前上下文、API Server 和命名空间
  • get 用于快速查看,describe 用于分析状态、事件和失败原因
  • 创建、切换与删除后都要立即查询验证,不能只依赖命令返回成功

下一课预告

下一课将从单条命令进入声明式管理,学习如何编写并应用 Kubernetes YAML 清单。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

kubectl 基础操作

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通