與運行中的 Pods 進行交互
kubectl logs my-pod # 獲取 pod 日志(標(biāo)準(zhǔn)輸出)
kubectl logs -l name=myLabel # 獲取含 name=myLabel 標(biāo)簽的 Pods 的日志(標(biāo)準(zhǔn)輸出)
kubectl logs my-pod --previous # 獲取上個容器實例的 pod 日志(標(biāo)準(zhǔn)輸出)
kubectl logs my-pod -c my-container # 獲取 Pod 容器的日志(標(biāo)準(zhǔn)輸出, 多容器場景)
獲取含 name=myLabel 標(biāo)簽的 Pod 容器日志(標(biāo)準(zhǔn)輸出, 多容器場景)
kubectl logs -l name=myLabel -c my-container
獲取 Pod 中某容器的上個實例的日志(標(biāo)準(zhǔn)輸出, 多容器場景)
kubectl logs my-pod -c my-container --previous
kubectl logs -f my-pod # 流式輸出 Pod 的日志(標(biāo)準(zhǔn)輸出)
kubectl logs -f my-pod -c my-container # 流式輸出 Pod 容器的日志(標(biāo)準(zhǔn)輸出, 多容器場景)
kubectl logs -f -l name=myLabel --all-containers # 流式輸出含 name=myLabel 標(biāo)簽的 Pod 的所有日志(標(biāo)準(zhǔn)輸出)
kubectl run -i --tty busybox --image=busybox -- sh # 以交互式 Shell 運行 Pod
kubectl run nginx --image=nginx -n mynamespace # 在指定名字空間中運行 nginx Pod
kubectl run nginx --image=nginx # 運行 ngins Pod 并將其規(guī)約寫入到名為 pod.yaml 的文件
--dry-run=client -o yaml > pod.yaml
kubectl attach my-pod -i # 掛接到一個運行的容器中
在本地計算機上偵聽端口 5000 并轉(zhuǎn)發(fā)到 my-pod 上的端口 6000
kubectl port-forward my-pod 5000:6000
kubectl exec my-pod -- ls / # 在已有的 Pod 中運行命令(單容器場景)
kubectl exec --stdin --tty my-pod -- /bin/sh # 使用交互 shell 訪問正在運行的 Pod (一個容器場景)
kubectl exec my-pod -c my-container -- ls / # 在已有的 Pod 中運行命令(多容器場景)
kubectl top pod POD_NAME --containers # 顯示給定 Pod 和其中容器的監(jiān)控數(shù)據(jù)
與節(jié)點和集群進行交互
kubectl cordon my-node # 標(biāo)記 my-node 節(jié)點為不可調(diào)度
kubectl drain my-node # 對 my-node 節(jié)點進行清空操作晋修,為節(jié)點維護做準(zhǔn)備
kubectl uncordon my-node # 標(biāo)記 my-node 節(jié)點為可以調(diào)度
kubectl top node my-node # 顯示給定節(jié)點的度量值
kubectl cluster-info # 顯示主控節(jié)點和服務(wù)的地址
kubectl cluster-info dump # 將當(dāng)前集群狀態(tài)轉(zhuǎn)儲到標(biāo)準(zhǔn)輸出
將當(dāng)前集群狀態(tài)輸出到 /path/to/cluster-state
kubectl cluster-info dump --output-directory=/path/to/cluster-state
如果已存在具有指定鍵和效果的污點,則替換其值為指定值蘸秘。
kubectl taint nodes foo dedicated=special-user:NoSchedule
資源類型
列出所支持的全部資源類型和它們的簡稱恨搓、API 組, 是否是名字空間作用域 和 Kind。
kubectl api-resources
探索 API 資源的其他操作:
kubectl api-resources --namespaced=true # 所有命名空間作用域的資源
kubectl api-resources --namespaced=false # 所有非命名空間作用域的資源
kubectl api-resources -o name # 用簡單格式列舉所有資源(僅顯示資源名稱)
kubectl api-resources -o wide # 用擴展格式列舉所有資源(又稱 "wide" 格式)
kubectl api-resources --verbs=list,get # 支持 "list" 和 "get" 請求動詞的所有資源
kubectl api-resources --api-group=extensions # "extensions" API 組中的所有資源
格式化輸出
要以特定格式將詳細信息輸出到終端窗口娜汁,將 -o(或者 --output)參數(shù)添加到支持的 kubectl 命令中嫂易。
輸出格式 描述
-o=custom-columns=<spec> 使用逗號分隔的自定義列來打印表格
-o=custom-columns-file=<filename> 使用 <filename> 文件中的自定義列模板打印表格
-o=json 輸出 JSON 格式的 API 對象
-o=jsonpath=<template> 打印 jsonpath 表達式中定義的字段
-o=jsonpath-file=<filename> 打印在 <filename> 文件中定義的 jsonpath 表達式所指定的字段。
-o=name 僅打印資源名稱而不打印其他內(nèi)容
-o=wide 以純文本格式輸出額外信息掐禁,對于 Pod 來說怜械,輸出中包含了節(jié)點名稱
-o=yaml 輸出 YAML 格式的 API 對象
使用 -o=custom-columns 的示例:
集群中運行著的所有鏡像
kubectl get pods -A -o=custom-columns='DATA:spec.containers[*].image'
除 "k8s.gcr.io/coredns:1.6.2" 之外的所有鏡像
kubectl get pods -A -o=custom-columns='DATA:spec.containers[?(@.image!="k8s.gcr.io/coredns:1.6.2")].image'
輸出 metadata 下面的所有字段颅和,無論 Pod 名字為何
kubectl get pods -A -o=custom-columns='DATA:metadata.*'
Kubectl 日志輸出詳細程度和調(diào)試
Kubectl 日志輸出詳細程度是通過 -v 或者 --v 來控制的,參數(shù)后跟一個數(shù)字表示日志的級別缕允。
Kubernetes 通用的日志習(xí)慣和相關(guān)的日志級別在 這里 有相應(yīng)的描述峡扩。
詳細程度 描述
--v=0 用于那些應(yīng)該 始終 對運維人員可見的信息,因為這些信息一般很有用障本。
--v=1 如果您不想要看到冗余信息教届,此值是一個合理的默認日志級別。
--v=2 輸出有關(guān)服務(wù)的穩(wěn)定狀態(tài)的信息以及重要的日志消息驾霜,這些信息可能與系統(tǒng)中的重大變化有關(guān)案训。
這是建議大多數(shù)系統(tǒng)設(shè)置的默認日志級別。
--v=3 包含有關(guān)系統(tǒng)狀態(tài)變化的擴展信息粪糙。
--v=4 包含調(diào)試級別的冗余信息强霎。
--v=5 跟蹤級別的詳細程度。
--v=6 顯示所請求的資源猜旬。
--v=7 顯示 HTTP 請求頭脆栋。
--v=8 顯示 HTTP 請求內(nèi)容。
--v=9 顯示 HTTP 請求內(nèi)容而且不截斷內(nèi)容洒擦。
==============================================================
查看和查找資源
get 命令的基本輸出
kubectl get services # 列出當(dāng)前命名空間下的所有 services
kubectl get pods --all-namespaces # 列出所有命名空間下的全部的 Pods
kubectl get pods -o wide # 列出當(dāng)前命名空間下的全部 Pods椿争,并顯示更詳細的信息
kubectl get deployment my-dep # 列出某個特定的 Deployment
kubectl get pods # 列出當(dāng)前命名空間下的全部 Pods
kubectl get pod my-pod -o yaml # 獲取一個 pod 的 YAML
describe 命令的詳細輸出
kubectl describe nodes my-node
kubectl describe pods my-pod
列出當(dāng)前名字空間下所有 Services,按名稱排序
kubectl get services --sort-by=.metadata.name
列出 Pods熟嫩,按重啟次數(shù)排序
kubectl get pods --sort-by='.status.containerStatuses[0].restartCount'
列舉所有 PV 持久卷秦踪,按容量排序
kubectl get pv --sort-by=.spec.capacity.storage
獲取包含 app=cassandra 標(biāo)簽的所有 Pods 的 version 標(biāo)簽
kubectl get pods --selector=app=cassandra -o
jsonpath='{.items[*].metadata.labels.version}'
檢索帶有 “.” 鍵值,例: 'ca.crt'
kubectl get configmap myconfig
-o jsonpath='{.data.ca.crt}'
獲取所有工作節(jié)點(使用選擇器以排除標(biāo)簽名稱為 'node-role.kubernetes.io/master' 的結(jié)果)
kubectl get node --selector='!node-role.kubernetes.io/master'
獲取當(dāng)前命名空間中正在運行的 Pods
kubectl get pods --field-selector=status.phase=Running
獲取全部節(jié)點的 ExternalIP 地址
kubectl get nodes -o jsonpath='{.items[*].status.addresses[?(@.type=="ExternalIP")].address}'
列出屬于某個特定 RC 的 Pods 的名稱
在轉(zhuǎn)換對于 jsonpath 過于復(fù)雜的場合掸茅,"jq" 命令很有用椅邓;可以在 https://stedolan.github.io/jq/ 找到它。
sel=(kubectl get rc my-rc --output=json | jq -j '.spec.selector | to_entries | .[] | "(.key)=(.value),"')%?}
echo sel --output=jsonpath={.items..metadata.name})
顯示所有 Pods 的標(biāo)簽(或任何其他支持標(biāo)簽的 Kubernetes 對象)
kubectl get pods --show-labels
檢查哪些節(jié)點處于就緒狀態(tài)
JSONPATH='{range .items[]}{@.metadata.name}:{range @.status.conditions[]}{@.type}={@.status};{end}{end}'
&& kubectl get nodes -o jsonpath="$JSONPATH" | grep "Ready=True"
列出被一個 Pod 使用的全部 Secret
kubectl get pods -o json | jq '.items[].spec.containers[].env[]?.valueFrom.secretKeyRef.name'
| grep -v null | sort | uniq
列舉所有 Pods 中初始化容器的容器 ID(containerID)
Helpful when cleaning up stopped containers, while avoiding removal of initContainers.
kubectl get pods --all-namespaces
-o jsonpath='{range .items[].status.initContainerStatuses[]}{.containerID}{"\n"}{end}' | cut -d/ -f3
列出事件(Events)昧狮,按時間戳排序
kubectl get events --sort-by=.metadata.creationTimestamp
比較當(dāng)前的集群狀態(tài)和假定某清單被應(yīng)用之后的集群狀態(tài)
kubectl diff -f ./my-manifest.yaml
生成一個句點分隔的樹景馁,其中包含為節(jié)點返回的所有鍵
在復(fù)雜的嵌套JSON結(jié)構(gòu)中定位鍵時非常有用
kubectl get nodes -o json | jq -c 'path(..)|[.[]|tostring]|join(".")'
生成一個句點分隔的樹,其中包含為pod等返回的所有鍵
kubectl get pods -o json | jq -c 'path(..)|[.[]|tostring]|join(".")'
更新資源
kubectl set image deployment/frontend www=image:v2 # 滾動更新 "frontend" Deployment 的 "www" 容器鏡像
kubectl rollout history deployment/frontend # 檢查 Deployment 的歷史記錄逗鸣,包括版本
kubectl rollout undo deployment/frontend # 回滾到上次部署版本
kubectl rollout undo deployment/frontend --to-revision=2 # 回滾到特定部署版本
kubectl rollout status -w deployment/frontend # 監(jiān)視 "frontend" Deployment 的滾動升級狀態(tài)直到完成
kubectl rollout restart deployment/frontend # 輪替重啟 "frontend" Deployment
cat pod.json | kubectl replace -f - # 通過傳入到標(biāo)準(zhǔn)輸入的 JSON 來替換 Pod
強制替換合住,刪除后重建資源。會導(dǎo)致服務(wù)不可用撒璧。
kubectl replace --force -f ./pod.json
為多副本的 nginx 創(chuàng)建服務(wù)透葛,使用 80 端口提供服務(wù),連接到容器的 8000 端口卿樱。
kubectl expose rc nginx --port=80 --target-port=8000
將某單容器 Pod 的鏡像版本(標(biāo)簽)更新到 v4
kubectl get pod mypod -o yaml | sed 's/(image: myimage):.*$/\1:v4/' | kubectl replace -f -
kubectl label pods my-pod new-label=awesome # 添加標(biāo)簽
kubectl annotate pods my-pod icon-url=http://goo.gl/XXBTWq # 添加注解
kubectl autoscale deployment foo --min=2 --max=10 # 對 "foo" Deployment 自動伸縮容
部分更新資源
部分更新某節(jié)點
kubectl patch node k8s-node-1 -p '{"spec":{"unschedulable":true}}'
更新容器的鏡像僚害;spec.containers[*].name 是必須的。因為它是一個合并性質(zhì)的主鍵繁调。
kubectl patch pod valid-pod
-p '{"spec":{"containers":[{"name":"kubernetes-serve-hostname","image":"new image"}]}}'
使用帶位置數(shù)組的 JSON patch 更新容器的鏡像
kubectl patch pod valid-pod --type='json'
-p='[{"op": "replace", "path": "/spec/containers/0/image", "value":"new image"}]'
使用帶位置數(shù)組的 JSON patch 禁用某 Deployment 的 livenessProbe
kubectl patch deployment valid-deployment --type json
-p='[{"op": "remove", "path": "/spec/template/spec/containers/0/livenessProbe"}]'
在帶位置數(shù)組中添加元素
kubectl patch sa default --type='json'
-p='[{"op": "add", "path": "/secrets/1", "value": {"name": "whatever" } }]'
編輯資源
kubectl edit svc/docker-registry # 編輯名為 docker-registry 的服務(wù)
KUBE_EDITOR="nano" kubectl edit svc/docker-registry # 使用其他編輯器
對資源進行伸縮
kubectl scale --replicas=3 rs/foo # 將名為 'foo' 的副本集伸縮到 3 副本
kubectl scale --replicas=3 -f foo.yaml # 將在 "foo.yaml" 中的特定資源伸縮到 3 個副本
如果名為 mysql 的 Deployment 的副本當(dāng)前是 2萨蚕,那么將它伸縮到 3
kubectl scale --current-replicas=2 --replicas=3 deployment/mysql
kubectl scale --replicas=5 rc/foo rc/bar rc/baz # 伸縮多個副本控制器
刪除資源
kubectl delete -f ./pod.json # 刪除在 pod.json 中指定的類型和名稱的 Pod
kubectl delete pod,service baz foo # 刪除名稱為 "baz" 和 "foo" 的 Pod 和服務(wù)
kubectl delete pods,services -l name=myLabel # 刪除包含 name=myLabel 標(biāo)簽的 pods 和服務(wù)
kubectl -n my-ns delete pod,svc --all # 刪除在 my-ns 名字空間中全部的 Pods 和服務(wù)
刪除所有與 pattern1 或 pattern2 awk 模式匹配的 Pods
kubectl get pods -n mynamespace --no-headers=true | awk '/pattern1|pattern2/{print $1}'
| xargs kubectl delete -n mynamespace pod