Kubernetes资源清单

什么叫资源?
k8s中所有的内容都抽象为资源,资源实例化之后,叫做对象

在k8s中有哪些资源?
工作负载型资源(workload)
Pod、ReplicaSet、Deployment、StatefulSet、DaemonSet、Job、CronJob(ReplicationController在v1.11版本被废弃)

服务发现及负载均衡型资源(ServiceDiscovery LoadBalance):
Service、Ingress、...

配置与存储型资源:
Volume(存储卷)、CSI(容器存储接口,可以扩展各种各样的第三方存储卷)

特殊类型的存储卷:
ConfigMap(当配置中心来使用的资源类型)、Secret(保存敏感数据)、DownwardAPI(把外部环境中的信息输出给容器)
以上这些资源都是配置在名称空间级别

集群级资源:
Namespace、Node、Role、ClusterRole、RoleBinding(角色绑定)、ClusterRoleBinding(集群角色绑定)

元数据型资源:
HPA(Pod水平扩展)、PodTemplate(Pod模板,用于让控制器创建Pod时使用的模板)、LimitRange(用来定义硬件资源限制的)


资源清单
什么是资源清单
在k8s中,一般使用yaml格式的文件来创建符合我们预期期望的pod,这样的yaml文件我们一般称为资源清单

创建资源的方法
apiserver 仅接受JSON格式的资源定义;
yaml格式提供配置清单,apiserver 可自动将其转为JSON格式,而后再提交;

资源清单的格式
apiserver:group/version  如果没有给定group名称,那么默认为croe,可以使用kubectl api-versions 获取当前k8s版本上所有的apiVersion版本信息(每个版本可能不同)
kind:资源类别
metadata:元数据
name:名称
namespace:名称空间
labels:标签
annotation:资源注解,主要目的是方便用户阅读查找
spec:期望的状态(disired state),期望资源应该用于什么特性
status:当前状态(current state),本字段由kubernetes集群维护,用户不能自己定义

获取apiVersion版本信息
[root@k8smaster01 ~]# kubectl api-versions
apps/v1beta1
authentication.k8s.io/v1beta1
authorization.k8s.io/v1beta1
autoscaling/v1
batch/v1
certificates.k8s.io/v1alpha1
extensions/v1beta1
policy/v1beta1
rbac.authorization.k8s.io/v1alpha1
storage.k8s.io/v1beta1
v1
[root@k8smaster01 ~]#

获取资源的apiVersion版本信息
[root@k8smaster01 ~]# kubectl explain pod
DESCRIPTION:
Pod is a collection of containers that can run on a host. This resource is created by clients and scheduled onto hosts.

FIELDS:
   apiVersion    
     APIVersion defines the versioned schema of this representation of an
     object. Servers should convert recognized schemas to the latest internal
     value, and may reject unrecognized values. More info:
     http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#resources

   kind    
     Kind is a string value representing the REST resource this object
     represents. Servers may infer this from the endpoint the client submits
     requests to. Cannot be updated. In CamelCase. More info:
     http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds

   metadata    
     Standard object's metadata. More info:
     http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata

   spec    
     Specification of the desired behavior of the pod. More info:
     http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#spec-and-status

   status    
     Most recently observed status of the pod. This data may not be up to date.
     Populated by the system. Read-only. More info:
     http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#spec-and-status
[root@k8smaster01 ~]#
帮助信息中常见格式如下:
apiVersion  表示字符串类型
metadata  表示需要嵌套多层字段
labels  表示由k:v组成的映射
finalizers <[]string>  表示字串列表
ownerReferences <[]Object>  表示对象列表
hostPID  布尔类型
priority  整型
name -required-  如果类型后面接 -required-,表示为必填字段


必须存在的属性
version(String):k8s api的版本,目前基本是V1,可以使用kubectl api-versions命令查询
kind(String):yaml文件定义的资源类型和角色,,比如Pod
metadata(Object):元数据对象,固定值就写metadata
metadata.name(String):元数据对象的名字,由我们编写,如定义Pod的名字
metadata.namespace:元数据对象的命名空间,由我们自身定义
Spec(Object):详细定义对象,固定值就写Spec
spec.containers[](list):Spec对象的容器列表定义,是个列表
spec.containers[].name(String):定义容器的名字
spec.containers[].image(String):容器用到的镜像名称

主要的属性:
spec.containers[].name(String):容器的名称
spec.containers[].imagePullPolicy(String):定义镜像拉取策略,有Always(每次都尝试重新拉取镜像)、Never(仅使用本地镜像)、IfNotPresent(如果本地有镜像就使用本地镜像,没有则拉取镜像)三个值可选,默认是Always
spec.containers[].command[](List):指定容器启动命令,因为是数组可以指定多个,不指定则使用镜像打包时使用的启动命令
spec.containers[].args[](List):指定容器启动命令参数,因为是数组可以指定多个
spec.containers[].workingDir(String):指定容器的工作目录
spec.containers[].volumeMounts[](List):指定容器内部的存储卷配置
spec.containers[].volumeMounts[].name(String):指定被容器挂载的存储卷的名称
spec.containers[].volumeMounts[].mountPath(String):指定被容器挂载的存储卷的路径
spec.containers[].volumeMounts[].readOnly(String):设置存储卷路径的读写模式,true或者false,默认为读写模式
spec.containers[].ports[](List):指定容器需要用到的端口列表
spec.containers[].ports[].name(String):指定端口名称
spec.containers[].ports[].containerPort(String):指定容器需要监听的端口号
spec.containers[].ports[].hostPort(String):指定容器所在主机需要监听的端口号,默认跟containerPort相同,注意设置了hostPort,同一台主机无法启动该容器的相同副本(因为主机的端口号不能相同,会冲突)
spec.containers[].ports[].protocol(String):指定端口协议,支持TCP和UDP,默认值是TCP
spec.containers[].env[](List):指定容器运行前需要设置的环境变量列表
spec.containers[].env[].name(String):指定环境变量名称
spec.containers[].env[].value(String):指定环境变量值
spec.containers[].resources(Object):指定资源限制和资源请求的值
spec.containers[].resources.limits(Object):指定设置容器运行时资源的运行上限
spec.containers[].resources.limits.cpu(String):指定cpu的限制,单位为core数,将用于docker run --cpu-shares参数
spec.containers[].resources.limits.memory(String):指定mem内存的限制
spec.containers[].resources.requests(Object):指定容器启动和调度时的限制设置
spec.containers[].resources.requests.cpu(String):cpu请求,单位为core数,容器启动时初始化可用数量
spec.containers[].resources.requests.memory(String):内存请求,容器启动的初始化可用数量

额外属性
spec.restartPolicy(String):定义Pod的重启策略,可选值为Always(Pod一旦终止运行,则无论容器是如何终止的,kubelet服务都将重启它)、OnFailure(只有Pod以非零码终止时,kubelet才会重启该容器,如果是正常结束,退出码为0,则kubelet将不会重启它)、Never(Pod终止后,kubelet将退出码报告给master,不会重启该Pod)
spec.nodeSelector(Object):定义Node的Label过滤标签,以key:value格式指定
spec.imagePullSecrets(Object):定义pull镜像时使用secret名称,以name:secretkey格式指定
spec.hostNetwork(Boolean):定义是否使用主机网络模式,默认值为false,设置true表示使用宿主机网络,不使用docker网桥,同时设置了true将无法在同一台宿主机上启动第二个副本

创建一个配置清单实例
[root@k8smaster01 k8s]# more nginx-pod.yaml 
apiVersion: v1
kind: Pod
metadata:
  name: nginx
  labels:
     app: nginx
spec:
     containers:
     - name: nginx
       image: 192.168.23.134:5000/nginx
       imagePullPolicy: IfNotPresent
       ports:
       - containerPort: 80
     restartPolicy: Always

根据资源清单创建pod
[root@k8smaster01 k8s]# kubectl create -f nginx-pod.yaml 
pod "nginx" created
[root@k8smaster01 k8s]#
  
查看创建的 pod
[root@k8smaster01 k8s]# kubectl get pod
NAME      READY     STATUS    RESTARTS   AGE
nginx     1/1       Running   0          19s
[root@k8smaster01 k8s]#


获取刚创建pod-demo的详细信息:
[root@k8smaster01 k8s]# kubectl describe pods nginx
Name:        nginx
Namespace:    default
Node:        192.168.23.133/192.168.23.133
Start Time:    Fri, 07 Feb 2020 21:32:33 -0500
Labels:        app=nginx
Status:        Running
IP:        172.16.11.2
Controllers:    
Containers:
  nginx:
    Container ID:        docker://50d9170d9fc4176a3cb61c1560a9e410a9725d35bf37e20499a1327275b903ee
    Image:            192.168.23.134:5000/nginx
    Image ID:            docker-pullable://192.168.23.134:5000/nginx@sha256:89a42c3ba15f09a3fbe39856bddacdf9e94cd03df7403cad4fc105088e268fc9
    Port:            80/TCP
    State:            Running
      Started:            Fri, 07 Feb 2020 21:32:33 -0500
    Ready:            True
    Restart Count:        0
    Volume Mounts:        
    Environment Variables:    
Conditions:
  Type        Status
  Initialized     True 
  Ready     True 
  PodScheduled     True 
No volumes.
QoS Class:    BestEffort
Tolerations:    
Events:
  FirstSeen    LastSeen    Count    From                SubObjectPath        Type        Reason            Message
  ---------    --------    -----    ----                -------------        --------    ------            -------
  1m        1m        2    {kubelet 192.168.23.133}                Warning        MissingClusterDNS    kubelet does not have ClusterDNS IP configured and cannot create Pod using "ClusterFirst" policy. Falling back to DNSDefault policy.
  1m        1m        1    {kubelet 192.168.23.133}    spec.containers{nginx}    Normal        Pulled            Container image "192.168.23.134:5000/nginx" already present on machine
  1m        1m        1    {kubelet 192.168.23.133}    spec.containers{nginx}    Normal        Created            Created container with docker id 50d9170d9fc4; Security:[seccomp=unconfined]
  1m        1m        1    {kubelet 192.168.23.133}    spec.containers{nginx}    Normal        Started            Started container with docker id 50d9170d9fc4
  1m        1m        1    {default-scheduler }                    Normal        Scheduled        Successfully assigned nginx to 192.168.23.133
[root@k8smaster01 k8s]# 

你可能感兴趣的:(k8s)