在k8s中所有的内容都抽象为资源,资源实例化之后,叫做对象。一般使用yaml格式的文件来创建符合我们预期期望的pod,这样的yaml文件我们一般称为资源清单
资源清单的格式:
apiVersion: group/apiversion # 如果没有给定group名称,那么默认为croe,可以使用kubectl api-versions 获取当前k8s版本上所有的apiVersion版本信息(每个版本可能不同)
kind: #资源类别
metadata: #资源元数据
name
namespace #k8s自身的namespace
lables
annotations #主要目的是方便用户阅读查找
spec:期望的状态(disired state)
status:当前状态,本字段有kubernetes自身维护,用户不能去定义
使用kubectl explain 获取资源配置清单中各字段设置的帮助文档:
帮助信息中常见格式如下:
apiVersion <string> #表示字符串类型
metadata <Object> #表示需要嵌套多层字段,需要查看下一级的字段帮助信息
labels <map[string]string> #表示由k:v组成的映射
finalizers <[]string> #表示字串列表
ownerReferences <[]Object> #表示对象列表
hostPID <boolean> #布尔类型
priority <integer> #整型
name <string> -required- #如果类型后面接 -required-,表示为必填字段
----------------------------------------------------------------------------------------
一、前言
kubectl是apiserver的客户端工具,工作在命令行下,能够连接apiserver上实现各种增删改查等各种操作
kubectl官方使用文档:https://kubernetes.io/docs/reference/kubectl/overview/
二、设置kubectl输入命令自动补全
[root@k8s-master01 ~]# yum install -y bash-completion
[root@k8s-master01 ~]# source /usr/share/bash-completion/bash_completion
[root@k8s-master01 ~]# source <(kubectl completion bash)
[root@k8s-master01 ~]# echo "source <(kubectl completion bash)" >> ~/.bashrc
三、使用kubectl进行增、删、查、改等常用操作
1.查看kubectl命令帮助
[root@k8s-master01 ~]# kubectl -h
kubectl controls the Kubernetes cluster manager.
Find more information at: https://kubernetes.io/docs/reference/kubectl/overview/
Basic Commands (Beginner): #基本命令集,适合新手
create Create a resource from a file or from stdin.
expose 使用 replication controller, service, deployment 或者 pod 并暴露它作为一个 新的
Kubernetes Service
run 在集群中运行一个指定的镜像
set 为 objects 设置一个指定的特征
run-container 在集群中运行一个指定的镜像. This command is deprecated, use "run" instead
Basic Commands (Intermediate): #基本命令集,适合有一定基础的人
get 显示一个或更多 resources
explain 查看资源的文档
edit 在服务器上编辑一个资源
delete Delete resources by filenames, stdin, resources and names, or by resources and label selector
Deploy Commands: #发布相关的命令集
rollout Manage the rollout of a resource
rolling-update 完成指定的 ReplicationController 的滚动升级
scale 为 Deployment, ReplicaSet, Replication Controller 或者 Job 设置一个新的副本数量
autoscale 自动调整一个 Deployment, ReplicaSet, 或者 ReplicationController 的副本数量
Cluster Management Commands: #集群管理相关的命令集
certificate 修改 certificate 资源.
cluster-info 显示集群信息
top Display Resource (CPU/Memory/Storage) usage.
cordon 标记 node 为 unschedulable
uncordon 标记 node 为 schedulable
drain Drain node in preparation for maintenance
taint 更新一个或者多个 node 上的 taints
Troubleshooting and Debugging Commands: #故障检测及调试相关命令集
describe 显示一个指定 resource 或者 group 的 resources 详情
logs 输出容器在 pod 中的日志
attach Attach 到一个运行中的 container
exec 在一个 container 中执行一个命令
port-forward Forward one or more local ports to a pod
proxy 运行一个 proxy 到 Kubernetes API server
cp 复制 files 和 directories 到 containers 和从容器中复制 files 和 directories.
auth Inspect authorization
Advanced Commands: #高级命令集
apply 通过文件名或标准输入流(stdin)对资源进行配置
patch 使用 strategic merge patch 更新一个资源的 field(s)
replace 通过 filename 或者 stdin替换一个资源
convert 在不同的 API versions 转换配置文件
Settings Commands: #设置相关的命令集
label 更新在这个资源上的 labels
annotate 更新一个资源的注解
completion Output shell completion code for the specified shell (bash or zsh)
Other Commands: #其他命令集
api-versions Print the supported API versions on the server, in the form of "group/version"
config 修改 kubeconfig 文件
help Help about any command
plugin Runs a command-line plugin
version 输出 client 和 server 的版本信息
Usage: #使用格式
kubectl [flags] [options]
Use "kubectl <command> --help" for more information about a given command. #各个子命令如何获取命令帮助
Use "kubectl options" for a list of global command-line options (applies to all commands). #查看命令的通用选项(所有命令)
#可以看到,命令帮助很人性化的帮我们对各个命令做了划分,让我们可以更好的学习和使用,下面我们开始使用kubectl命令在命令行下测试相关命令的用法
2.创建一个应用程序
1)创建一个应用程序,我们使用 "kubectl run " 命令,是 "kubectl run -h" 查看命令使用帮助,命令说明告诉我们这个命令可以创建一个deployment或者job的容器(deployment和job是什么意思,我们后续再讲)
[root@k8s-master01 ~]# kubectl run nginx-deploy --image=nginx:1.14-alpine --port=80 --replicas=1 --dry-run=true #nginx-deploy表示deployment的名称 --image表示镜像的地址 --port表示pod暴露的端口 --replicas表示副本的个数 --dry-run表示测试,不真正执行命令
NAME AGE
nginx-deploy <unknown>
[root@k8s-master01 ~]# kubectl run nginx-deploy --image=nginx:1.14-alpine --port=80 --replicas=1 #测试发现命令正常,执行命令
deployment.apps "nginx-deploy" created #提示我们创建成功了
[root@k8s-master01 ~]# kubectl get deployment #我们查看一下deployment的信息,是否有当前创建的
NAME(名称) DESIRED(需要pod的个数) CURRENT(当前已经存在的个数) UP-TO-DATE(最新创建的pod个数) AVAILABLE(可用的pod个数) AGE(deployment存活的时间)
nginx-deploy 1 1 1 1 12s
[root@k8s-master01 ~]# kubectl get pod -o wide #获取pod的信息,-o wide 表示更详细的显示信息
NAME(pod的名称) READY(就绪的个数/总的个数) STATUS(目前的状态) RESTARTS(重启的次数) AGE(存活的时间) IP(pod的IP地址) NODE(部署在哪个节点)
nginx-deploy-7db697dfbd-qkdqp 1/1 Running 0 19s 10.244.2.2 k8s-node02
2)下面我们来访问一下这个nginx pod
集群内访问
[root@k8s-master01 ~]# curl -I 10.244.2.2 #在集群内进行访问,返回状态码为200,访问没有问题
HTTP/1.1 200 OK
Server: nginx/1.14.0
Date: Tue, 30 Oct 2018 03:20:33 GMT
Content-Type: text/html
Content-Length: 612
Last-Modified: Wed, 12 Sep 2018 00:04:31 GMT
Connection: keep-alive
ETag: "5b98580f-264"
Accept-Ranges: bytes
集群外部访问
当我们在集群之外访问是发现无法访问,那么集群之外的客户端如何才能访问呢?这就需要我们的service服务了,下面我们就创建一个service,是外部客户端可以访问我们的pod
3)创建一个service
[root@k8s-master01 ~]# kubectl expose deployment nginx-deploy --name=nginx --port=80 --target-port=80 --type=NodePort #
service "nginx" exposed #使用kubectl expose 可以创建一个service ,可以使用 kubectl expose -h命令查看命令帮助,由于篇幅有限,各参数含义参考命令帮助
[root@k8s-master01 ~]# kubectl get svc -o wide #查看我们service的详细信息
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE SELECTOR
kubernetes ClusterIP 10.96.0.1 <none> 443/TCP 54m <none>
nginx NodePort 10.107.16.3 <none> 80:30757/TCP 56s run=nginx-deploy #这是我们新创建service的信息,使用30757端口进行映射
使用集群外客户端再一次访问,需要使用集群任意节点的IP地址加上暴露的端口号
service服务有个特点,如果端口暴露类型为NodePort,那么可以通过集群内任意一台主机加暴露的端口进行访问
4)现在我们来删除刚刚参加的pod,看看会发生什么
[root@k8s-master01 ~]# kubectl get pod
NAME READY STATUS RESTARTS AGE
nginx-deploy-7db697dfbd-qkdqp 1/1 Running 0 2h
[root@k8s-master01 ~]# kubectl delete pod nginx-deploy-7db697dfbd-qkdqp #删除deployment下的pod
pod "nginx-deploy-7db697dfbd-qkdqp" deleted
[root@k8s-master01 ~]# kubectl get pod -w #然后迅速的查看pod状态,-w是一直等待的意思,我们可以看到pod被删除后系统又自动创建一个新的pod (deployment管理的pod会尽量一直保持我们期望的状态)
NAME READY STATUS RESTARTS AGE
nginx-deploy-7db697dfbd-46x7s 0/1 ContainerCreating 0 6s
nginx-deploy-7db697dfbd-46x7s 1/1 Running 0 15s
查看下deployment和service的状态
NAME DESIRED CURRENT UP-TO-DATE AVAILABLE AGE
nginx-deploy 1 1 1 1 2h
[root@k8s-master01 ~]# kubectl get svc #service的名称和IP没有发生改变
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
kubernetes ClusterIP 10.96.0.1 <none> 443/TCP 2h
nginx NodePort 10.107.16.3 <none> 80:30757/TCP 1h
再一次访问service地址,看看是否可以访问成功
没有问题,为什么我们删除pod之后重新创建service还可创建成功呢?这是因为service和pod直接是使用标签来进行关联的
[root@k8s-master01 ~]# kubectl describe svc nginx #查看nginx的信息
Name: nginx
Namespace: default
Labels: run=nginx-deploy #我们看到nginx的标签为run=nginx-deploy
Annotations: <none>
Selector: run=nginx-deploy
Type: NodePort
IP: 10.107.16.3
Port: <unset> 80/TCP
TargetPort: 80/TCP
NodePort: <unset> 30757/TCP
Endpoints: 10.244.1.2:80
Session Affinity: None
External Traffic Policy: Cluster
Events: <none>
[root@k8s-master01 ~]# kubectl describe pod nginx-deploy-7db697dfbd-46x7s #在看下新创建的pod信息
Name: nginx-deploy-7db697dfbd-46x7s
Namespace: default
Node: k8s-node01/172.16.150.213
Start Time: Tue, 30 Oct 2018 13:06:02 +0800
Labels: pod-template-hash=3862538968
run=nginx-deploy #同样也拥有run=nginx-deploy的标签
Annotations: <none>
Status: Running
IP: 10.244.1.2
.......(以下省略)
5)下面我们来尝试手动对nginx-deploy这个deployment进行扩容和缩减操作
扩容:
[root@k8s-master01 ~]# kubectl get deployment
NAME DESIRED CURRENT UP-TO-DATE AVAILABLE AGE
nginx-deploy 1 1 1 1 2h
[root@k8s-master01 ~]# kubectl scale --replicas=5 deployment nginx-deploy #对名称为nginx-deploy类型为deployment的对象进行扩容,有初始的1个扩容到五个
deployment.extensions "nginx-deploy" scaled
[root@k8s-master01 ~]# kubectl get pod -w #我们可以看到pod扩容的过程
NAME READY STATUS RESTARTS AGE
nginx-deploy-7db697dfbd-46x7s 1/1 Running 0 14m
nginx-deploy-7db697dfbd-lr7wx 0/1 ContainerCreating 0 1s
nginx-deploy-7db697dfbd-sk48l 0/1 ContainerCreating 0 1s
nginx-deploy-7db697dfbd-tdtc8 0/1 ContainerCreating 0 1s
nginx-deploy-7db697dfbd-xg25w 0/1 ContainerCreating 0 1s
nginx-deploy-7db697dfbd-xg25w 1/1 Running 0 11s
nginx-deploy-7db697dfbd-lr7wx 1/1 Running 0 12s
nginx-deploy-7db697dfbd-sk48l 1/1 Running 0 12s
nginx-deploy-7db697dfbd-tdtc8 1/1 Running 0 12s
缩减:
[root@k8s-master01 ~]# kubectl scale --replicas=3 deployment nginx-deploy #使用replicas指定我们想要的个数即可
deployment.extensions "nginx-deploy" scaled
[root@k8s-master01 ~]# kubectl get pod -w
NAME READY STATUS RESTARTS AGE
nginx-deploy-7db697dfbd-46x7s 1/1 Running 0 16m
nginx-deploy-7db697dfbd-lr7wx 0/1 Terminating 0 2m
nginx-deploy-7db697dfbd-sk48l 0/1 Terminating 0 2m
nginx-deploy-7db697dfbd-tdtc8 1/1 Running 0 2m
nginx-deploy-7db697dfbd-xg25w 1/1 Running 0 2m
nginx-deploy-7db697dfbd-sk48l 0/1 Terminating 0 2m
nginx-deploy-7db697dfbd-sk48l 0/1 Terminating 0 2m
nginx-deploy-7db697dfbd-lr7wx 0/1 Terminating 0 2m
nginx-deploy-7db697dfbd-lr7wx 0/1 Terminating 0 2m
6.现在我们对nginx-deploy进行滚动升级及回滚操作,由1.14-alpine 升级到
1.15-alpine,并由1.15-alpine回滚到1.14-alpine版本(nginx在docker hub上版本信息:https://hub.docker.com/_/nginx/)
滚动升级:
[root@k8s-master01 ~]# kubectl set image deployment nginx-deploy nginx-deploy=nginx:1.15-alpine --record #具体命令及参数含义请参考命令帮助
deployment.apps "nginx-deploy" image updated
[root@k8s-master01 ~]# kubectl get pod -w #观察滚动升级的过程
NAME READY STATUS RESTARTS AGE
nginx-deploy-6c7dd4d9bf-c58mr 0/1 ContainerCreating 0 3s
nginx-deploy-6c7dd4d9bf-fvmt5 0/1 ContainerCreating 0 3s
nginx-deploy-7db697dfbd-46x7s 1/1 Running 0 27m
nginx-deploy-7db697dfbd-xg25w 1/1 Running 0 13m
nginx-deploy-6c7dd4d9bf-c58mr 1/1 Running 0 28s
nginx-deploy-7db697dfbd-xg25w 1/1 Terminating 0 13m
nginx-deploy-6c7dd4d9bf-lp7w2 0/1 Pending 0 0s
nginx-deploy-6c7dd4d9bf-lp7w2 0/1 Pending 0 0s
nginx-deploy-6c7dd4d9bf-lp7w2 0/1 ContainerCreating 0 0s
nginx-deploy-7db697dfbd-xg25w 0/1 Terminating 0 13m
nginx-deploy-7db697dfbd-xg25w 0/1 Terminating 0 13m
nginx-deploy-7db697dfbd-xg25w 0/1 Terminating 0 13m
nginx-deploy-6c7dd4d9bf-fvmt5 1/1 Running 0 30s
nginx-deploy-7db697dfbd-46x7s 1/1 Terminating 0 27m
nginx-deploy-7db697dfbd-46x7s 0/1 Terminating 0 27m
nginx-deploy-7db697dfbd-46x7s 0/1 Terminating 0 27m
nginx-deploy-7db697dfbd-46x7s 0/1 Terminating 0 27m
^C[root@k8s-master01 ~]# kubectl get pod
NAME READY STATUS RESTARTS AGE
nginx-deploy-6c7dd4d9bf-c58mr 1/1 Running 0 41s
nginx-deploy-6c7dd4d9bf-fvmt5 1/1 Running 0 41s
nginx-deploy-6c7dd4d9bf-lp7w2 0/1 ContainerCreating 0 13s
[root@k8s-master01 ~]# kubectl get pod #查看最后的状态,比对一下现在的pod和之前的pod是否相同
NAME READY STATUS RESTARTS AGE
nginx-deploy-6c7dd4d9bf-c58mr 1/1 Running 0 1m
nginx-deploy-6c7dd4d9bf-fvmt5 1/1 Running 0 1m
nginx-deploy-6c7dd4d9bf-lp7w2 1/1 Running 0 45s
查看任意一个pod的信息,看看镜像是否升级
[root@k8s-master01 ~]# kubectl describe pod nginx-deploy-6c7dd4d9bf-c58mr
Name: nginx-deploy-6c7dd4d9bf-c58mr
Namespace: default
Node: k8s-node02/172.16.150.214
Start Time: Tue, 30 Oct 2018 13:33:15 +0800
Labels: pod-template-hash=2738808569
run=nginx-deploy
Annotations: <none>
Status: Running
IP: 10.244.2.5
Controlled By: ReplicaSet/nginx-deploy-6c7dd4d9bf
Containers:
nginx-deploy:
Container ID: docker://934e8074c90e0a5114ae846a2405515885efbcf1fcba8653a66d303f94e47253
Image: nginx:1.15-alpine #image信息
Image ID: docker-pullable://docker.io/nginx@sha256:ae5da813f8ad7fa785d7668f0b018ecc8c3a87331527a61d83b3b5e816a0f03c
......(以下省略)
版本回滚:
[root@k8s-master01 ~]# kubectl rollout undo deployment nginx-deploy #--to-revision 参数可以指定回退的版本
deployment.apps "nginx-deploy"
[root@k8s-master01 ~]# kubectl get pod -w
NAME READY STATUS RESTARTS AGE
nginx-deploy-6c7dd4d9bf-c58mr 1/1 Running 0 7m
nginx-deploy-6c7dd4d9bf-fvmt5 1/1 Running 0 7m
nginx-deploy-6c7dd4d9bf-lp7w2 0/1 Terminating 0 7m
nginx-deploy-7db697dfbd-gskcv 0/1 ContainerCreating 0 4s
nginx-deploy-7db697dfbd-ssws8 0/1 ContainerCreating 0 4s
nginx-deploy-7db697dfbd-ssws8 1/1 Running 0 11s
nginx-deploy-6c7dd4d9bf-fvmt5 1/1 Terminating 0 7m
nginx-deploy-7db697dfbd-2qh7v 0/1 Pending 0 0s
nginx-deploy-7db697dfbd-2qh7v 0/1 Pending 0 0s
nginx-deploy-7db697dfbd-2qh7v 0/1 ContainerCreating 0 0s
nginx-deploy-6c7dd4d9bf-fvmt5 0/1 Terminating 0 7m
nginx-deploy-6c7dd4d9bf-lp7w2 0/1 Terminating 0 7m
nginx-deploy-6c7dd4d9bf-lp7w2 0/1 Terminating 0 7m
....(以下省略)
查看任意一个pod的信息,看看镜像是否回滚到1.14-alpine版本
[root@k8s-master01 ~]# kubectl get pod
NAME READY STATUS RESTARTS AGE
nginx-deploy-7db697dfbd-2qh7v 1/1 Running 0 5m
nginx-deploy-7db697dfbd-gskcv 1/1 Running 0 5m
nginx-deploy-7db697dfbd-ssws8 1/1 Running 0 5m
[root@k8s-master01 ~]# kubectl describe pod nginx-deploy-7db697dfbd-2qh7v #查看任意一个pod的版本信息,查看是否回滚到1.14版本
Name: nginx-deploy-7db697dfbd-2qh7v
Namespace: default
Node: k8s-node02/172.16.150.214
Start Time: Tue, 30 Oct 2018 13:40:55 +0800
Labels: pod-template-hash=3862538968
run=nginx-deploy
Annotations: <none>
Status: Running
IP: 10.244.2.7
Controlled By: ReplicaSet/nginx-deploy-7db697dfbd
Containers:
nginx-deploy:
Container ID: docker://b75740e5919bd975755b256c83e03b63ea95cf2307ffc606abd03b59fea6634a
Image: nginx:1.14-alpine
Image ID: docker-pullable://docker.io/nginx@sha256:8976218be775f4244df2a60a169d44606b6978bac4375192074cefc0c7824ddf
下面我们对刚刚操作的命令做一个大致的总结:
kubectl run #创建一个deployment或job来管理创建的容器
kubectl get #显示一个或多个资源,可以使用标签过滤,默认查看当前名称空间的资源
kubectl expose #将一个资源暴露为一个新的kubernetes的service资源,资源包括pod (po), service (svc), replicationcontroller (rc),deployment(deploy), replicaset (rs)
kubectl describe #显示特定资源或资源组的详细信息
kubectl scale #可以对Deployment, ReplicaSet, Replication Controller, 或者StatefulSet设置新的值,可以指定一个或多个先决条件
kubectl set #更改现有的应用程序资源
kubectl rollout #资源回滚管理