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 :

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.

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.

Observaçã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:

  1. Emita o ansible-galaxy collection install comando e especifique a juniper.device coleção.
  2. Emita o ansible-galaxy collection install comando e especifique 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:

  1. Instale o Docker.

    Consulte o site do Docker em https://www.docker.com para obter instruções sobre como instalar e configurar o Docker em seu sistema operacional específico.

  2. Baixe a imagem do Docker juniper/pyez-ansible do Docker Hub.
    • Para baixar a imagem mais recente, emita o seguinte comando:

      Observação:

      A imagem mais recente do Docker do Ansible para Junos OS é criada usando o código confirmado mais recentemente no repositório de origem do GitHub da Juniper/ansible-junos-stdlib , que está em desenvolvimento ativo e pode não ser estável.

    • Para baixar uma imagem específica, anexe a tag de versão apropriada ao nome da imagem, por exemplo, v1.0.7-collections.

  3. Execute o contêiner.

    Para obter instruções sobre como executar o contêiner, consulte os exemplos de uso oficiais em https://github.com/Juniper/ansible-junos-stdlib/blob/master/README.md#docker.

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.

Lançamento
Descrição
2.0.0
A partir da juniper.device versão 2.0.0, mesclamos os módulos do Red Hat Ansible junipernetworks.junos na juniper.device coleção.