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

Примечание

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

Новое в версии 1.0: of ansible.builtin

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

Обзор

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

Требования

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
data строка		Содержимое файла ключа для добавления в хранилище ключей.
file строка		Путь к файлу ключа на удалённом сервере для добавления в хранилище ключей.
id строка		Идентификатор ключа. Включение этого параметра позволяет режиму проверки правильно сообщать о состоянии изменения. Если вы указываете идентификатор подключа, имейте в виду, что apt-key не понимает, как удалять ключи через идентификатор подключа. Укажите идентификатор основного ключа вместо этого. Этот параметр требуется, когда `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 не будут проверены. Это следует использовать только на контролируемых вами сайтах, использующих самозаверяющие сертификаты.

Примечания

Примечание

Не загружает ключ, если это не необходимо.
В качестве проверки, идентификатор загруженного ключа должен совпадать с указанным.
Используйте полные идентификаторы ключей (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

Авторы

Jayson Vantuyl (@jvantuyl)

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