You are reading an unmaintained version of the Ansible documentation. Unmaintained Ansible versions can contain unfixed security vulnerabilities (CVE). Please upgrade to a maintained version. See the latest Ansible documentation.

Ansible.Builtin

Collection version 2.13.10.post0

Description 

These are all modules and plugins contained in ansible-core.

Author:

Ansible, Inc.

Issue Tracker Repository (Sources)

Communication 

Matrix room #users:ansible.im: General usage and support questions.
IRC channel #ansible (Libera network): General usage and support questions.
Mailing list: Ansible Project List. (Subscribe)

Plugin Index 

These are the plugins in the ansible.builtin collection:

Modules

add_host module – Add a host (and alternatively a group) to the ansible-playbook in-memory inventory
apt module – Manages apt-packages
apt_key module – Add or remove an apt key
apt_repository module – Add and remove APT repositories
assemble module – Assemble configuration files from fragments
assert module – Asserts given expressions are true
async_status module – Obtain status of asynchronous task
blockinfile module – Insert/update/remove a text block surrounded by marker lines
command module – Execute commands on targets
copy module – Copy files to remote locations
cron module – Manage cron.d and crontab entries
debconf module – Configure a .deb package
debug module – Print statements during execution
dnf module – Manages packages with the dnf package manager
dpkg_selections module – Dpkg package selection selections
expect module – Executes a command and responds to prompts
fail module – Fail with custom message
fetch module – Fetch files from remote nodes
file module – Manage files and file properties
find module – Return a list of files based on specific criteria
gather_facts module – Gathers facts about remote hosts
get_url module – Downloads files from HTTP, HTTPS, or FTP to node
getent module – A wrapper to the unix getent utility
git module – Deploy software (or files) from git checkouts
group module – Add or remove groups
group_by module – Create Ansible groups based on facts
hostname module – Manage hostname
import_playbook module – Import a playbook
import_role module – Import a role into a play
import_tasks module – Import a task list
include module – Include a task list
include_role module – Load and execute a role
include_tasks module – Dynamically include a task list
include_vars module – Load variables from files, dynamically within a task
iptables module – Modify iptables rules
known_hosts module – Add or remove a host from the known_hosts file
lineinfile module – Manage lines in text files
meta module – Execute Ansible ‘actions’
package module – Generic OS package manager
package_facts module – Package information as facts
pause module – Pause playbook execution
ping module – Try to connect to host, verify a usable python and return pong on success
pip module – Manages Python library dependencies
raw module – Executes a low-down and dirty command
reboot module – Reboot a machine
replace module – Replace all instances of a particular string in a file using a back-referenced regular expression
rpm_key module – Adds or removes a gpg key from the rpm db
script module – Runs a local script on a remote node after transferring it
service module – Manage services
service_facts module – Return service state information as fact data
set_fact module – Set host variable(s) and fact(s).
set_stats module – Define and display stats for the current ansible run
setup module – Gathers facts about remote hosts
shell module – Execute shell commands on targets
slurp module – Slurps a file from remote nodes
stat module – Retrieve file or file system status
subversion module – Deploys a subversion repository
systemd module – Manage systemd units
sysvinit module – Manage SysV services.
tempfile module – Creates temporary files and directories
template module – Template a file out to a target host
unarchive module – Unpacks an archive after (optionally) copying it from the local machine
uri module – Interacts with webservices
user module – Manage user accounts
validate_argument_spec module – Validate role argument specs.
wait_for module – Waits for a condition before continuing
wait_for_connection module – Waits until remote system is reachable/usable
yum module – Manages packages with the yum package manager
yum_repository module – Add or remove YUM repositories

Become Plugins

runas become – Run As user
su become – Substitute User
sudo become – Substitute User DO

Cache Plugins

jsonfile cache – JSON formatted files.
memory cache – RAM backed, non persistent

Callback Plugins

default callback – default Ansible screen output
junit callback – write playbook output to a JUnit file.
minimal callback – minimal Ansible screen output
oneline callback – oneline Ansible screen output
tree callback – Save host events to files

Connection Plugins

local connection – execute on controller
paramiko_ssh connection – Run tasks via python ssh (paramiko)
psrp connection – Run tasks over Microsoft PowerShell Remoting Protocol
ssh connection – connect via SSH client binary
winrm connection – Run tasks over Microsoft’s WinRM

Inventory Plugins

advanced_host_list inventory – Parses a ‘host list’ with ranges
auto inventory – Loads and executes an inventory plugin specified in a YAML config
constructed inventory – Uses Jinja2 to construct vars and groups based on existing inventory.
generator inventory – Uses Jinja2 to construct hosts and groups from patterns
host_list inventory – Parses a ‘host list’ string
ini inventory – Uses an Ansible INI file as inventory source.
script inventory – Executes an inventory script that returns JSON
toml inventory – Uses a specific TOML file as an inventory source.
yaml inventory – Uses a specific YAML file as an inventory source.

Lookup Plugins

config lookup – Lookup current Ansible configuration values
csvfile lookup – read data from a TSV or CSV file
dict lookup – returns key/value pair items from dictionaries
env lookup – Read the value of environment variables
file lookup – read file contents
fileglob lookup – list files matching a pattern
first_found lookup – return first file found from list
indexed_items lookup – rewrites lists to return ‘indexed items’
ini lookup – read data from an ini file
inventory_hostnames lookup – list of inventory hosts matching a host pattern
items lookup – list of items
lines lookup – read lines from command
list lookup – simply returns what it is given.
nested lookup – composes a list with nested elements of other lists
password lookup – retrieve or generate a random password, stored in a file
pipe lookup – read output from a command
random_choice lookup – return random element from list
sequence lookup – generate a list based on a number sequence
subelements lookup – traverse nested key from a list of dictionaries
template lookup – retrieve contents of file after templating with Jinja2
together lookup – merges lists into synchronized list
unvault lookup – read vaulted file(s) contents
url lookup – return contents from URL
varnames lookup – Lookup matching variable names
vars lookup – Lookup templated value of variables

Shell Plugins

cmd shell – Windows Command Prompt
powershell shell – Windows PowerShell
sh shell – POSIX shell (/bin/sh)

Strategy Plugins

debug strategy – Executes tasks in interactive debug session.
free strategy – Executes tasks without waiting for all hosts
host_pinned strategy – Executes tasks on each host without interruption
linear strategy – Executes tasks in a linear fashion

Vars Plugins

host_group_vars vars – In charge of loading group_vars and host_vars