ansible.netcommon.persistent connection — Использование постоянного сокета Unix для подключения

Примечание

Этот подключаемый модуль подключения входит в коллекцию ansible.netcommon (версия 8.5.3).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install ansible.netcommon.

Чтобы использовать её в плейбуке, укажите: ansible.netcommon.persistent.

Добавлено в ansible.netcommon 1.0.0

Краткое описание
Параметры

Краткое описание

Этот вспомогательный подключаемый модуль позволяет сделать другие подключения постоянными.

Параметры

Параметр	Комментарии
import_modules логическое значение	Снижает использование ЦП и время выполнения сетевых модулей за счёт прямого выполнения. Вместо упаковки модуля и его выполнения оболочкой он будет выполняться непосредственно управляющим узлом Ansible с использованием того же интерпретатора Python, что и процесс Ansible. Примечание. Несовместимо с `asynchronous mode`. Примечание. Требуется Python 3 и Ansible версии 2.9.16 или выше. Примечание. В Ansible 2.9.x в задачах необходимо использовать полные имена модулей. Варианты: `false` `true` ← (по умолчанию) Конфигурация: Запись INI: [ansible_network] import_modules = true Переменная среды: `ANSIBLE_NETWORK_IMPORT_MODULES` Переменная: ansible_network_import_modules
persistent_command_timeout целое число	Задаёт время ожидания (в секундах) возврата результата команды с удалённого устройства. Если это время истечёт до возврата результата команды, подключаемый модуль подключения вызовет исключение и завершит работу. По умолчанию: `30` Конфигурация: Запись INI: [persistent_connection] command_timeout = 30 Переменная среды: `ANSIBLE_PERSISTENT_COMMAND_TIMEOUT` Переменная: ansible_command_timeout
persistent_connect_timeout целое число	Задаёт время ожидания (в секундах) при первоначальной установке постоянного подключения. Если это время истечёт до завершения подключения к удалённому устройству, попытка подключения завершится неудачей. По умолчанию: `30` Конфигурация: Запись INI: [persistent_connection] connect_timeout = 30 Переменная среды: `ANSIBLE_PERSISTENT_CONNECT_TIMEOUT` Переменная: ansible_connect_timeout
persistent_log_messages логическое значение	Этот флаг включает запись выполненной команды и полученного от целевого устройства ответа в файл журнала Ansible. Для работы этого параметра необходимо задать параметр конфигурации Ansible ‘log_path’ и указать путь к файлу, доступному для записи. Перед включением этого параметра обязательно ознакомьтесь с последствиями для безопасности: запись конфиденциальной информации в файл журнала может создать уязвимость. Варианты: `false` ← (по умолчанию) `true` Конфигурация: Запись INI: [persistent_connection] log_messages = false Переменная среды: `ANSIBLE_PERSISTENT_LOG_MESSAGES` Переменная: ansible_persistent_log_messages

Примечание

Перечисленные выше записи конфигурации для каждого типа (переменная Ansible, переменная среды и т. д.) упорядочены по приоритету от низкого к высокому. Например, переменная, находящаяся ниже в списке, переопределяет переменную, расположенную выше. Типы записей также упорядочены по приоритету от низкого к высокому. Например, запись ansible.cfg (находящаяся выше в списке) переопределяется переменной Ansible (находящейся ниже в списке).

Авторы

Команда сетевого взаимодействия Ansible (@ansible-network)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/ansible/netcommon/persistent_connection.html