如何使用Ansible配置Juniper交换机端口VLAN及解决报错

1. 基础依赖检查 #

• 确认本地已安装netconf通信依赖和对应Ansible集合：

  # 安装Python依赖
  pip install ncclient
  # 安装官方维护的网络设备集合
  ansible-galaxy collection install ansible.netcommon junipernetworks.junos
  

• 确认Ansible核心版本和集合版本兼容，建议使用Ansible 2.14及以上版本搭配最新的junipernetworks.junos集合。

2. Inventory 配置补全 #

你遇到的b'None'报错90%是因为连接参数缺失，需要在inventory中补充以下变量：

[all:vars]
ansible_network_os=junipernetworks.junos.junos
ansible_user=交换机管理用户名
ansible_password=交换机管理密码
ansible_port=830
# 若使用密钥认证替换密码配置
# ansible_private_key_file=/本地/密钥/路径

netconf协议默认使用830端口，未配置该参数会默认走22端口导致连接失败。

3. 交换机侧配置校验 #

• 确认交换机已配置netconf服务和用户权限，Junos配置参考：

  set system services netconf ssh
  set system login user 你的管理用户名 class super-user
  

• 本地测试830端口连通性：

  nc -zv 10.70.44.76 830
  

  若端口不通需要排查交换机安全策略、ACL限制。

4. 剧本调试优化 #

• 关闭不必要的facts收集，调整剧本开头配置：

  - name: Switch VLAN
    hosts: all
    gather_facts: no
    connection: ansible.netcommon.netconf
    tasks:
      - name: Replace VLAN
        junipernetworks.junos.junos_l2_interfaces:
          config:
            - name: xe-0/0/16
              access:
                vlan: 100
          state: merged
  

  如果只是新增/修改VLAN配置建议先用state: merged，state: replaced会清空接口下其他所有二层配置，容易引发冲突。
• 执行剧本时添加-vvv参数开启debug日志，可查看完整的netconf交互流程，定位具体报错原因。

5. 废弃连接方式说明 #

juniper.device.pyez是Juniper官方集合专用的连接方式，和社区维护的junipernetworks.junos集合不兼容，因此会返回Method not found报错，无需使用该连接方式，统一使用ansible.netcommon.netconf即可。

内容的提问来源于stack exchange，提问作者dranobob