feat: expose some config options as env variables (#1099)

Includes global and some MQTT options for now.

Closes #1094

Author: mKeRix

docs/guide/configuration.md

@@ -14,7 +14,7 @@ Having trouble with your configuration? You can launch room-assistant with the `
 
 ## Configuring with Docker
 
-The official [Docker image](https://hub.docker.com/r/mkerix/room-assistant/) can be configured in two different ways. You can either mount your local config folder into the container as `/room-assistant/config` or you can provide the configuration as JSON through an environment variable.
+The official [Docker image](https://hub.docker.com/r/mkerix/room-assistant/) can be configured in two different ways. You can either mount your local config folder into the container as `/room-assistant/config` or you can provide the configuration as JSON through an environment variable. Some settings may also be configured via special environment variables, in those cases the variable names are documented next to the options.
 
 ::: details Example docker-compose.yml
 
@@ -27,10 +27,10 @@ services:
     volumes:
       - /var/run/dbus:/var/run/dbus
     environment:
+      RA_GLOBAL_INSTANCE_NAME: living-room
       NODE_CONFIG: >
         {
           "global": {
-            "instanceName": "living-room",
             "integrations": ["homeAssistant", "bluetoothClassic"]
           }
         }
@@ -50,7 +50,10 @@ room-assistant exposes a few settings that affect the overall behavior of the ap
 | `integrations` | Array  |          | The integrations that should be loaded on this instance, denoted as camelCase. |
 | `apiPort`      | Number | `6415`   | The port that the REST API should be available on.           |
 
+These settings may also be configured as environment variables, using `RA_GLOBAL_INSTANCE_NAME`, `RA_GLOBAL_INTEGRATIONS` and `RA_GLOBAL_API_PORT`.
+
 ::: details Example Config
+
 ```yaml
 global:
   instanceName: bedroom

docs/integrations/home-assistant.md

@@ -35,6 +35,8 @@ room-assistant makes use of the [MQTT auto discovery](https://www.home-assistant
 | `password`           | String  |         | Password for authentication                                  |
 | `rejectUnauthorized` | Boolean | `true`  | Whether MQTTS connections should fail for invalid certificates or not. Set this to `false` if you are using a self-signed certificate and connect via TLS. |
 
+Some of these settings may also be configured as environment variables, using `RA_HOME_ASSISTANT_MQTT_URL`, `RA_HOME_ASSISTANT_MQTT_USERNAME` and `RA_HOME_ASSISTANT_MQTT_PASSWORD`.
+
 ::: details Example Config
 
 ```yaml

docs/integrations/mqtt.md

@@ -115,6 +115,8 @@ To get started with your automations based on these topics it is recommended to
 | `password`           | String  |         | Password for authentication                                  |
 | `rejectUnauthorized` | Boolean | `true`  | Whether MQTTS connections should fail for invalid certificates or not. Set this to `false` if you are using a self-signed certificate and connect via TLS. |
 
+Some of these settings may also be configured as environment variables, using `RA_MQTT_MQTT_URL`, `RA_MQTT_MQTT_USERNAME` and `RA_MQTT_MQTT_PASSWORD`.
+
 ::: details Example Config
 
 ```yaml

nest-cli.json

@@ -2,6 +2,7 @@
   "collection": "@nestjs/schematics",
   "sourceRoot": "src",
   "compilerOptions": {
-    "plugins": ["@nestjs/swagger/plugin"]
+    "plugins": ["@nestjs/swagger/plugin"],
+    "assets": ["config/definitions/*.yml"]
   }
 }

package.json

@@ -21,6 +21,7 @@
   "types": "dist/src/main.d.ts",
   "files": [
     "dist/**/*.{js,ts}",
+    "dist/config/definitions/*.yml",
     "bin/*.js",
     ".github/FUNDING.yml"
   ],

src/config/definitions/custom-environment-variables.yml

@@ -0,0 +1,18 @@
+global:
+  instanceName: RA_GLOBAL_INSTANCE_NAME
+  integrations:
+    __name: RA_GLOBAL_INTEGRATIONS
+    __format: json
+  apiPort:
+    __name: RA_GLOBAL_API_PORT
+    __format: number
+homeAssistant:
+  mqttUrl: RA_HOME_ASSISTANT_MQTT_URL
+  mqttOptions:
+    username: RA_HOME_ASSISTANT_MQTT_USERNAME
+    password: RA_HOME_ASSISTANT_MQTT_PASSWORD
+mqtt:
+  mqttUrl: RA_MQTT_MQTT_URL
+  mqttOptions:
+    username: RA_MQTT_MQTT_USERNAME
+    password: RA_MQTT_MQTT_PASSWORD