community.general.apk – Manages apk packages¶
Note
This plugin is part of the community.general collection (version 2.5.1).
To install it use: ansible-galaxy collection install community.general
.
To use it in a playbook, specify: community.general.apk
.
Parameters¶
Notes¶
Note
“name” and “upgrade” are mutually exclusive.
When used with a loop: each package will be processed individually, it is much more efficient to pass the list directly to the name option.
Examples¶
- name: Update repositories and install foo package
community.general.apk:
name: foo
update_cache: yes
- name: Update repositories and install foo and bar packages
community.general.apk:
name: foo,bar
update_cache: yes
- name: Remove foo package
community.general.apk:
name: foo
state: absent
- name: Remove foo and bar packages
community.general.apk:
name: foo,bar
state: absent
- name: Install the package foo
community.general.apk:
name: foo
state: present
- name: Install the packages foo and bar
community.general.apk:
name: foo,bar
state: present
- name: Update repositories and update package foo to latest version
community.general.apk:
name: foo
state: latest
update_cache: yes
- name: Update repositories and update packages foo and bar to latest versions
community.general.apk:
name: foo,bar
state: latest
update_cache: yes
- name: Update all installed packages to the latest versions
community.general.apk:
upgrade: yes
- name: Upgrade / replace / downgrade / uninstall all installed packages to the latest versions available
community.general.apk:
available: yes
upgrade: yes
- name: Update repositories as a separate step
community.general.apk:
update_cache: yes
- name: Install package from a specific repository
community.general.apk:
name: foo
state: latest
update_cache: yes
repository: http://dl-3.alpinelinux.org/alpine/edge/main
- name: Install package without using cache
community.general.apk:
name: foo
state: latest
no_cache: yes
Return Values¶
Common return values are documented here, the following are the fields unique to this module:
Key | Returned | Description |
---|---|---|
packages
list
/ elements=string
|
when packages have changed |
a list of packages that have been changed
Sample:
['package', 'other-package']
|
Authors¶
Kevin Brebanov (@kbrebanov)