377f5e4124
This drops support for the TCP port and switches to using a socket at /var/run/weldr/api.socket Also add the start of some docs for lorax-composer. --host and --port argument have been removed. --group sets the group name to use for access to the socket and its parent directory. Defaults to 'weldr' --socket sets the full path to the socket to create. Defaults to '/var/run/weldr/api.socket'
38 lines
1.4 KiB
ReStructuredText
38 lines
1.4 KiB
ReStructuredText
lorax-composer
|
|
==============
|
|
|
|
:Authors:
|
|
Brian C. Lane <bcl@redhat.com>
|
|
|
|
lorax-composer is an API server that is compatible with the Weldr project's
|
|
bdcs-api REST protocol. More information on Weldr can be found [on the Weldr
|
|
blog](https://www.weldr.io).
|
|
|
|
The server runs as root, and communication with it is via a unix domain socket
|
|
(``/run/weldr/api.socket`` by default). The directory and socket are owned by
|
|
root:weldr so that any user in the weldr group can use the API to control
|
|
lorax-composer.
|
|
|
|
When starting the server it will check for the correct permissions and
|
|
ownership of pre-existing directory, or it will create a new one if none exist.
|
|
The socket path and group owner's name can be changed from the cmdline by
|
|
passing it the ``--socket`` and ``--group`` arguments.
|
|
|
|
Logs
|
|
----
|
|
|
|
Logs are stored under ``/var/log/lorax-composer/`` and includes all console
|
|
messages as well as extra debugging info and API requests.
|
|
|
|
Quickstart
|
|
----------
|
|
|
|
1. Create a ``weldr`` group by running ``groupadd weldr``
|
|
2. Remove any pre-existing socket directory with ``rm -rf /run/weldr/``
|
|
A new directory with correct permissions will be created the first time the server runs.
|
|
3. Either start it via systemd with ``systemctl start lorax-composer`` or
|
|
run it directly with ``lorax-composer /path/to/recipes/``
|
|
|
|
The ``/path/to/recipes/`` is where the recipe's git repo will be created, and all
|
|
the recipes created with the ``/api/v0/recipes/new`` route will be stored.
|