модуль community.general.sorcery — менеджер пакетов для Source Mage GNU/Linux

Примечание

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

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

Чтобы установить её, используйте: ansible-galaxy collection install community.general. Для использования этого модуля требуются дополнительные зависимости. Подробности см. в разделе Требования.

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

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

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

Управляет «заклинаниями» в Source Mage GNU/Linux с помощью набора инструментов sorcery.

Требования

Следующие требования должны быть выполнены на узле, на котором выполняется этот модуль.

bash

Параметры

Параметр	Комментарии
cache_valid_time целое число	Время в секундах, по истечении которого коллекция гримуаров считается устаревшей при обновлении. Особенно полезно для гримуаров SCM и rsync. Имеет смысл только вместе с `update_cache`. По умолчанию: `0`
depends строка	Разделённый запятыми список _необязательных_ зависимостей, с которыми нужно собрать заклинание (или убедиться, что оно собрано); чтобы включить или отключить зависимость, добавьте перед ней `+`/`-` (`+` при этом необязателен). Этот параметр игнорируется, если значение параметра `name` равно `*` или содержит более одного заклинания. Поставщиков необходимо указывать в форме, распознаваемой Sorcery, например «`openssl(SSL)`».
name псевдонимы: spell, grimoire список / элементы=строка	Имя заклинания или гримуара. Можно указать несколько имён через запятую. Специальное значение `*` в сочетании с состояниями `latest` или `rebuild` соответственно обновляет или пересобирает всю систему. Псевдоним `grimoire` добавлен в community.general 7.3.0.
repository строка добавлен в community.general 7.3.0	Расположение репозитория. Если указано, `name` обозначает гримуар(ы), а не заклинание(я). Специальное значение `` загружает гримуар из официального источника. Можно использовать только один элемент в `name` в сочетании с ``. `state=absent` необходимо использовать со специальным значением `*`.
state строка	Определяет, нужно ли собрать, удалить или пересобрать пакет. Состояние `cast` эквивалентно `present`, а не `latest`. Состояние `rebuild` подразумевает сборку всех указанных заклинаний, а не только тех, которые существовали ранее. Варианты: `"present"` ← (по умолчанию) `"latest"` `"absent"` `"cast"` `"dispelled"` `"rebuild"`
update логический	Определяет, нужно ли на первом этапе обновить скрипты sorcery. Варианты: `false` ← (по умолчанию) `true`
update_cache псевдонимы: update_codex логический	Определяет, нужно ли обновить коллекцию гримуаров перед сборкой заклинаний. Варианты: `false` ← (по умолчанию) `true`

Атрибуты

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

Примечания

Примечание

Если выбраны все три компонента, обновление выполняется в следующем порядке: Sorcery -> гримуар(ы) -> заклинание(я); изменить этот порядок нельзя.
Поддержка работы с гримуарами добавлена в community.general 7.3.0.

Примеры

- name: Make sure spell foo is installed
  community.general.sorcery:
    spell: foo
    state: present

- name: Make sure spells foo, bar and baz are removed
  community.general.sorcery:
    spell: foo,bar,baz
    state: absent

- name: Make sure spell foo with dependencies bar and baz is installed
  community.general.sorcery:
    spell: foo
    depends: bar,baz
    state: present

- name: Make sure spell foo with bar and without baz dependencies is installed
  community.general.sorcery:
    spell: foo
    depends: +bar,-baz
    state: present

- name: Make sure spell foo with libressl (providing SSL) dependency is installed
  community.general.sorcery:
    spell: foo
    depends: libressl(SSL)
    state: present

- name: Make sure spells with/without required dependencies (if any) are installed
  community.general.sorcery:
    name: "{{ item.spell }}"
    depends: "{{ item.depends | default(None) }}"
    state: present
  loop:
    - {spell: 'vifm', depends: '+file,-gtk+2'}
    - {spell: 'fwknop', depends: 'gpgme'}
    - {spell: 'pv,tnftp,tor'}

- name: Install the latest version of spell foo using regular glossary
  community.general.sorcery:
    name: foo
    state: latest

- name: Rebuild spell foo
  community.general.sorcery:
    spell: foo
    state: rebuild

- name: Rebuild the whole system, but update Sorcery and Codex first
  community.general.sorcery:
    spell: '*'
    state: rebuild
    update: true
    update_cache: true

- name: Refresh the grimoire collection if it is 1 day old using native sorcerous alias
  community.general.sorcery:
    update_codex: true
    cache_valid_time: 86400

- name: Make sure stable grimoire is present
  community.general.sorcery:
    name: stable
    repository: '*'
    state: present

- name: Make sure binary and stable-rc grimoires are removed
  community.general.sorcery:
    grimoire: binary,stable-rc
    repository: '*'
    state: absent

- name: Make sure games grimoire is pulled from rsync
  community.general.sorcery:
    grimoire: games
    repository: "rsync://download.sourcemage.org::codex/games"
    state: present

- name: Make sure a specific branch of stable grimoire is pulled from git
  community.general.sorcery:
    grimoire: stable.git
    repository: "git://download.sourcemage.org/smgl/grimoire.git:stable.git:stable-0.62"
    state: present

- name: Update only Sorcery itself
  community.general.sorcery:
    update: true

Авторы

Vlad Glagolev (@vaygr)

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

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