4.0 KiB
demo-role-custom-header
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