Модуль community.general.pkgng — менеджер пакетов для FreeBSD >= 9.0

Примечание

Этот модуль входит в коллекцию community.general (версия 12.6.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install community.general.

Чтобы использовать её в плейбуке, укажите: community.general.pkgng.

Краткое описание
Параметры
Атрибуты
Примечания
Примеры

Краткое описание

Управление бинарными пакетами FreeBSD с помощью pkgng, доступного в версиях новее 9.0.

Параметры

Параметр	Комментарии
annotation list / elements=string	Список пар ключ-значение в формате `<+/-/:><key>[=<value>]`. `+` означает добавление аннотации, `-` — удаление аннотации, а `:` — изменение аннотации. При установке или изменении аннотаций необходимо указать значение.
autoremove boolean	Удалять автоматически установленные пакеты, которые больше не нужны. Варианты: `false` ← (по умолчанию) `true`
cached boolean	Использовать локальную базу пакетов вместо загрузки обновлённой. Варианты: `false` ← (по умолчанию) `true`
chroot path	Выполнять pkg в указанном окружении chroot. Нельзя использовать вместе с параметрами `rootdir` или `jail`.
ignore_osver boolean добавлено в community.general 1.3.0	Игнорировать проверку версии ОС FreeBSD; полезно для веток `-STABLE` и `-CURRENT`. Задаёт переменную окружения `IGNORE_OSVERSION`. Варианты: `false` ← (по умолчанию) `true`
jail string	Выполнять pkg в указанной jail по имени или ID. Нельзя использовать вместе с параметрами `chroot` или `rootdir`.
name псевдонимы: pkg list / elements=string / обязательный	Имя или список имён пакетов для установки/удаления. При использовании `name=*` выполняется `state=latest`, а `state=present` и `state=absent` ничего не делают.
pkgsite string	Для версий `pkgng` до 1.1.4 укажите `packagesite`, используемый для загрузки пакетов. Если параметр не указан, используются настройки из `/usr/local/etc/pkg.conf`. Для более новых версий `pkgng` укажите имя репозитория, настроенного в `/usr/local/etc/pkg/repos`.
rootdir path	В версиях `pkgng` 1.5 и новее pkg устанавливает все пакеты в указанный корневой каталог. Нельзя использовать вместе с параметрами `chroot` или `jail`.
state string	Состояние пакета. Варианты: `"present"` ← (по умолчанию) `"latest"` `"absent"`
use_globs boolean добавлено в community.general 9.3.0	Рассматривать имена пакетов как шаблоны glob командной оболочки. Варианты: `false` `true` ← (по умолчанию)

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: full	Можно выполнить в `check_mode` и получить прогноз изменения состояния без внесения изменений на целевом узле.
diff_mode	Поддержка: none	В режиме diff возвращает сведения об изменениях (или возможных изменениях в `check_mode`).

Примечания

Примечание

При использовании pkgsite следите за тем, чтобы пакеты, уже находящиеся в кэше, не загружались повторно.
При использовании с loop: каждый пакет обрабатывается отдельно; гораздо эффективнее передать список непосредственно параметру name.

Примеры

- 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

- 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

- name: Upgrade foo/bar
  community.general.pkgng:
    name: foo/bar
    state: latest
    use_globs: false

Авторы

bleader (@bleader)

Ссылки на коллекцию

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