banzaicloud/nodepool-labels-operator

Nodepool Labels Operator

镜像概述和主要用途

节点池（node pool）是集群中具有相同配置的节点实例子集，而整个集群可包含多个节点池及异构节点/配置。Pipeline平台可管理Kubernetes集群中的多个节点池，每个节点池具有不同配置（如本地SSD、Spot实例、GPU等）。

Nodepool Labels Operator用于监控节点事件，捕捉节点加入集群的时机。它通过自定义资源（Custom Resource）跟踪节点池节点的期望标签列表（每个节点池对应一个CR）。Pipeline平台创建并更新这些CR，Operator负责将CR中定义的标签应用到对应节点池的所有节点，并维护标签的一致性。

核心功能和特性

1. 节点事件监控：实时监控节点加入集群事件，触发标签管理流程。
2. 自定义资源管理：通过NodePoolLabelSet CR定义节点池的期望标签列表。
3. 节点池识别机制：
   • 主标签：依赖node.banzaicloud.io/nodepool: <节点池名称>标签识别节点所属节点池。
   • 云厂商回退标签：当主标签不可用时，使用云厂商特定标签：
     • AKS：agent: <节点池名称>
     • GKE：cloud.google.com/gke-nodepool: <节点池名称>
4. 标签生命周期管理：通过节点注释nodepool.banzaicloud.io/managed-labels跟踪管理的标签，自动移除CR中不再存在的标签。

使用场景和适用范围

适用于需要管理多个异构节点池的Kubernetes集群，例如：

• 区分环境（如测试/生产环境）
• 标识团队归属（如研发/运维团队）
• 区分资源类型（如GPU节点池、SSD节点池、Spot实例节点池）
• 实现基于标签的资源调度和权限控制

使用方法和配置说明

安装Operator

通过Helm安装：

bash
helm repo add banzai-stable http://kubernetes-charts.banzaicloud.com/branch/master
helm install banzai-stable/nodepool-labels-operator

创建节点池标签配置（CR示例）

创建NodePoolLabelSet自定义资源，定义节点池的期望标签：

bash
cat <<EOF | kubectl create -f -
apiVersion: labels.banzaicloud.io/v1alpha1
kind: NodePoolLabelSet
metadata:
  name: test-pool-2  # 节点池名称，需与节点池标签匹配
spec:
  labels:
    environment: "testing"  # 环境标签
    team: "rnd"             # 团队标签
EOF

验证节点标签

查看节点标签是否已应用：

bash
kubectl describe node <节点名称>

预期输出示例：

Name:               gke-standard-cluster-1-test-pool-2-1be3b06d-42wd
Roles:              <none>
Labels:             environment=testing
                    team=rnd
Annotations:        nodepool.banzaicloud.io/managed-labels: ["environment","team"]

贡献指南

如果您觉得该项目有用，可通过以下方式贡献：

• 提交包含新功能或bug修复的Pull Request
• 帮助解决用户遇到的问题
• 支持项目开发并为仓库点赞！