容器与云原生 / 系统课时
kubectl 基础操作
kubectl 基础操作
本课用一组可直接执行的命令,完成资源查询、创建、描述、删除、上下文切换与命名空间管理,并建立“先确认目标,再执行变更,最后验证结果”的安全操作习惯。
学习目标
- 使用
kubectl get和describe查看资源状态 - 使用命令式方式创建、修改与删除测试资源
- 正确切换上下文和命名空间,避免操作错误集群
先确认当前集群与命名空间
kubectl 会把请求发送到当前上下文指定的 API Server。执行任何创建或删除操作前,应先确认当前上下文、集群地址和默认命名空间。
kubectl config current-context
kubectl config view --minify预期输出
<CONTEXT_NAME>
apiVersion: v1
clusters:
- cluster:
server: https://<API_SERVER>:<PORT>
...<CONTEXT_NAME>、<API_SERVER> 和 <PORT> 会随环境变化。若输出的集群不是目标环境,应先切换上下文,不要继续执行变更命令。
查询与定位资源
get 适合快速查看资源列表,describe 适合检查事件、调度结果和容器状态。下面先查看节点,再查看所有命名空间中的 Pod,最后定位某个 Pod 的详细信息。
kubectl get nodes -o wide
kubectl get pods -A
kubectl describe pod <POD_NAME> -n <NAMESPACE>预期输出
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 后使用声明式管理。
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预期输出
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 命名空间,并将当前上下文的默认命名空间切换为它。
kubectl create namespace training
kubectl config set-context --current --namespace=training
kubectl config view --minify -o jsonpath='{..namespace}'; echo预期输出
namespace/training created
Context "<CONTEXT_NAME>" modified.
training切换默认命名空间后,未显式写 -n 的命令都会作用于 training。排查“资源明明存在却查询不到”时,应先检查当前命名空间。
切换上下文与安全删除
先列出可用上下文,再切换到目标上下文。删除资源前使用 get 精确确认名称和命名空间,避免因同名资源或环境错误造成误删。
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预期输出
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 清单。