matrix-docker-ansible-deploy/roles/custom/matrix-dimension/tasks/validate_config.yml

---

- name: Fail if required Dimension settings not defined
  ansible.builtin.fail:
    msg: >
      You need to define a required configuration setting (`{{ item.name }}`).      
  when: "item.when | bool and vars[item.name] == ''"
  with_items:
    - {'name': 'matrix_dimension_access_token', when: true}
    - {'name': 'matrix_dimension_database_hostname', when: "{{ matrix_dimension_database_engine == 'postgres' }}"}

- name: (Deprecation) Catch and report renamed Dimension variables
  ansible.builtin.fail:
    msg: >-
      Your configuration contains a variable, which now has a different name.
      Please change your configuration to rename the variable (`{{ item.old }}` -> `{{ item.new }}`).      
  when: "item.old in vars"
  with_items:
    - {'old': 'matrix_dimension_container_expose_port', 'new': '<superseded by matrix_dimension_container_http_host_bind_port>'}