Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Instalar Junos PyEZ

Puede instalar Junos PyEZ en un sistema de administración de red, en un entorno virtual de Python o como un contenedor de Docker.

Junos PyEZ es una biblioteca de Python que le permite administrar y automatizar dispositivos Junos. Puede instalar Junos PyEZ en un sistema operativo similar a UNIX o en Windows. Tiene la opción de instalar y ejecutar Junos PyEZ de una de las siguientes maneras:

  • Directamente en el servidor de administración de configuración

  • Dentro de un entorno virtual Python

  • Como contenedor de Docker

Como alternativa a la instalación de Junos PyEZ directamente en el servidor, puede instalarlo en un entorno virtual. Un entorno virtual de Python aísla la instalación y los paquetes de Python de un proyecto de los instalados en el sistema o en otros entornos virtuales, lo que evita romper las dependencias de otros proyectos. Puede crear entornos virtuales cuando tenga proyectos que requieran diferentes versiones de Python o paquetes de Python o como alternativa a la instalación global de paquetes en el sistema.

Juniper Networks también proporciona una imagen de Docker de Junos PyEZ que le permite ejecutar Junos PyEZ como un contenedor de Docker. El contenedor Docker es un sistema ligero y autónomo que agrupa Junos PyEZ, sus dependencias y Python en un único contenedor portátil. La imagen de Docker le permite ejecutar rápidamente Junos PyEZ en modo interactivo, como un paquete ejecutable o como un terminal en cualquier plataforma que admita Docker.

Para instalar Junos PyEZ en el servidor de administración de configuración, consulte las siguientes secciones:

Para instalar Junos PyEZ en un entorno virtual Python, consulte las siguientes secciones:

Para utilizar la imagen de Docker de Junos PyEZ, consulte la siguiente sección:

Instalar el software necesario

Antes de instalar la biblioteca de Junos PyEZ en el servidor de administración de configuración o en un entorno virtual, asegúrese de que el servidor de administración de configuración tenga instalado el siguiente software:

  • Python: Junos PyEZ admite Python 3.8 a Python 3.12

  • Todo el software de requisito previo para el sistema operativo dado, que se describe en la Tabla 1

Nota:

Python 3.x es compatible a partir de Junos PyEZ versión 2.0.

La compatibilidad con Python 2.7 se elimina a partir de Junos PyEZ versión 2.6.0.

Python 3.10 es compatible a partir de Junos PyEZ versión 2.7.0.

Python 3.12 es compatible a partir de Junos PyEZ versión 2.7.2.

Tabla 1: Software de prerrequisito de Junos PyEZ

Sistema operativo

Paquete o biblioteca

Centos

  • Gcc

  • libffi-devel

  • libxml2-devel

  • libxslt-devel

  • openssl-devel

  • pepita

  • python-devel

  • redhat-rpm-config

Debian

  • libxml2-dev

  • libxslt1-dev

  • libssl-dev

  • pepita

  • python3-devel (requerido para Python 3)

Fedora

  • Gcc

  • libffi-devel

  • libxml2-devel

  • libxslt-devel

  • openssl-devel

  • pepita

  • python3-devel (requerido para Python 3)

  • redhat-rpm-config

FreeBSD

  • libxml2

  • libxslt

  • py27-pip

OSX

Nota:

Si Junos PyEZ no se instala correctamente con pip, intente usar easy_install para instalar la lxml biblioteca y, a continuación, Junos PyEZ.

  • pepita

  • xcode

Ubuntu (en inglés)

  • libffi-dev

  • libssl-dev

  • libxml2-dev

  • libxslt1-dev

  • python3-dev (requerido para Python 3)

  • pepita

Windows

  • ECDSA

  • pepita

Instalar Junos PyEZ en el servidor de administración de configuración

Después de instalar el software necesario en el servidor de administración de configuración, puede instalar la versión más reciente de Junos PyEZ desde el sitio de Python Package Index (PyPI). También puede descargar la versión más reciente del código desde el repositorio de GitHub de Junos PyEZ. Para instalar Junos PyEZ desde GitHub, debe tener Git instalado en el servidor de administración de configuración.

  • Para instalar la versión actual de Junos PyEZ de PyPI, ejecute el siguiente comando (utilícelo sudo cuando corresponda):

    Nota:

    Para actualizar una versión existente de Junos PyEZ, incluya la -U opción o --upgrade en el comando.

  • Para instalar Junos PyEZ desde la rama maestra del proyecto GitHub, ejecute el siguiente comando (úselo sudo cuando corresponda):

    Nota:

    El código más reciente en el repositorio de código fuente de GitHub está en desarrollo activo y es posible que no sea estable.

Para obtener información adicional acerca de la instalación de Junos PyEZ, incluidas las opciones de instalación adicionales, consulte el archivo INSTALL de su sistema operativo específico en el repositorio de GitHub de Junos PyEZ.

Instalar Junos PyEZ en un entorno virtual Python

Como alternativa a la instalación global de paquetes de Python en un sistema, puede instalar los paquetes y las dependencias necesarios para un proyecto específico en un entorno virtual de Python aislado. Le recomendamos que utilice Python 3 para su entorno virtual.

Para crear una instalación virtual de Python 3 con Junos PyEZ en un servidor Linux o macOS:

  1. Instale el software necesario en el servidor de administración de configuración, como se describe en Instalar software de requisito previo.
  2. Desplácese al directorio de proyecto existente o cree uno nuevo, si no existe ninguno.
  3. Cree una instalación virtual de Python y especifique su nombre, que en este caso es venv.
    Nota:

    Los sistemas Ubuntu y Debian pueden requerir que instale el paquete antes de python3-venv poder crear el entorno virtual.

  4. Active el entorno virtual ejecutando el script en el directorio del bin entorno virtual adecuado para su plataforma y shell.
  5. Instalar Junos PyEZ.
    • Para instalar la versión actual de Junos PyEZ desde PyPI, ejecute el siguiente comando:

    • Para instalar Junos PyEZ desde la rama maestra del proyecto GitHub, ejecute el siguiente comando, que requiere que Git esté instalado:

      Nota:

      El código más reciente en el repositorio de código fuente de GitHub está en desarrollo activo y es posible que no sea estable.

  6. Ejecute sus comandos o scripts de Junos PyEZ dentro del entorno virtual.
  7. Cuando haya terminado de trabajar en el entorno virtual, desactívelo para volver al símbolo del shell principal.

Usar la imagen de Docker de Junos PyEZ

Docker es una plataforma de contenedor de software que se utiliza para empaquetar y ejecutar una aplicación y sus dependencias en un contenedor aislado. Juniper Networks ofrece un archivo Docker de Junos PyEZ , así como imágenes de Docker de Junos PyEZ, que se crean automáticamente para cada versión de Junos PyEZ. A partir de Junos PyEZ versión 2.1.8, las imágenes de Docker incluyen Python 3.6.

Puede personalizar y usar Dockerfile para crear su propia imagen de Docker de Junos PyEZ, o puede usar una de las imágenes de Docker precompiladas, que se almacenan en Docker Hub, para ejecutar Junos PyEZ como un contenedor de Docker. Puede ejecutar el contenedor en modo interactivo, como un paquete ejecutable o como un terminal.

Para usar una imagen de Docker de Junos PyEZ pregenerada en el servidor de administración de configuración:

  1. Instale Docker.

    Consulte el sitio web de Docker en https://www.docker.com para obtener instrucciones sobre cómo instalar y configurar Docker en su sistema operativo específico.

  2. Descargue la imagen de Docker de juniper/pyez desde Docker Hub.
    • Para descargar la imagen más reciente, emita el siguiente comando:

      Nota:

      La última imagen de Docker de Junos PyEZ se creó con el código confirmado más reciente en el repositorio de código fuente de Junos PyEZ, que está en desarrollo activo y podría no ser estable.

    • Para descargar una imagen específica, anexe la etiqueta de liberación adecuada al nombre de la imagen, por ejemplo, 2.1.2.

  3. Vaya al directorio local que contiene los scripts.

    Cuando se ejecuta el contenedor Docker, los scripts locales se montan en /scripts en el contenedor.

  4. Ejecute el contenedor.

    Para obtener instrucciones sobre cómo ejecutar el contenedor, consulte los ejemplos de uso oficiales en DOCKER-EXAMPLES.md.