ansible.builtin.apt_key – Добавить или удалить ключ apt

Примечание

Этот модуль является частью ansible-base и включен во все установки Ansible. В большинстве случаев вы можете использовать короткое имя модуля apt_key даже без указания collections: ключевого слова. Несмотря на это, мы рекомендуем использовать FQCN для удобной ссылки на документацию модуля и для предотвращения конфликтов с другими коллекциями, которые могут иметь то же имя модуля.

Добавлена в версии 1.0: от ansible.builtin

Описание
Требования
Параметры
Примечания
Примеры
Возвращаемые значения

Описание

Добавить или удалить ключ apt, при необходимости загрузив его.

Требования

Ниже перечислены требования к хосту, на котором выполняется этот модуль.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
data строка		Содержимое файла ключа для добавления в хранилище.
file путь		Путь к файлу ключа на удаленном сервере для добавления в хранилище.
id строка		Идентификатор ключа. Включение этого параметра позволяет режиму проверки правильно сообщать о состоянии изменения. Если вы указываете id подключа, будьте осторожны, apt-key не понимает, как удалить ключи через id подключа. Укажите id основного ключа вместо этого. Этот параметр обязателен, когда `state` установлен в `absent`.
keyring путь добавлен в 1.3 от ansible.builtin		Полный путь к конкретному файлу хранилища в `/etc/apt/trusted.gpg.d/`.
keyserver строка добавлен в 1.6 от ansible.builtin		Сервер ключей для получения ключа.
state строка	Варианты: absent present ←	Обеспечивает, что ключ присутствует (добавлен) или отсутствует (отменён).
url строка		URL для получения ключа.
validate_certs булево	Варианты: no yes ←	Если `no`, сертификаты SSL для целевого URL не будут проверены. Это следует использовать только на контролируемых вами сайтах, использующих самозаверяющие сертификаты.

Примечания

Примечание

Команда apt-key устарела и предлагает «управлять файлами хранилища в trusted.gpg.d вместо этого». Подробнее см. в вики Debian. Этот модуль поддерживается для обратной совместимости с системами, которые по-прежнему используют apt-key в качестве основного способа управления ключами репозиториев apt.
В качестве проверки, идентификатор загруженного ключа должен совпадать с указанным.
Используйте полные идентификаторы ключа (40 символов) для предотвращения конфликтов ключей. Чтобы сгенерировать полный отпечаток импортированного ключа: apt-key adv --list-public-keys --with-fingerprint --with-colons.
Если вы указываете как идентификатор ключа, так и URL с state=present, задача может проверить или добавить ключ по мере необходимости.
Добавление нового ключа требует обновления кэша apt (например, с использованием параметра update_cache модуля ansible.builtin.apt).
Поддерживает check_mode.

Примеры

- name: Add an apt key by id from a keyserver
  ansible.builtin.apt_key:
    keyserver: keyserver.ubuntu.com
    id: 36A1D7869245C8950F966E92D8576A8BA88D21E9

- name: Add an Apt signing key, uses whichever key is at the URL
  ansible.builtin.apt_key:
    url: https://ftp-master.debian.org/keys/archive-key-6.0.asc
    state: present

- name: Add an Apt signing key, will not download if present
  ansible.builtin.apt_key:
    id: 9FED2BCBDCD29CDF762678CBAED4B06F473041FA
    url: https://ftp-master.debian.org/keys/archive-key-6.0.asc
    state: present

- name: Remove a Apt specific signing key, leading 0x is valid
  ansible.builtin.apt_key:
    id: 0x9FED2BCBDCD29CDF762678CBAED4B06F473041FA
    state: absent

# Use armored file since utf-8 string is expected. Must be of "PGP PUBLIC KEY BLOCK" type.
- name: Add a key from a file on the Ansible server
  ansible.builtin.apt_key:
    data: "{{ lookup('file', 'apt.asc') }}"
    state: present

- name: Add an Apt signing key to a specific keyring file
  ansible.builtin.apt_key:
    id: 9FED2BCBDCD29CDF762678CBAED4B06F473041FA
    url: https://ftp-master.debian.org/keys/archive-key-6.0.asc
    keyring: /etc/apt/trusted.gpg.d/debian.gpg

- name: Add Apt signing key on remote server to keyring
  ansible.builtin.apt_key:
    id: 9FED2BCBDCD29CDF762678CBAED4B06F473041FA
    file: /tmp/apt.gpg
    state: present

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

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

Ключ	Возвращаемое значение	Описание
after список / элементы=строка	при изменении	Список идентификаторов ключей apt или отпечатков после любых изменений Пример: ['D8576A8BA88D21E9', '3B4FE6ACC0B21F32', 'D94AA3F0EFE21092', '871920D1991BC93C']
before список / элементы=строка	всегда	Список идентификаторов ключей apt или отпечатков до любых изменений Пример: ['3B4FE6ACC0B21F32', 'D94AA3F0EFE21092', '871920D1991BC93C']
fp строка	всегда	Отпечаток ключа для импорта Пример: D8576A8BA88D21E9
id строка	всегда	Идентификатор ключа из источника Пример: 36A1D7869245C8950F966E92D8576A8BA88D21E9
key_id строка	всегда	Вычисленный идентификатор ключа, он должен быть таким же, как «id», но может быть другим Пример: 36A1D7869245C8950F966E92D8576A8BA88D21E9
short_id строка	всегда	Вычисленный короткий идентификатор ключа Пример: A88D21E9

Авторы

Jayson Vantuyl (@jvantuyl)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/ansible/builtin/apt_key_module.html