Requisitos do servidor Ansible for Junos OS
Saiba mais sobre os requisitos para configurar um nó de controle do Ansible para gerenciar dispositivos que executam o Junos OS e dispositivos que executam o Junos OS Evolved.
A Juniper Networks oferece suporte ao uso do Ansible para gerenciar dispositivos que executam o Junos OS e dispositivos que executam o Junos OS Evolved. Fornecemos módulos do Ansible que você pode usar para executar tarefas operacionais e de configuração em seus dispositivos gerenciados. Os módulos da Juniper Networks são distribuídos por meio da seguinte coleção, que está hospedada no site do Ansible Galaxy :
-
juniper.deviceColeção
A partir da juniper.device versão 2.0.0, consolidamos a coleção da Juniper Networks juniper.device e a coleção do Red Hat Ansible junipernetworks.junos em uma única juniper.device coleção. Ao instalar a juniper.device coleção, você pode usá-la juniper.device.module_name para executar módulos de qualquer conjunto de módulos. Se você quiser continuar a usar os manuais existentes que fazem referência junipernetworks.junos.module_nameao , também deverá instalar a junipernetworks.junos coleção. Para executar os módulos usando qualquer um dos junipernetworks.junos namespaces, você deve definir ansible_network_os=juniper.device.junos. Caso contrário, todo o resto permanece o mesmo ao usar o conjunto mesclado de módulos.
Você instala o Ansible em um nó de controle com um sistema operacional semelhante ao Unix. Você pode instalar o Ansible e a coleção da Juniper Networks:
-
Diretamente no servidor de gerenciamento de configuração
-
Em um ambiente virtual Python
-
Como um contêiner do Docker
Para instalar o Ansible e a juniper.device coleção no Python instalado pelo sistema ou no ambiente virtual Python no nó de controle, consulte as seguintes seções:
A imagem do Docker juniper/pyez-ansible da Juniper Networks é um sistema leve e independente que agrupa o Ansible, os módulos da Juniper Networks e todas as dependências em um único contêiner portátil. O contêiner do Docker permite que você execute rapidamente o Ansible no modo interativo ou como um pacote executável em qualquer plataforma que ofereça suporte ao Docker. Para usar a imagem do Docker do Ansible for Junos OS, consulte a seção a seguir:
Software de pré-requisito
Antes de instalar a coleção da Juniper Networks juniper.device e começar a usar o Ansible para gerenciar dispositivos Junos, você deve instalar o software de pré-requisito a seguir no ambiente selecionado no nó de controle do Ansible. Você pode instalar o software no Python instalado pelo sistema ou em um ambiente virtual Python. Recomendamos o uso de um ambiente virtual Python.
-
Python 3.12 ou posterior
-
Ansible 10.x ou posterior (ansible-core versão 2.17 ou posterior)
-
Junos PyEZ (
junos-eznc) versão 2.7.3 ou posterior.Para obter instruções de instalação do Junos PyEZ, consulte:
-
Os seguintes pacotes e bibliotecas do Python:
-
Administrador de instantâneos do Junos em Python (JSNAPy) versão 1.3.7 ou posterior (necessário para usar o
juniper.device.jsnapymódulo).Para obter instruções de instalação e informações atualizadas sobre o JSNAPy, consulte:
Instalar a coleção juniper.device
No nó de controle do Ansible, você pode instalar a coleção e a juniper.device junipernetworks.junos coleção do Ansible Galaxy. Instale as coleções no mesmo ambiente em que você instalou o Ansible e os outros softwares de pré-requisito.
A partir da juniper.device versão 2.0.0, a juniper.device coleção inclui os juniper.device módulos e os junipernetworks.junos módulos. Você pode instalar apenas a juniper.device coleção e usar juniper.device.module-name para executar qualquer módulo em qualquer conjunto de módulos. Se você usou os junipernetworks.junos módulos anteriormente e deseja continuar usando os guias estratégicos existentes que fazem referência junipernetworks.junos.module-nameao , também deverá instalar a junipernetworks.junos coleção.
Recomendamos que os usuários da coleção existente junipernetworks.junos instalem ambas as coleções em seu ambiente do Ansible for Junos OS.
Para instalar a juniper.device coleção e a junipernetworks.junos coleção:
Use a imagem do Docker do Ansible for Junos OS
O Docker é uma plataforma de contêiner de software usada para empacotar e executar um aplicativo e suas dependências em um contêiner isolado. A Juniper Networks fornece imagens do Docker com os módulos Ansible da Juniper Networks. A imagem do Docker inclui Python 3 e Ansible. Ele também inclui as versões mais recentes da juniper.device coleção, Junos, PyEZ e JSNAPy, juntamente com todas as dependências necessárias. Você pode executar o contêiner no modo interativo ou usá-lo como um executável para executar seus playbooks.
Para usar a imagem do Docker do Ansible for Junos OS no nó de controle do Ansible:
Tabela de histórico de alterações
A compatibilidade com recursos é determinada pela plataforma e versão utilizada. Use o Explorador de recursos para determinar se um recurso é compatível com sua plataforma.
juniper.device versão 2.0.0, mesclamos os módulos do Red Hat Ansible junipernetworks.junos na juniper.device coleção.