kubectl 安装与配置

约 566 字大约 2 分钟

布欧-Lewyon

2026-05-15

首页 › K8s › 安装与工具（在新窗口打开） › kubectl 安装与配置

安装 kubectl

# macOS
brew install kubectl

# Ubuntu
sudo apt update
sudo apt install -y kubectl

# curl 下载（所有平台）
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl"
chmod +x kubectl
sudo mv kubectl /usr/local/bin/

# 验证
kubectl version --client

~/.kube/config

kubectl 通过 ~/.kube/config 文件连接集群：

apiVersion: v1
kind: Config
current-context: minikube
clusters:
- cluster:
    server: https://192.168.49.2:8443
    certificate-authority: /Users/me/.minikube/ca.crt
  name: minikube
users:
- name: minikube
  user:
    client-certificate: /Users/me/.minikube/profiles/minikube/client.crt
    client-key: /Users/me/.minikube/profiles/minikube/client.key
contexts:
- context:
    cluster: minikube
    user: minikube
  name: minikube

kubectl 常用命令分组

查看资源

kubectl get pods                     # 查看 Pod
kubectl get pods -o wide             # 显示更多信息（IP、节点）
kubectl get pods -n kube-system      # 指定 Namespace
kubectl get pods --all-namespaces    # 所有 Namespace
kubectl get deployment,service       # 多种资源
kubectl describe pod nginx-pod       # 详细信息

创建与更新

# 声明式（推荐）
kubectl apply -f deployment.yaml
kubectl apply -f ./configs/          # 应用目录下所有 YAML
kubectl apply -f https://...         # URL 远程文件

# 命令式
kubectl create deployment nginx --image=nginx:alpine
kubectl run nginx --image=nginx:alpine

删除

kubectl delete pod nginx-pod
kubectl delete -f deployment.yaml
kubectl delete deployment nginx

调试

kubectl logs nginx-pod               # 查看日志
kubectl logs -f nginx-pod            # 实时追踪
kubectl logs nginx-pod -c sidecar    # 多容器指定容器
kubectl exec -it nginx-pod -- sh     # 进入容器
kubectl exec nginx-pod -- env        # 执行单条命令

kubectl port-forward pod/nginx-pod 8080:80  # 端口转发

上下文管理

kubectl config current-context             # 查看当前上下文
kubectl config get-contexts                # 列出所有上下文
kubectl config use-context minikube         # 切换上下文
kubectl config set-context --current --namespace=prod  # 设置默认 Namespace

输出格式

kubectl get pods -o wide                   # 扩展信息
kubectl get pods -o yaml                   # YAML 格式
kubectl get pods -o json                   # JSON 格式
kubectl get pods -o jsonpath='{.items[*].metadata.name}'  # JSONPath 提取
kubectl get pods --watch                   # 实时监听变化
kubectl get pods --field-selector=status.phase=Running  # 字段过滤

自动补全

# bash
source <(kubectl completion bash)
echo "source <(kubectl completion bash)" >> ~/.bashrc

# zsh
source <(kubectl completion zsh)
echo "source <(kubectl completion zsh)" >> ~/.zshrc

# 别名
alias k=kubectl
complete -o default -F __start_kubectl k

小结

kubectl apply -f file.yaml 是声明式推荐用法。
-o wide/yaml/json 控制输出格式，-w 实时监听。
kubectl config 管理多集群上下文切换。
kubectl logs/exec/port-forward 是调试三板斧。
建议配置自动补全和 k 别名提升操作效率。

上一节：Minikube 与 kind 下一节：Pod 定义与基本操作