Parameter |
Choices/Defaults |
Comments |
allow_unauthenticated
bool
(added in 2.1) |
|
Ignore if packages cannot be authenticated. This is useful for bootstrapping environments that manage their own apt-key setup.
allow_unauthenticated is only supported with state: install/present
|
autoclean
bool
(added in 2.4) |
|
If yes , cleans the local repository of retrieved package files that can no longer be downloaded.
|
autoremove
bool
(added in 2.1) |
|
If yes , remove unused dependency packages for all module states except build-dep. It can also be used as the only option.
Previous to version 2.4, autoclean was also an alias for autoremove, now it is its own separate command. See documentation for further information.
|
cache_valid_time
|
Default:
0
|
Update the apt cache if its older than the cache_valid_time. This option is set in seconds. As of Ansible 2.4, this sets update_cache=yes.
|
deb
(added in 1.6) |
|
Path to a .deb package on the remote machine.
If :// in the path, ansible will attempt to download deb before installing. (Version added 2.1)
|
default_release
|
|
Corresponds to the -t option for apt and sets pin priorities
|
dpkg_options
|
Default:
force-confdef,force-confold
|
Add dpkg options to apt command. Defaults to '-o "Dpkg::Options::=--force-confdef" -o "Dpkg::Options::=--force-confold"'
Options should be supplied as comma separated list
|
force
bool |
|
Corresponds to the --force-yes to apt-get and implies allow_unauthenticated: yes
This option will disable checking both the packages' signatures and the certificates of the web servers they are downloaded from.
This option *is not* the equivalent of passing the -f flag to apt-get on the command line
**This is a destructive operation with the potential to destroy your system, and it should almost never be used.** Please also see man apt-get for more information.
|
force_apt_get
bool
(added in 2.4) |
|
Force usage of apt-get instead of aptitude
|
install_recommends
bool |
|
Corresponds to the --no-install-recommends option for apt. yes installs recommended packages. no does not install recommended packages. By default, Ansible will use the same defaults as the operating system. Suggested packages are never installed.
aliases: install-recommends
|
name
|
|
A list of package names, like foo , or package specifier with version, like foo=1.0 . Name wildcards (fnmatch) like apt* and version wildcards like foo=1.0* are also supported.
aliases: package, pkg
|
only_upgrade
bool
(added in 2.1) |
|
Only upgrade a package if it is already installed.
|
purge
bool |
|
Will force purging of configuration files if the module state is set to absent.
|
state
|
Choices:
- absent
- build-dep
- latest
present ←
|
Indicates the desired package state. latest ensures that the latest version is installed. build-dep ensures the package build dependencies are installed.
|
update_cache
bool |
|
Run the equivalent of apt-get update before the operation. Can be run as part of the package installation or as a separate step.
|
upgrade
|
Choices:
- dist
- full
no ←
- safe
- yes
|
If yes or safe, performs an aptitude safe-upgrade.
If full, performs an aptitude full-upgrade.
If dist, performs an apt-get dist-upgrade.
Note: This does not upgrade a specific package, use state=latest for that.
Note: Since 2.4, apt-get is used as a fall-back if aptitude is not present.
|