community.general.pkgng – Package manager for FreeBSD >= 9.0

Note

This plugin is part of the community.general collection (version 3.8.1).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install community.general.

To use it in a playbook, specify: community.general.pkgng.

Synopsis

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

Parameters

Parameter	Choices/Defaults	Comments
annotation string		A comma-separated list of keyvalue-pairs of the form `<+/-/:><key>[=<value>]`. A `+` denotes adding an annotation, a `-` denotes removing an annotation, and `:` denotes modifying an annotation. If setting or modifying annotations, a value must be provided.
autoremove boolean	Choices: no ← yes	Remove automatically installed packages which are no longer needed.
cached boolean	Choices: no ← yes	Use local package base instead of fetching an updated one.
chroot path		Pkg will chroot in the specified environment. Can not be used together with rootdir or jail options.
ignore_osver boolean added in 1.3.0 of community.general	Choices: no ← yes	Ignore FreeBSD OS version check, useful on -STABLE and -CURRENT branches. Defines the `IGNORE_OSVERSION` environment variable.
jail string		Pkg will execute in the given jail name or id. Can not be used together with chroot or rootdir options.
name list / elements=string / required		Name or list of names of packages to install/remove. With name=, state: latest* will operate, but state: present and state: absent will be noops. Warning: In Ansible 2.9 and earlier this module had a misfeature where name=* with state: latest or state: present would install every package from every package repository, filling up the machines disk. Avoid using them unless you are certain that your role will only be used with newer versions. aliases: pkg
pkgsite string		For pkgng versions before 1.1.4, specify packagesite to use for downloading packages. If not specified, use settings from `/usr/local/etc/pkg.conf`. For newer pkgng versions, specify a the name of a repository configured in `/usr/local/etc/pkg/repos`.
rootdir path		For pkgng versions 1.5 and later, pkg will install all packages within the specified root directory. Can not be used together with chroot or jail options.
state string	Choices: present ← latest absent	State of the package. Note: "latest" added in 2.7

Notes

Note

When using pkgsite, be careful that already in cache packages won’t be downloaded again.
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: Install package foo
  community.general.pkgng:
    name: foo
    state: present

- name: Annotate package foo and bar
  community.general.pkgng:
    name: foo,bar
    annotation: '+test1=baz,-test2,:test3=foobar'

- name: Remove packages foo and bar
  community.general.pkgng:
    name: foo,bar
    state: absent

# "latest" support added in 2.7
- name: Upgrade package baz
  community.general.pkgng:
    name: baz
    state: latest

- name: Upgrade all installed packages (see warning for the name option first!)
  community.general.pkgng:
    name: "*"
    state: latest

Authors

bleader (@bleader)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/pkgng_module.html

Docs

Docs4dev

Title here