Модуль community.general.pacman_key — управление списком доверенных ключей pacman

Примечание

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

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

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

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

Добавлено в community.general 3.2.0

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

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

Добавление или удаление ключей GPG из связки ключей pacman.

Требования

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

gpg
pacman-key

Параметры

Параметр	Комментарии
data string	Содержимое файла ключа для добавления в связку ключей. Должно иметь тип `PGP PUBLIC KEY BLOCK`.
ensure_trusted boolean добавлено в community.general 11.0.0	Проверяет, что ключ является доверенным (подписан ключом машины Pacman и не просрочен). Варианты: `false` ← (по умолчанию) `true`
file path	Путь к файлу ключа на удалённом сервере для добавления в связку ключей. Удалённый файл должен иметь тип `PGP PUBLIC KEY BLOCK`.
force_update boolean	Принудительно обновляет ключ, если он уже есть в связке ключей. Варианты: `false` ← (по умолчанию) `true`
id string / обязательный	40-символьный идентификатор ключа. Указание этого параметра позволяет корректно сообщать об изменениях в режиме проверки. Не указывайте идентификатор подключа; вместо этого укажите идентификатор основного ключа.
keyring path	Полный путь к каталогу связки ключей на удалённом сервере. Если параметр не указан, модуль использует значение по умолчанию для pacman (`/etc/pacman.d/gnupg`). Полезно, если удалённой системе требуется альтернативный каталог gnupg. По умолчанию: `"/etc/pacman.d/gnupg"`
keyserver string	Сервер ключей, с которого нужно получить ключ.
state string	Обеспечивает, чтобы ключ был `present` (добавлен) или `absent` (отозван). Варианты: `"absent"` `"present"` ← (по умолчанию)
url string	URL для получения файла ключа. Удалённый файл должен иметь тип `PGP PUBLIC KEY BLOCK`.
verify boolean	Определяет, нужно ли сверять идентификатор ключа в файле ключа с указанным идентификатором ключа. Варианты: `false` `true` ← (по умолчанию)

Атрибуты

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

Примечания

Примечание

Используйте полный идентификатор ключа (40 символов).
При использовании data, file или url ключи проверяются, если не переопределён параметр verify.
После импорта в связку ключей ключи подписываются локально.
Если идентификатор ключа уже есть в связке ключей, ключ не добавляется, если не указан force_update.
data, file, url и keyserver являются взаимоисключающими.

Примеры

- name: Import a key via local file
  community.general.pacman_key:
    id: 01234567890ABCDE01234567890ABCDE12345678
    data: "{{ lookup('file', 'keyfile.asc') }}"
    state: present

- name: Import a key via remote file
  community.general.pacman_key:
    id: 01234567890ABCDE01234567890ABCDE12345678
    file: /tmp/keyfile.asc
    state: present

- name: Import a key via url
  community.general.pacman_key:
    id: 01234567890ABCDE01234567890ABCDE12345678
    url: https://domain.tld/keys/keyfile.asc
    state: present

- name: Import a key via keyserver
  community.general.pacman_key:
    id: 01234567890ABCDE01234567890ABCDE12345678
    keyserver: keyserver.domain.tld

- name: Import a key into an alternative keyring
  community.general.pacman_key:
    id: 01234567890ABCDE01234567890ABCDE12345678
    file: /tmp/keyfile.asc
    keyring: /etc/pacman.d/gnupg-alternative

- name: Remove a key from the keyring
  community.general.pacman_key:
    id: 01234567890ABCDE01234567890ABCDE12345678
    state: absent

Авторы

George Rawlinson (@grawlinson)

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

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