在 Kubernetes (K8s) 中,常见的 YAML 文件配置包括:
文章目录
- Pod
- Deployment
- Service
- Ingress
- ConfigMap
- Secret
- Volume
- 访问模式
- StatefulSet
- DaemonSet
- Job
- 容器的重启策略
- ConJob
Pod
apiVersion: v1
kind: Pod
metadata:
name: my-pod # Pod 的名称
labels:
app: my-app # Pod 的标签,可用于选择器和服务发现
spec:
containers:
- name: my-container # 容器的名称
image: nginx # 使用的容器镜像
ports:
- containerPort: 80 # 容器内部暴露的端口号
protocol: TCP # 端口的协议类型
resources: # 容器所需的资源限制和需求
limits:
cpu: "0.5" # CPU 使用上限
memory: "256Mi" # 内存使用上限
requests:
cpu: "0.2" # CPU 最小需求
memory: "128Mi" # 内存最小需求
env: # 容器的环境变量
- name: ENV_VAR1
value: value1
- name: ENV_VAR2
valueFrom:
secretKeyRef:
name: my-secret # 引用的 Secret 对象的名称
key: secret-key # 从 Secret 对象中获取的键名
volumeMounts: # 容器的挂载路径
- name: data-volume # 挂载的卷的名称
mountPath: /data # 挂载的路径
volumes: # Pod 的卷
- name: data-volume # 卷的名称
emptyDir: {} # 空的卷,生命周期与 Pod 相关联
#可以添加 metadata.annotations 字段用于存放其他注释信息
metadata:
annotations:
description: This is a sample Pod configuration file. # 描述该配置文件的注释
Deployment
apiVersion: apps/v1
kind: Deployment
metadata:
name: my-deployment # Deployment 的名称
spec:
replicas: 3 # 副本数
selector:
matchLabels:
app: my-app # 用于选择 Pod 的标签
template:
metadata:
labels:
app: my-app # Pod 的标签,用于与选择器匹配
spec:
containers:
- name: my-container # 容器的名称
image: nginx # 使用的容器镜像
ports:
- containerPort: 80 # 容器内部暴露的端口号
protocol: TCP # 端口的协议类型
resources: # 容器所需的资源限制和需求
limits:
cpu: "0.5" # CPU 使用上限
memory: "256Mi" # 内存使用上限
requests:
cpu: "0.2" # CPU 最小需求
memory: "128Mi" # 内存最小需求
env: # 容器的环境变量
- name: ENV_VAR1
value: value1
- name: ENV_VAR2
valueFrom:
secretKeyRef:
name: my-secret # 引用的 Secret 对象的名称
key: secret-key # 从 Secret 对象中获取的键名
volumeMounts: # 容器的挂载路径
- name: data-volume # 挂载的卷的名称
mountPath: /data # 挂载的路径
volumes: # Pod 的卷
- name: data-volume # 卷的名称
emptyDir: {} # 空的卷,生命周期与 Pod 相关联
# 可以添加 metadata.annotations 字段用于存放其他注释信息
metadata:
annotations:
description: This is a sample Deployment configuration file. # 描述该配置文件的注释
Service
apiVersion: v1
kind: Service
metadata:
name: my-service # Service 的名称
spec:
selector:
app: my-app # 选择要路由到的 Pod 的标签
ports:
- name: http # 端口的名称
protocol: TCP # 端口的协议类型
port: 80 # Service 暴露的端口号
targetPort: 8080 # 路由到的 Pod 的端口号
type: LoadBalancer # Service 的类型,可以是 ClusterIP、NodePort 或者 LoadBalancer
Ingress
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: my-ingress # Ingress 的名称
annotations:
nginx.ingress.kubernetes.io/rewrite-target: /$1 # 添加 NGINX Ingress 控制器的注解,用于重写 URL
spec:
rules:
- host: example.com # 定义要匹配的域名
http:
paths:
- path: /appA # URL 路径
pathType: Prefix # 路径匹配类型,可以是 Prefix 或 Exact
backend:
service:
name: appA-service # 要路由到的 Service 的名称
port:
number: 80 # 路由到的 Service 的端口号
- path: /appB(/|$)(.*) # 使用正则表达式匹配 URL 路径
pathType: Prefix # 路径匹配类型,可以是 Prefix 或 Exact
backend:
service:
name: appB-service # 要路由到的 Service 的名称
port:
number: 80 # 路由到的 Service 的端口号
ConfigMap
apiVersion: v1
kind: ConfigMap
metadata:
name: my-configmap # ConfigMap 的名称
data:
server.conf: |
# Server 配置文件
port=8080
host=localhost
client.conf: |
# Client 配置文件
timeout=5000
retries=3
需要注意的是,
ConfigMap 的配置文件可以包含多个键值对,键名和对应的值可以是任意字符串类型,
例如文件内容、环境变量、命令行参数等。
在使用 ConfigMap 时,可以将其挂载到 Pod 中的容器内,从而使容器可以轻松地访问配置信息。
为了更好地管理和维护 ConfigMap,建议使用有意义的名称和注释对其进行命名和描述。
Secret
apiVersion: v1
kind: Secret
metadata:
name: my-secret # Secret 的名称
type: Opaque # Secret 类型(Opaque 表示任意类型)
data:
username: dXNlcm5hbWU= # 加密后的用户名
password: cGFzc3dvcmQ= # 加密后的密码
Secret 的配置文件包含敏感信息,如用户名、密码等,需要进行加密处理。在 YAML 文件中,可以将敏感信息以 base64 编码的方式保存在 data 字段中,以保证安全性。
Volume
apiVersion: v1
kind: Pod
metadata:
name: my-pod # Pod 的名称
spec:
containers:
- name: my-container # 容器的名称
image: nginx # 容器的镜像
volumeMounts:
- name: data-volume # 挂载卷的名称
mountPath: /data # 挂载到容器中的路径
volumes:
- name: data-volume # 卷的名称
emptyDir: {} # 空目录卷
Volume 的配置文件可以包含多个卷定义,每个卷可以是不同类型的卷(如 emptyDir、hostPath、persistentVolumeClaim 等)。在上述示例中,使用的是 emptyDir 类型的卷,它会在 Pod 运行时创建一个空目录,并将其挂载到容器内的指定路径。
访问模式
在 Kubernetes 中,访问模式(Access Modes)是用来定义持久化存储卷(Persistent Volume)的访问方式的。下面是 Kubernetes 支持的三种访问模式:
ReadWriteOnce
(RWO):该访问模式表示该存储卷可以被单个节点以读写方式挂载。这意味着同一时间内只能有一个 Pod 能够挂载并对存储卷进行读写操作。当存储卷被某个节点上的 Pod 挂载时,它将成为该节点的专属卷,在其他节点上不可见。
ReadOnlyMany
(ROX):该访问模式表示该存储卷可以以只读方式被多个节点挂载。多个 Pod 可以共享对存储卷的只读访问权限,但不能进行写入操作。
ReadWriteMany
(RWX):该访问模式表示该存储卷可以以读写方式被多个节点挂载。多个 Pod 可以同时挂载并对存储卷进行读写操作,即具有读写共享的功能。
StatefulSet
apiVersion: apps/v1
kind: StatefulSet
metadata:
name: my-statefulset # StatefulSet 的名称
spec:
selector:
matchLabels:
app: my-app # 匹配标签,用于选择要管理的 Pod
serviceName: my-service # Headless Service 的名称
replicas: 3 # 副本数
template:
metadata:
labels:
app: my-app # Pod 的标签
spec:
containers:
- name: my-container # 容器的名称
image: nginx # 容器的镜像
ports:
- containerPort: 80 # 容器监听的端口号
volumeMounts:
- name: data-volume # 挂载卷的名称
mountPath: /data # 挂载到容器中的路径
volumeClaimTemplates:
- metadata:
name: data-volume # 持久化存储卷模板的名称
spec:
accessModes:
- ReadWriteOnce # 访问模式
resources:
requests:
storage: 1Gi # 存储容量
StatefulSet 是用于管理有状态应用程序的控制器,它保证 Pod 的唯一性和稳定性,并按照序号进行命名。
在上述示例中,创建了一个包含 3 个副本的 StatefulSet,每个副本都会被命名为 my-statefulset-{0…2}。
StatefulSet 是用于管理有状态应用程序的控制器,它保证 Pod 的唯一性和稳定性,并按照序号进行命名。
在上述示例中,创建了一个包含 3 个副本的 StatefulSet,每个副本都会被命名为 my-statefulset-{0…2}。
DaemonSet
apiVersion: apps/v1
kind: DaemonSet
metadata:
name: my-daemonset # DaemonSet 的名称
spec:
selector:
matchLabels:
app: my-app # 匹配标签,用于选择要管理的节点上的 Pod
template:
metadata:
labels:
app: my-app # Pod 的标签
spec:
containers:
- name: my-container # 容器的名称
image: nginx # 容器的镜像
ports:
- containerPort: 80 # 容器监听的端口号
volumeMounts:
- name: data-volume # 挂载卷的名称
mountPath: /data # 挂载到容器中的路径
nodeSelector:
disktype: ssd # 节点的标签选择器,用于选择带有指定标签的节点
updateStrategy:
type: RollingUpdate # 更新策略为滚动更新
rollingUpdate:
maxUnavailable: 1 # 在更新期间最多允许一个 Pod 不可用
volumeClaimTemplates:
- metadata:
name: data-volume # 持久化存储卷模板的名称
spec:
accessModes:
- ReadWriteOnce # 访问模式
resources:
requests:
storage: 1Gi # 存储容量
DaemonSet 是用于在每个节点上运行一个 Pod 的控制器,它保证每个节点上都有一个唯一的 Pod 进行运行,并自动适应节点变化。
在上述示例中,创建了一个 DaemonSet,每个节点上都会运行一个 Pod,该 Pod 将被命名为 my-daemonset-{node-name}。
DaemonSet 还包含了 volumeClaimTemplates
字段,用于定义持久化存储卷模板。
在上述示例中,使用了一个名为 data-volume 的持久化存储卷模板,访问模式为 ReadWriteOnce
,存储容量为 1GB。Pod 将根据该模板创建一个与之对应的持久化存储卷。
通过使用 DaemonSet
和持久化存储卷,可以在集群的每个节点上运行一个 Pod,并确保应用程序的数据持久化和可靠性存储。
由于 DaemonSet 会自动适应节点变化,因此在增加或删除节点时,应用程序的数据不会丢失或受影响。
Job
apiVersion: batch/v1
kind: Job
metadata:
name: my-job # Job 的名称
spec:
completions: 1 # 完成的任务数
parallelism: 1 # 并行运行的 Pod 数量
template:
metadata:
name: my-pod # Pod 的名称
spec:
restartPolicy: Never # 不重启容器
containers:
- name: my-container # 容器的名称
image: nginx # 容器的镜像
command: ["echo", "Hello, world!"] # 容器启动命令
volumes:
- name: data-volume # 卷的名称
emptyDir: {} # 空的临时卷
backoffLimit: 3 # 重试次数上限
Job 是用于在 Kubernetes 中运行一次性任务的控制器。
在上述示例中,创建了一个 Job,其中包含一个 Pod,Pod 中运行了一个名为 my-container 的容器,该容器使用 nginx 镜像,并执行了 echo “Hello, world!” 命令。
Job 的配置还包括一些重要的字段,如 completions
(完成的任务数)和 parallelism
(并行运行的 Pod 数量)。completions 字段指定了 Job 完成的任务数,一旦达到该数量,Job 就会被标记为成功。parallelism 字段指定了同时运行的 Pod 数量,可以控制并行执行任务的速度。
另外,还有一些其他常用的字段,例如 restartPolicy
(容器的重启策略),volumes
(卷的定义)和 backoffLimit
(重试次数上限)。这些参数可以根据业务需求进行调整和配置。
通过使用 Job 控制器,可以在 Kubernetes 中运行一次性任务,并确保任务的完成和可靠性运行。由于 Job 可以指定任务数量和并行度,可以很好地适应不同规模和要求的任务场景。
容器的重启策略
在 Kubernetes 中,容器的重启策略可以通过在 Pod 的配置中设置 restartPolicy 字段来定义。以下是常见的三种重启策略:
Always(默认):当容器失败、终止或退出时,总是自动重启容器。这是默认的重启策略。
spec:
restartPolicy: Always
OnFailure:只有当容器以非零状态码退出时,才会自动重启容器。如果容器正常终止并退出(即零状态码),则不会自动重启容器。
spec:
restartPolicy: OnFailure
Never:当容器失败、终止或退出时,不会自动重启容器。如果容器异常终止,它将保持在该状态,直到手动重启。
spec:
restartPolicy: Never
通过选择适当的重启策略,您可以根据应用程序的特性和需求来配置容器的行为。请注意,在某些情况下,如在 Job 中使用特定任务执行成功或失败的标志,您可能需要选择适合的重启策略来确保任务按预期运行。
需要注意的是,Pod 的 restartPolicy 字段适用于整个 Pod 中的所有容器。如果多个容器在同一个 Pod 中运行,并且希望它们具有不同的重启策略,可以考虑将它们放置在不同的 Pod 中。
ConJob
apiVersion: batch/v1beta1 # 使用的 API 版本
kind: CronJob # CronJob 类型
metadata:
name: my-cronjob # CronJob 的名称
spec:
schedule: "*/1 * * * *" # Cron 表达式,用于定义作业执行的时间表
jobTemplate: # 作业模板,指定 CronJob 创建的作业配置
spec:
template:
metadata:
name: my-job # 作业的名称
spec:
restartPolicy: OnFailure # 容器的重启策略
containers:
- name: my-container # 容器的名称
image: nginx # 容器的镜像
command: ["echo", "Hello, world!"] # 容器启动命令
successfulJobsHistoryLimit: 5 # 历史成功作业保存的数量上限
failedJobsHistoryLimit: 5 # 历史失败作业保存的数量上限
CronJob 是 Kubernetes 中的一种控制器,用于定期运行作业。在上述示例中,创建了一个 CronJob,其中定义了一个 Cron 表达式 */1 * * * *,表示每分钟执行一次作业。
CronJob 的配置还包括使用 jobTemplate
指定了创建作业的模板。在这个模板中,指定了作业的 Pod 配置,其中包含一个名为 my-container 的容器,使用 nginx 镜像,并执行了 echo “Hello, world!” 命令。
除了基本的配置外,还有一些其他常用的字段。例如,successfulJobsHistoryLimit
和 failedJobsHistoryLimit
字段分别指定历史成功和失败作业保存的数量上限,可以根据需求进行调整。
通过使用 CronJob 控制器,可以定期运行作业,并对作业的运行情况进行管理和记录。CronJob 的配置文件中的注释可以帮助我们理解每个字段的含义和作用,方便后续管理和维护。