Kong Kubernetes Ingress Controller中dblessConfig配置的正确使用方式

在使用Kong Kubernetes Ingress Controller（KIC）进行部署时，许多开发者会遇到dblessConfig配置不生效的问题。本文将深入分析这一问题的根源，并提供完整的解决方案。

问题背景

当开发者尝试通过Helm chart的values.yaml文件配置Kong的声明式配置时，经常会发现dblessConfig的设置没有按预期生效。这通常发生在同时启用了Ingress Controller的情况下。

核心问题分析

dblessConfig配置项仅适用于不启用Ingress Controller的部署场景。这是Kong Helm chart的一个设计特性。当Ingress Controller被启用时，Kong会通过Kubernetes API来获取配置，而不是通过dblessConfig。

正确配置方法

1. 禁用Ingress Controller：确保在values.yaml中将Ingress Controller设置为禁用状态

   controller:
     ingressController:
       enabled: false
   

2. 正确缩进YAML配置：dblessConfig下的config内容必须正确缩进

   gateway:
     dblessConfig:
       config: |
         _format_version: "3.0"
         _transform: true
         services:
         - name: my-service
           protocol: http
           port: 3000
   

3. 完整配置示例：以下是一个完整的values.yaml配置示例

   controller:
     enabled: true
     ingressController:
       enabled: false
   
   gateway:
     enabled: true
     dblessConfig:
       config: |
         _format_version: "3.0"
         _transform: true
         services:
         - name: example-service
           url: http://example.com
           routes:
           - name: example-route
             paths: ["/example"]
   

替代方案

如果必须使用Ingress Controller，开发者可以通过以下方式管理配置：

1. 使用KongPlugin资源：为每个需要不同配置的插件创建独立的KongPlugin资源
2. 通过HTTP API配置：直接使用Kong的/config API端点进行配置
3. 使用Kubernetes原生资源：通过Ingress或HTTPRoute资源定义流量规则

自定义插件注意事项

当开发自定义插件时，若依赖第三方Lua模块，需要注意：

1. 模块安装：需要在Kong容器中安装所需的Lua模块
2. 初始化容器：考虑使用init容器预先安装依赖
3. 插件打包：确保插件及其依赖被正确打包到容器镜像中

总结

正确使用Kong Kubernetes Ingress Controller的dblessConfig功能需要注意部署模式的选择和YAML格式的正确性。对于复杂的配置场景，开发者应该根据实际需求选择合适的配置管理方式，无论是通过声明式配置还是Kubernetes原生资源。理解这些关键点将帮助开发者更高效地部署和管理Kong网关服务。