Document updated on Apr 12, 2023
The Designer is a UI that allows you to create KrakenD configurations from scratch or resume editing an existing one. It is a tool very useful in your early contact with KrakenD, as it helps you try functionalities without having to learn the different attributes of the configuration.
Combined with a
:watch container, you can administer and apply configuration changes automatically in a development environment.
Suppose you have a Chrome, Edge, or Opera desktop browser. In that case, you can have the whole experience of editing in the browser and see the changes applied to your local development container without doing anything else.
To use this, you need to:
From here, every save will automatically apply the changes on KrakenD.
You’ll see a warning in the dashboard when your browser is not supported, or you are using a local copy without HTTPS.
The first time you attempt to save a file you have loaded from the disk, the browser will ask permission.
Suppose you don’t have an initial configuration. In that case, you can generate an initial one by clicking Download on the Designer without needing to configure anything yet, or you can paste this inside a new file,
Now that you have a fresh
krakend.json, add a local
docker-compose.yaml like this in the same folder if you are going to plug KrakenD into other containers locally:
command: [ "run", "-dc", "krakend.json" ]
Or do a
docker run if you don’t want a Docker compose:
docker run -it --rm -v "$PWD:/etc/krakend" devopsfaith/krakend:watch run -dc krakend.json
You can check that KrakenD is running by visiting its health endpoint: http://localhost:8080/__health
Once KrakenD runs, the watcher follows changes happening in this folder. If you edit the file by hand, it will reload the new changes. But if you Open this file on the Designer, and save it, it will do it as well.
As KrakenD supports hundreds of features, it might be overwhelming to review all the documentation. Therefore, a tool that allows you to play in the browser is beneficial.
The Designer supports almost all the functionality, although there might be a few corner-case attributes or very advanced functionalities that aren’t in the interface. In any case, when this happens, even if you don’t see them in the interface, they are kept in the final save if you loaded them.
The Designer does not support flexible configuration, as the browser cannot render Go templates of a complex directory structure.
The Designer supports editing Enterprise and Community features simultaneously. When you enable a single Enterprise feature, you will see a badge informing you about it.
The documentation is only a piece of the help you can get! Whether you are looking for Open Source or Enterprise support, see more support channels that can help you.