Ansible pour la configuration requise du serveur Junos OS
Découvrez la configuration requise pour configurer un nœud de contrôle Ansible afin de gérer les équipements exécutant Junos OS et les équipements exécutant Junos OS Evolved.
Juniper Networks prend en charge l’utilisation d’Ansible pour gérer les équipements exécutant Junos OS et les équipements exécutant Junos OS Evolved. Nous fournissons des modules Ansible que vous pouvez utiliser pour effectuer des tâches opérationnelles et de configuration sur vos appareils gérés. Les modules Juniper Networks sont distribués via la collection suivante, qui est hébergée sur le site Web d’Ansible Galaxy :
-
juniper.devicecollection
juniper.device À partir de la version 2.0.0, nous avons consolidé la collection Juniper Networks juniper.device et la collection Red Hat Ansible junipernetworks.junos en une seule juniper.device collection. Lorsque vous installez la juniper.device collection, vous pouvez l’utiliser juniper.device.module_name pour exécuter des modules à partir de l’un ou l’autre ensemble de modules. Si vous souhaitez continuer à utiliser les playbooks existants qui font référence junipernetworks.junos.module_nameà , vous devez également installer la junipernetworks.junos collection. Pour exécuter les modules en utilisant l’un junipernetworks.junos ou l’autre des espaces de noms, vous devez définir ansible_network_os=juniper.device.junos. Sinon, tout le reste reste reste le même lors de l’utilisation de l’ensemble fusionné de modules.
Vous installez Ansible sur un nœud de contrôle avec un système d’exploitation de type Unix. Vous pouvez installer Ansible et la collection Juniper Networks :
-
Directement sur le serveur de gestion de la configuration
-
Dans un environnement virtuel Python
-
En tant que conteneur Docker
Pour installer Ansible et la collection sous l’environnement Python installé par le système ou dans l’environnement juniper.device virtuel Python sur le nœud de contrôle, consultez les sections suivantes :
L’image Docker Juniper/pyez-Ansible de Juniper Networks est un système léger et autonome qui regroupe Ansible, les modules de Juniper Networks et toutes les dépendances dans un seul conteneur portable. Le conteneur Docker vous permet d’exécuter rapidement Ansible en mode interactif ou en tant que package exécutable sur n’importe quelle plateforme prenant en charge Docker. Pour utiliser l’image Docker d’Ansible pour Junos OS, reportez-vous à la section suivante :
Logiciels prérequis
Avant d’installer la collection Juniper Networks juniper.device et de commencer à utiliser Ansible pour gérer les appareils Junos, vous devez installer le logiciel prérequis suivant dans l’environnement sélectionné sur le nœud de contrôle Ansible. Vous pouvez installer le logiciel sous le Python installé par le système ou dans un environnement virtuel Python. Nous vous recommandons d’utiliser un environnement virtuel Python.
-
Python 3.12 ou version ultérieure
-
Ansible 10.x ou version ultérieure (ansible-core version 2.17 ou ultérieure)
-
Junos PyEZ (
junos-eznc) version 2.7.3 ou ultérieure.Pour obtenir des instructions d’installation de Junos PyEZ, reportez-vous à :
-
Les packages et bibliothèques Python suivants :
-
Junos Snapshot Administrator in Python (JSNAPy) version 1.3.7 ou ultérieure (requis pour utiliser le
juniper.device.jsnapymodule).Pour obtenir des instructions d’installation et des informations à jour sur JSNAPy, reportez-vous à :
Installez la collection juniper.device
Sur le nœud de contrôle Ansible, vous pouvez installer la juniper.device collection et la junipernetworks.junos collection à partir d’Ansible Galaxy. Installez les collections dans le même environnement que celui dans lequel vous avez installé Ansible et les autres logiciels prérequis.
À partir de juniper.device la version 2.0.0, la juniper.device collection comprend les juniper.device modules et les junipernetworks.junos modules. Vous pouvez installer uniquement la collection et l’utiliser juniper.device.module-name pour exécuter n’importe juniper.device quel module de l’un ou l’autre ensemble de modules. Si vous avez déjà utilisé les junipernetworks.junos modules et que vous souhaitez continuer à utiliser les playbooks existants qui font référence junipernetworks.junos.module-nameà , vous devez également installer la junipernetworks.junos collection.
Nous recommandons aux utilisateurs existants junipernetworks.junos des collections d’installer les deux collections dans votre environnement Ansible pour Junos OS.
Pour installer la juniper.device collection et la junipernetworks.junos collection :
Utiliser l’image Docker d’Ansible pour Junos OS
Docker est une plateforme logicielle de conteneurs utilisée pour empaqueter et exécuter une application et ses dépendances dans un conteneur isolé. Juniper Networks fournit des images Docker avec les modules Ansible de Juniper Networks. L’image Docker inclut Python 3 et Ansible. Elle inclut également les dernières versions de la juniper.device collection, Junos PyEZ et JSNAPy, ainsi que toutes les dépendances requises. Vous pouvez exécuter le conteneur en mode interactif ou l’utiliser comme exécutable pour exécuter vos playbooks.
Pour utiliser l’image Docker d’Ansible pour Junos OS sur votre nœud de contrôle Ansible :
Tableau de l’historique des modifications
La prise en charge des fonctionnalités est déterminée par la plateforme et la version que vous utilisez. Utilisez l’explorateur de fonctionnalités pour déterminer si une fonctionnalité est prise en charge sur votre plateforme.
juniper.device À partir de la version 2.0.0, nous avons fusionné les modules Red Hat Ansible junipernetworks.junos dans la juniper.device collection.