ansible-doctor/example/demo-role/README.md

4.0 KiB
Raw Blame History

demo-role-custom-header

Build Status License: GPL-3.0

Role to demonstrate ansible-doctor. It is also possible to overwrite the default description with an annotation.

Table of content


Requirements

  • Minimum Ansible version: 2.10

Default Variables

demo_bool

Default value

demo_bool: true

Example usage

demo_bool: false

demo_role_deprecated

Deprecated

Default value

demo_role_deprecated: b

demo_role_deprecated_info

Deprecated: This variable is deprected since v2.0.0 and will be removed in a future release.
Type: string

Default value

demo_role_deprecated_info: a

demo_role_dict

Default value

demo_role_dict:
  key1:
    sub: some value

Example usage

demo_role_dict:
  key1:
    sub: some value

  # Inline description
  key2:
    sublist:
      - subval1
      - subval2

demo_role_empty

Default value

demo_role_empty: ''

demo_role_empty_dict

... or valid json can be used. In this case, the json will be automatically prefixed with the annotation key and filters like to_nice_yaml can be used in templates. To get it working, the json need to be prefixed with a $.

Default value

demo_role_empty_dict: {}

Example usage

demo_role_empty_dict:
  key1:
    sub: some value
  key2:
    sublist:
      - subval1
      - subval2

demo_role_other_tags

If a variable need some more explanation, this is a good place to do so.

Default value

demo_role_other_tags: []

Example usage

demo_role_other_tags:
  - package1
  - package2

demo_role_override

Default value

demo_role_override: test

demo_role_override_complex

Default value

demo_role_override_complex:
  foo: bar
  second: value

demo_role_single

Default value

demo_role_single: b

demo_role_undefined_var

To highlight a variable that has not set a value by default, this is one way to achieve it. Make sure to flag it as json value: @var demo_role_undefined_var: $ "_unset_"

Attribute Description
value1 desc1

Default value

demo_role_undefined_var: _unset_

demo_role_unset

Values can be plain strings, but there is no magic or autoformatting...

Default value

demo_role_unset:

Example usage

demo_role_unset: some_value

Discovered Tags

role-tag1

role-tag2

single-tag
Example description of tag single-tag

Open Tasks

  • Unscoped general todo.
  • (bug): Some bug that is known and need to be fixed.
  • (bug): Multi line description are possible as well. Some bug that is known and need to be fixed.
  • (improvement): Some things that need to be improved.

Dependencies

  • role2

License

MIT

Author

John Doe