Модуль community.general.xbps — управление пакетами с помощью XBPS

Примечание

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

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

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

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

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

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

Управление пакетами с помощью пакетного менеджера XBPS.

Параметры

Параметр	Комментарии
accept_pubkey логическое значение добавлено в community.general 10.2.0	Следует ли автоматически принимать ключи подписи репозиториев. Варианты: `false` ← (по умолчанию) `true`
name псевдонимы: pkg, package список / элементы=строка	Имя пакета для установки, обновления или удаления.
recurse логическое значение	При удалении пакета удалять также его зависимости, если они не требуются другим пакетам и не были явно установлены пользователем. Варианты: `false` ← (по умолчанию) `true`
repositories список / элементы=строка добавлено в community.general 10.2.0	URL репозитория(ев), добавляемые в начало списка репозиториев для установки пакета. URL может указывать на удалённые репозитории или пути к локальным репозиториям.
root путь добавлено в community.general 10.2.0	Полный путь к целевому корневому каталогу.
state строка	Желаемое состояние пакета. Варианты: `"present"` ← (по умолчанию) `"absent"` `"latest"` `"installed"` `"removed"`
update_cache логическое значение	Следует ли обновлять основные списки пакетов. Это можно выполнить как часть установки пакета или отдельным шагом. Варианты: `false` `true` ← (по умолчанию)
upgrade логическое значение	Следует ли обновлять всю систему. Варианты: `false` ← (по умолчанию) `true`
upgrade_xbps логическое значение добавлено в community.general 0.2.0	Следует ли при необходимости обновлять пакет `xbps`. Перед установкой новых пакетов `xbps` требует, чтобы пользователь обновил сам пакет. Поэтому, если этот параметр имеет значение `false`, обновление и установка завершаются ошибкой, когда `xbps` не обновлён. Варианты: `false` `true` ← (по умолчанию)

Атрибуты

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

Примеры

- name: Install package foo (automatically updating the xbps package if needed)
  community.general.xbps:
    name: foo
    state: present

- name: Upgrade package foo
  community.general.xbps:
    name: foo
    state: latest
    update_cache: true

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

- name: Recursively remove package foo
  community.general.xbps:
    name: foo
    state: absent
    recurse: true

- name: Update package cache
  community.general.xbps:
    update_cache: true

- name: Upgrade packages
  community.general.xbps:
    upgrade: true

- name: Install a package, failing if the xbps package is out of date
  community.general.xbps:
    name: foo
    state: present
    upgrade_xbps: false

- name: Find repository keys to install into a new void system on a mounted partition
  ansible.builtin.find:
    path: /var/db/xbps/keys
    pattern: "*.plist"
  register: xbps_keys

- name: Copy repository keys to into a new void system on a mounted partition
  ansible.builtin.copy:
    remote_src: true
    src: "{{ item }}"
    dest: "/mnt/{{ item }}"
    owner: root
    group: root
    mode: "0644"
  when: xbps_keys.matched > 0
  loop: "{{ xbps_keys.files | map(attribute='path') }}"

- name: Install a new void system on a mounted partition
  community.general.xbps:
    name: base-system
    state: present
    repositories: https://repo-default.voidlinux.org/current
    root: /mnt

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:

Ключ	Описание
msg строка	Сообщение о результатах. Возвращается: success Пример: `"System Upgraded"`
packages список / элементы=строка	Затронутые или потенциально затрагиваемые пакеты. Возвращается: success Пример: `["ansible"]`

Авторы

Dino Occhialini (@dinoocch)
Michael Aldridge (@the-maldridge)

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

© 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/xbps_module.html