Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

安装 Junos PyEZ

您可以在网络管理系统上、Python 虚拟环境中或者作为 Docker 容器安装 Junos PyEZ。

Junos PyEZ 是一个 Python 库,可用于管理和自动化 Junos 设备。您可以在类 UNIX 操作系统或 Windows 上安装 Junos PyEZ。您可以选择通过下列任一方式安装和运行 Junos PyEZ:

  • 直接在配置管理服务器上

  • 在 Python 虚拟环境中

  • 作为 Docker 容器

除了直接在服务器上安装 Junos PyEZ,还可以将其安装在虚拟环境中。Python 虚拟环境将项目的 Python 安装和包与系统或其他虚拟环境中安装的 Python 安装和包隔离开来,从而防止中断其他项目的依赖项。当您的项目需要不同版本的 Python 或 Python 包时,或者作为在系统上全局安装包的替代方法,您可以创建虚拟环境。

瞻博网络还提供了 Junos PyEZ Docker 映像,使您能够将 Junos PyEZ 作为 Docker 容器运行。Docker 容器是一个轻量级、独立的系统,它将 Junos PyEZ、其依赖项和 Python 捆绑到一个可移植容器中。Docker 映像使您能够在支持 Docker 的任何平台上以交互模式、可执行包或终端快速运行 Junos PyEZ。

要在配置管理服务器上安装 Junos PyEZ,请参阅以下部分:

要在 Python 虚拟环境中安装 Junos PyEZ,请参阅以下部分:

要使用 Junos PyEZ Docker 映像,请参阅以下部分:

安装必备软件

在配置管理服务器或虚拟环境中安装 Junos PyEZ 库之前,请确保配置管理服务器已安装以下软件:

  • Python - Junos PyEZ 支持 Python 3.8 到 Python 3.12

  • 给定操作系统的所有必备软件,如表 1 所示

注意:

从 Junos PyEZ 2.0 版开始支持 Python 3.x。

从 Junos PyEZ 2.6.0 版开始,将移除对 Python 2.7 的支持。

从 Junos PyEZ 2.7.0 版开始支持 Python 3.10。

从 Junos PyEZ 2.7.2 版开始支持 Python 3.12。

表 1:Junos PyEZ 必备软件

操作系统

软件包或库

CentOS

  • 海湾合作委员会

  • libffi-devel

  • libxml2-devel

  • libxslt-devel

  • openssl-devel

  • 果仁

  • python-devel

  • redhat-rpm-配置

Debian

  • libxml2-dev

  • libxslt1-dev

  • libssl-dev

  • 果仁

  • python3-devel(Python 3 需要)

软呢帽

  • 海湾合作委员会

  • libffi-devel

  • libxml2-devel

  • libxslt-devel

  • openssl-devel

  • 果仁

  • python3-devel(Python 3 需要)

  • redhat-rpm-配置

FreeBSD

  • libxml2

  • libxslt

  • py27-点

OSX

注意:

如果 Junos PyEZ 未使用 pip成功安装,请尝试使用 安装 easy_install 库,然后使用 Junos lxml PyEZ。

  • 果仁

  • xcode

Ubuntu的

  • libffi-dev

  • libssl-dev

  • libxml2-dev

  • libxslt1-dev

  • python3-dev(Python 3 需要)

  • 果仁

窗户

  • ECDSA

  • 果仁

在配置管理服务器上安装 Junos PyEZ

在配置管理服务器上安装必备软件后,可以从 Python 包索引 (PyPI) 站点安装最新版本的 Junos PyEZ。您还可以从 Junos PyEZ GitHub 存储库下载最新版本的代码。要从 GitHub 安装 Junos PyEZ,必须在配置管理服务器上安装 Git。

  • 要从 PyPI 安装当前版本的 Junos PyEZ,请执行以下命令(在适当情况下使用 sudo ):

    注意:

    要升级现有版本的 Junos PyEZ,请在命令中包含 -U--upgrade 选项。

  • 要从 GitHub 项目主分支安装 Junos PyEZ,请执行以下命令(在适当情况下使用 sudo ):

    注意:

    GitHub 源存储库中的最新代码正在积极开发中,可能不稳定。

有关安装 Junos PyEZ 的更多信息(包括其他安装选项),请参阅 Junos PyEZ GitHub 存储库中特定操作系统的 INSTALL 文件。

在 Python 虚拟环境中安装 Junos PyEZ

作为在系统上全局安装 Python 包的替代方法,您可以在隔离的 Python 虚拟环境中安装特定项目所需的包和依赖项。我们建议您在虚拟环境中使用 Python 3。

要在 Linux 或 macOS 服务器上使用 Junos PyEZ 创建虚拟 Python 3 安装:

  1. 在配置管理服务器上安装必备软件,如 安装必备软件中所述。
  2. 移动到现有项目目录或创建一个新项目目录(如果不存在)。
  3. 创建一个虚拟 Python 安装并指定其名称,在本例中为 venv。
    注意:

    Ubuntu 和 Debian 系统可能要求您先安装软件包, python3-venv 然后才能创建虚拟环境。

  4. 通过在适合您的平台和 shell 的虚拟环境 bin 目录中执行脚本来激活虚拟环境。
  5. 安装 Junos PyEZ。
    • 要从 PyPI 安装当前版本的 Junos PyEZ,请执行以下命令:

    • 要从 GitHub 项目主分支安装 Junos PyEZ,请执行以下命令,这需要安装 Git:

      注意:

      GitHub 源存储库中的最新代码正在积极开发中,可能不稳定。

  6. 在虚拟环境中执行 Junos PyEZ 命令或脚本。
  7. 在虚拟环境中完成工作后,请停用它以返回主 shell 提示符。

使用 Junos PyEZ Docker 映像

Docker 是一个软件容器平台,用于在隔离容器中打包和运行应用程序及其依赖项。瞻博网络会提供 Junos PyEZ Dockerfile 以及 Junos PyEZ Docker 映像,这些映像会为每个 Junos PyEZ 版本自动构建。从 Junos PyEZ 2.1.8 版开始,Docker 映像包括 Python 3.6。

您可以自定义并使用 Dockerfile 来构建自己的 Junos PyEZ Docker 映像,也可以使用存储在 Docker Hub 上的预构建 Docker 映像之一将 Junos PyEZ 作为 Docker 容器运行。您可以在交互模式下运行容器,作为可执行包或终端。

要在配置管理服务器上使用预构建的 Junos PyEZ Docker 映像,请执行以下操作:

  1. 安装 Docker。

    有关在特定操作系统上安装和配置 Docker 的说明,请参阅 https://www.docker.com 上的 Docker 网站。

  2. 从 Docker Hub 下载 juniper/pyez Docker 映像。
    • 要下载最新映像,请发出以下命令:

      注意:

      最新的 Junos PyEZ Docker 映像是使用 Junos PyEZ 源存储库中最近提交的代码构建的,该存储库正在积极开发中,可能不稳定。

    • 要下载特定映像,请将相应的发布标记附加到映像名称中,例如 2.1.2。

  3. 移动到包含脚本的本地目录。

    运行 Docker 容器时,本地脚本将装载到容器中的 /scripts 中。

  4. 运行容器。

    有关运行容器的说明,请参阅 DOCKER-EXAMPLES.md 上的官方使用示例。