Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Instale o Junos PyEZ

Você pode instalar o Junos PyEZ em um sistema de gerenciamento de rede, em um ambiente virtual Python ou como um contêiner Docker.

Junos PyEZ é uma biblioteca Python que permite que você gerencie e automatize dispositivos Junos. Você pode instalar o Junos PyEZ em um sistema operacional semelhante ao UNIX ou no Windows. Você tem a opção de instalar e executar o Junos PyEZ de uma das seguintes maneiras:

  • Diretamente no servidor de gerenciamento de configuração

  • Dentro de um ambiente virtual Python

  • Como um contêiner Docker

Como uma alternativa para instalar o Junos PyEZ diretamente no servidor, você pode instalá-lo em um ambiente virtual. Um ambiente virtual Python isola a instalação e os pacotes python de um projeto daqueles instalados no sistema ou em outros ambientes virtuais, o que evita quebrar as dependências de outros projetos. Você pode criar ambientes virtuais quando tiver projetos que exijam diferentes versões de pacotes Python ou Python ou como alternativa à instalação de pacotes globalmente no sistema.

A Juniper Networks também oferece uma imagem do Junos PyEZ Docker que permite que você execute o Junos PyEZ como um contêiner Docker. O contêiner Docker é um sistema leve e autônomo que agrupa o Junos PyEZ, suas dependências e Python em um único contêiner portátil. A imagem do Docker permite que você execute rapidamente o Junos PyEZ no modo interativo, como um pacote executável ou como um terminal em qualquer plataforma que ofereça suporte ao Docker.

Para instalar o Junos PyEZ no servidor de gerenciamento de configuração, veja as seguintes seções:

Para instalar o Junos PyEZ em um ambiente virtual Python, veja as seguintes seções:

Para usar a imagem do Junos PyEZ Docker, veja a seção a seguir:

Instalar software de pré-requisito

Antes de instalar a biblioteca Junos PyEZ no servidor de gerenciamento de configuração ou em um ambiente virtual, certifique-se de que o servidor de gerenciamento de configuração tenha o seguinte software instalado:

  • Python — Junos PyEZ oferece suporte a Python 3.8 até Python 3.12

  • Todos os softwares pré-requisitos para o determinado sistema operacional, que está descrito na Tabela 1

Nota:

O Python 3.x tem suporte a partir do Junos PyEZ Release 2.0.

O suporte ao Python 2.7 é removido a partir do Junos PyEZ Release 2.6.0.

O Python 3.10 tem suporte a partir do Junos PyEZ Release 2.7.0.

O Python 3.12 tem suporte a partir do Junos PyEZ Release 2.7.2.

Tabela 1: Software pré-requisito do Junos PyEZ

Sistema Operacional

Pacote ou biblioteca

Centos

  • Gcc

  • libffi-devel

  • libxml2-devel

  • libxslt-devel

  • opensl-devel

  • semente

  • desenvolvimento de python

  • redhat-rpm-config

Debian

  • libxml2-dev

  • libxslt1-dev

  • libssl-dev

  • semente

  • nível python3 (necessário para Python 3)

Fedora

  • Gcc

  • libffi-devel

  • libxml2-devel

  • libxslt-devel

  • opensl-devel

  • semente

  • nível python3 (necessário para Python 3)

  • redhat-rpm-config

FreeBSD

  • libxml2

  • libxslt

  • py27-pip

OSX

Nota:

Se o Junos PyEZ não instalar com sucesso o uso pip, tente usar easy_install para instalar a lxml biblioteca e, em seguida, Junos PyEZ.

  • semente

  • xcode

Ubuntu

  • libffi-dev

  • libssl-dev

  • libxml2-dev

  • libxslt1-dev

  • python3-dev (necessário para Python 3)

  • semente

Windows

  • ecdsa

  • semente

Instale o Junos PyEZ no servidor de gerenciamento de configuração

Depois de instalar o software pré-requisito no servidor de gerenciamento de configuração, você pode instalar a versão mais recente do Junos PyEZ do site Python Package Index (PyPI ). Você também pode baixar a versão mais recente do código do repositório Junos PyEZ GitHub. Para instalar o Junos PyEZ no GitHub, você deve ter Git instalado no servidor de gerenciamento de configuração.

  • Para instalar a versão atual do Junos PyEZ do PyPI, execute o seguinte comando (use sudo quando apropriado):

    Nota:

    Para atualizar uma versão existente do Junos PyEZ, inclua a ou --upgrade opção -U no comando.

  • Para instalar o Junos PyEZ na filial mestre do projeto GitHub, execute o seguinte comando (use sudo quando apropriado):

    Nota:

    O código mais recente do repositório de origem do GitHub está em desenvolvimento ativo e pode não ser estável.

Para obter informações adicionais sobre a instalação do Junos PyEZ, incluindo opções adicionais de instalação, consulte o arquivo INSTALL para seu sistema operacional específico no repositório Junos PyEZ GitHub.

Instale o Junos PyEZ em um ambiente virtual python

Como uma alternativa à instalação de pacotes Python globalmente em um sistema, você pode instalar os pacotes e dependências necessários para um projeto específico em um ambiente virtual Python isolado. Recomendamos que você use o Python 3 para o seu ambiente virtual.

Para criar uma instalação virtual do Python 3 com o Junos PyEZ em um servidor Linux ou macOS:

  1. Instale o software pré-requisito no servidor de gerenciamento de configuração, conforme descrito no Software de pré-requisito de instalação.
  2. Mude para o seu diretório de projeto existente ou crie um novo, se nenhum deles existir.
  3. Crie uma instalação de Python virtual e especifique seu nome, que neste caso é venv.
    Nota:

    Os sistemas Ubuntu e Debian podem exigir que você instale o python3-venv pacote antes de criar o ambiente virtual.

  4. Ative o ambiente virtual executando o script no diretório do bin ambiente virtual que é apropriado para sua plataforma e shell.
  5. Instale o Junos PyEZ.
    • Para instalar a versão atual do Junos PyEZ do PyPI, execute o seguinte comando:

    • Para instalar o Junos PyEZ na filial mestre do projeto GitHub, execute o seguinte comando, que exige que Git seja instalado:

      Nota:

      O código mais recente do repositório de origem do GitHub está em desenvolvimento ativo e pode não ser estável.

  6. Execute seus comandos ou scripts Junos PyEZ dentro do ambiente virtual.
  7. Quando você terminar de trabalhar no ambiente virtual, desative-o para retornar ao prompt principal de shell.

Use a imagem do Junos PyEZ Docker

Docker é uma plataforma de contêineres de software que é usada para empacotar e executar um aplicativo e suas dependências em um contêiner isolado. A Juniper Networks oferece um junos PyEZ Dockerfile , bem como imagens Junos PyEZ Docker, que são automaticamente construídas para cada versão Junos PyEZ. A partir do Junos PyEZ Release 2.1.8, as imagens do Docker incluem Python 3.6.

Você pode personalizar e usar o Dockerfile para construir sua própria imagem Junos PyEZ Docker, ou pode usar uma das imagens Docker pré-construídas, que são armazenadas no Docker Hub, para executar o Junos PyEZ como um contêiner Docker. Você pode executar o contêiner no modo interativo, como um pacote executável ou como um terminal.

Para usar uma imagem pré-construída do Junos PyEZ Docker em seu servidor de gerenciamento de configuração:

  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 da Juniper/pyez Docker do Docker Hub.
    • Para baixar a imagem mais recente, emita o seguinte comando:

      Nota:

      A imagem mais recente do Junos PyEZ Docker foi construída usando o código mais recentemente comprometido no repositório de fonte Junos PyEZ, que está em desenvolvimento ativo e pode não ser estável.

    • Para baixar uma imagem específica, a aplicação da tag de versão apropriada ao nome da imagem, por exemplo, 2.1.2.

  3. Mude para o diretório local que contém seus scripts.

    Quando você executa o contêiner Docker, os scripts locais são montados em /scripts no contêiner.

  4. Execute o contêiner.

    Para obter instruções sobre como executar o contêiner, veja os exemplos oficiais de uso em DOCKER-EXAMPLES.md.