KB - Configbuilder errors during startup

Affects product

  • Microgateway

Question or problem

The following errors result in an error log message and prevent the container from starting up.

  • General errors
  • an external file is explicitly referenced but not found
  • Errors in config.yaml
  • the config.yaml file is not a valid YAML file or does not exist
  • invalid attributes are used
  • invalid values are used
  • structure mismatch, e.g., providing a single value when a list is expected

Explicitly referenced files not found

  1. Instruction
  2. Check the path of the corresponding DSL attribute with the suffix _file.
  3. Check if the file is available in the configbuilder container.
  4. Either correct the path in config.yaml or mount the file accordingly.
  5. The configbuilder can access the files configured with the DSL attributes _file.

The config.yaml is invalid or does not exist

  1. Instruction
  2. Check if the configuration file is available in the configbuilder container at /config/config.yaml.
  3. Check that the DSL attributes are used correctly.
    • Correct attribute name
    • Correct attribute value
    • Correct attribute type

    Use the (Microgateway) DSL reference to accomplish this task. The referenced examples might help as well.

  4. Check with a YAML syntax checker, whether it is valid YAML.
  5. The Configbuilder can successfully read and interpret the config.yaml file.

Outdated links or content?

In case of outdated links or bad content, please let us know by sending an email with a short description of your findings. Thank you very much!