fastybird/ui-node

This package is not installable via Composer 1.x, please make sure you upgrade to Composer 2+. Read more about our Composer 1.x deprecation policy.

FastyBird IoT user interface node for additional user specific visualisation

dev-master 2020-12-22 10:48 UTC

This package is auto-updated.

Last update: 2021-09-22 12:16:54 UTC


README

Build Status Code coverage PHP Licence Downloads total Latest stable PHPStan

What is FastyBird user interface node?

User interface node is a microservice for managing user interface, creating visualisations and storing user interfaces presset for web and mobile app clients.

FastyBird user interface node is an Apache2 licensed distributed microservice, developed in PHP with Nette framework.

Requirements

FastyBird user interface node is tested against PHP 7.4 and ReactPHP http 0.8 event-driven, streaming plaintext HTTP server

Getting started

NOTE: If you don't want to install it manually, try docker image

The best way to install fastybird/ui-node is using Composer. If you don't have Composer yet, download it following the instructions. Then use command:

$ composer create-project --no-dev fastybird/ui-node path/to/install
$ cd path/to/install

Everything required will be then installed in the provided folder path/to/install

This microservice has one console command.

HTTP & WS server
$ vendor/bin/fb-console fb:web-server:start

This command is to start build in web server which is listening for incoming http api request messages from clients and is listening for new data from exchange bus from other microservices.

Install with docker

Docker Image Version (latest by date) Docker Image Size (latest by date) Docker Cloud Build Status

Docker image: fastybird/ui-node

Use docker hub image

$ docker run -d -it --name devices fastybird/ui-node:latest

Generate local image

$ docker build --tag=ui-node .
$ docker run -d -it --name ui-node ui-node

Configuration

This microservices is preconfigured for default connections, but your infrastructure could be different.

Configuration could be made via environment variables:

Environment Variable Description
FB_APP_PARAMETER__EXCHANGE_HOST=127.0.0.1 RabbitMQ host address
FB_APP_PARAMETER__EXCHANGE_PORT=5672 RabbitMQ access port
FB_APP_PARAMETER__EXCHANGE_VHOST=/ RabbitMQ vhost
FB_APP_PARAMETER__EXCHANGE_USERNAME=guest Username
FB_APP_PARAMETER__EXCHANGE_PASSWORD=guest Password
FB_APP_PARAMETER__DATABASE_VERSION=5.7 MySQL server version
FB_APP_PARAMETER__DATABASE_HOST=127.0.0.1 MySQL host address
FB_APP_PARAMETER__DATABASE_PORT=3306 MySQL access port
FB_APP_PARAMETER__DATABASE_DBNAME=ui_node MySQL database name
FB_APP_PARAMETER__DATABASE_USERNAME=root Username
FB_APP_PARAMETER__DATABASE_PASSWORD= Password
FB_APP_PARAMETER__WS_PORT=8080 WS server access port
FB_APP_PARAMETER__SERVER_ADDRESS=0.0.0.0 HTTP server host address
FB_APP_PARAMETER__SERVER_PORT=8000 HTTP server access port
FB_APP_PARAMETER__SECURITY_SIGNATURE= Security token signature string

NOTE: In case you are not using docker image or you are not able to configure environment variables, you could edit configuration file ./config/default.neon

Initialization

This microservice is using database, so database have to be initialise with basic database schema. It could be done via shell command:

$ php vendor/bin/doctrine orm:schema-tool:create

After this steps, microservice could be started with server command

Feedback

Use the issue tracker for bugs or mail or Tweet us for any idea that can improve the project.

Thank you for testing, reporting and contributing.

Changelog

For release info check release page

Maintainers

1866672?s=460&v=4
Adam Kadlec

Homepage https://www.fastybird.com and repository http://github.com/fastybird/ui-node.