Warning
Deprecated: Go plugins are no longer supported in the Community Edition.
KrakenD CE 3.0 dropped custom Go plugins, so this example only works with KrakenD CE 2.x, and is pinned to krakend:2.13.11 and krakend/builder:2.13.11, the last release supporting them.
To keep using Go plugins on 3.0, move to KrakenD Enterprise, which also changes the plugin configuration format (see the opentelemetry example for working 3.0 plugins). For custom logic on the Community Edition, use Lua scripting.
This repository provides an example of how to build and inject a Request/Response Modifier Plugin into the KrakenD API Gateway. Follow the steps below to understand how to set up and use the modifier plugin.
The modifier plugin, named my-modifier, demonstrates how to create custom request and response modifiers that can be integrated into KrakenD. The plugin allows you to intercept and modify the request before it reaches the backend and the response before it is returned to the client.
modifier.go: The main plugin code that implements the request and response modifiers.go.mod: The Go module file.Makefile: Instructions for building the plugin using Docker.
- Go
- Docker
- KrakenD API Gateway (version 2.x)
You should build the plugin using the KrakenD Docker builder image. The Makefile includes targets for different architectures.
-
Clone the Repository:
git clone https://github.com/krakend/examples.git cd examples/plugins/modifier -
Build for Different Architectures:
-
For amd64:
make amd64
-
For arm64:
make arm64
-
For linux_amd64 (non-docker):
make linux_amd64
-
For linux_arm64 (non-docker):
make linux_arm64
-
To use the plugin in your KrakenD configuration, add it under the extra_config section of your krakend.json file.
{
"version": 3,
"plugin": {
"pattern": ".so",
"folder": "/etc/krakend/plugins"
},
"host": ["http://localhost:8080/"],
"debug_endpoint": true,
"endpoints": [
{
"endpoint": "/example",
"method": "GET",
"extra_config": {
"plugin/req-resp-modifier": {
"name": ["my-modifier-request", "my-modifier-response"],
"my-modifier-request": {
"option": "value"
},
"my-modifier-response": {
"option": "value"
}
}
},
"backend": [
{
"url_pattern": "/__debug/"
}
]
}
]
}The plugin supports a logger interface to help with debugging and logging messages.
Debug(v ...interface{})Info(v ...interface{})Warning(v ...interface{})Error(v ...interface{})Critical(v ...interface{})Fatal(v ...interface{})
The my-modifier plugin adds custom logic by intercepting and potentially modifying the request and response. The example plugin logs details about the request and response but does not modify them.
- Build the plugin using the appropriate make target. The plugin will be generated under the
pluginsfolder. - Test your KrakenD using Docker, for instance:
docker run --rm -it --name krakend -p 8080:8080 -v "$PWD:/etc/krakend" krakend:2.13.11- Send an example call
curl -iG 'http://localhost:8080/example'For more details on request/response modifier plugins and extending KrakenD, refer to the official documentation.