apk – Manages apk packages¶
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¶
# Update repositories and install "foo" package
- apk:
    name: foo
    update_cache: yes
# Update repositories and install "foo" and "bar" packages
- apk:
    name: foo,bar
    update_cache: yes
# Remove "foo" package
- apk:
    name: foo
    state: absent
# Remove "foo" and "bar" packages
- apk:
    name: foo,bar
    state: absent
# Install the package "foo"
- apk:
    name: foo
    state: present
# Install the packages "foo" and "bar"
- apk:
    name: foo,bar
    state: present
# Update repositories and update package "foo" to latest version
- apk:
    name: foo
    state: latest
    update_cache: yes
# Update repositories and update packages "foo" and "bar" to latest versions
- apk:
    name: foo,bar
    state: latest
    update_cache: yes
# Update all installed packages to the latest versions
- apk:
    upgrade: yes
# Upgrade / replace / downgrade / uninstall all installed packages to the latest versions available
- apk:
    available: yes
    upgrade: yes
# Update repositories as a separate step
- apk:
    update_cache: yes
# Install package from a specific repository
- apk:
    name: foo
    state: latest
    update_cache: yes
    repository: http://dl-3.alpinelinux.org/alpine/edge/main
Return Values¶
Common return values are documented here, the following are the fields unique to this module:
| Key | Returned | Description | 
|---|---|---|
| packages 
                  list
                                       | when packages have changed | a list of packages that have been changed Sample: ['package', 'other-package'] | 
Status¶
- This module is guaranteed to have backward compatible interface changes going forward. [stableinterface]
- This module is maintained by the Ansible Community. [community]
Authors¶
- Kevin Brebanov (@kbrebanov)
Hint
If you notice any issues in this documentation, you can edit this document to improve it.
