在Kubernetes中使用ClickHouse Operator暴露服务的Ingress配置指南

ClickHouse Operator是管理Kubernetes集群中ClickHouse部署的强大工具。本文将详细介绍如何通过Ingress资源安全地暴露ClickHouse服务，使其能够被外部访问。

服务暴露的基本原理

在Kubernetes环境中，ClickHouse Operator默认会创建LoadBalancer类型的服务。这种方式虽然简单，但可能不是最经济高效的选择。更优的方案是使用Ingress控制器来管理外部访问。

配置ClickHouse服务模板

首先需要修改ClickHouseInstallation资源定义，将服务类型设置为ClusterIP：

apiVersion: "clickhouse.altinity.com/v1"
kind: "ClickHouseInstallation"
metadata:
  name: "clickhouse-service"
spec:
  defaults:
    templates:
      serviceTemplate: clusterip-template
  templates:
    serviceTemplates:
      - name: clusterip-template
        type: ClusterIP

这个配置确保服务只在集群内部可用，为后续通过Ingress暴露做好准备。

创建HTTP Ingress资源

对于基本的HTTP访问（如8123端口），可以创建如下Ingress资源：

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: clickhouse-http-ingress
  annotations:
    nginx.ingress.kubernetes.io/proxy-connect-timeout: "60m"
    nginx.ingress.kubernetes.io/proxy-send-timeout: "60m"
    nginx.ingress.kubernetes.io/proxy-read-timeout: "60m"
spec:
  rules:
  - host: clickhouse.example.com
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: chendpoint-clickhouse-service
            port:
              number: 8123

这个配置允许外部客户端通过HTTP协议访问ClickHouse的HTTP接口（默认端口8123）。

高级配置注意事项

1. TCP流量处理：如果需要暴露ClickHouse的TCP端口（如9000），需要额外配置Ingress控制器的TCP代理功能。

2. TLS终止：对于生产环境，强烈建议配置TLS证书：

   spec:
     tls:
     - hosts:
       - clickhouse.example.com
       secretName: clickhouse-tls-secret
   

3. 连接超时：ClickHouse查询可能耗时较长，适当增加超时设置很重要。

4. 服务发现：确保Ingress中指定的服务名称与实际创建的服务名称匹配。

验证配置

部署完成后，可以通过以下命令验证服务是否正常：

curl -v http://clickhouse.example.com/ping

预期响应应为"Ok."，表示服务已正确配置。

最佳实践建议

1. 生产环境应始终启用TLS加密
2. 考虑实现基于路径的路由，以便在同一域名下暴露多个服务
3. 监控Ingress控制器的资源使用情况
4. 为不同的环境（开发、测试、生产）配置不同的Ingress规则

通过合理配置Ingress，可以安全、高效地将ClickHouse服务暴露给外部用户，同时保持Kubernetes集群的安全性。这种方案相比直接使用LoadBalancer更加灵活且成本效益更高。