Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Junos PyEZをインストールする

概要 Junos PyEZは、ネットワーク管理システム、Python仮想環境、またはDockerコンテナとしてインストールできます。

Junos PyEZ は、Junos デバイスの管理と自動化を可能にする Python ライブラリです。Junos PyEZは、UNIX系オペレーティングシステムまたはWindowsにインストールできます。次のいずれかの方法でJunos PyEZをインストールして実行するオプションがあります。

  • 構成管理サーバー上で直接

  • Python仮想環境内

  • Dockerコンテナとして

Junos PyEZをサーバーに直接インストールする代わりに、仮想環境にインストールすることもできます。Python 仮想環境は、プロジェクトの Python インストールとパッケージをシステムまたは他の仮想環境にインストールされているものから分離し、他のプロジェクトの依存関係を壊すのを防ぎます。仮想環境は、異なるバージョンの Python または Python パッケージを必要とするプロジェクトがある場合、またはシステムにパッケージをグローバルにインストールする代わりに作成できます。

ジュニパーネットワークスは、Junos PyEZをDockerコンテナとして実行できるJunos PyEZ Dockerイメージも提供しています。Dockerコンテナは、Junos PyEZとその依存関係、Pythonを1つのポータブルコンテナにバンドルした軽量の自己完結型システムです。Dockerイメージを使用すると、Junos PyEZをインタラクティブモードで、実行可能パッケージとして、またはDockerをサポートする任意のプラットフォームのターミナルとしてすばやく実行できます。

構成管理サーバーにJunos PyEZをインストールするには、次のセクションを参照してください。

Python 仮想環境に Junos PyEZ をインストールするには、以下のセクションを参照してください。

Junos PyEZ Dockerイメージを使用するには、次のセクションを参照してください。

前提条件となるソフトウェアのインストール

Junos PyEZ ライブラリを構成管理サーバーまたは仮想環境にインストールする前に、構成管理サーバーに次のソフトウェアがインストールされていることを確認してください。

  • Python 3.8 以降

  • 表 1 に概説されている、特定のオペレーティング システム用のすべての前提ソフトウェア

メモ:

Python 3.xは、Junos PyEZリリース2.0からサポートされています。

Python 2.7 のサポートは、Junos PyEZ リリース 2.6.0 から削除されます。

Python 3.10 は Junos PyEZ リリース 2.7.0 以降でサポートされています。

表1:Junos PyEZ前提条件ソフトウェア

オペレーティング システム

パッケージまたはライブラリ

Centos

  • Gcc

  • libffi-devel

  • libxml2-devel

  • libxslt-devel

  • openssl-devel

  • ピップ

  • python-devel

  • redhat-rpm-config

Debian

  • libxml2-dev

  • libxslt1-dev

  • libssl-dev

  • ピップ

  • python3-devel (Python 3 では必須)

Fedora

  • Gcc

  • libffi-devel

  • libxml2-devel

  • libxslt-devel

  • openssl-devel

  • ピップ

  • python3-devel (Python 3 では必須)

  • redhat-rpm-config

Freebsd

  • libxml2

  • libxslt

  • py27-pip

Osx

メモ:

Junos PyEZが正常にインストール pipされない場合は、 を使用して easy_install ライブラリをインストールしてからJunos PyEZをインストール lxml してみてください。

  • ピップ

  • Xcode

Ubuntu

  • libffi-dev

  • libssl-dev

  • libxml2-dev

  • libxslt1-dev

  • python3-dev (Python 3 では必須)

  • ピップ

Windows

  • Ecdsa

  • ピップ

構成管理サーバーにJunos PyEZをインストールします

構成管理サーバーに前提条件のソフトウェアをインストールした後、Python パッケージ インデックス (PyPI) サイトから Junos PyEZ の最新リリースをインストールできます。また、Junos PyEZ GitHub リポジトリから最新バージョンのコードをダウンロードすることもできます。GitHub から Junos PyEZ をインストールするには、構成管理サーバーに Git がインストールされている必要があります。

  • PyPIから現在のリリースのJunos PyEZをインストールするには、次のコマンドを実行します(必要に応じて使用 sudo )。

    メモ:

    Junos PyEZの既存のバージョンをアップグレードするには、コマンドに または --upgrade オプションを含め-Uます。

  • GitHub プロジェクト マスター ブランチから Junos PyEZ をインストールするには、次のコマンドを実行します (必要に応じて使用 sudo )。

    メモ:

    GitHub ソース リポジトリ内の最新のコードは活発に開発中であり、安定していない可能性があります。

追加のインストールオプションを含む、Junos PyEZのインストールに関する詳細については、Junos PyEZ GitHubリポジトリにある特定のオペレーティングシステムのインストールファイルを参照してください

Python仮想環境へのJunos PyEZのインストール

Python パッケージをシステムにグローバルにインストールする代わりに、分離された Python 仮想環境に特定のプロジェクトに必要なパッケージと依存関係をインストールできます。仮想環境には Python 3 を使用することをお勧めします。

Linux または macOS サーバー上の Junos PyEZ を使用して仮想 Python 3 インストールを作成するには、以下を行います。

  1. 前提条件のソフトウェアのインストール」で説明されているように、構成管理サーバーに前提条件ソフトウェアをインストールします。
  2. 既存のプロジェクトディレクトリに移動するか、存在しない場合は新しいプロジェクトディレクトリを作成します。
  3. 仮想 Python インストールを作成し、その名前 (この場合は venv) を指定します。
    メモ:

    Ubuntu および Debian システムでは、仮想環境を作成する前にパッケージ python3-venv のインストールが必要になる場合があります。

  4. プラットフォームとシェルに適した仮想環境の bin ディレクトリでスクリプトを実行して、仮想環境をアクティブ化します。
  5. Junos PyEZをインストールします。
    • PyPIから現在のリリースのJunos PyEZをインストールするには、次のコマンドを実行します。

    • GitHub プロジェクト マスター ブランチから Junos PyEZ をインストールするには、次のコマンドを実行します。これには Git がインストールされている必要があります。

      メモ:

      GitHub ソース リポジトリ内の最新のコードは活発に開発中であり、安定していない可能性があります。

  6. 仮想環境内でJunos PyEZコマンドまたはスクリプトを実行します。
  7. 仮想環境での作業が終了したら、非アクティブ化してメインシェルプロンプトに戻ります。

Junos PyEZ Dockerイメージを使用する

Docker は、アプリケーションとその依存関係を分離されたコンテナーにパッケージ化して実行するために使用されるソフトウェア コンテナー プラットフォームです。ジュニパーネットワークスは、Junos PyEZ DockerファイルとJunos PyEZ Dockerイメージを提供しており、Junos PyEZリリースごとに自動的にビルドされます。Junos PyEZ リリース 2.1.8 以降、Docker イメージには Python 3.6 が含まれます。

Dockerファイルをカスタマイズして使用し、独自のJunos PyEZ Dockerイメージを構築するか、 Docker Hubに保存されている構築済みのDockerイメージの1つを使用して、Junos PyEZをDockerコンテナとして実行することができます。コンテナーは、対話モード、実行可能パッケージ、またはターミナルとして実行できます。

構成管理サーバーで構築済みの Junos PyEZ Docker イメージを使用するには、次のようにします。

  1. ドッカーをインストールします。

    特定のオペレーティング システムに Docker をインストールして構成する手順については 、https://www.docker.com の Docker Web サイトを参照してください。

  2. Docker Hubからjuniper/pyez Dockerイメージをダウンロードします。
    • 最新のイメージをダウンロードするには、次のコマンドを発行します。

      メモ:

      最新のJunos PyEZ Dockerイメージは、Junos PyEZソースリポジトリで最近コミットされたコードを使用してビルドされています。このリポジトリは現在開発中であり、安定していない可能性があります。

    • 特定のイメージをダウンロードするには、イメージ名に適切なリリース タグ (2.1.2 など) を追加します。

  3. スクリプトを含むローカル ディレクトリに移動します。

    Docker コンテナーを実行すると、ローカル スクリプトがコンテナー内の /scripts にマウントされます。

  4. コンテナーを実行します。

    コンテナーの実行手順については、 DOCKER-EXAMPLES.md の公式使用例を参照してください。