36 lines
2.7 KiB
ReStructuredText
36 lines
2.7 KiB
ReStructuredText
.. _apt:
|
|
|
|
apt
|
|
```
|
|
|
|
Manages apt-packages (such as for Debian/Ubuntu).
|
|
|
|
+--------------------+----------+---------+----------------------------------------------------------------------------+
|
|
| parameter | required | default | comments |
|
|
+====================+==========+=========+============================================================================+
|
|
| name | no | | A package name or package specifier with version, like `foo` or `foo=1.0` |
|
|
+--------------------+----------+---------+----------------------------------------------------------------------------+
|
|
| state | no | present | 'absent', 'present', or 'latest'. |
|
|
+--------------------+----------+---------+----------------------------------------------------------------------------+
|
|
| update_cache | no | no | Run the equivalent of apt-get update before the operation. |
|
|
| | | | Can be run as part of the package installation or a seperate step |
|
|
+--------------------+----------+---------+----------------------------------------------------------------------------+
|
|
| purge | no | no | Will forge purge of configuration files if state is set to 'absent'. |
|
|
+--------------------+----------+---------+----------------------------------------------------------------------------+
|
|
| default_release | no | | Corresponds to the -t option for apt and sets pin priorities |
|
|
+--------------------+----------+---------+----------------------------------------------------------------------------+
|
|
| install_recommends | no | yes | Corresponds to the --no-install-recommends option for apt, default |
|
|
| | | | behavior works as apt's default behavior, 'no' does not install |
|
|
| | | | recommended packages. Suggested packages are never installed. |
|
|
+--------------------+----------+---------+----------------------------------------------------------------------------+
|
|
| force | no | no | If 'yes', force installs/removes. |
|
|
+--------------------+----------+---------+----------------------------------------------------------------------------+
|
|
|
|
Example action from Ansible :doc:`playbooks`::
|
|
|
|
apt pkg=foo update-cache=yes
|
|
apt pkg=foo state=removed
|
|
apt pkg=foo state=installed
|
|
apt pkg=foo=1.00 state=installed
|
|
apt pkg=nginx state=latest default-release=squeeze-backports update-cache=yes
|
|
apt pkg=openjdk-6-jdk state=latest install-recommends=no
|