Spec-Zone.ru › Ansible 2.9

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

  • Описание
  • Требования
  • Параметры
  • Примечания
  • Примеры
  • Статус

Описание

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

Требования

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

  • gpg

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
data
-
Содержимое файла ключа для добавления в хранилище.
file
-
Путь к файлу ключа на удаленном сервере для добавления в хранилище.
id
-
Идентификатор ключа.
Включение этого параметра позволяет режиму проверки корректно сообщать о состоянии изменений.
Если указывается идентификатор подключа, следует учитывать, что apt-key не понимает, как удалять ключи через идентификатор подключа. Укажите идентификатор основного ключа.
Этот параметр требуется, когда state установлено в absent.
keyring
-
Полный путь к определенному файлу хранилища в /etc/apt/trusted.gpg.d/
keyserver
-
Сервер ключей для получения ключа.
state
-
    Варианты:
  • absent
  • present ←
Обеспечивает, что ключ присутствует (добавлен) или отсутствует (аннулирован).
url
-
URL для получения ключа.
validate_certs
boolean
    Варианты:
  • no
  • yes ←
Если 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API