/kong-to-apisix

Primary LanguageGoApache License 2.0Apache-2.0

Kong-To-APISIX

Go Report Card Build Status Codecov

Kong-To-APISIX is a migration tool helping you migrate configuration data of your API gateway from Kong to Apache APISIX. It aims to help people to dip their toes in APISIX and also reduce the operations cost.

Only tested with APISIX 2.7 and Kong 2.4 for now.

How to use

  1. Dump Kong Configuration with Deck. See https://docs.konghq.com/deck/1.7.x/guides/backup-restore/ for details.

  2. Run Kong-To-APISIX, and it would generate apisix.yaml as declarative configuration file for APISIX.

    $ make build
$ ./bin/kong-to-apisix migrate -i kong.yaml -o apisix.yaml
migrate succeed

  3. Configure APISIX with apisix.yaml, see https://apisix.apache.org/docs/apisix/stand-alone for details.

If more help needed, you could refer detail steps

Roadmap

  • Improving and completing current apis, eg. support tcp/tls in kong to stream route in APISIX
  • Provide migration report, to declare what has been migrated and those currently not supported
  • Support sni, certificates, ca_certificates configuration migration
  • Support 15+ common plugins
  • Support customized plugin migration
  • Support Incremental migration