This repository contains a very simple Kong plugin template to get you up and running quickly for developing your own plugins.
This template was designed to work with the
kong-pongo
and
kong-vagrant
development environments.
Please check out those repos README
files for usage instructions. For a complete
walkthrough check this blogpost on the Kong website.
There are a number "named" components and related versions. These are the conventions:
-
Kong plugin name: This is the name of the plugin as it is shown in the Kong Manager GUI, and the name used in the file system. A plugin named
my-cool-plugin
would have ahandler.lua
file at./kong/plugins/my-cool-plugin/handler.lua
. -
Kong plugin version: This is the version of the plugin code, expressed in
x.y.z
format (using Semantic Versioning is recommended). This version should be set in thehandler.lua
file as theVERSION
property on the plugin table. -
LuaRocks package name: This is the name used in the LuaRocks eco system. By convention this is
kong-plugin-[KongPluginName]
. This name is used for therockspec
file, both in the filename as well as in the contents (LuaRocks requires that they match). -
LuaRocks package version: This is the version of the package, and by convention it should be identical to the Kong plugin version. As with the LuaRocks package name the version is used in the
rockspec
file, both in the filename as well as in the contents (LuaRocks requires that they match). -
LuaRocks rockspec revision: This is the revision of the rockspec, and it only changes if the rockspec is updated. So when the source code remains the same, but build instructions change for example. When there is a new LuaRocks package version the LuaRocks rockspec revision is reset to
1
. As with the LuaRocks package name the revision is used in therockspec
file, both in the filename as well as in the contents (LuaRocks requires that they match). -
LuaRocks rockspec name: this is the filename of the rockspec. This is the file that contains the meta-data and build instructions for the LuaRocks package. The filename is
[package name]-[package version]-[package revision].rockspec
.
-
Kong plugin name:
my-cool-plugin
-
Kong plugin version:
1.4.2
(set in theVERSION
field insidehandler.lua
)
This results in:
-
LuaRocks package name:
kong-plugin-my-cool-plugin
-
LuaRocks package version:
1.4.2
-
LuaRocks rockspec revision:
1
-
rockspec file:
kong-plugin-my-cool-plugin-1.4.2-1.rockspec
-
File
handler.lua
is located at:./kong/plugins/my-cool-plugin/handler.lua
(and similar for the other plugin files)
- Custom Lua Plugin with Kong Gateway - Blog Post