RKE2项目中Ingress控制器服务的默认配置解析

在RKE2集群部署过程中，许多用户会遇到一个常见现象：默认安装后，系统中没有自动创建rke2-ingress-nginx-controller服务。本文将深入解析这一现象背后的技术原理，并提供解决方案。

现象描述

当用户使用默认配置部署RKE2集群时，通过kubectl get svc -A命令查看服务列表，会发现只有rke2-ingress-nginx-controller-admission服务，而没有预期的rke2-ingress-nginx-controller服务。这一现象常被误认为是安装失败，实际上这是RKE2的默认设计行为。

技术原理

RKE2集成了NGINX Ingress Controller作为默认的Ingress控制器，但其Helm chart的默认配置中，controller.service.enabled参数被设置为false。这意味着：

1. 核心的Ingress控制器Pod仍会正常运行
2. 相关的Deployment和ConfigMap等资源都会被创建
3. 唯独不会自动创建对外暴露的Service资源

这种设计考虑到了不同部署环境的差异性，特别是在裸金属环境中，用户可能需要自定义Service类型和配置。

解决方案

要让Ingress控制器正常工作，需要显式启用Service创建。具体步骤如下：

1. 创建或编辑配置文件：/var/lib/rancher/rke2/server/manifests/rke2-ingress-nginx.yaml
2. 添加以下配置内容：

controller:
  service:
    enabled: true
    type: LoadBalancer  # 可根据实际环境选择ClusterIP或NodePort

3. 保存文件后，RKE2会自动应用变更
4. 验证服务是否创建成功：

kubectl get svc -n kube-system rke2-ingress-nginx-controller

进阶配置建议

在生产环境中，通常还需要考虑以下配置项：

1. 外部IP设置（适用于裸金属环境）
2. 负载均衡器特定注解（如MetalLB配置）
3. 资源限制和请求
4. 自定义Ingress类名称
5. SSL/TLS配置

示例完整配置：

controller:
  service:
    enabled: true
    type: LoadBalancer
    annotations:
      metallb.universe.tf/address-pool: production-public-ips
  resources:
    requests:
      cpu: 100m
      memory: 90Mi
  config:
    use-forwarded-headers: "true"

最佳实践

1. 在部署前规划好Ingress的访问方式（LoadBalancer/NodePort）
2. 生产环境建议设置资源限制
3. 考虑启用Prometheus指标监控
4. 定期检查Ingress控制器的日志和指标
5. 在集群扩容时注意Ingress控制器的副本分布

总结

RKE2的这种设计虽然初期可能造成困惑，但实际上提供了更大的灵活性。理解这一机制后，用户可以根据实际环境需求灵活配置Ingress控制器的暴露方式。对于刚接触RKE2的用户，建议在测试环境中先验证不同配置方案，再应用到生产环境。