ce_file_copy - Копирование файла на удалённое устройство cloudengine через SCP на коммутаторах HUAWEI CloudEngine.
Новая версия 2.4.
Обзор
- Копирование файла на удалённое устройство 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 указывает на флэш-память с идентификатором chassis 1 и номером слота 5. |
| local_file обязательно | Путь к локальному файлу. Локальный каталог должен существовать. Максимальная длина local_file составляет 4096. | |
| remote_file | Путь к удалённому файлу для копирования. Удалённые каталоги должны существовать. Если опущен, используется имя локального файла. Максимальная длина remote_file составляет 4096. |
Примечания
Примечание
- Функция должна быть включена с помощью параметра scp-server.
- Если файл уже существует, передача не произойдёт.
Примеры
- 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. См. Техническое обслуживание и поддержка модулей для получения дополнительной информации.
Список других модулей, которые также поддерживаются сообществом Ansible, см. здесь.
Автор
- Zhou Zhijin (@CloudEngine-Ansible)
Подсказка
Если вы обнаружите какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/ce_file_copy_module.html
