编辑“︁Kubernetes标签”︁（章节）

= Kubernetes标签 =

'''Kubernetes标签（Labels）'''是附加到Kubernetes对象（如Pod、Service、Deployment等）上的键值对，用于标识对象的特征或属性。标签提供了一种灵活的方式，允许用户组织、筛选和选择对象子集，而不会影响核心功能。它们是Kubernetes中实现高效资源管理和操作的关键机制之一。

== 标签基础 ==
标签由键（key）和值（value）组成，格式为<code>key=value</code>。键和值必须是字符串，且遵循以下规则：
* 键：最长63字符，支持字母、数字、连字符（-）、下划线（_）和点（.），必须以字母或数字开头/结尾。
* 值：最长63字符（可为空），支持与键相同的字符集。

=== 示例标签定义 ===
以下是一个Pod的YAML片段，展示了如何添加标签：
<syntaxhighlight lang="yaml">
apiVersion: v1
kind: Pod
metadata:
  name: nginx-pod
  labels:
    app: nginx
    environment: production
    tier: frontend
spec:
  containers:
  - name: nginx
    image: nginx:latest
</syntaxhighlight>

== 标签选择器（Label Selectors） ==
标签选择器用于查询和筛选带有特定标签的对象。Kubernetes支持两种选择器：

=== 等式选择器（Equality-based） ===
* <code>key=value</code>：匹配值完全相等的标签
* <code>key!=value</code>：排除值相等的标签

=== 集合选择器（Set-based） ===
* <code>key in (value1, value2)</code>：匹配值在集合中的标签
* <code>key notin (value1, value2)</code>：排除值在集合中的标签
* <code>key</code>：仅检查键是否存在（忽略值）

=== 选择器使用示例 ===
在Service中通过标签选择器关联Pod：
<syntaxhighlight lang="yaml">
apiVersion: v1
kind: Service
metadata:
  name: nginx-service
spec:
  selector:
    app: nginx
    tier: frontend
  ports:
    - protocol: TCP
      port: 80
      targetPort: 80
</syntaxhighlight>

== 实际应用场景 ==

=== 场景1：环境隔离 ===
为不同环境（开发/测试/生产）的Pod添加标签：
* <code>environment: dev</code>
* <code>environment: staging</code>
* <code>environment: production</code>

通过选择器可以只操作特定环境的资源：
<syntaxhighlight lang="bash">
kubectl get pods -l environment=production
</syntaxhighlight>

=== 场景2：版本金丝雀发布 ===
使用版本标签实现渐进式发布：
<mermaid>
graph LR
  A[v1.0.0] -->|20%流量| B[app=nginx,version=1.0.0]
  A -->|80%流量| C[app=nginx,version=1.1.0]
</mermaid>

对应Deployment配置片段：
<syntaxhighlight lang="yaml">
apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx-deployment
spec:
  replicas: 5
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
        version: 1.1.0
    spec:
      containers:
      - name: nginx
        image: nginx:1.19.0
</syntaxhighlight>

== 标签最佳实践 ==
1. '''语义化命名'''：使用有意义的键名如<code>app</code>, <code>tier</code>, <code>release</code>
2. '''避免过度使用'''：每个标签都应具有明确的用途
3. '''标准化约定'''：团队内部统一标签策略
4. '''不可变标签'''：标识核心属性的标签应避免运行时修改

== 数学表示 ==
标签选择器可以形式化为集合操作。设对象标签集合为<math>L = \{(k_1,v_1),...,(k_n,v_n)\}</math>，选择器匹配规则为：

对于等式选择器<math>k=v</math>：
<math>(k,v) \in L</math>

对于集合选择器<math>k \in \{v_1,...,v_m\}</math>：
<math>\exists v_i \in \{v_1,...,v_m\} \text{ 使得 } (k,v_i) \in L</math>

== 高级用法 ==
=== 标签传播 ===
某些控制器（如Deployment）会自动将标签传播到其管理的所有对象。例如：
<mermaid>
graph TB
  D[Deployment: app=nginx] --> R[ReplicaSet: app=nginx]
  R --> P[Pod: app=nginx]
</mermaid>

=== 节点选择 ===
通过<code>nodeSelector</code>结合节点标签实现Pod调度：
<syntaxhighlight lang="yaml">
apiVersion: v1
kind: Pod
metadata:
  name: gpu-pod
spec:
  containers:
  - name: cuda-container
    image: nvidia/cuda
  nodeSelector:
    accelerator: nvidia-tesla-p100
</syntaxhighlight>

== 常见命令 ==
* 查看所有标签：<code>kubectl get <resource> --show-labels</code>
* 按标签筛选：<code>kubectl get pods -l 'environment in (production,staging)'</code>
* 添加标签：<code>kubectl label pods my-pod new-label=awesome</code>
* 修改标签：<code>kubectl label pods my-pod existing-label=new-value --overwrite</code>
* 删除标签：<code>kubectl label pods my-pod old-label-</code>（注意末尾的减号）

== 总结 ==
Kubernetes标签是微服务架构中实现灵活资源管理的基础工具。通过合理使用标签和选择器，可以实现：
* 逻辑资源分组
* 精细化操作控制
* 跨对象关联
* 自动化运维策略

标签系统的设计体现了Kubernetes的核心哲学：通过声明式配置和松耦合关系实现强大的自动化管理能力。

[[Category:集成部署]]
[[Category:Kubernetes]]
[[Category:Kubernetes核心概念]]