Junos OS 平台选项

Juniper Junos OS 中支持多种连接。此页面提供了有关每种连接在 Ansible 中的工作方式以及如何使用它的详细信息。

可用连接

CLI

junos_netconfjunos_command 模块

NETCONF

junos_netconf(启用 NETCONF)之外的所有模块

协议

SSH

通过 SSH 传输 XML

凭据

如果存在,则使用 SSH 密钥/SSH 代理

如果使用密码,则接受 -u myuser -k

如果存在,则使用 SSH 密钥/SSH 代理

如果使用密码,则接受 -u myuser -k

间接访问

通过堡垒机(跳板主机)

通过堡垒机(跳板主机)

连接设置

ansible_connection: ``ansible.netcommon.network_cli

ansible_connection: ``ansible.netcommon.netconf

启用模式
(权限提升)

Junos OS 不支持

Junos OS 不支持

返回的数据格式

stdout[0].

  • json: result[0]['software-information'][0]['host-name'][0]['data'] foo lo0

  • text: result[1].interface-information[0].physical-interface[0].name[0].data foo lo0

  • xml: result[1].rpc-reply.interface-information[0].physical-interface[0].name[0].data foo lo0

ansible_connection: local 已弃用。请改用 ansible_connection: ansible.netcommon.network_cliansible_connection: ansible.netcommon.netconf

在 Ansible 中使用 CLI

CLI 清单示例 [junos:vars]

[junos:vars]
ansible_connection=ansible.netcommon.network_cli
ansible_network_os=junipernetworks.junos.junos
ansible_user=myuser
ansible_password=!vault...
ansible_ssh_common_args='-o ProxyCommand="ssh -W %h:%p -q bastion01"'
  • 如果您使用 SSH 密钥(包括 ssh 代理),则可以删除 ansible_password 配置。

  • 如果您直接访问主机(不是通过堡垒机/跳板主机),则可以删除 ansible_ssh_common_args 配置。

  • 如果您通过堡垒机/跳板主机访问主机,则不能在 ProxyCommand 指令中包含 SSH 密码。为了防止机密泄露(例如在 ps 输出中),SSH 不支持通过环境变量提供密码。

CLI 任务示例

- name: Retrieve Junos OS version
  junipernetworks.junos.junos_command:
    commands: show version
  when: ansible_network_os == 'junipernetworks.junos.junos'

在 Ansible 中使用 NETCONF

启用 NETCONF

在您可以使用 NETCONF 连接到交换机之前,您必须

  • 在您的控制节点上使用 pip install ncclient 安装 ncclient python 包

  • 在 Junos OS 设备上启用 NETCONF

要通过 Ansible 在新的交换机上启用 NETCONF,请通过 CLI 连接使用 junipernetworks.junos.junos_netconf 模块。像上面 CLI 示例中一样设置您的平台级变量,然后运行如下 playbook 任务

- name: Enable NETCONF
  connection: ansible.netcommon.network_cli
  junipernetworks.junos.junos_netconf:
  when: ansible_network_os == 'junipernetworks.junos.junos'

启用 NETCONF 后,更改您的变量以使用 NETCONF 连接。

NETCONF 清单示例 [junos:vars]

[junos:vars]
ansible_connection=ansible.netcommon.netconf
ansible_network_os=junipernetworks.junos.junos
ansible_user=myuser
ansible_password=!vault |
ansible_ssh_common_args='-o ProxyCommand="ssh -W %h:%p -q bastion01"'

NETCONF 任务示例

- name: Backup current switch config (junos)
  junipernetworks.junos.junos_config:
    backup: yes
  register: backup_junos_location
  when: ansible_network_os == 'junipernetworks.junos.junos'

警告

切勿以明文形式存储密码。我们建议使用 SSH 密钥来验证 SSH 连接。Ansible 支持 ssh 代理来管理您的 SSH 密钥。如果您必须使用密码来验证 SSH 连接,我们建议使用 Ansible Vault 对其进行加密。

另请参阅

设置超时选项