diff options
Diffstat (limited to 'lib/ansible/keyword_desc.yml')
| -rw-r--r-- | lib/ansible/keyword_desc.yml | 20 |
1 files changed, 10 insertions, 10 deletions
diff --git a/lib/ansible/keyword_desc.yml b/lib/ansible/keyword_desc.yml index 1e8d844a..22a612cc 100644 --- a/lib/ansible/keyword_desc.yml +++ b/lib/ansible/keyword_desc.yml @@ -5,7 +5,7 @@ action: "The 'action' to execute for a task, it normally translates into a C(mod args: "A secondary way to add arguments into a task. Takes a dictionary in which keys map to options and values." always: List of tasks, in a block, that execute no matter if there is an error in the block or not. 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 asynchronously if the C(action) supports this; value is maximum runtime in seconds. +async: Run a task asynchronously if the C(action) supports this; the value is the maximum runtime in seconds. become: Boolean that controls if privilege escalation is used or not on :term:`Task` execution. Implemented by the become plugin. See :ref:`become_plugins`. become_exe: Path to the executable used to elevate privileges. Implemented by the become plugin. See :ref:`become_plugins`. become_flags: A string of flag(s) to pass to the privilege escalation program when :term:`become` is True. @@ -23,25 +23,25 @@ collections: | connection: Allows you to change the connection plugin used for tasks to execute on the target. See :ref:`using_connection`. -debugger: Enable debugging tasks based on state of the task result. See :ref:`playbook_debugger`. +debugger: Enable debugging tasks based on the state of the task result. See :ref:`playbook_debugger`. 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. diff: "Toggle to make tasks return 'diff' information or not." -environment: A dictionary that gets converted into environment vars to be provided for the task upon execution. This can ONLY be used with modules. This isn't supported for any other type of plugins nor Ansible itself nor its configuration, it just sets the variables for the code responsible for executing the task. This is not a recommended way to pass in confidential data. +environment: A dictionary that gets converted into environment vars to be provided for the task upon execution. This can ONLY be used with modules. This is not supported for any other type of plugins nor Ansible itself nor its configuration, it just sets the variables for the code responsible for executing the task. This is not a recommended way to pass in confidential data. 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." force_handlers: Will force notified handler execution for hosts even if they failed during the play. Will not trigger if the play itself fails. 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_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`. 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. A handler's `listen` field is not templatable." hosts: "A list of groups, hosts or host pattern that translates into a list of hosts that are the play's target." ignore_errors: Boolean that allows you to ignore task failures and continue with play. It does not affect connection errors. ignore_unreachable: Boolean that allows you to ignore task failures due to an unreachable host and continue with the play. This does not affect other task errors (see :term:`ignore_errors`) but is useful for groups of volatile/ephemeral hosts. loop: "Takes a list for the task to iterate over, saving each list element into the ``item`` variable (configurable via loop_control)" -loop_control: Several keys here allow you to modify/set loop behaviour in a task. See :ref:`loop_control`. -max_fail_percentage: can be used to abort the run after a given percentage of hosts in the current batch has failed. This only works on linear or linear derived strategies. +loop_control: Several keys here allow you to modify/set loop behavior in a task. See :ref:`loop_control`. +max_fail_percentage: can be used to abort the run after a given percentage of hosts in the current batch has failed. This only works on linear or linear-derived strategies. module_defaults: Specifies default parameter values for modules. name: "Identifier. Can be used for documentation, or in tasks/handlers." no_log: Boolean that controls information disclosure. @@ -56,13 +56,13 @@ register: Name of variable that will contain task status and module return data. 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`." roles: List of roles to be imported into the play -run_once: Boolean that will bypass the host loop, forcing the task to attempt to execute on the first host available and afterwards apply any results and facts to all active hosts in the same batch. +run_once: Boolean that will bypass the host loop, forcing the task to attempt to execute on the first host available and afterward apply any results and facts to all active hosts in the same batch. serial: Explicitly define how Ansible batches the execution of the current play on the play's target. See :ref:`rolling_update_batch_size`. -strategy: Allows you to choose the connection plugin to use for the play. +strategy: Allows you to choose the strategy plugin to use for the play. See :ref:`strategy_plugins`. tags: Tags applied to the task or included tasks, this allows selecting subsets of tasks from the command line. tasks: Main list of tasks to execute in the play, they run after :term:`roles` and before :term:`post_tasks`. -timeout: Time limit for task to execute in, if exceeded Ansible will interrupt and fail the task. -throttle: Limit number of concurrent task runs on task, block and playbook level. This is independent of the forks and serial settings, but cannot be set higher than those limits. For example, if forks is set to 10 and the throttle is set to 15, at most 10 hosts will be operated on in parallel. +timeout: Time limit for the task to execute in, if exceeded Ansible will interrupt and fail the task. +throttle: Limit the number of concurrent task runs on task, block and playbook level. This is independent of the forks and serial settings, but cannot be set higher than those limits. For example, if forks is set to 10 and the throttle is set to 15, at most 10 hosts will be operated on in parallel. 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." vars: Dictionary/map of variables vars_files: List of files that contain vars to include in the play. |