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格
### 如何编写 Kubernetes 资源清单 YAML 文件 #### 1. 基本结构 Kubernetes 资源清单文件通常由几个核心字段组成,这些字段定义了资源的元数据、规格以及行为。以下是基本结构: ```yaml apiVersion: <API版本> # 定义所使用的 Kubernetes API 版本[^3] kind: <资源类型> # 指定要创建的资源种类,例如 Pod, Service 等 metadata: name: <资源名称> # 设置资源的名字 spec: # 描述资源的具体配置细节 ... ``` #### 2. 实例演示 下面是一个简单的 Pod 配置示例,展示了如何使用上述结构来定义一个容器化的应用程序。 ```yaml apiVersion: v1 # 使用的核心 API 版本 kind: Pod # 创建的对象类型为 Pod metadata: name: my-first-pod # Pod 名称为 my-first-pod spec: containers: - name: nginx-container # 容器名为 nginx-container image: nginx:latest # 使用最新的 Nginx 镜像 ports: - containerPort: 80 # 映射容器端口到主机上的 80 端口 ``` 此示例中,`apiVersion`, `kind`, 和 `metadata.name` 是必需字段,而 `spec.containers` 列表则描述了一个运行 Nginx 的单个容器及其开放的端口号[^4]。 #### 3. 应用资源配置 一旦完成了 YAML 文件的编写,可以利用 kubectl 工具将其应用至集群环境之中。常用命令如下所示: ```bash kubectl apply -f pod.yaml # 将 pod.yaml 中的内容应用于当前上下文中指定的 Kubernetes 集群 ``` 如果希望仅验证而不实际提交更改,则可采用以下方式测试配置的有效性: ```bash helm template --validate . | kubectl api-resources --validate=true -f - ``` 这一步骤能够确保生成的 YAML 文件符合预期的标准并能被 Kubernetes 正确解析[^2]。 #### 4. 更复杂的例子:Deployment 类型 对于更复杂的应用场景,可能需要用到 Deployment 来管理多个副本集和服务扩展等功能。这里提供一段关于 Deployment 的样例代码供参考: ```yaml apiVersion: apps/v1 # 使用 applications API 组合下的 V1 版本 kind: Deployment # 对象类型设置为 Deployment metadata: name: example-deployment # deployment 名字设为例子部署 spec: replicas: 3 # 运行三个实例作为高可用保障 selector: matchLabels: app: webapp # 标签选择器匹配具有特定标签的服务 template: metadata: labels: app: webapp # 添加标签以便于服务发现机制识别 spec: containers: - name: demo-app # 主程序容器命名示范应用 image: nodejs-express-demo # 自定义镜像地址替换此处占位符 ports: - containerPort: 3000 # 开放内部监听端口给外部访问 ``` 以上展示了一种典型的多副本部署模式,其中包含了负载均衡自动恢复等特性支持。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

Rio520

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值