Chemins

Où se trouvent la configuration, les formulaires, les playbooks, les fichiers téléversés et les sauvegardes

Exemple
Variables

Modifiez-les pour conserver une partie des données sur un autre volume, par exemple les sauvegardes et les fichiers téléversés sur un stockage plus grand ou moins cher.

Exemple

Les sauvegardes et les fichiers téléversés sur un volume séparé, le reste des données dans le dossier persistant habituel. Dans docker-compose.yml :

    environment:
      - BACKUP_PATH=/data/backups
      - FORMS_BACKUP_PATH=/data/forms_backups
      - UPLOAD_PATH=/data/uploads
    volumes:
      - /srv/ansibleforms-data:/data

Un nouveau chemin ne s’applique qu’aux nouveaux fichiers : ce qui se trouve déjà dans l’ancien dossier n’est pas déplacé, copiez-le donc vous-même.

Variables

Toutes les variables de ce groupe, avec leur type, leur valeur par défaut et leur description :

Variable	Choix/Valeurs par défaut	Commentaires
BACKUP_PATH string	Par défaut : %PERSISTENT_FOLDER%/backups	Backups folder a valid directory path AnsibleForms can backup the database and forms. This is the path where the backups are stored. The backup folder is created at first start if not present and a timestamp folder is created for each backup.
CONFIG_PATH string added in version 6.1.0	Par défaut : %PERSISTENT_FOLDER%/config.yaml	config.yaml path a valid file path The config.yaml file contains application configuration (categories, roles, constants). Forms are not in this file: they are stored in the forms folder (FORMS_FOLDER_PATH).
FORMS_FOLDER_PATH string added in version 6.1.0	Par défaut : %PERSISTENT_FOLDER%/forms	Forms folder a valid directory path The directory where individual form YAML files are stored. Forms can be organized in subdirectories within this folder.
FORMS_STAGING_PATH string added in version 6.1.0	Par défaut : %PERSISTENT_FOLDER%/forms_staging	Forms staging folder a valid directory path When forms come from a git repository, a form created or edited in the designer is written here first and only lands in the repository once it is pushed. The loader reads this folder alongside the repository ones, so a staged form is usable immediately.
FORMS_BACKUP_PATH string added in version 4.0.3	Par défaut : %PERSISTENT_FOLDER%/forms_backups	Form backups folder a valid directory path When backups are made, they end up in this path
HOME_PATH string added in version 3.0.0	Par défaut : OS Homedir path	Home folder a valid path AnsibleForms generates an sshkey at first start, is one is not present, so you can have a git connection or other password-less connection. Typically this key is stored in the users home-directory under `/.ssh/id_rsa`. You can set this homedirectory path manually with this property.
REPO_PATH string added in version 3.0.0	Par défaut : %PERSISTENT_FOLDER%/repositories	Repositories folder a valid path This path is the root path for your local repositories, allowing you to integrate data with git repositories.
VARS_FILES_PATH string added in version 6.1.0	Par défaut : %PERSISTENT_FOLDER%/vars	Vars files folder a valid directory path Base directory for resolving relative paths in form varsFiles property. Absolute paths in varsFiles are used as-is. Relative paths are resolved against this directory. Allows centralized management of shared variable files across forms.
INVENTORY_PATH string added in version 7.0.0	Par défaut : %PERSISTENT_FOLDER%/inventories	Inventories folder a valid directory path The local inventories folder: one folder per inventory (staging/inventory.yaml, with its group_vars and host_vars), edited in the designer’s Inventories section, next to the repositories used for inventories (each of them an inventory). A playbook form names one with `inventory: <name>`. Read by the RTE as well, where the playbook runs: set it there too (or mount the same folder) when the RTE runs elsewhere.
WORKFLOWS_PATH string added in version 7.0.0	Par défaut : %PERSISTENT_FOLDER%/workflows	Workflows folder a valid directory path The local workflows folder: workflow files in the AWX export syntax (workflow_job_templates, a job template node running one of the designer’s playbooks), edited in the designer’s Workflows section, next to the repositories used for workflows. A workflow form runs one with `workflow: <name>`.
ANSIBLE_PATH string	Par défaut : %PERSISTENT_FOLDER%/playbooks	Where an RTE finds the playbooks a valid path Read by an RTE (`AF_ROLE=rte`): the folder its playbooks run from when no repository is marked for playbooks. Since 7 the app runs no playbook itself, so set this in the RTE container’s environment ; it is not editable on the Settings page.
UPLOAD_PATH string added in version 4.0.16	Par défaut : %PERSISTENT_FOLDER%/uploads	Uploads folder a valid path Since 4.0.16, a new field type is introduced that allows file uploads. The files are uploaded in this path.