Add new RADL option #1121

grycap · Feb 24, 2021 · ae76c35 · ae76c35
1 parent 82b14c5
commit ae76c35
Showing 1 changed file with 8 additions and 0 deletions.
diff --git a/doc/source/radl.rst b/doc/source/radl.rst
@@ -33,6 +33,7 @@ An RADL document has the next general structure::
    configure <configure_id> (<Ansible recipes>)
 
    contextualize [max_time] (
+     option <option_name> = <value>
      system <system_id> configure <configure_id> [step <num>]
      ...
    )
@@ -606,13 +607,20 @@ tool to use en each case.
 The contextualize section has the next structure::
 
    contextualize <max_context_time> (
+      option <option_name> = <value>
       system <system_id> configure <configure_id> [step <num>] [with (Ansible|cloud_init)]
       ...
    )
 
 The ``max_context_time`` value enables to set a timeout for the contextualization step to enable to
 kill the process if some of the steps takes more time than expected.
 
+The optional "option" lines enable to specify some contextualizacion option values. Currently only
+``ansible_version`` is supported. It enables the user to specify the ansible version to be installed
+in the "master" VM that will be used to configure all the VMs of the infrastructure. For example::
+
+   option ansible_version = 2.6.20
+
 Each line inside the contextualize section enables to specify which configure section ``configure_id``
 will be applied in the nodes of type ``system_id``. Optionally a step number can be specified to set
 the execution order. For example::