kong/nginx-kong-migrator

Kong Ingress 迁移工具

概述

该Docker镜像提供了一个专用工具，用于将Kubernetes集群中的Ingress资源从NGINX Ingress Controller无缝迁移到Kong Ingress Controller。它能够自动转换配置格式，确保迁移过程中配置的一致性和完整性，帮助用户简化从NGINX到Kong的迁移流程。

核心功能与特性

• 自动配置转换：将NGINX Ingress特定的注解（annotations）和配置规则转换为Kong Ingress Controller兼容的格式
• 配置验证：迁移过程中自动检查配置的有效性，确保转换后的资源符合Kong Ingress Controller要求
• 批量迁移：支持同时迁移单个命名空间或整个集群的Ingress资源
• 配置保留：保留原始Ingress资源的元数据（如标签、注释）和核心路由规则
• 无侵入式操作：迁移过程不会修改原始NGINX Ingress资源，确保数据安全

使用场景与适用范围

• Kubernetes集群从NGINX Ingress Controller迁移到Kong Ingress Controller的场景
• 需要保留现有Ingress路由规则和配置的迁移需求
• 希望自动化迁移流程以减少手动操作和错误的场景
• 多命名空间环境下的批量Ingress资源转换需求

使用方法与配置说明

前提条件

• 已安装Docker环境
• 拥有目标Kubernetes集群的管理员权限
• 本地已配置kubectl访问集群（kubeconfig文件）

基本使用命令

bash
docker run --rm \
  -v $HOME/.kube/config:/app/kubeconfig \
  kong/ingress-migrator:latest \
  --kubeconfig /app/kubeconfig \
  --namespace default \
  --output-dir /app/output

参数说明

输出说明

迁移完成后，工具会在指定的--output-dir目录下生成以下文件：

• migrated-ingresses.yaml：转换后的Kong Ingress资源清单
• migration-report.txt：迁移报告，包含成功/失败的资源列表和转换说明
• original-backup/：原始NGINX Ingress资源的备份目录

完整迁移流程示例

1. 执行迁移预览（验证配置）：

bash
docker run --rm \
  -v $HOME/.kube/config:/app/kubeconfig \
  -v $(pwd)/migration-output:/app/output \
  kong/ingress-migrator:latest \
  --kubeconfig /app/kubeconfig \
  --namespace production \
  --dry-run

2. 执行实际迁移：

bash
docker run --rm \
  -v $HOME/.kube/config:/app/kubeconfig \
  -v $(pwd)/migration-output:/app/output \
  kong/ingress-migrator:latest \
  --kubeconfig /app/kubeconfig \
  --namespace production \
  --output-dir /app/output \
  --overwrite

3. 应用迁移后的资源：

bash
kubectl apply -f migration-output/migrated-ingresses.yaml