community.network.ce_file_copy – Копирование файла на удалённое устройство cloudengine через SCP на коммутаторах HUAWEI CloudEngine.

Примечание

Этот плагин является частью коллекции community.network (версия 1.3.0).

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

Для использования в книге задач укажите: community.network.ce_file_copy.

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

Обзор

Копирование файла на удалённое устройство cloudengine через SCP на коммутаторах HUAWEI CloudEngine.

Требования

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

paramiko

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
file_system строка	Значение по умолчанию: "flash:"	Файловая система удалённого устройства. Если опущено, устройства, поддерживающие параметр file_system, будут использовать значения по умолчанию. Файловая система указывает на носитель хранения и может быть установлена следующим образом: 1) `flash` — корневой каталог флэш-памяти на главном MPU. 2) `slave#flash` — корневой каталог флэш-памяти на подчиненном MPU. Если подчиненный MPU отсутствует, этот диск недоступен. 3) `chassis ID/slot number#flash` — корневой каталог флэш-памяти на устройстве в стеке. Например, `1/5#flash` указывает на флэш-память с идентификатором шасси 1 и номером слота 5.
local_file строка / обязательно		Путь к локальному файлу. Локальный каталог должен существовать. Максимальная длина local_file — `4096`.
remote_file строка		Путь к удалённому файлу для копирования. Удалённые каталоги должны существовать. Если опущено, используется имя локального файла. Максимальная длина remote_file — `4096`.

Примечания

Примечание

Функция должна быть включена с помощью функции scp-server.
Если файл уже существует, передача не произойдёт.
Этот модуль требует включения системной службы netconf на удалённом управляемом устройстве.
Рекомендуемое подключение — netconf.
Этот модуль также работает с подключениями local для устаревших книг задач.

Примеры

- name: File copy test
  hosts: cloudengine
  connection: local
  gather_facts: no
  vars:
    cli:
      host: "{{ inventory_hostname }}"
      port: "{{ ansible_ssh_port }}"
      username: "{{ username }}"
      password: "{{ password }}"
      transport: cli

  tasks:

  - name: "Copy a local file to remote device"
    community.network.ce_file_copy:
      local_file: /usr/vrpcfg.cfg
      remote_file: /vrpcfg.cfg
      file_system: 'flash:'
      provider: "{{ cli }}"

Возвращаемые значения

Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого модуля:

Ключ	Возвращаемое значение	Описание
changed булево	всегда	проверка, были ли внесены изменения на устройстве Пример: True
local_file строка	всегда	Путь к локальному файлу. Пример: /usr/work/vrpcfg.zip
remote_file строка	всегда	Путь к удалённому файлу. Пример: /vrpcfg.zip
transfer_result строка	всегда	информация о результате передачи. Пример: Локальный файл успешно передан на устройство.

Авторы

Zhou Zhijin (@QijunPan)

© 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/community/network/ce_file_copy_module.html