apt_key – Добавить или удалить ключ apt
Описание
- Добавление или удаление ключа apt, при необходимости скачивание его.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- gpg
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| data - | Содержимое файла ключа для добавления в хранилище. | |
| file - | Путь к файлу ключа на удаленном сервере для добавления в хранилище. | |
| id - | Идентификатор ключа. Включение этого параметра позволяет режиму проверки корректно сообщать о состоянии изменений. Если указывается идентификатор подключа, следует учитывать, что apt-key не понимает, как удалять ключи через идентификатор подключа. Укажите идентификатор основного ключа. Этот параметр требуется, когда state установлено в absent. | |
| keyring - | Полный путь к определенному файлу хранилища в /etc/apt/trusted.gpg.d/ | |
| keyserver - | Сервер ключей для получения ключа. | |
| state - |
| Обеспечивает, что ключ присутствует (добавлен) или отсутствует (аннулирован). |
| url - | URL для получения ключа. | |
| validate_certs boolean |
| Если no, сертификаты SSL для целевого URL не будут проверены. Это следует использовать только на сайтах, контролируемых лично, с использованием самозаверенных сертификатов. |
Примечания
Примечание
- Ключ не скачивается, если это действительно не требуется.
- Для проверки скачанный идентификатор ключа должен соответствовать указанному.
- Используйте полные идентификаторы ключей (40 символов) для предотвращения столкновений ключей. Чтобы сгенерировать полный идентификатор импортированного ключа:
apt-key adv --list-public-keys --with-fingerprint --with-colons. - Если вы укажете и идентификатор ключа, и URL с
state=present, задача может проверить или добавить ключ по мере необходимости. - Добавление нового ключа требует обновления кэша apt (например, с использованием параметра update_cache модуля apt).
Примеры
- name: Add an apt key by id from a keyserver
apt_key:
keyserver: keyserver.ubuntu.com
id: 36A1D7869245C8950F966E92D8576A8BA88D21E9
- name: Add an Apt signing key, uses whichever key is at the URL
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
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
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.
apt_key:
data: "{{ lookup('file', 'apt.asc') }}"
state: present
- name: Add an Apt signing key to a specific keyring file
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
apt_key:
id: 9FED2BCBDCD29CDF762678CBAED4B06F473041FA
file: /tmp/apt.gpg
state: present
Статус
- Этот модуль не гарантирует обратную совместимость. [превью]
- Этот модуль поддерживается командой разработчиков Ansible. [core]
Поддержка Red Hat
Дополнительную информацию о поддержке этого модуля компанией Red Hat можно найти в этой статье базы знаний Red Hat.
Авторы
- 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.9/modules/apt_key_module.html