Kubectl 自动补全
设置shell自动补全,要先安装bash-completion 并永久添加自动补全
source <(kubectl completion bash)
echo “source <(kubectl completion bash)” >> ~/.bashrc
Kubectl 上下文
kubectl config view # 显示config 配置。
kubectl config get-contexts # 显示上下文列表
kubectl config current-context # 展示当前所处的上下文
kubectl config use-context my-context # 切换上下文到my-context
kubectl config set-context kubernetes-admin@kubernetes --namespace=default #设置上下文的默认namespace
kubectl config set-context
w
o
r
k
c
o
n
t
e
x
t
−
−
c
l
u
s
t
e
r
=
d
e
f
a
u
l
t
−
−
u
s
e
r
=
d
e
f
a
u
l
t
−
−
n
a
m
e
s
p
a
c
e
=
{work_context} --cluster=default --user=default --namespace=
workcontext−−cluster=default−−user=default−−namespace={work_namespace} #新建上下文
Kubectl apply、create
kubectl apply -f ./my.yaml # 创建资源
kubectl apply -f ./my1.yaml -f ./my2.yaml # 使用多个文件创建
kubectl apply -f ./dir # 目录下的所有清单文件都创建
kubectl apply -f http://***/xxx.yaml # 读取url配置并创建资源
kubectl create deployment nginx --image=nginx # 启动单实例 nginx
kubectl create job hello --image=busybox – echo “Hello World” # 创建一个打印 “Hello World” 的 Job
kubectl create cronjob hello --image=busybox --schedule=“*/1 * * * *” – echo “Hello World” # 创建一个打印 “Hello World” 间隔1分钟的 CronJob
kubectl explain pods # 获取 pod 清单的文档说明
查看资源
get 命令的基本输出
kubectl get services # 列出当前命名空间下的所有 services
kubectl get pod # 列出当前命名空间下的所有 pod
#可选参数
–all-namespaces 或者 -A # 指定所有命名空间
-o wide # 显示更详细的信息
–show-labels # 显示标签
kubectl get deployment my-dep # 列出某个特定的 Deployment
kubectl get pod my-pod -o yaml # 获取一个 pod 的 YAML
kubectl get pod,svc # 可以同时查看多种资源对象
kubectl get all -A # 查看所有资源对象
describe 详细输出,创建过程,事件等
kubectl describe nodes my-node
kubectl describe pods my-pod
列出当前名字空间下所有 Services,按名称排序
kubectl get services --sort-by=.metadata.name
列出 Pods,按重启次数排序
kubectl get pods --sort-by=‘.status.containerStatuses[0].restartCount’
列举所有 PV 持久卷,按容量排序
kubectl get pv --sort-by=.spec.capacity.storage
获取包含 app=cassandra 标签的所有 Pods 的 version 标签
kubectl get pods --selector=app=cassandra -o
jsonpath=‘{.items[*].metadata.labels.version}’
检索带有 “.” 键值,例: ‘ca.crt’
kubectl get configmap myconfig -o jsonpath=‘{.data.ca.crt}’
获取所有工作节点(使用选择器以排除标签名称为 ‘node-role.kubernetes.io/master’ 的结果)
kubectl get node --selector=‘!node-role.kubernetes.io/master’
获取当前命名空间中正在运行的 Pods
kubectl get pods --field-selector=status.phase=Running
获取全部节点的 ExternalIP 地址
kubectl get nodes -o jsonpath=‘{.items[*].status.addresses[?(@.type==“ExternalIP”)].address}’
列出属于某个特定 RC 的 Pods 的名称
在转换对于 jsonpath 过于复杂的场合,“jq” 命令很有用;可以在 https://stedolan.github.io/jq/ 找到它。
sel=KaTeX parse error: Expected '}', got 'EOF' at end of input: {(kubectl get rc my-rc --output=json | jq -j ‘.spec.selector | to_entries | .[] | “(.key)=(.value),”’)%?}
echo
(
k
u
b
e
c
t
l
g
e
t
p
o
d
s
−
−
s
e
l
e
c
t
o
r
=
(kubectl get pods --selector=
(kubectlgetpods−−selector=sel --output=jsonpath={.items…metadata.name})
显示所有 Pods 的标签(或任何其他支持标签的 Kubernetes 对象)
kubectl get pods --show-labels
按照标签过滤
kubectl get pod -l app=nginx
检查哪些节点处于就绪状态
JSONPATH=‘{range .items[]}{@.metadata.name}:{range @.status.conditions[]}{@.type}={@.status};{end}{end}’
&& kubectl get nodes -o jsonpath=“$JSONPATH” | grep “Ready=True”
不使用外部工具来输出解码后的 Secret
kubectl get secret my-secret -o go-template=‘{{range k , k, k,v := .data}}{{“### “}}{{KaTeX parse error: Expected 'EOF', got '}' at position 2: k}̲}{{"\n"}}{{v|base64decode}}{{”\n\n”}}{{end}}’
列出被一个 Pod 使用的全部 Secret
kubectl get pods -o json | jq ‘.items[].spec.containers[].env[]?.valueFrom.secretKeyRef.name’ | grep -v null | sort | uniq
列举所有 Pods 中初始化容器的容器 ID(containerID)
可用于在清理已停止的容器时避免删除初始化容器
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
比较当前的集群状态和假定某清单被应用之后的集群状态
kubectl diff -f ./my-manifest.yaml
生成一个句点分隔的树,其中包含为节点返回的所有键
在复杂的嵌套JSON结构中定位键时非常有用
kubectl get nodes -o json | jq -c ‘path(…)|[.[]|tostring]|join(“.”)’
生成一个句点分隔的树,其中包含为pod等返回的所有键
kubectl get pods -o json | jq -c ‘path(…)|[.[]|tostring]|join(“.”)’
假设你的 Pods 有默认的容器和默认的名字空间,并且支持 ‘env’ 命令,可以使用以下脚本为所有 Pods 生成 ENV 变量。
该脚本也可用于在所有的 Pods 里运行任何受支持的命令,而不仅仅是 ‘env’。
for pod in $(kubectl get po --output=jsonpath={.items…metadata.name}); do echo $pod && kubectl exec -it $pod – env; done
label标签
#给名为foo的pod添加一个unhealthy:true 的标签,如果标签名存在会提示设置不成功,可添加–overwrite覆盖标签值
kubectl label pods foo unhealthy=true
更新命名空间中的所有 pod
kubectl label pods --all status=unhealthy
更新由“pod.json”中的类型和名称标识的 pod
kubectl label -f pod.json status=unhealthy
仅当资源与版本 1 相同时才更新 pod ‘foo’
kubectl label pods foo status=unhealthy --resource-version=1
删除Label,只需在需要删除Label的key名后面添加一个减号即可,不需要 --overwrite 标志,如删除status=unhealthy
kubectl label pods foo status-
更新资源
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 # 监视 “frontend” Deployment 的滚动升级状态直到完成
kubectl rollout restart deployment/frontend # 轮替重启 “frontend” Deployment
cat pod.json | kubectl replace -f - # 通过传入到标准输入的 JSON 来替换 Pod
强制替换,删除后重建资源。会导致服务不可用。
kubectl replace --force -f ./pod.json
为多副本的 nginx 创建服务,使用 80 端口提供服务,连接到容器的 8000 端口。
kubectl expose rc nginx --port=80 --target-port=8000
将某单容器 Pod 的镜像版本(标签)更新到 v4
kubectl get pod mypod -o yaml | sed ‘s/(image: myimage):.*$/\1:v4/’ | kubectl replace -f -
kubectl label pods my-pod new-label=awesome # 添加标签
kubectl annotate pods my-pod icon-url=http://goo.gl/XXBTWq # 添加注解
kubectl autoscale deployment foo --min=2 --max=10 # 对 “foo” Deployment 自动伸缩容
部分更新资源
部分更新某节点
kubectl patch node k8s-node-1 -p ‘{“spec”:{“unschedulable”:true}}’
更新容器的镜像;spec.containers[*].name 是必须的。因为它是一个合并性质的主键。
kubectl patch pod valid-pod -p ‘{“spec”:{“containers”:[{“name”:“kubernetes-serve-hostname”,“image”:“new image”}]}}’
使用带位置数组的 JSON patch 更新容器的镜像
kubectl patch pod valid-pod --type=‘json’ -p=‘[{“op”: “replace”, “path”: “/spec/containers/0/image”, “value”:“new image”}]’
使用带位置数组的 JSON patch 禁用某 Deployment 的 livenessProbe
kubectl patch deployment valid-deployment --type json -p=‘[{“op”: “remove”, “path”: “/spec/template/spec/containers/0/livenessProbe”}]’
在带位置数组中添加元素
kubectl patch sa default --type=‘json’ -p=‘[{“op”: “add”, “path”: “/secrets/1”, “value”: {“name”: “whatever” } }]’
编辑资源
kubectl edit svc/docker-registry # 编辑名为 docker-registry 的服务
KUBE_EDITOR=“nano” kubectl edit svc/docker-registry # 使用其他编辑器
–record #记录版本
对资源进行伸缩
kubectl scale --replicas=3 rs/foo # 将名为 ‘foo’ 的副本集伸缩到 3 副本
kubectl scale --replicas=3 -f foo.yaml # 将在 “foo.yaml” 中的特定资源伸缩到 3 个副本
kubectl scale --current-replicas=2 --replicas=3 deployment/mysql # 如果名为 mysql 的 Deployment 的副本当前是 2,那么将它伸缩到 3
kubectl scale --replicas=5 rc/foo rc/bar rc/baz # 伸缩多个副本控制器
–record #记录版本
删除资源
kubectl delete -f ./pod.json # 删除在 pod.json 中指定的类型和名称的 Pod
kubectl delete pod,service baz foo # 删除名称为 “baz” 和 “foo” 的 Pod 和服务
kubectl delete pods,services -l name=myLabel # 删除包含 name=myLabel 标签的 pods 和服务
kubectl -n my-ns delete pod,svc --all # 删除在 my-ns 名字空间中全部的 Pods 和服务
删除所有与 pattern1 或 pattern2 awk 模式匹配的 Pods
kubectl get pods -n mynamespace --no-headers=true | awk ‘/pattern1|pattern2/{print $1}’ | xargs kubectl delete -n mynamespace pod
与运行中的 Pods 进行交互
kubectl logs my-pod # 获取 pod 日志(标准输出)
kubectl logs -l name=myLabel # 获取含 name=myLabel 标签的 Pods 的日志(标准输出)
kubectl logs my-pod --previous # 获取上个容器实例的 pod 日志(标准输出)
kubectl logs my-pod -c my-container # 获取 Pod 容器的日志(标准输出, 多容器场景)
kubectl logs -l name=myLabel -c my-container # 获取含 name=myLabel 标签的 Pod 容器日志(标准输出, 多容器场景)
kubectl logs my-pod -c my-container --previous # 获取 Pod 中某容器的上个实例的日志(标准输出, 多容器场景)
kubectl logs -f my-pod # 流式输出 Pod 的日志(标准输出)
kubectl logs -f my-pod -c my-container # 流式输出 Pod 容器的日志(标准输出, 多容器场景)
kubectl logs -f -l name=myLabel --all-containers # 流式输出含 name=myLabel 标签的 Pod 的所有日志(标准输出)
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 并将其规约写入到名为 pod.yaml 的文件
–dry-run=client -o yaml > pod.yaml
kubectl attach my-pod -i # 挂接到一个运行的容器中
kubectl port-forward my-pod 5000:6000 # 在本地计算机上侦听端口 5000 并转发到 my-pod 上的端口 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 和其中容器的监控数据
kubectl top pod POD_NAME --sort-by=cpu # 显示给定 Pod 的指标并且按照 ‘cpu’ 或者 ‘memory’ 排序
与 Deployments 和 Services 进行交互
kubectl logs deploy/my-deployment # 获取一个 Deployment 的 Pod 的日志(单容器例子)
kubectl logs deploy/my-deployment -c my-container # 获取一个 Deployment 的 Pod 的日志(多容器例子)
kubectl port-forward svc/my-service 5000 # 侦听本地端口 5000 并转发到 Service 后端端口 5000
kubectl port-forward svc/my-service 5000:my-service-port # 侦听本地端口 5000 并转发到名字为 的 Service 目标端口
kubectl port-forward deploy/my-deployment 5000:6000 # 侦听本地端口 5000 并转发到 创建的 Pod 里的端口 6000
kubectl exec deploy/my-deployment – ls # 在 Deployment 里的第一个 Pod 的第一个容器里运行命令(单容器和多容器例子)
节点维护,驱逐,集群,污点
kubectl cordon my-node # 标记 my-node 节点为不可调度
kubectl drain my-node # 对 my-node 节点进行清空操作,为节点维护做准备
kubectl uncordon my-node # 标记 my-node 节点为可以调度
kubectl top node my-node # 显示给定节点的度量值
kubectl cluster-info # 显示主控节点和服务的地址
kubectl cluster-info dump # 将当前集群状态转储到标准输出
kubectl cluster-info dump --output-directory=/path/to/cluster-state # 将当前集群状态输出到 /path/to/cluster-state
如果已存在具有指定键和效果的污点,则替换其值为指定值。
kubectl taint nodes foo dedicated=special-user:NoSchedule
添加污点
kubectl taint nodes node1 key=value:NoSchedule
删除污点
kubectl taint nodes node1 key=value:NoSchedule-
资源类型
列出所支持的全部资源类型
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 组中的所有资源
查看pod日志
kubectl logs -f podname -n namepsace #查看pod输出日志,-f为持续打印
kubectl logs -f podname containername -n namepsace #pod中多个container时可以指定查看某个容器日志