004-k8s资源清单-01-yaml文件创建pod、deployment、service、secret、namespace等

一、概述

  上文使用kubectl run 或者kubectl expose等方式使用,其实不是常用方案,一般使用资源清单方式

  k8s中的资源、资源清单、常用字段解释、容器生命周期

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

1.1、k8s中的资源

资源分类:名称空间级别、集群级资源、元数据型资源

1.1.1、名称空间级别

  工作负载资源(workload):Pod、ReplicaSet、Deployment、StatefulSet、DaemonSet、Job、CronJob(ReplicationController 在v1.11版本放弃)

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

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

  特殊类型的存储卷:ConfigMap(当配置中心来使用的资源类型)Secret(保存敏感数据)DownwardAPI(把外部环境中的信息输出给容器) 

1.1.2、集群级资源

  Namespace、Node、Role、ClusterRole、RoleBinding、ClusterRoleBinding

1.1.3、元数据型资源

  HPA、PodTemplate、LimitRange

1.2、资源清单 yaml编写使用

  通过yaml格式文件来创建符合预期的pod ,一般统称为资源清单

  可以通过命令查看:kuibectl explain pod 具体属性可以使用:kubectl explain pod.spec

1.2.1、必选参数

参数名 字段类型 说明
apiVersion String k8s的api版本,目前均是v1,可以使用 kubectl api-version查看
kind String 使用yaml文件定义的资源类型和角色,如Pod
metadata Object 元数据对象
metadata.name String 元数据对象的名字,如Pod名称
metadata.namespace String 元数据对象的命名空间,自定义,默认是default。
spec Object 详细定义对象
spec.containers[] list 容器列表定义,是个list
spec.containers[].name String 容器名称
spec.containers[].image String 容器使用的镜像

1.2.2、pod的yaml模板

# yaml格式的pod定义文件完整内容:
apiVersion: v1       #必选,版本号,例如v1
kind: Pod       #必选,Pod
metadata:       #必选,元数据
  name: string       #必选,Pod名称
  namespace: string    #必选,Pod所属的命名空间
  labels:      #自定义标签
    - name: string     #自定义标签名字
  annotations:       #自定义注释列表
    - name: string
spec:         #必选,Pod中容器的详细定义
  containers:      #必选,Pod中容器列表
  - name: string     #必选,容器名称
    image: string    #必选,容器的镜像名称
    imagePullPolicy: [Always | Never | IfNotPresent] #获取镜像的策略 Alawys表示下载镜像 默认值; IfnotPresent表示优先使用本地镜像,否则下载镜像,Nerver表示仅使用本地镜像
    command: [string]    #容器的启动命令列表,如不指定,使用打包时使用的启动命令
    args: [string]     #容器的启动命令参数列表
    workingDir: string     #容器的工作目录
    volumeMounts:    #挂载到容器内部的存储卷配置
    - name: string     #引用pod定义的共享存储卷的名称,需用volumes[]部分定义的的卷名
      mountPath: string    #存储卷在容器内mount的绝对路径,应少于512字符
      readOnly: boolean    #是否为只读模式
    ports:       #需要暴露的端口库号列表
    - name: string     #端口号名称
      containerPort: int   #容器需要监听的端口号
      hostPort: int    #容器所在主机需要监听的端口号,默认与Container相同
      protocol: string     #端口协议,支持TCP和UDP,默认TCP
    env:       #容器运行前需设置的环境变量列表
    - name: string     #环境变量名称
      value: string    #环境变量的值
    resources:       #资源限制和请求的设置
      limits:      #资源限制的设置
        cpu: string    #Cpu的限制,单位为core数,将用于docker run --cpu-shares参数
        memory: string     #内存限制,单位可以为Mib/Gib,将用于docker run --memory参数
      requests:      #资源请求的设置
        cpu: string    #Cpu请求,容器启动的初始可用数量
        memory: string     #内存清楚,容器启动的初始可用数量
    livenessProbe:     #对Pod内个容器健康检查的设置,当探测无响应几次后将自动重启该容器,检查方法有exec、httpGet和tcpSocket,对一个容器只需设置其中一种方法即可
      exec:      #对Pod容器内检查方式设置为exec方式
        command: [string]  #exec方式需要制定的命令或脚本
      httpGet:       #对Pod内个容器健康检查方法设置为HttpGet,需要制定Path、port
        path: string
        port: number
        host: string
        scheme: string
        HttpHeaders:
        - name: string
          value: string
      tcpSocket:     #对Pod内个容器健康检查方式设置为tcpSocket方式
         port: number
       initialDelaySeconds: 0  #容器启动完成后首次探测的时间,单位为秒
       timeoutSeconds: 0   #对容器健康检查探测等待响应的超时时间,单位秒,默认1秒
       periodSeconds: 0    #对容器监控检查的定期探测时间设置,单位秒,默认10秒一次
       successThreshold: 0
       failureThreshold: 0
       securityContext:
         privileged:false
    restartPolicy: [Always | Never | OnFailure]#Pod的重启策略,Always表示一旦不管以何种方式终止运行,默认值,kubelet都将重启,OnFailure表示只有Pod以非0退出码退出才重启,Nerver表示不再重启该Pod
    nodeSelector: obeject  #设置NodeSelector表示将该Pod调度到包含这个label的node上,以key:value的格式指定
    imagePullSecrets:    #Pull镜像时使用的secret名称,以key:secretkey格式指定
    - name: string
    hostNetwork:false      #是否使用主机网络模式,默认为false,如果设置为true,表示使用宿主机网络
    volumes:       #在该pod上定义共享存储卷列表
    - name: string     #共享存储卷名称 (volumes类型有很多种)
      emptyDir: {}     #类型为emtyDir的存储卷,与Pod同生命周期的一个临时目录。为空值
      hostPath: string     #类型为hostPath的存储卷,表示挂载Pod所在宿主机的目录
        path: string     #Pod所在宿主机的目录,将被用于同期中mount的目录
      secret:      #类型为secret的存储卷,挂载集群与定义的secre对象到容器内部
        scretname: string  
        items:     
        - key: string
          path: string
      configMap:     #类型为configMap的存储卷,挂载预定义的configMap对象到容器内部
        name: string
        items:
        - key: string
          path: string 

测试:

vim pod.yaml

apiVersion: v1
kind: Pod
metadata:
  name: myapp-pod
  labels:
    app: myapp
    version: v1
spec:
  containers:
  - name: app
    image: 10.0.0.82/library/myapp:v1
  - name: test
    image: 10.0.0.82/library/myapp:v1 

这样会有80端口冲突问题。可以测试下

kubectl apply -f pod.yaml

查看,发现一直报错

# kubectl get pod
NAME                               READY   STATUS             RESTARTS   AGE
myapp-pod                          1/2     CrashLoopBackOff   4          2m37s

原因是一个pod中复用了一个pause,使用pause的网络,会有端口冲突问题。如何查看问题

查看容器详情:kubectl describe pod

查看容器启动的详细日志:kubectl log myapp-pod -c test

可以看到端口冲突,-c是指定具体容器名,可以增加端口映射,或者暂时删除test 容器

apiVersion: v1
kind: Pod
metadata:
  name: myapp-pod
  labels:
    app: myapp
    version: v1
spec:
  containers:
  - name: app
    image: 10.0.0.82/library/myapp:v1

删除pod:kubectl delete pod myapp-pod

重新建立pod:kubectl create -f pod.yaml

1.2.3、deployment的yaml模板

一个redis 的Deployment模板

apiVersion: apps/v1beta1
kind: Deployment
metadata:
  name: redis-deployment
spec:
  replicas: 2
  template:
    metadata:
      labels:
        app: default.Deployment.redis_server
    spec:
      containers:
      - name: redis
        image: redis:latest
        imagePullPolicy: IfNotPresent
        ports:
        - containerPort: 6379
      volumes:
        - name: data
          emptyDir: {} 

1.2.4、service的yaml

上述redis对应的对应的service配置文件

kind: Service
apiVersion: v1
metadata:
  name: redis
spec:
  type: NodePort
  ports:
  - protocol: TCP
    port: 6379
    targetPort: 6379
    nodePort: 30379
    name: test
  selector:
    app: default.Deployment.redis_server

1.2.5、Secret的yaml

apiVersion: v1
kind: Secret
metadata:
  name: mysecret
data:
  username: xxx
  password: yyy

# 敏感数据必须是base64编码后的结果,如上面的username和password
# 创建secret用 kubectl apply -f xxx.yml命令

pod读取secret文件

apiVersion: v1
kind: Pod
metadata:
  name: mypod
spec:
  containers:
  - name: mypod
    image: busybox
    args:
      - /bin/sh
      - -c
      - sleep 10; touch /tmp/healthy; sleep 30000
    volumeMounts:
    - name: foo
      mountPath: "/etc/foo"
      readOnly: true
  volumes:
  - name: foo
    secret:
      secretName: mysecret
# k8s会在 /etc/foo 下创建文件,每个数据创建一个文件,文件名是数据的key
# 即 会存在 username 和 password两个文件,内容就是其内容的明文存储
# volume方式支持动态更新

pod也可以使用环境变量方式读取secret数据,但不支持动态更新

apiVersion: v1
kind: Pod
metadata:
  name: mypod
spec:
  containers:
  - name: mypod
    image: busybox
    args:
      - /bin/sh
      - -c
      - sleep 10; touch /tmp/healthy; sleep 30000
    env:
      - name: SECRET_USERNAME
        valueFrom:
          secretKeyRef:
            name: mysecret
            key: username
      - name: SECRET_PASSWORD
        valueFrom:
          secretKeyRef:
            name: mysecret
            key: password

1.2.6、configMap yml

和secret大致相似

apiVersion: v1
kind: ConfigMap
metadata:
  name: myconfigMap
data:
  config1: xxx
  config2: yyy

调用方式和secret相似,对应类型换成configMap就OK了

1.2.7、namespace

apiVersion: v1
kind: Namespace
metadata:
   name: development
   labels:
     name: lhx 

pod选择namespace

apiVersion: v1
kind: Pod
metadata:
   name: test
   labels: 
     name: php-test
   namespace: lhx
spec:
  containers:
  - name: php-test
    image: 192.168.174.131:5000/php-base:1.0
    env:
    - name: ENV_TEST_1
      value: env_test_1
    - name: ENV_TEST_2
      value: env_test_2
    ports:
    - containerPort: 80
      hostPort: 80 
 

附注、yaml语法

  可读性高,用来表达数据序列的格式。仍是一种标记语言。

1》基础语法

  缩进时不允许使用Tab键,只允许使用空格

  缩进的空格数目不重要,只要相同层级的元素左侧对其即可

  # 标记注释,至结尾

2》yaml支持的数据结构

  对象:键值对的集合,又称为映射(mapping)、哈希(hashes)、字典(dictonary)

  数组:一组按次序排列的值,又称为序列(sequence)、列表(list)

  纯量(scalars):单个的、不可再分的值

示例一、对象类型,使用“:”分隔

name: lihongxu
age: 30

或者:

hash: {name: lihongxu,age: 30}

示例二、数组:一组连词线开头的行,构成一个数据

animal
- Cat
- Dog

或者

animal: [Cat,Dog]

示例三、复合使用

languages:
- Ruby
- Java
websites:
Ruby: ruby-lang.org
Java: java-lang.org

示例四、纯量:

字符串、布尔值、整数、浮点数、null、时间、日期等

# 数值直接以字面量的形式标识
number: 12.30
#布尔值用 true false
isSet: true
# null用~,或者不写
parent: ~
# 时间采用iso8601
iso8601: 2020-08-28t04:34:54.10-05:00
# 日期采用复合iso8601格式的年月日
date: 2020-08-28
#使用两个感叹号,强制转换数据类型
e: !!str 123
f: !!str true

字符串特殊用法

# 字符串默认不使用引号括起来,如果有个空格特殊字符等。使用可以用单引号或双引号,其中双引号不转义
str: hello
str: 'hello lihongxu'
str: 'hello\nlihongxu'
str: "hello\nlihongxu"
# 单引号之间还有单引号,需要写两个单引号转义
str: 'labor''s day'
# 多行,第二行开始缩进,换行符被转为空格
str: 这是一个
  多行
  记录
#多行可以使用|保留换行符,也可以使用>折叠换行
this: |
Foo
bar
that: >
Foo
Bar
# +表示保留文字块末尾的换行,-表示删除
s1: |
  Foo
s2: |+
  Foo
s3: |-
  Foo

 

posted @ 2020-09-05 09:33  bjlhx15  阅读(83)  评论(0编辑  收藏
Copyright ©2011~2020 JD-李宏旭