Модуль community.general.sorcery – Управляющий пакетными менеджерами для Source Mage GNU/Linux

Примечание

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

У вас, возможно, уже установлена эта коллекция, если вы используете пакет 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

Авторы

Влад Глаголев (@vaygr)

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

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