Documentation

apk - Manages apk packages

New in version 2.0.

Synopsis

Manages apk packages for Alpine Linux.

Options

parameter required default choices comments
name
no
    A package name, like foo, or mutliple packages, like foo, bar.
    state
    no present
    • present
    • absent
    • latest
    Indicates the desired package(s) state.
    present ensures the package(s) is/are present.
    absent ensures the package(s) is/are absent.
    latest ensures the package(s) is/are present and the latest version(s).
    update_cache
    no
    • yes
    • no
    Update repository indexes. Can be run with other steps or on it's own.
    upgrade
    no
    • yes
    • no
    Upgrade all installed packages to their latest version.

    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
    
    # Update repositories as a separate step
    - apk: update_cache=yes
    

    This is an Extras Module

    For more information on what this means please read Extras Modules

    For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Helping Testing PRs and Developing Modules.