Elektra  0.9.3
elektra-web

an API and web user interface to remotely manage Elektra instances

The configuration view of elektra-web is similar to the tree view of the qt-gui, but with dynamic fields rendered via key metadata.

Elektra-web requires:

To build Elektra with the elektra-web tool:

If you do not want to configure multiple instances, you can set the INSTANCE environment variable to the server you want to configure. You can also set user/sw/elektra/web/#0/current/instance to the host. Make sure to enter a full HTTP URL, e.g. http://localhost:33333.

If this configuration option is set, elektra-web will load the configuration page for that instance instead of the main overview page.

If you want to host elektra-web with the client and elektrad on the same instance, after starting elektrad via kdb run-elektrad, you can run start the client as follows:

INSTANCE="http://localhost:33333" kdb run-web

It is also possible to set visibility by prefixing the host with VISIBILITY@.

For example (advanced visibility, user is default):

INSTANCE="advanced@http://localhost:33333" kdb run-web

Now, when you open http://localhost:33334 in your browser, the configuration page for the instance will be opened immediately.

It is possible to change the kdb executable that elektra-web uses by setting the KDB environment variable, this is not needed for elektrad.

For example:

kdb run-elektrad
KDB="/usr/local/custom/bin/kdb" kdb run-web

Elektra web consists of multiple components:

https://cdn.rawgit.com/ElektraInitiative/libelektra/master/doc/images/network_structure.png
https://cdn.rawgit.com/ElektraInitiative/libelektra/master/doc/images/daemon_structure.png

API blueprints are available for both APIs:

In order to test API on localhost, you have to start elektrad instance. You can do it in two ways:

Now the server is runing on http://localhost:33333. After that you can test API with help of Postman or other tool, which allows to send REST API requests.

Additional note. It is recommended to install the elektrad tool than starting the server manually. When Elektra is installed, the kdb command together with its tools is installed globally. For instance, whenever you would like to write any shell script, which has to start a REST API server, you can just add the following line kdb run-elektrad inside your file and save it. After that, the created shell script can be executed from any directory.

Examples:

let's create the new key-value pair user/test and set its value to 5. You can do it next way:

The output of the commandline tool will be: Set string to "5". If the specified key didn't exist before, then the output will be Create a new key user/test with string "5". Elektrad will respond with code 200.

Now, the command

curl http://localhost:33333/kdb/user/test

will return us the value of the specified key user/test, which is stored in the database right now

{
"exists": true,
"name": "test",
"path": "user/test",
"ls": [
"user/test"
],
"value": "5",
"meta": ""
}

Currently, webd does not support authentication. The best way to work around this is to use a reverse proxy (e.g. nginx reverse proxy).

Once you set up a reverse proxy on your web server, you can use it to authenticate users, e.g. by username/password auth

elektrad/ - contains the daemon to interact with a single elektra instance webd/ - contains a daemon to serve the client and interact with multiple elektra instances

client/ - contains the elektra-web client (Web UI)

Lockfiles (package-lock.json) can be updated by simply deleting the current lock file and running npm install, which creates a new lock file.

Check for outdated dependencies via npm outdated. Dependencies can then be updated by running npm update.

Run the following command in the scripts/docker/web/ directory, replacing 1.5.0 with the latest version:

docker build -t elektra/web:1.5.0 -t elektra/web:latest .

Test the image:

docker run -d -it -p 33333:33333 -p 33334:33334 elektra/web:1.5.0

Publish it to the docker registry:

docker push elektra/web:1.5.0
+ <NewSubDialog
+ onChange={this.handleEdit('check/something')}
+ value={this.getMeta('check/something', '')}
+ saved={this.getSaved('check/something')}
+ />
<AdditionalMetakeysSubDialog
handleEdit={this.handleEdit.bind(this)}
getMeta={this.getMeta.bind(this)}
getSaved={this.getSaved.bind(this)}
meta={this.props.meta}
deleteMeta={this.props.deleteMeta}
/>
</FocusTrapDialog>
export const HANDLED_METADATA = [
...,
'visibility',
'binary',
+ 'check/something',
]