junipernetworks.junos.junos_scp – Передача файлов на удалённые устройства под управлением Junos или с них

Примечание

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

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

Для использования в книге задач укажите: junipernetworks.junos.junos_scp.

Новое в версии 1.0.0: плагина junipernetworks.junos

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

Обзор

Этот модуль передает файлы через SCP на удалённые устройства под управлением Junos или с них.

Примечание

У этого модуля есть соответствующий плагин действия.

Требования

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

junos-eznc
ncclient (>=v0.5.2)

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
dest путь		Значение по умолчанию: "."	Аргумент `dest` указывает путь для получения файлов.
provider словарь			Устарело Начиная с Ansible 2.5, рекомендуется использовать `connection: network_cli` или `connection: netconf`. Для получения дополнительной информации обратитесь к руководству Junos OS Platform Options. Объект словаря, содержащий данные подключения.
	host строка		Указывает имя DNS хоста или адрес для подключения к удалённому устройству по указанному протоколу. Значение host используется в качестве адреса назначения для протокола.
	password строка		Указывает пароль для аутентификации подключения к удалённому устройству. Это значение используется для аутентификации сеанса SSH. Если значение не указано в задаче, используется значение переменной среды `ANSIBLE_NET_PASSWORD`.
	port целое число		Указывает порт, используемый при построении подключения к удалённому устройству. Значение порта по умолчанию — стандартный порт SSH 22 (для `transport=cli`) или порт 830 (для `transport=netconf`) устройства.
	ssh_keyfile путь		Указывает SSH-ключ для аутентификации подключения к удалённому устройству. Это значение — путь к ключу, используемому для аутентификации сеанса SSH. Если значение не указано в задаче, используется значение переменной среды `ANSIBLE_NET_SSH_KEYFILE`.
	timeout целое число		Указывает время ожидания в секундах для связи с сетевым устройством при подключении или отправке команд. Если время ожидания истечёт до завершения операции, модуль вернёт ошибку.
	transport строка	Варианты: cli netconf ←	Настраивает транспортное соединение для подключения к удалённому устройству.
	username строка		Настраивает имя пользователя для аутентификации подключения к удалённому устройству. Это значение используется для аутентификации сеанса SSH. Если значение не указано в задаче, используется значение переменной среды `ANSIBLE_NET_USERNAME`.
recursive булево		Варианты: нет ← да	Аргумент `recursive` включает рекурсивную передачу файлов и каталогов.
remote_src булево		Варианты: нет ← да	Аргумент `remote_src` включает загрузку файлов (scp get) с удалённого устройства. По умолчанию выполняется загрузка файлов (scp put) на удалённое устройство.
src список / элементы=строка / обязательный			Аргумент `src` принимает один путь или список путей, которые нужно передать. Аргумент `recursive` должен быть `true`, чтобы передавать каталоги.
ssh_config путь			Аргумент `ssh_config` — путь к конфигурационному файлу SSH. Он может быть использован для загрузки информации SSH из конфигурационного файла. По умолчанию, если этот параметр не задан, ищется ~/.ssh/config.
ssh_private_key_file путь			Аргумент `ssh_private_key_file` — путь к файлу закрытого SSH-ключа. Используется, если требуется предоставить закрытый ключ, а не загрузить его в ssh-key-ring/среду.

Примечания

Примечание

Этот модуль требует, чтобы на управляемом удалённом устройстве была включена системная служба netconf.
Тестировался с vMX JUNOS версии 17.3R1.10.
Работает только с подключениями local.
Поскольку этот модуль использует junos-eznc для подключения к устройству Junos, параметры конфигурации netconf необходимо передавать с помощью параметров модуля, например, ssh_config, в отличие от других модулей junos, которые используют тип подключения netconf.
Подробную информацию об использовании CLI и netconf см. в руководстве Junos OS Platform Options
Дополнительную информацию об использовании Ansible для управления сетевыми устройствами см. в руководстве Ansible Network Guide
Дополнительную информацию об использовании Ansible для управления устройствами сети Juniper см. на https://www.ansible.com/ansible-juniper.

Примеры

# the required set of connection arguments have been purposely left off
# the examples for brevity
- name: upload local file to home directory on remote device
  junipernetworks.junos.junos_scp:
    src: test.tgz

- name: upload local file to tmp directory on remote device
  junipernetworks.junos.junos_scp:
    src: test.tgz
    dest: /tmp/

- name: download file from remote device
  junipernetworks.junos.junos_scp:
    src: test.tgz
    remote_src: true

- name: ssh config file path for jumphost config
  junipernetworks.junos.junos_scp:
    src: test.tgz
    remote_src: true
    ssh_config: /home/user/customsshconfig

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

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

Ключ	Возвращённое значение	Описание
changed булево	всегда	всегда true

Авторы

Christian Giese (@GIC-de)

© 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/junipernetworks/junos/junos_scp_module.html