ansible.netcommon.net_put – Копирование файла с контроллера Ansible на сетевое устройство
Примечание
Этот плагин является частью коллекции ansible.netcommon (версия 1.5.0).
Для его установки используйте: ansible-galaxy collection install ansible.netcommon.
Для использования в плейбуке укажите: ansible.netcommon.net_put.
Новое в версии 1.0.0: коллекции ansible.netcommon
Описание
- Этот модуль предоставляет возможность копирования файла с контроллера Ansible на сетевые устройства.
Примечание
Этот модуль имеет соответствующий плагин действий.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- scp
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| dest строка | По умолчанию: ["Имя файла из src и в стандартном каталоге пользователя оболочки на network_os."] | Указывает целевой файл. Путь к целевому файлу может быть полным или относительным, как поддерживается network_os. |
| mode строка |
| Устанавливает режим передачи файла. Если режим установлен на text, то файл src пройдет через движок шаблонизации Jinja2 для замены любых переменных, если они присутствуют в файле src. Если режим установлен на binary, то файл будет скопирован в целевое устройство без изменений. |
| protocol строка |
| Протокол, используемый для передачи файла. |
| src строка / обязательно | Указывает исходный файл. Путь к исходному файлу может быть полным на хосте Ansible или относительным от корня плейбука или роли. |
Примечания
Примечание
- Некоторые устройства требуют настройки для работы 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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/ansible/netcommon/net_put_module.html