Ansible.Builtin
Collection version 2.12.10.post0
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 play or 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
filelineinfile 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 successpip 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 a 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
See also
List of collections with docs hosted here.