Devices node is a core microservice for managing all connected devices, managing basic devices logic and exposing them for clients.
FastyBird devices node is an Apache2 licensed distributed microservice, developed in PHP with Nette framework.
FastyBird devices node is tested against PHP 7.4 and ReactPHP http 0.8 event-driven, streaming plaintext HTTP server and RabbitMQ 3.7 message broker
NOTE: If you don't want to install it manually, try docker image
The best way to install fastybird/devices-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/devices-node path/to/install
$ cd path/to/installEverything required will be then installed in the provided folder path/to/install
This microservice has several console command.
$ vendor/bin/fb-console fb:web-server:startThis 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.
Docker image: fastybird/devices-node
$ docker run -d -it --name devices fastybird/devices-node:latest$ docker build --tag=devices-node .
$ docker run -d -it --name devices-node devices-nodeThis microservice 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=devices_node |
MySQL database name |
FB_APP_PARAMETER__DATABASE_USERNAME=root |
Username |
FB_APP_PARAMETER__DATABASE_PASSWORD= |
Password |
FB_APP_PARAMETER__STORAGE_HOST=127.0.0.1 |
CouchDB host address |
FB_APP_PARAMETER__STORAGE_PORT=1883 |
CouchDB access port |
FB_APP_PARAMETER__STORAGE_USERNAME=null |
Username |
FB_APP_PARAMETER__STORAGE_PASSWORD=null |
Password |
FB_APP_PARAMETER__MQTT_HOST=127.0.0.1 |
VerneMQ host address |
FB_APP_PARAMETER__MQTT_PORT=1883 |
VerneMQ access port |
FB_APP_PARAMETER__MQTT_USERNAME=guest |
Username |
FB_APP_PARAMETER__MQTT_PASSWORD=guest |
Password |
FB_APP_PARAMETER__MQTT_CLIENTID=guest |
MQTT client ID |
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
This microservice is using database, and need some initial data to be inserted into it. This could be done via shell command:
$ vendor/bin/fb-console fb:initializeThis console command is interactive and will ask for all required information.
After this steps, microservice could be started with server command
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.
For release info check release page
Adam Kadlec |
Homepage https://www.fastybird.com and repository https://github.com/fastybird/devices-node.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent