bedrock-config-yaml

bedrock-config-yaml

This module is used to layer a deployment Bedrock configuration defined in a YAML file onto bedrock.config. Values defined in the YAML config may add and overwrite values in bedrock.config. The YAML configuration is applied after all conventional Bedrock module configuration has been completed. If there is no YAML configuration file found in the location specified by the bedrock-config-yaml config, Bedrock startup proceeds normally and no configuration changes are applied.

Usage

To ensure that no other module will override the YAML configuration, bedrock-config-yaml should be the last import before bedrock.start() is called. If bedrock-config-yaml is not the last bedrock-cli.parsed or bedrock.configure event handler, an error will be thrown that will prevent application startup.

There are two separate configuration files that are applied when different events occur during Bedrock startup: core and app.

Core Config

The core config is used to configure core Bedrock features such as the number of workers or the default log formatter. The core config is applied by the last handler for the bedrock-cli.parsed event. The default location for the core config is: /etc/bedrock-config/core.yaml.

Sample core.yaml

core:
  workers: 2
loggers:
  console:
    bedrock:
      formatter: logstash

App Config

The app config is used to configure Bedrock application/module features. The app config is applied by the last handler for the bedrock.configure event. The default location for the app config is: /etc/bedrock-config/app.yaml.

Sample app.yaml

test-bedrock-module:
  foo: fromYaml
  overwriteMe: fromYaml
another-bedrock-module:
  host: example.com
  port: 18443

Changelog

2.1.0 - 2021-07-16

Added:

• Add support for a combined.yaml file that may contain both an app and core section. This file may be used instead of, or in combination with separate app.yaml and core.yaml files. If used in conjunction with separate files, the values in the app.yaml and core.yaml files will override the values in the combined.yaml file. The use of a single combined.yaml file simplifies some deployment environments.