ansible.builtin.pkgng (v2.3.2.0-1) — module

Package manager for FreeBSD >= 9.0

| "added in version" 1.2 of ansible.builtin"

Authors: bleader (@bleader)

preview | supported by community

Install Ansible via pip

Install with pip install ansible==2.3.2.0.post1

Description

Manage binary packages for FreeBSD using 'pkgng' which is available in versions after 9.0.

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
# Install package foo
- pkgng:
    name: foo
    state: present
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
# Annotate package foo and bar
- pkgng:
    name: foo,bar
    annotation: '+test1=baz,-test2,:test3=foobar'
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
# Remove packages foo and bar
- pkgng:
    name: foo,bar
    state: absent

Inputs

    
name:
    description:
    - Name of package to install/remove.
    required: true

state:
    choices:
    - present
    - absent
    default: present
    description:
    - State of the package.
    required: false

cached:
    choices:
    - 'yes'
    - 'no'
    default: false
    description:
    - Use local package base instead of fetching an updated one.
    required: false

chroot:
    description:
    - Pkg will chroot in the specified environment.
    - Can not be used together with I(rootdir) option.
    required: false
    version_added: '2.1'
    version_added_collection: ansible.builtin

pkgsite:
    description:
    - For pkgng versions before 1.1.4, specify packagesite to use for downloading packages.
      If not specified, use settings from C(/usr/local/etc/pkg.conf).
    - For newer pkgng versions, specify a the name of a repository configured in C(/usr/local/etc/pkg/repos).
    required: false

rootdir:
    description:
    - For pkgng versions 1.5 and later, pkg will install all packages within the specified
      root directory.
    - Can not be used together with I(chroot) option.
    required: false

annotation:
    description:
    - A comma-separated list of keyvalue-pairs of the form C(<+/-/:><key>[=<value>]).
      A C(+) denotes adding an annotation, a C(-) denotes removing an annotation, and
      C(:) denotes modifying an annotation. If setting or modifying annotations, a value
      must be provided.
    required: false
    version_added: '1.6'
    version_added_collection: ansible.builtin

autoremove:
    choices:
    - 'yes'
    - 'no'
    default: false
    description:
    - Remove automatically installed packages which are no longer needed.
    required: false
    version_added: '2.2'
    version_added_collection: ansible.builtin