k8s资源清单

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

简单说明
是一个可读性高，用来表达数据序列的格式。YAML 的意思其实是：仍是一种标记语言，但为了强调这种语言以数
据做为中心，而不是以标记语言为重点

基本语法
缩进时不允许使用Tab键，只允许使用空格
缩进的空格数目不重要，只要相同层级的元素左侧对齐即可
#标识注释，从这个字符一直到行尾，都会被解释器忽略

YAML 支持的数据结构
对象：键值对的集合，又称为映射（mapping）/ 哈希（hashes） / 字典（dictionary）
数组：一组按次序排列的值，又称为序列（sequence） / 列表 （list）
纯量（scalars）：单个的、不可再分的值
对象类型：对象的一组键值对，使用冒号结构表示

name: Steve
age: 18

Yaml 也允许另一种写法，将所有键值对写成一个行内对象

hash: { name: Steve, age: 18 }

数组类型：一组连词线开头的行，构成一个数组

animal
- Cat
- Dog

数组也可以采用行内表示法

animal: [Cat, Dog]

复合结构：对象和数组可以结合使用，形成复合结构

anguages:
 - Ruby
 - Perl
 - Python
 websites:
 YAML: yaml.org
 Ruby: ruby-lang.org
 Python: python.org
 Perl: use.perl.org

纯量：纯量是最基本的、不可再分的值。以下数据类型都属于纯量

1 字符串 布尔值 整数 浮点数 Null
2 时间 日期

数值直接以字面量的形式表示

number: 12.30

布尔值用true和false表示

isSet: true

null用 ~ 表示

parent: ~

时间采用 ISO8601 格式

iso8601: 2001-12-14t21:59:43.10-05:00

日期采用复合 iso8601 格式的年、月、日表示

date: 1976-07-31

YAML 允许使用两个感叹号，强制转换数据类型

 !!str 123
 !!str true

字符串
字符串默认不使用引号表示

str: 这是一行字符串

如果字符串之中包含空格或特殊字符，需要放在引号之中

str: '内容： 字符串'

单引号和双引号都可以使用，双引号不会对特殊字符转义

s1: '内容\n字符串'
s2: "内容\n字符串"

单引号之中如果还有单引号，必须连续使用两个单引号转义

str: 'labor''s day'

字符串可以写成多行，从第二行开始，必须有一个单空格缩进。换行符会被转为 空格

str: 这是一段
多行
字符串

多行字符串可以使用|保留换行符，也可以使用>折叠换行

this: |
Foo
Bar
that: >
Foo
Bar

• 表示保留文字块末尾的换行，- 表示删除字符串末尾的换行

s1: |
Foo
s2: |+
Foo
s3: |-
Foo

资源清单常用字段的解释

查看详细的资源帮助信息

[root@k8s-master01 ~]# kubectl explain pod
[root@k8s-master01 ~]# kubectl explain pod.apiVersion
KIND:     Pod
VERSION:  v1

FIELD:    apiVersion <string>

DESCRIPTION:
     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:
     https://git.k8s.io/community/contributors/devel/api-conventions.md#resources

资源清单格式

apiVersion: group/apiversion # 如果没有给定 group 名称，那么默认为 core，可以使用 kubectl api-
versions # 获取当前 k8s 版本上所有的 apiVersion 版本信息( 每个版本可能不同 )
kind:
#资源类别
metadata： #资源元数据
name
namespace
lables   #标签
annotations
# 主要目的是方便用户阅读查找
spec: # 期望的状态（disired state）
status：# 当前状态，本字段有 Kubernetes 自身维护，用户不能去定义

编写一个pod yaml

apiVersion: v1
kind: Pod
metadata:
 name: nginx
 labels:
    app: nginx
    version: v1
spec:
 containers:
  - name: nginx
    image: at.harbor.com/library/nginx:v1

[root@k8s-master01 ~]# kubectl  apply -f pod.yaml 
pod/nginx created

查看日志
kubectl log pod名 -c 容器名

[root@k8s-master01 ~]# kubectl  log nginx -c nginx
log is DEPRECATED and will be removed in a future version. Use logs instead.
/docker-entrypoint.sh: /docker-entrypoint.d/ is not empty, will attempt to perform configuration
/docker-entrypoint.sh: Looking for shell scripts in /docker-entrypoint.d/
/docker-entrypoint.sh: Launching /docker-entrypoint.d/10-listen-on-ipv6-by-default.sh
10-listen-on-ipv6-by-default.sh: Getting the checksum of /etc/nginx/conf.d/default.conf
10-listen-on-ipv6-by-default.sh: Enabled listen on IPv6 in /etc/nginx/conf.d/default.conf
/docker-entrypoint.sh: Launching /docker-entrypoint.d/20-envsubst-on-templates.sh
/docker-entrypoint.sh: Configuration complete; ready for start up

启动报错可以用这个命令查看容器的信息

[root@k8s-master01 ~]# kubectl  describe pod nginx

删除pod

[root@k8s-master01 ~]# kubectl  delete pod nginx

新建pod

[root@k8s-master01 ~]# kubectl  create -f pod.yaml 
pod/nginx created

资源清单的常用命令

获取 apiversion 版本信息

[root@k8s-master01 ~]# kubectl api-versions

获取资源的 apiVersion 版本信息

[root@k8s-master01 ~]# kubectl  explain pod
KIND:     Pod
VERSION:  v1

获取字段设置帮助文档

[root@k8s-master01 ~]# kubectl  explain pod
KIND:     Pod
VERSION:  v1

字段配置格式
#表示字符串类型

apiVersion <string>

#表示需要嵌套多层字段

metadata <Object>

#表示由k:v组成的映射

labels <map[string]string>

#表示字串列表

finalizers <[]string>

#表示对象列表

ownerReferences <[]Object>

#布尔类型

hostPID <boolean>

#整型

priority <integer>

#如果类型后面接 -required-，表示为必填字段

name <string> -required-

通过定义清单文件创建 Pod

apiVersion: v1
kind: Pod
metadata:
 name: pod-demo
 namespace: default
 labels:
  app: myapp
spec:
 containers:
- name: myapp-1
image: hub.atguigu.com/library/myapp:v1
- name: busybox-1
  image: busybox:latest
  command:
  - "/bin/sh"
  - "-c"
  - "sleep 3600"

kubectl get pod xx.xx.xx -o yaml
<!--使用 -o 参数 加 yaml，可以将资源的配置以 yaml的格式输出出来，也可以使用json，输出为json格