101 lines
2.8 KiB
Markdown
101 lines
2.8 KiB
Markdown
---
|
|
title: Configuration
|
|
---
|
|
|
|
_ansible-doctor_ comes with default settings which should be sufficient for most users to start, but most of the settings can be adjusted.
|
|
|
|
{{< toc >}}
|
|
|
|
Configuration options can be set in different places, which are processed in the following order (last wins):
|
|
|
|
- Standard configuration (built-in)
|
|
- Global configuration file (the path depends on the operating system)
|
|
- Folder-based configuration file (`.ansibledoctor.yml|.ansibledoctor.yaml|.ansibledoctor`) in the current working directory
|
|
- Environment Variables
|
|
- CLI options
|
|
|
|
## Defaults
|
|
|
|
```YAML
|
|
---
|
|
# default is the current working directory
|
|
role_dir:
|
|
# default is the basename of 'role_name'
|
|
role_name:
|
|
# Auto-detect if the given directory is a role, can be disabled
|
|
# to parse loose files instead.
|
|
role_detection: True
|
|
# don't write anything to file system
|
|
dry_run: False
|
|
|
|
logging:
|
|
# possible options debug | info | warning | error | critical
|
|
level: "warning"
|
|
# json logging can be enabled if a parsable output is required
|
|
json: False
|
|
|
|
# path to write rendered template file
|
|
# default is the current working directory
|
|
output_dir:
|
|
# default is in-build templates directory
|
|
template_dir:
|
|
template: readme
|
|
|
|
# don't ask to overwrite if output file exists
|
|
force_overwrite: False
|
|
# load custom header from given file and append template output
|
|
# to it before write.
|
|
custom_header: ""
|
|
|
|
exclude_files: []
|
|
# Examples
|
|
# exclude_files:
|
|
# - molecule/
|
|
# - files/**/*.py
|
|
```
|
|
|
|
## CLI
|
|
|
|
```Shell
|
|
$ ansible-doctor --help
|
|
usage: ansible-doctor [-h] [-c CONFIG_FILE] [-o OUTPUT_DIR] [-f] [-d] [-n] [-v] [-q] [--version] [role_dir]
|
|
|
|
Generate documentation from annotated Ansible roles using templates
|
|
|
|
positional arguments:
|
|
role_dir role directory (default: current working dir)
|
|
|
|
optional arguments:
|
|
-h, --help show this help message and exit
|
|
-c CONFIG_FILE, --config CONFIG_FILE
|
|
location of configuration file
|
|
-o OUTPUT_DIR, --output OUTPUT_DIR
|
|
output base dir
|
|
-f, --force force overwrite output file
|
|
-d, --dry-run dry run without writing
|
|
-n, --no-role-detection
|
|
disable automatic role detection
|
|
-v increase log level
|
|
-q decrease log level
|
|
--version show program's version number and exit
|
|
```
|
|
|
|
## Environment Variables
|
|
|
|
```Shell
|
|
ANSIBLE_DOCTOR_CONFIG_FILE=
|
|
ANSIBLE_DOCTOR_ROLE_DETECTION=true
|
|
ANSIBLE_DOCTOR_ROLE_DIR=
|
|
ANSIBLE_DOCTOR_ROLE_NAME=
|
|
ANSIBLE_DOCTOR_DRY_RUN=false
|
|
ANSIBLE_DOCTOR_LOG_LEVEL=warning
|
|
ANSIBLE_DOCTOR_LOG_JSON=false
|
|
ANSIBLE_DOCTOR_OUTPUT_DIR=
|
|
ANSIBLE_DOCTOR_TEMPLATE_DIR=
|
|
ANSIBLE_DOCTOR_TEMPLATE=readme
|
|
ANSIBLE_DOCTOR_FORCE_OVERWRITE=false
|
|
ANSIBLE_DOCTOR_CUSTOM_HEADER=
|
|
ANSIBLE_DOCTOR_EXCLUDE_FILES=
|
|
ANSIBLE_DOCTOR_EXCLUDE_FILES=molecule/,files/**/*.py
|
|
```
|