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

Новая версия 2.4.

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

Обзор

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

Требования

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

paramiko

Параметры

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

Примечания

Примечание

Функция должна быть включена с помощью функции scp-server.
Если файл уже существует, передача не будет выполнена.
Для данного модуля требуется включенная служба netconf system на управляемом удалённом устройстве.
Рекомендуемое соединение — 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"
    ce_file_copy:
      local_file: /usr/vrpcfg.cfg
      remote_file: /vrpcfg.cfg
      file_system: 'flash:'
      provider: "{{ cli }}"

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

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

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

Статус

Данный модуль не гарантирует обратную совместимость интерфейса. [превью]
Данный модуль поддерживается сообществом Ansible. [сообщество]

Авторы

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.9/modules/ce_file_copy_module.html