适用于 Junos OS 的 Ansible 服务器要求
了解设置 Ansible 控制节点以管理运行 Junos OS 的设备和运行 Junos OS Evolved 的设备的要求。
瞻博网络支持使用 Ansible 管理运行 Junos OS 的设备和运行 Junos OS Evolved 的设备。我们提供 Ansible 模块,您可以使用这些模块在托管设备上执行操作和配置任务。瞻博网络模块通过以下集合进行分发,这些集合托管在 Ansible Galaxy 网站上:
从 2.0.0 版开始 juniper.device ,我们将瞻博网络 juniper.device 产品系列和红帽 Ansible junipernetworks.junos 产品系列整合为一个 juniper.device 产品系列。安装 juniper.device 集合时,可用于 juniper.device.module_name 执行任一模块集中的模块。如果要继续使用引用 junipernetworks.junos.module_name的现有 playbook,还必须安装 junipernetworks.junos 集合。要使用任一命名空间执行 junipernetworks.junos 模块,必须定义 ansible_network_os=juniper.device.junos.否则,在使用合并的模块集时,其他一切都保持不变。
将 Ansible 安装在具有类 Unix 操作系统的控制节点上。您可以安装 Ansible 和瞻博网络合集:
-
直接在配置管理服务器上
-
在 Python 虚拟环境中
-
作为 Docker 容器
要在系统安装的 Python 下或控制节点上的 Python 虚拟环境中安装 Ansible 和 juniper.device 集合,请参阅以下部分:
瞻博网络 juniper/pyez-ansible Docker 映像是一个轻量级、独立的系统,将 Ansible、瞻博网络模块和所有依赖项捆绑到一个可移植容器中。Docker 容器使您能够在任何支持 Docker 的平台上以交互式模式快速运行 Ansible,或作为可执行包运行。要使用 Ansible for Junos OS Docker 映像,请参阅以下部分:
先决条件软件
在安装瞻博网络 juniper.device 集合并开始使用 Ansible 管理 Junos 设备之前,必须在所选环境中的 Ansible 控制节点上安装以下先决条件软件。您可以在系统安装的 Python 下或 Python 虚拟环境中安装软件。建议使用 Python 虚拟环境。
-
Python 3.12 或更高版本
-
Ansible 10.x 或更高版本(ansible-core 版本 2.17 或更高版本)
-
Junos PyEZ (
junos-eznc) 2.7.3 或更高版本。有关 Junos PyEZ 安装说明,请参阅:
-
以下 Python 包和库:
-
Python 中的 Junos 快照管理员 (JSNAPy) 1.3.7 或更高版本(使用该
juniper.device.jsnapy模块需要)。有关 JSNAPy 的安装说明和最新信息,请参阅:
安装 juniper.device 集合
在 Ansible 控制节点上,您可以安装 juniper.device 集合和 junipernetworks.junos Ansible Galaxy 中的集合。在安装 Ansible 和其他先决条件软件的同一环境中安装集合。
从 2.0.0 版开始 juniper.device , juniper.device 集合包括 juniper.device 模块和 junipernetworks.junos 模块。您可以只 juniper.device 安装集合并用于 juniper.device.module-name 执行任一模块集中的任何模块。如果您以前使用过这些 junipernetworks.junos 模块,并且想要继续使用引用 junipernetworks.junos.module-name的现有playbook,那么还必须安装集合 junipernetworks.junos 。
我们建议现有 junipernetworks.junos 集合用户在适用于 Junos OS 的 Ansible 环境中安装这两个集合。
要安装集合和集合,junipernetworks.junos请执行juniper.device以下操作:
使用 Ansible for Junos OS Docker 映像
Docker 是一个软件容器平台,用于在隔离容器中打包和运行应用程序及其依赖项。瞻博网络 提供了带有 瞻博网络 Ansible 模块的 Docker 映像 。Docker 映像包含 Python 3 和 Ansible。还包括集合 juniper.device 的最新版本、Junos PyEZ 和 JSNAPy 以及任何必需的依赖项。您可以在交互模式下运行容器,也可以将容器用作可执行文件来运行 playbook。
要在 Ansible 控制节点上使用 Ansible for Junos OS Docker 映像:
变更历史表
是否支持某项功能取决于您使用的平台和版本。使用 功能资源管理器 确定您的平台是否支持某个功能。
juniper.device ,我们已将 Red Hat Ansible junipernetworks.junos 模块合并到集合中 juniper.device 。