Gardener项目配置与使用完全指南

Gardener项目配置与使用完全指南

gardener Homogeneous Kubernetes clusters at scale on any infrastructure using hosted control planes. 项目地址: https://gitcode.com/gh_mirrors/ga/gardener

前言

Gardener作为Kubernetes集群即服务的自动化管理平台，其强大的功能背后是一套完善的配置体系。本文将深入解析Gardener的配置架构，帮助系统管理员和终端用户理解如何正确配置和使用这一平台。

核心组件架构

Gardener由五个关键组件构成，每个组件都有其独特的配置方式：

1. gardener-apiserver：作为Kubernetes API扩展，负责处理自定义资源(如Seed和Shoot)的CRUD操作
2. gardener-admission-controller：提供验证性Webhook功能，确保资源变更符合规范
3. gardener-controller-manager：实现Project、Shoot等核心资源的调和逻辑
4. gardener-scheduler：负责将新建的Shoot集群分配到合适的Seed集群
5. gardenlet：运行在Seed集群中的守护进程，管理Shoot集群的生命周期

管理员配置详解

组件配置文件

每个核心组件都支持通过配置文件进行参数设置：

1. Admission Controller配置：

   • 主要配置准入控制策略
   • 支持资源验证规则定义
   • 可配置Webhook的失效策略

2. Controller Manager配置：

   • 控制器并发度设置
   • 资源调和间隔配置
   • 领导者选举参数

3. Scheduler配置：

   • 调度策略配置
   • 亲和性/反亲和性规则
   • 种子集群选择算法

4. Gardenlet配置：

   • Seed集群连接参数
   • 控制器配置
   • 资源同步设置

系统关键配置

部署完成后，需要在garden命名空间中配置以下关键Secret：

1. 内部域名Secret

• 包含DNS提供商凭证
• 用于创建Shoot集群的内部DNS记录
• 一旦设置后，存在Shoot集群时不可更改

2. 默认域名Secret（可选）

• 为没有自定义域名的Shoot提供默认域名
• 支持多域名优先级配置（通过注解）
• 示例格式：

  apiVersion: v1
  kind: Secret
  metadata:
    name: default-domain
    annotations:
      dns.gardener.cloud/domain-default-priority: "100"
  

3. 告警Secret（可选）

• 支持两种告警模式：
  • 内置AlertManager：部署到每个Seed集群
  • 外部AlertManager：支持无认证、基础认证和mTLS

4. 全局监控Secret（可选）

• 包含聚合监控的认证凭据
• 自动同步到所有Seed集群

5. 服务账户颁发者Secret（重要）

• 实现集中式OIDC配置
• 主机名一旦设置不应更改
• 与Gardener Operator兼容性注意事项

终端用户使用指南

对于使用Gardener平台的终端用户，主要需要了解以下核心资源：

1. Project资源

• 组织Shoot集群的逻辑单元
• 配置成员和权限
• 配额管理

2. SecretBinding

• 将凭证Secret与Project关联
• 支持基础设施提供商凭据管理

3. Shoot集群

• 定义Kubernetes集群规格
• 配置网络、存储等基础设施
• 版本控制和升级策略

4. OpenIDConnect预设

• 统一配置集群认证
• 支持集群级和命名空间级预设

最佳实践

1. 配置管理：

   • 使用GitOps管理配置变更
   • 重要Secret启用加密存储
   • 定期轮换凭证

2. 域名管理：

   • 内部域名与业务域名分离
   • 为生产环境配置高优先级域名

3. 监控告警：

   • 生产环境建议使用外部AlertManager
   • 配置多级告警通知

4. 迁移策略：

   • 变更前充分测试
   • 关键配置变更采用蓝绿部署
   • 维护详细的变更日志

总结

Gardener的配置体系既考虑了平台管理员的灵活性需求，也兼顾了终端用户的易用性。通过理解各组件配置要点和核心资源的使用方法，可以充分发挥Gardener作为Kubernetes集群管理平台的强大能力。无论是平台运维团队还是业务开发团队，都能在各自层面高效地使用这一工具。

gardener Homogeneous Kubernetes clusters at scale on any infrastructure using hosted control planes. 项目地址: https://gitcode.com/gh_mirrors/ga/gardener