known_hosts – Добавление или удаление хоста из файла known_hosts
Описание
- Модуль
known_hostsпозволяет добавлять или удалять ключи хоста из файлаknown_hosts. - Начиная с Ansible 2.2, разрешены несколько записей на один хост, но только по одному для каждого типа ключа, поддерживаемого ssh. Это полезно, если вы собираетесь использовать модуль git через ssh, например.
- Если вам нужно управлять очень большим количеством ключей хостов, модуль template будет более полезным.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| hash_host boolean добавлено в 2.3 |
| Хэшировать имя хоста в файле known_hosts |
| key - | Открытый ключ хоста SSH в виде строки (требуется, если state=present, необязателен при state=absent, в этом случае все ключи для хоста удаляются). Ключ должен иметь правильный формат для ssh (см. sshd(8), раздел "SSH_KNOWN_HOSTS FILE FORMAT"). В частности, ключ не должен соответствовать формату, который находится в файле SSH pubkey, но должен иметь имя хоста, добавленное к строке, содержащей pubkey, так же, как он отображается в файле known_hosts. Значение, добавленное к строке, также должно соответствовать значению параметра name. | |
| name - / обязательно | Хост для добавления или удаления (должен соответствовать хосту, указанному в key). Он будет преобразован в нижний регистр, чтобы ssh-keygen мог его найти. псевдонимы: host | |
| path - | Значение по умолчанию: "(homedir)+/.ssh/known_hosts" | Файл known_hosts для редактирования |
| state - |
|
present для добавления ключа хоста, absent для удаления. |
Примеры
- name: tell the host about our servers it might want to ssh to
known_hosts:
path: /etc/ssh/ssh_known_hosts
name: foo.com.invalid
key: "{{ lookup('file', 'pubkeys/foo.com.invalid') }}"
Статус
- Данный модуль не гарантирует обратной совместимости. [превью]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- Matthew Vernon (@mcv21)
Подсказка
Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/known_hosts_module.html