Documentation

pkgng - Package manager for FreeBSD >= 9.0

Synopsis

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

Parameters

Parameter Choices/Defaults Comments
annotation
(added in 1.6)
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
bool

(added in 2.2)
    Choices:
  • no ←
  • yes
Remove automatically installed packages which are no longer needed.
cached
bool
    Choices:
  • no ←
  • yes
Use local package base instead of fetching an updated one.
chroot
(added in 2.1)
Pkg will chroot in the specified environment.
Can not be used together with rootdir or jail options.
jail
(added in 2.4)
Pkg will execute in the given jail name or id.
Can not be used together with chroot or rootdir options.
name
required
Name or list of names of packages to install/remove.
pkgsite
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
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
    Choices:
  • present ←
  • absent
State of the package.

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

# Install package foo
- pkgng:
    name: foo
    state: present

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

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

Status

This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.

Maintenance

This module is flagged as community which means that it is maintained by the Ansible Community. See Module Maintenance & Support for more info.

For a list of other modules that are also maintained by the Ansible Community, see here.

Author

  • bleader (@bleader)

Hint

If you notice any issues in this documentation you can edit this document to improve it.