ansible.netcommon.net_put – Копирование файла с контроллера Ansible на сетевое устройство

Примечание

Этот плагин входит в коллекцию ansible.netcommon (версия 1.4.1).

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

Для использования в книге задач укажите: ansible.netcommon.net_put.

Добавлено в версии 1.0.0: модуля ansible.netcommon

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

Обзор

Этот модуль предоставляет возможность копирования файла с контроллера Ansible на сетевые устройства.

Примечание

Данному модулю соответствует плагин действия.

Требования

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
dest строка	По умолчанию: ["Имя файла из src и в стандартном каталоге пользователя shell на network_os."]	Указывает имя файла назначения. Путь к файлу назначения может быть полным или относительным, как поддерживается network_os.
mode строка	Варианты: binary ← text	Устанавливает режим передачи файла. Если режим установлен в text, то файл src пройдет через движок шаблонов Jinja2 для замены переменных, если они присутствуют в файле src. Если режим установлен в binary, то файл будет скопирован на целевое устройство без изменений.
protocol строка	Варианты: scp ← sftp	Протокол, используемый для передачи файла.
src строка / обязательно		Указывает исходный файл. Путь к исходному файлу может быть полным на хосте Ansible Control или относительным от корневой директории книги задач или роли.

Примечания

Примечание

Некоторые устройства требуют определённых настроек для включения работы scp. Эти настройки должны быть предварительно сконфигурированы перед использованием этого модуля, например, для IOS - ip scp server enable.
Права пользователя для выполнения scp на сетевом устройстве должны быть предварительно сконфигурированы, например, для IOS - по умолчанию требуется привилегия пользователя 15 для разрешения scp.
Стандартное место назначения исходного файла.
Этот модуль поддерживается на ansible_network_os сетевых платформах. Подробности см. в разделе Параметры сетевых платформ.

Примеры

- name: copy file from ansible controller to a network device
  ansible.netcommon.net_put:
    src: running_cfg_ios1.txt

- name: copy file at root dir of flash in slot 3 of sw1(ios)
  ansible.netcommon.net_put:
    src: running_cfg_sw1.txt
    protocol: sftp
    dest: flash3:/running_cfg_sw1.txt

Авторы

Deepak Agrawal (@dagrawal)

© 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/netcommon/net_put_module.html