kubernetes系列05—kubectl应用快速入门
本文收录在
1、使用kubectl
1.1 介绍
kubectl用于运行kubernetes集群命令的管理工具。
1.2 语法
kubectl [command] [type] [name] [flags]
- command：指定要在一个或多个资源执行的操作，例如操作create，get，describe，delete。type：指定资源类型resource types。
- name区分大小写，如果省略name，则显示所有资源的详细信息，例如：$ kubectl get pods。
1.3 选项
|
operation |
description |
syntax |
|
annotate |
为一个或多个资源添加注释 |
kubectl annotate (-f filename | type name | type/name) key_1=val_1 ... key_n=val_n [--overwrite] [--all] [--resource-version=version] [flags] |
|
api-versions |
列出支持的api版本。 |
kubectl api-versions [flags] |
|
apply |
对文件或stdin的资源进行配置更改。 |
kubectl apply -f filename [flags] |
|
attach |
连接到一个运行的容器，既可以查看output stream，也可以与容器(stdin)进行交互。 |
kubectl attach pod -c container [-i] [-t] [flags] |
|
autoscale |
自动扩容/缩容由replication controller管理的一组pod。 |
kubectl autoscale (-f filename | type name | type/name) [--min=minpods] --max=maxpods [--cpu-percent=cpu] [flags] |
|
cluster-info |
显示有关集群中master和services的终端信息。 |
kubectl cluster-info [flags] |
|
config |
修改kubeconfig文件。有关详细信息，请参阅各个子命令。 |
kubectl config subcommand [flags] |
|
create |
从file或stdin创建一个或多个资源。 |
kubectl create -f filename [flags] |
|
delete |
从file，stdin或指定label 选择器，names，resource选择器或resources中删除resources。 |
kubectl delete (-f filename | type [name | /name | -l label | --all]) [flags] |
|
describe |
显示一个或多个resources的详细状态。 |
kubectl describe (-f filename | type [name_prefix | /name | -l label]) [flags] |
|
edit |
使用默认编辑器编辑和更新服务器上一个或多个定义的资源。 |
kubectl edit (-f filename | type name | type/name) [flags] |
|
exec |
对pod中的容器执行命令。 |
kubectl exec pod [-c container] [-i] [-t] [flags] [-- command [args...]] |
|
explain |
获取各种资源的文档。例如pod，node，services等 |
kubectl explain [--include-extended-apis=true] [--recursive=false] [flags] |
|
expose |
将 replication controller，service或pod作为一个新的kubernetes service显示。 |
kubectl expose (-f filename | type name | type/name) [--port=port] [--protocol=tcp|udp] [--target-port=number-or-name] [--name=name] [----external-ip=external-ip-of-service] [--type=type] [flags] |
|
get |
列出一个或多个资源。 |
kubectl get (-f filename | type [name | /name | -l label]) [--watch] [--sort-by=field] [[-o | --output]=output_format] [flags] |
|
label |
添加或更新一个或多个资源的flags。 |
kubectl label (-f filename | type name | type/name) key_1=val_1 ... key_n=val_n [--overwrite] [--all] [--resource-version=version] [flags] |
|
logs |
在pod中打印容器的日志。 |
kubectl logs pod [-c container] [--follow] [flags] |
|
patch |
使用strategic merge 补丁程序更新资源的一个或多个字段。 |
kubectl patch (-f filename | type name | type/name) --patch patch [flags] |
|
port-forward |
将一个或多个本地端口转发到pod。 |
kubectl port-forward pod [local_port:]remote_port [...[local_port_n:]remote_port_n] [flags] |
|
proxy |
在kubernetes api服务器运行代理。 |
kubectl proxy [--port=port] [--www=static-dir] [--www-prefix=prefix] [--api-prefix=prefix] [flags] |
|
replace |
从file或stdin替换资源。 |
kubectl replace -f filename |
|
rolling-update |
通过逐步替换指定的replication controller及其pod来执行滚动更新。 |
kubectl rolling-update old_controller_name ([new_controller_name] --image=new_container_image | -f new_controller_spec) [flags] |
|
run |
在集群上运行指定的镜像。 |
kubectl run name --image=image [--env="key=value"] [--port=port] [--replicas=replicas] [--dry-run=bool] [--overrides=inline-json] [flags] |
|
scale |
更新指定replication controller的大小。 |
kubectl scale (-f filename | type name | type/name) --replicas=count [--resource-version=version] [--current-replicas=count] [flags] |
|
stop |
已弃用 |
kubectl stop |
|
version |
显示客户端和服务器上运行的kubernetes版本。 |
kubectl version [--client] [flags] |
1.4 示例演示
（1）简单的查询操作
查询节点详细信息
[root@master ~]# kubectl describe node node1
name: node1
roles: <none>
labels: beta.kubernetes.io/arch=amd64
... ...
查看版本
[root@master ~]# kubectl version
client version: version.info{major:"1", minor:"11", gitversion:"v1.11.1", gitcommit:"bb9ffb1654d4a729bb4cec18ff088eacc153c239", gittreestate:"clean", builddate:"2018-08-07t23:17:28z", goversion:"go1.10.3", compiler:"gc", platform:"linux/amd64"}
server version: version.info{major:"1", minor:"11", gitversion:"v1.11.1", gitcommit:"b1b29978270dc22fecc592ac55d903350454310a", gittreestate:"clean", builddate:"2018-07-17t18:43:26z", goversion:"go1.10.3", compiler:"gc", platform:"linux/amd64"}
查看集群信息
[root@master ~]# kubectl cluster-info
kubernetes master is running at https://192.168.10.103:6443
kubedns is running at https://192.168.10.103:6443/api/v1/namespaces/kube-system/services/kube-dns:dns/proxy
2、run运行
2.1 介绍
创建并运行一个或多个容器镜像。
2.2 命令
$ kubectl run name --image=image [--env="key=value"] [--port=port] [--replicas=replicas] [--dry-run=bool] [--overrides=inline-json] [--command] -- [command] [args...] [options]
2.3 常用选项
- --port：要暴露的端口
- --replicas：期望创建几个pod，默认1个
- --dry-run：true为干跑
2.4 演示
（1）运行一个nginx的pod
[root@master ~]# kubectl run nginx-deploy --image=nginx:1.14-alpine --port=80 --replicas=1
deployment.apps/nginx-deploy created
（2）在master上查询验证
[root@master ~]# kubectl get deployment
name desired current up-to-date available age
nginx-deploy 1 1 1 1 44s
[root@master ~]# kubectl get pods
name ready status restarts age
nginx-deploy-5b595999-6kw54 1/1 running 0 51s
[root@master ~]# kubectl get pods -o wide
name ready status restarts age ip node
nginx-deploy-5b595999-6kw54 1/1 running 0 1m 10.244.2.2 node2
（3）在部署的node节点上查询
[root@node2 ~]# ifconfig |head -2
cni0: flags=4163<up,broadcast,running,multicast> mtu 1450
inet 10.244.2.1 netmask 255.255.255.0 broadcast 0.0.0.0
（4）访问pod内的nginx服务
[root@node1 ~]# curl 10.244.2.2
<!doctype html>
<html>
<head>
<title>welcome to nginx!</title>
3、delete删除
3.1 介绍
- 通过配置文件名、stdin、资源名称或label选择器来删除资源。
- 支持json和yaml格式文件。可以只指定一种类型的参数：文件名、资源名称或label选择器。
3.2 语法
$ kubectl delete ([-f filename] | type [(name | -l label | --all)])
3.3 演示
删除刚才的pod，立刻会生成一个新的pod，因为此pod是控制器管理的
[root@master ~]# kubectl delete pods nginx-deploy-5b595999-6kw54
pod "nginx-deploy-5b595999-6kw54" deleted
[root@master ~]# kubectl get pods
name ready status restarts age
nginx-deploy-5b595999-jf5gm 0/1 containercreating 0 16s
[root@master ~]# kubectl get pods -o wide
name ready status restarts age ip node
nginx-deploy-5b595999-jf5gm 1/1 running 0 47s 10.244.1.2 node1
4、expose暴露
4.1 介绍
- 将资源暴露为新的kubernetes service。
- 指定deployment、service、replica set、replication controller或pod ，并使用该资源的选择器作为指定端口上新服务的选择器。deployment 或 replica set只有当其选择器可转换为service支持的选择器时，即当选择器仅包含matchlabels组件时才会作为暴露新的service。
- 资源包括(不区分大小写)：pod（po），service（svc），replication controller（rc），deployment（deploy），replica set（rs）
4.2 语法
$ kubectl expose (-f filename | type name) [--port=port] [--protocol=tcp|udp] [--target-port=number-or-name] [--name=name] [--external-ip=external-ip-of-service] [--type=type]
4.3 常用选项
- --port：暴露在service上的端口
- --target-port：容器中的端口
4.4 演示
（1）将nginx-deploy控制器中相关的pod资源创建一个名为nginx的服务
[root@master ~]# kubectl expose deployment nginx-deploy --name=nginx --port=80 --target-port=80 --protocol=tcp
service/nginx exposed
[root@master ~]# kubectl get services
name type cluster-ip external-ip port(s) age
kubernetes clusterip 10.96.0.1 <none> 443/tcp 16h
nginx clusterip 10.96.212.79 <none> 80/tcp 9s
[root@master ~]# kubectl get svc #简写
name type cluster-ip external-ip port(s) age
kubernetes clusterip 10.96.0.1 <none> 443/tcp 16h
nginx clusterip 10.96.212.79 <none> 80/tcp 13s
（2）验证，在集群内部节点访问服务
[root@master ~]# curl 10.96.212.79
<!doctype html>
<html>
<head>
<title>welcome to nginx!</title>
（3）删除pod，立即生产新的pod，但是service还是不变，继续提供服务，只是指定到新的pod
---删除pod
[root@master ~]# kubectl delete pods nginx-deploy-5b595999-jf5gm
---立即生产新的pod，service继续提供服务
[root@master ~]# curl 10.96.212.79
<!doctype html>
<html>
<head>
<title>welcome to nginx!</title>
---指定到新的pod
[root@master ~]# kubectl get pod -o wide
name ready status restarts age ip node
nginx-deploy-5b595999-2z769 1/1 running 0 29m 10.244.1.2 node2
[root@master ~]# kubectl describe svc nginx
name: nginx
namespace: default
labels: run=nginx-deploy
annotations: <none>
selector: run=nginx-deploy
type: clusterip
ip: 10.96.212.79
port: <unset> 80/tcp
targetport: 80/tcp
endpoints: 10.244.1.2:80
session affinity: none
events: <none>
5、scale动态扩容/缩容
5.1 介绍
- 扩容或缩容 deployment、replicaset、replication controller或 job 中pod数量。
- scale也可以指定多个前提条件，如：当前副本数量或 --resource-version ，进行伸缩比例设置前，系统会先验证前提条件是否成立。
5.2 语法
$ kubectl scale [--resource-version=version] [--current-replicas=count] --replicas=count (-f filename | type name)
5.3 演示
（1）先运行名为myapp标签选择器的2个pod，镜像是我用于测试演示自己构建的
[root@master ~]# kubectl run myapp --image=ikubernetes/myapp:v1 --replicas=2
deployment.apps/myapp created
[root@master ~]# kubectl get deployment
name desired current up-to-date available age
myapp 2 2 2 2 6s
[root@master ~]# kubectl get pods -o wide
name ready status restarts age ip node
myapp-848b5b879b-58jcr 1/1 running 0 11s 10.244.2.53 node2
myapp-848b5b879b-wpx9v 1/1 running 0 11s 10.244.1.56 node1
（2）创建service，并验证
[root@master ~]# kubectl expose deployment myapp --name=myapp --port=80
service/myapp exposed
[root@master ~]# kubectl get svc myapp
name type cluster-ip external-ip port(s) age
myapp clusterip 10.104.205.158 <none> 80/tcp 8s
[root@master ~]# curl 10.104.205.158
hello myapp | version: v1 | <a href="hostname.html">pod name</a>
---因为有2个pod，所以是随机调度
[root@master ~]# curl 10.104.205.158/hostname.html
myapp-848b5b879b-58jcr
[root@master ~]# curl 10.104.205.158/hostname.html
myapp-848b5b879b-wpx9v
（3）使用scale，将pod扩容到5个
[root@master ~]# kubectl scale --replicas=5 deployment myapp
deployment.extensions/myapp scaled
[root@master ~]# kubectl get pods
name ready status restarts age
myapp-848b5b879b-2sj8n 1/1 running 0 8s
myapp-848b5b879b-58jcr 1/1 running 0 4m
myapp-848b5b879b-hp7zs 1/1 running 0 8s
myapp-848b5b879b-sfq8r 1/1 running 0 8s
myapp-848b5b879b-wpx9v 1/1 running 0 4m
（4）使用scale，将pod缩容到3个
[root@master ~]# kubectl scale --replicas=3 deployment myapp
[root@master ~]# kubectl get pods
name ready status restarts age
myapp-848b5b879b-2sj8n 1/1 running 0 1m
myapp-848b5b879b-58jcr 1/1 running 0 6m
myapp-848b5b879b-wpx9v 1/1 running 0 6m
6、set动态升级版本
6.1 介绍
（1）set
- 配置应用资源。
- 使用这些命令能帮你更改现有应用资源一些信息。
- 子命令：image、resources、selector、subject
（2）set image
- 更新现有的资源对象的容器镜像。
- 可使用资源对象包括（不区分大小写）：pod (po)、replicationcontroller (rc)、deployment (deploy)、daemonset (ds)、job、replicaset (rs)
6.2 语法
$ kubectl set image (-f filename | type name) container_name_1=container_image_1 ... container_name_n=container_image_n
6.3 演示
将镜像版本从v1升级到v2版
[root@master ~]# kubectl set image deployment myapp myapp=ikubernetes/myapp:v2
deployment.extensions/myapp image updated
[root@master ~]# kubectl rollout status deployment myapp #动态显示版本升级过程
---因为版本升级，所以pod都是新建的，名字都改变了
[root@master ~]# kubectl get pods
name ready status restarts age
client 1/1 running 0 3h
myapp-74c94dcb8c-d5fgk 1/1 running 0 55s
myapp-74c94dcb8c-f2ntn 1/1 running 0 21s
myapp-74c94dcb8c-ht9v7 1/1 running 0 38s
---验证，版本升级成功
[root@master ~]# curl 10.104.205.158
hello myapp | version: v2 | <a href="hostname.html">pod name</a>
7、rollout undo回滚版本
7.1 介绍
（1）rollout
- 对资源进行管理
- 可用资源包括：deployments、daemonsets
- 子命令：history（查看历史版本）、pause（暂停资源）、resume（恢复暂停资源）、status（查看资源状态）、undo（回滚版本）
（2）rollout undo
回滚pod到之前的版本。
7.2 语法
$ kubectl rollout undo (type name | type/name) [flags]
7.3 演示
[root@master ~]# kubectl rollout undo deployment myapp
deployment.extensions/myapp
[root@master ~]# kubectl get pods
name ready status restarts age
myapp-848b5b879b-gg9lr 1/1 running 0 15s
myapp-848b5b879b-km4t6 1/1 running 0 16s
myapp-848b5b879b-nq98c 1/1 running 0 17s
---验证，回滚成功
[root@master ~]# curl 10.104.205.158
hello myapp | version: v1 | <a href="hostname.html">pod name</a>
8、edit编辑修改
8.1 介绍
- 使用默认编辑器，编辑服务器上定义的资源。
- 使用命令行工具获取的任何资源都可以使用edit命令编辑。edit命令会打开使用kube_editor，git_editor 或者editor环境变量定义的编辑器，可以同时编辑多个资源，但所编辑过的资源只会一次性提交。edit除命令参数外还接受文件名形式。
- 文件默认输出格式为yaml。要以json格式编辑，请指定“-o json”选项。
- 如果在更新资源时报错，将会在磁盘上创建一个临时文件来记录。在更新资源时最常见的错误是几个用户同时使用编辑器更改服务器上资源，发生这种情况，你需要将你的更改应用到最新版本的资源上，或者更新保存的临时副本。
8.2 语法
$ kubectl edit (resource/name | -f filename)
8.3 演示
（1）修改service，将类型type: clusterip，修改为type: nodeport；修改后，可以在集群外访问到pod中的服务
[root@master ~]# kubectl edit svc myapp
... ...
spec:
... ...
type: nodeport
... ...
service/myapp edited
[root@master ~]# kubectl get svc myapp
name type cluster-ip external-ip port(s) age
myapp nodeport 10.104.205.158 <none> 80:31599/tcp 23m
（2）在集群外的主机*问了
9、label标签
9.1 介绍
更新（增加、修改或删除）资源上的 label（标签）。
- label 必须以字母或数字开头，可以使用字母、数字、连字符、点和下划线，最长63个字符。
- 如果--overwrite 为 true，则可以覆盖已有的 label，否则尝试覆盖 label 将会报错。
- 如果指定了--resource-version，则更新将使用此资源版本，否则将使用现有的资源版本。
9.2 语法
$ kubectl label [--overwrite] (-f filename | type name) key_1=val_1 ... key_n=val_n [--resource-version=version]
9.3 演示
（1）运行一个标签为app=nginx的pod
[root@master ~]# kubectl run nginx --image=nginx:1.14-alpine --replicas=1 --labels="app=nginx"
deployment.apps/nginx created
（2）-l 指定标签，实现标签过滤
[root@master ~]# kubectl get pods --show-labels
name ready status restarts age labels
myapp-848b5b879b-5blnx 1/1 running 0 4m pod-template-hash=4046164356,run=myapp
myapp-848b5b879b-6hgpp 1/1 running 0 4m pod-template-hash=4046164356,run=myapp
myapp-848b5b879b-hzj5g 1/1 running 0 4m pod-template-hash=4046164356,run=myapp
nginx-86d5b5ddb6-rwv2z 1/1 running 0 53s app=nginx,pod-template-hash=4281618862
[root@master ~]# kubectl get pods --show-labels -l app
name ready status restarts age labels
nginx-86d5b5ddb6-rwv2z 1/1 running 0 1m app=nginx,pod-template-hash=4281618862
（3）打一个新的标签
[root@master ~]# kubectl label pods nginx-86d5b5ddb6-rwv2z release=canary
pod/nginx-86d5b5ddb6-rwv2z labeled
[root@master ~]# kubectl get pods --show-labels -l release
name ready status restarts age labels
nginx-86d5b5ddb6-rwv2z 1/1 running 0 4m app=nginx,pod-template-hash=4281618862,release=canary
（4）修改标签
[root@master ~]# kubectl label pods nginx-86d5b5ddb6-rwv2z release=stable --overwrite
pod/nginx-86d5b5ddb6-rwv2z labeled
[root@master ~]# kubectl get pods --show-labels -l release
name ready status restarts age labels
nginx-86d5b5ddb6-rwv2z 1/1 running 0 5m app=nginx,pod-template-hash=4281618862,release=stable
9.4 标签选择器
（1）等值关系：=，==，!=
[root@master ~]# kubectl get pods -l release --show-labels
name ready status restarts age labels
nginx-86d5b5ddb6-rwv2z 1/1 running 0 6m app=nginx,pod-template-hash=4281618862,release=stable
[root@master ~]# kubectl get pods -l release=stable --show-labels
name ready status restarts age labels
nginx-86d5b5ddb6-rwv2z 1/1 running 0 6m app=nginx,pod-template-hash=4281618862,release=stable
[root@master ~]# kubectl get pods -l release!=stable --show-labels
name ready status restarts age labels
myapp-848b5b879b-5blnx 1/1 running 0 10m pod-template-hash=4046164356,run=myapp
myapp-848b5b879b-6hgpp 1/1 running 0 10m pod-template-hash=4046164356,run=myapp
myapp-848b5b879b-hzj5g 1/1 running 0 10m pod-template-hash=4046164356,run=myapp
（2）集合关系
- key in (value1,value2,...)：集合中存在此健
- key notin (value1,value2,...)：集合中不存在此健
- key：存在此健
- !key：不存在此健
[root@master ~]# kubectl get pods -l "release in (stable,beta,alpha)"
name ready status restarts age
nginx-86d5b5ddb6-rwv2z 1/1 running 0 9m
[root@master ~]# kubectl get pods -l "release notin (stable,beta,alpha)"
name ready status restarts age
myapp-848b5b879b-5blnx 1/1 running 0 12m
myapp-848b5b879b-6hgpp 1/1 running 0 12m
myapp-848b5b879b-hzj5g 1/1 running 0 12m
未完待续，后续还会补充更多的kubectl 应用及演示。