ansible.builtin.apk (v2.9.27) — module

Install Ansible via pip

Install with pip install ansible==2.9.27

Description

Manages I(apk) packages for Alpine Linux.

Usage examples

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

# Update repositories and install "foo" package
- apk:
    name: foo
    update_cache: yes

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

# Update repositories and install "foo" and "bar" packages
- apk:
    name: foo,bar
    update_cache: yes

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

# Remove "foo" package
- apk:
    name: foo
    state: absent

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

# Remove "foo" and "bar" packages
- apk:
    name: foo,bar
    state: absent

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

# Install the package "foo"
- apk:
    name: foo
    state: present

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

# Install the packages "foo" and "bar"
- apk:
    name: foo,bar
    state: present

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

# Update repositories and update package "foo" to latest version
- apk:
    name: foo
    state: latest
    update_cache: yes

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

# Update repositories and update packages "foo" and "bar" to latest versions
- apk:
    name: foo,bar
    state: latest
    update_cache: yes

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

# Update all installed packages to the latest versions
- apk:
    upgrade: yes

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

# Upgrade / replace / downgrade / uninstall all installed packages to the latest versions available
- apk:
    available: yes
    upgrade: yes

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

# Update repositories as a separate step
- apk:
    update_cache: yes

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

# Install package from a specific repository
- apk:
    name: foo
    state: latest
    update_cache: yes
    repository: http://dl-3.alpinelinux.org/alpine/edge/main

Inputs

    
name:
    description:
    - A package name, like C(foo), or multiple packages, like C(foo, bar).

state:
    choices:
    - present
    - absent
    - latest
    default: present
    description:
    - Indicates the desired package(s) state.
    - C(present) ensures the package(s) is/are present.
    - C(absent) ensures the package(s) is/are absent.
    - C(latest) ensures the package(s) is/are present and the latest version(s).

upgrade:
    default: 'no'
    description:
    - Upgrade all installed packages to their latest version.
    type: bool

available:
    default: 'no'
    description:
    - During upgrade, reset versioned world dependencies and change logic to prefer replacing
      or downgrading packages (instead of holding them) if the currently installed package
      is no longer available from any repository.
    type: bool
    version_added: '2.4'
    version_added_collection: ansible.builtin

repository:
    description:
    - A package repository or multiple repositories. Unlike with the underlying apk command,
      this list will override the system repositories rather than supplement them.
    version_added: '2.4'
    version_added_collection: ansible.builtin

update_cache:
    default: 'no'
    description:
    - Update repository indexes. Can be run with other steps or on it's own.
    type: bool

Outputs

packages:
  description: a list of packages that have been changed
  returned: when packages have changed
  sample:
  - package
  - other-package
  type: list