2017-11-11 00:59:26 +00:00
accelerate : "*DEPRECATED*, set to True to use accelerate connection plugin."
accelerate_ipv6 : "*DEPRECATED*, set to True to force accelerate plugin to use ipv6 for its connection."
accelerate_port : "*DEPRECATED*, set to override default port use for accelerate connection."
2017-09-07 19:46:53 +00:00
action : "The 'action' to execute for a task, it normally translates into a C(module) or action plugin."
2017-11-11 00:59:26 +00:00
args : "*DEPRECATED*, A secondary way to add arguments into a task. Takes a dictionary in which keys map to options and values."
2017-03-20 20:07:27 +00:00
always : List of tasks, in a block, that execute no matter if there is an error in the block or not.
2017-11-11 00:59:26 +00:00
always_run : "*DEPRECATED*, forces a task to run even in check mode. Use :term:`check_mode` directive instead."
2017-03-20 20:07:27 +00:00
any_errors_fatal : Force any un-handled task errors on any host to propagate to all hosts and end the play.
async : Run a task asyncronouslly if the C(action) supports this.
2017-09-07 19:46:53 +00:00
become : Boolean that controls if privilege escalation is used or not on :term:`Task` execution.
become_flags : A string of flag(s) to pass to the privilege escalation program when :term:`become` is True.
2017-11-11 00:59:26 +00:00
become_method : Which method of privilege escalation to use (such as sudo or su).
become_user : "User that you 'become' after using privilege escalation. The remote/login user must have permissions to become this user."
2017-03-20 20:07:27 +00:00
block : List of tasks in a block.
2017-09-07 19:46:53 +00:00
changed_when : "Conditional expression that overrides the task's normal 'changed' status."
2017-11-11 00:59:26 +00:00
check_mode : |
A boolean that controls if a task is executed in 'check' mode
.. seealso: : : ref:`check_mode_dry`
connection : |
Allows you to change the connection plugin used for tasks to execute on the target.
.. seealso: : : ref:`using_connection`
delay : Number of seconds to delay between retries. This setting is only used in combination with :term:`until`.
delegate_facts : Boolean that allows you to apply facts to a delegated host instead of inventory_hostname.
delegate_to : Host to execute task instead of the target (inventory_hostname). Connection vars from the delegated host will also be used for the task.
2017-09-07 19:46:53 +00:00
diff : "Toggle to make tasks return 'diff' information or not."
2017-03-15 15:29:58 +00:00
environment : A dictionary that gets converted into environment vars to be provided for the task upon execution.
2017-09-07 19:46:53 +00:00
fact_path : Set the fact path option for the fact gathering plugin controlled by :term:`gather_facts`.
failed_when : "Conditional expression that overrides the task's normal 'failed' status."
2017-11-11 00:59:26 +00:00
force_handlers : Will force notified handler execution for hosts even if they failed during the play. Will not trigger if the play itself fails.
2017-09-07 19:46:53 +00:00
gather_facts : "A boolean that controls if the play will automatically run the 'setup' task to gather facts for the hosts."
gather_subset : Allows you to pass subset options to the fact gathering plugin controlled by :term:`gather_facts`.
gather_timeout : Allows you to set the timeout for the fact gathering plugin controlled by :term:`gather_facts`.
2017-11-11 00:59:26 +00:00
handlers : "A section with tasks that are treated as handlers, these won't get executed normally, only when notified after each section of tasks is complete."
2017-09-07 19:46:53 +00:00
hosts : "A list of groups, hosts or host pattern that translates into a list of hosts that are the play's target."
2017-03-15 15:29:58 +00:00
ignore_errors : Boolean that allows you to ignore task failures and continue with play. It does not affect connection errors.
move from with_<lookup>: to loop:
- old functionality is still available direct lookup use, the following are equivalent
with_nested: [[1,2,3], ['a','b','c']]
loop: "{{lookup('nested', [1,2,3], ['a','b','c'])}}"
- avoid squashing with 'loop:'
- fixed test to use new intenal attributes
- removed most of 'lookup docs' as these now reside in the plugins
2017-09-17 03:32:34 +00:00
loop : "Takes a list for the task to iterate over, saving each list element into the ``item`` variable (configurable via loop_control)"
2017-11-11 00:59:26 +00:00
loop_control : |
Several keys here allow you to modify/set loop behaviour in a task.
.. seealso: : : ref:`loop_control`
2017-03-20 20:07:27 +00:00
max_fail_percentage : can be used to abort the run after a given percentage of hosts in the current batch has failed.
2017-11-11 00:59:26 +00:00
name : "Identifier. Can be used for documentation, in or tasks/handlers."
2017-03-15 15:29:58 +00:00
no_log : Boolean that controls information disclosure.
2017-11-11 00:59:26 +00:00
notify : "List of handlers to notify when the task returns a 'changed=True' status."
2017-05-16 19:54:19 +00:00
order : Controls the sorting of hosts as they are used for executing the play. Possible values are inventory (default), sorted, reverse_sorted, reverse_inventory and shuffle.
2017-08-10 17:29:34 +00:00
poll : Sets the polling interval in seconds for async tasks (default 10s).
2017-03-20 20:07:27 +00:00
port : Used to override the default port used in a connection.
2017-09-07 19:46:53 +00:00
post_tasks : A list of tasks to execute after the :term:`tasks` section.
pre_tasks : A list of tasks to execute before :term:`roles`.
2017-11-11 00:59:26 +00:00
remote_user : User used to log into the target via the connection plugin.
2017-08-10 17:29:34 +00:00
register : Name of variable that will contain task status and module return data.
2017-09-07 19:46:53 +00:00
rescue : List of tasks in a :term:`block` that run if there is a task error in the main :term:`block` list.
retries : "Number of retries before giving up in a :term:`until` loop. This setting is only used in combination with :term:`until`."
2017-08-10 17:29:34 +00:00
roles : List of roles to be imported into the play
2017-03-15 15:29:58 +00:00
run_once : Boolean that will bypass the host loop, forcing the task to execute on the first host available and will also apply any facts to all active hosts.
2017-11-11 00:59:26 +00:00
serial : |
Explicitly define how Ansible batches the execution of the current play on the play's target
.. seealso: : : ref:`rolling_update_batch_size`
2017-03-15 15:29:58 +00:00
strategy : Allows you to choose the connection plugin to use for the play.
tags : Tags applied to the task or included tasks, this allows selecting subsets of tasks from the command line.
2017-09-07 19:46:53 +00:00
tasks : Main list of tasks to execute in the play, they run after :term:`roles` and before :term:`post_tasks`.
until : "This keyword implies a ':term:`retries` loop' that will go on until the condition supplied here is met or we hit the :term:`retries` limit."
2017-03-15 15:29:58 +00:00
vars : Dictionary/map of variables
2017-03-20 20:07:27 +00:00
vars_files : List of files that contain vars to include in the play.
vars_prompt : list of variables to prompt for.
vault_password : Secret used to decrypt vaulted files or variables.
when : Conditional expression, determines if an iteration of a task is run or not.