Document updated on Dec 11, 2021
Automated integration tests
In addition to checking the syntax of your KrakenD configuration and make sure that the gateway can start, you can run integration tests to make sure that the gateway returns the expected content from the consumed backends. to make sure all endpoints are properly connected and that they reply with the expected content. To do that, you can use the library that KrakenD is relying on to run its integration tests, and complement the unit testing battery.
KrakenD comes with a small program that lets you define a folder with tests and execute them all at once, reporting any failures it found.
The way this library works is quite simple. You create a folder with all the different specs you want to tested, one per file. Each file is a .json
file with two keys:
in
: The parameters used to build the request to a running KrakenD with your configurationmethod
: The request methodurl
: The full URL to the endpoint you want to testheader
: An optional map of header to include in the requestbody
: An optional payload you can send in the request as data
out
: The expected response from the gatewaystatus_code
(integer): The expected status codebody
: The returned body by the response as a string, or as JSON object.header
: Any header included in the response. When the value is empty it means that you don’t expect that header.
For instance:
{
"in": {
"method": "GET",
"url": "http://localhost:8080/detail_error",
"header": {
"X-Header": "something"
}
},
"out": {
"status_code": 200,
"body": {
"message": "pong"
},
"header": {
"content-type": ["application/json; charset=utf-8"],
"Cache-Control": [""],
"X-Krakend-Completed": ["true"]
}
}
}
In the example above, the response must contain the content-type
and X-Krakend-Completed
with the specified values, and the Cache-Control
cannot be present.
You must build the go binary that allows you to run the tests.
Installing the integration tests tool
To install the integration tests you only need to run the following lines in any machine or Docker container with go installed:
Installing the integration tool
$go install github.com/krakendio/krakend-ce/v2/cmd/[email protected]
After this you should have a new binary krakend-integration
in your PATH. To use it you will to execute:
Term
$krakend-integration -krakend_bin_path ./krakend \
-krakend_config_path ./krakend.json \
-krakend_specs_path ./specs
The three parameters of the binary are:
-krakend_bin_path
: The path to the KrakenD binary. Defaults to./krakend
, but if KrakenD is in your PATH then you can usekrakend
.-krakend_config_path
: The path to the KrakenD configuration file that contains all endpoints you want to test.-krakend_specs_path
: The path to the folder containing all your specifications. These are all the tests that you want to run against KrakenD and check its output.