Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
SUR CETTE PAGE
 

Installer Junos PyEZ

Vous pouvez installer Junos PyEZ sur un système de gestion réseau, dans un environnement virtuel Python ou en tant que conteneur Docker.

Junos PyEZ est une bibliothèque Python qui vous permet de gérer et d’automatiser les équipements Junos. Vous pouvez installer Junos PyEZ sur un système d’exploitation de type UNIX ou sous Windows. Vous avez la possibilité d’installer et d’exécuter Junos PyEZ de l’une des manières suivantes :

  • Directement sur le serveur de gestion de la configuration

  • Au sein d’un environnement virtuel Python

  • En tant que conteneur Docker

Au lieu d’installer Junos PyEZ directement sur le serveur, vous pouvez l’installer dans un environnement virtuel. Un environnement virtuel Python isole l’installation et les packages Python d’un projet de ceux installés sur le système ou dans d’autres environnements virtuels, ce qui empêche de rompre les dépendances des autres projets. Vous pouvez créer des environnements virtuels lorsque vous avez des projets qui nécessitent différentes versions de Python ou de packages Python ou comme alternative à l’installation globale de packages sur le système.

Juniper Networks fournit également une image Docker Junos PyEZ qui vous permet d’exécuter Junos PyEZ en tant que conteneur Docker. Le conteneur Docker est un système léger et autonome qui regroupe Junos PyEZ, ses dépendances et Python dans un seul conteneur portable. L’image Docker vous permet d’exécuter rapidement Junos PyEZ en mode interactif, en tant que package exécutable ou en tant que terminal sur n’importe quelle plate-forme prenant en charge Docker.

Pour installer Junos PyEZ sur le serveur de gestion de la configuration, reportez-vous aux sections suivantes :

Pour installer Junos PyEZ dans un environnement virtuel Python, reportez-vous aux sections suivantes :

Pour utiliser l’image Docker Junos PyEZ, reportez-vous à la section suivante :

Installer le logiciel prérequis

Avant d’installer la bibliothèque Junos PyEZ sur le serveur de gestion de la configuration ou dans un environnement virtuel, assurez-vous que le logiciel suivant est installé sur le serveur de gestion de la configuration :

  • Python : Junos PyEZ prend en charge Python 3.8 à Python 3.12

  • Tous les logiciels prérequis pour le système d’exploitation donné, comme indiqué dans le Tableau 1

Note:

Python 3.x est pris en charge à partir de la version 2.0 de Junos PyEZ.

La prise en charge de Python 2.7 a été supprimée à partir de la version 2.6.0 de Junos PyEZ.

Python 3.10 est pris en charge à partir de la version 2.7.0 de Junos PyEZ.

Python 3.12 est pris en charge à partir de la version 2.7.2 de Junos PyEZ.

Tableau 1 : Logiciel prérequis Junos PyEZ

Système d’exploitation

Package ou bibliothèque

Centos

  • Gcc

  • libffi-devel

  • libxml2-devel

  • libxslt-devel

  • openssl-devel

  • pépin

  • python-devel

  • redhat-rpm-config

Debian

  • libxml2-dev

  • libxslt1-dev

  • libssl-dev

  • pépin

  • python3-devel (requis pour Python 3)

Chapeau mou

  • Gcc

  • libffi-devel

  • libxml2-devel

  • libxslt-devel

  • openssl-devel

  • pépin

  • python3-devel (requis pour Python 3)

  • redhat-rpm-config

FreeBSD

  • libxml2

  • libxslt

  • PY27-PIP

Système OSX

Note:

Si Junos PyEZ ne parvient pas à s’installer à l’aide pipde , essayez d’utiliser easy_install pour installer la lxml bibliothèque, puis Junos PyEZ.

  • pépin

  • xcode

Ubuntu

  • libffi-dev

  • libssl-dev

  • libxml2-dev

  • libxslt1-dev

  • python3-dev (requis pour Python 3)

  • pépin

Windows

  • ECDSA

  • pépin

Installer Junos PyEZ sur le serveur de gestion de la configuration

Après avoir installé le logiciel prérequis sur le serveur de gestion de la configuration, vous pouvez installer la dernière version de Junos PyEZ à partir du site Python Package Index (PyPI). Vous pouvez également télécharger la dernière version du code à partir du référentiel GitHub Junos PyEZ. Pour installer Junos PyEZ à partir de GitHub, Git doit être installé sur le serveur de gestion de la configuration.

  • Pour installer la version actuelle de Junos PyEZ à partir de PyPI, exécutez la commande suivante (à utiliser sudo le cas échéant) :

    Note:

    Pour mettre à niveau une version existante de Junos PyEZ, incluez l’option -U ou --upgrade dans la commande.

  • Pour installer Junos PyEZ à partir de la branche principale du projet GitHub, exécutez la commande suivante (à utiliser sudo le cas échéant) :

    Note:

    Le code le plus récent du référentiel source GitHub est en cours de développement actif et peut ne pas être stable.

Pour plus d’informations sur l’installation de Junos PyEZ, y compris des options d’installation supplémentaires, consultez le fichier INSTALL de votre système d’exploitation spécifique dans le référentiel GitHub Junos PyEZ.

Installer Junos PyEZ dans un environnement virtuel Python

Au lieu d’installer des packages Python globalement sur un système, vous pouvez installer les packages et dépendances requis pour un projet spécifique dans un environnement virtuel Python isolé. Nous vous recommandons d’utiliser Python 3 pour votre environnement virtuel.

Pour créer une installation Python 3 virtuelle avec Junos PyEZ sur un serveur Linux ou macOS :

  1. Installez le logiciel prérequis sur le serveur de gestion de la configuration, comme indiqué dans Installer le logiciel prérequis.
  2. Déplacez-vous dans le répertoire de votre projet existant ou créez-en un nouveau, s’il n’en existe pas.
  3. Créez une installation Python virtuelle et spécifiez son nom, qui dans ce cas est venv.
    Note:

    Les systèmes Ubuntu et Debian peuvent nécessiter l’installation du package avant de python3-venv pouvoir créer l’environnement virtuel.
  4. Activez l’environnement virtuel en exécutant le script dans le répertoire de bin l’environnement virtuel correspondant à votre plate-forme et à votre shell.
  5. Installez Junos PyEZ.

    • Pour installer la version actuelle de Junos PyEZ à partir de PyPI, exécutez la commande suivante :

    • Pour installer Junos PyEZ à partir de la branche principale du projet GitHub, exécutez la commande suivante, qui nécessite l’installation de Git :

      Note:

      Le code le plus récent du référentiel source GitHub est en cours de développement actif et peut ne pas être stable.

  6. Exécutez vos commandes ou scripts Junos PyEZ dans l’environnement virtuel.
  7. Lorsque vous avez fini de travailler dans l’environnement virtuel, désactivez-le pour revenir à l’invite du shell principal.

Utiliser l’image Docker Junos PyEZ

Docker est une plate-forme de conteneur logiciel utilisée pour empaqueter et exécuter une application et ses dépendances dans un conteneur isolé. Juniper Networks fournit un fichier Docker Junos PyEZ, ainsi que des images Docker Junos PyEZ, qui sont automatiquement générées pour chaque version de Junos PyEZ. À partir de la version 2.1.8 de Junos PyEZ, les images Docker incluent Python 3.6.

Vous pouvez personnaliser et utiliser le fichier Dockerpour créer votre propre image Docker Junos PyEZ, ou vous pouvez utiliser l’une des images Docker prédéfinies, qui sont stockées sur Docker Hub, pour exécuter Junos PyEZ en tant que conteneur Docker. Vous pouvez exécuter le conteneur en mode interactif, en tant que package exécutable ou en tant que terminal.

Pour utiliser une image Docker Junos PyEZ prédéfinie sur votre serveur de gestion de la configuration :

  1. Installez Docker.

    Consultez le site Web de Docker à l’adresse https://www.docker.com pour obtenir des instructions sur l’installation et la configuration de Docker sur votre système d’exploitation spécifique.

  2. Téléchargez l’image Docker juniper/pyez à partir de Docker Hub.

    • Pour télécharger la dernière image, exécutez la commande suivante :

      Note:

      La dernière image Docker Junos PyEZ est générée à l’aide du code le plus récemment validé dans le référentiel source Junos PyEZ, qui est en cours de développement actif et peut ne pas être stable.

    • Pour télécharger une image spécifique, ajoutez la balise de version appropriée au nom de l’image, par exemple, 2.1.2.

  3. Accédez au répertoire local qui contient vos scripts.

    Lorsque vous exécutez le conteneur Docker, les scripts locaux sont montés dans /scripts dans le conteneur.

  4. Exécutez le conteneur.

    Pour obtenir des instructions sur l’exécution du conteneur, consultez les exemples d’utilisation officiels à DOCKER-EXAMPLES.md.

Documentation connexe