サービスの改善にご協力お願いします。

お客様のご意見をお聞かせください。

アンケートの所要時間はおよそ 2 分です。

close
keyboard_arrow_left
list Table of Contents

この機械翻訳はお役に立ちましたでしょうか?

starstarstarstarstar
Go to English page
免責事項:

このページは、サードパーティー製機械翻訳ソフトウェアを使用して翻訳されます。質の高い翻訳を提供するために合理的な対応はされていますが、ジュニパーネットワークスがその正確性を保証することはできかねます。この翻訳に含まれる情報の正確性について疑問が生じた場合は、英語版を参照してください. ダウンロード可能なPDF (英語版のみ).

テストエージェントアプリケーションのインストール

date_range 18-Jun-24

インストールのトピックでは、公式コンテナイメージを使用してテストエージェントを登録する手順、テストエージェントイメージをビルドする手順、およびx86マシンにネイティブテストエージェントアプリケーションをデプロイする手順について説明します。

テストエージェントアプリケーションは、x86プラットフォームにネイティブに導入するコンテナ、Dockerコンテナとして、あるいはJunos Evolved OSを実行するルーターのコンテナとして導入するコンテナです。このインストール手順では、テストエージェントをコンテナとしてデプロイする手順について説明します。

始める前に

テスト エージェントのインストールを開始する前に、次のことを行う必要があります。

  • 最新のUbuntuバージョンを実行しているシステムに DockerEngine をインストールしてください。

  • ファイアウォールがTCPポート6800上のParagon Automationへの接続をブロックしていないことを確認します。

警告:

Junos CLIを使用したテストエージェントのインストールはお勧めしません。

コンテナー イメージを使用したテスト エージェントのデプロイ

コンテナイメージを使用してテストエージェントをデプロイするには、以下を行います。
  1. テストエージェントの最新イメージをダウンロードします。テストエージェントソフトウェア(テストエージェントアプリケーション(amd64))は、ソフトウェアダウンロードページまたはDocker Hub(netrounds/test-agent-application)からダウンロードできます。
  2. registerコマンドを使用してテストエージェントを登録します。これにより、テストエージェントがParagon Automationに接続されます。register コマンドを実行するときは、次のいずれかを指定します。
    • Paragon Automationのインストール時に使用するメールアドレスとパスワードを指定します。

    • 組織の UUID を指定します。組織の UUID を見つけるには、Paragon Automation の [管理] > [設定 ] に移動し、組織の UUID を コピー します。

    • Active Assurance Test Agent ゲートウェイ IP アドレスのホスト名を指定します。

    content_copy zoom_out_map
    user@hostname:~# docker run --rm \
    
                               -v $(pwd):/config \
                               -v /var/run/netns:/var/run/netns \
                               <Test Agent docker image> \
    
                     register --config /config/agent.conf -A\
                              --host <Host name>  \
                              --org <Organization UUID> \
                              --email <Control Center user email> \
                              --password <Control Center user password> \
                              --name <Test Agent name>
  3. runコマンドを使用して、テストエージェントを起動します。
    content_copy zoom_out_map
    user@host:~# docker run --network=host --cap-add=NET_ADMIN --device=/dev/net/tun -d \
                            --privileged -v $(pwd):/config -v /var/run/netns:/var/run/netns \
                            --log-opt max-size=10m --log-opt max-file=2 <Test Agent docker image> \
                            --config /config/agent.conf -A [-T]

テストエージェントコンテナイメージの構築

この手順を使用して、独自のコンテナー イメージを構築します。カスタム・テスト・エージェント・コンテナ・イメージをビルドするには、次のようにします。
  1. テストエージェントの最新イメージをダウンロードします。テストエージェントソフトウェア(Test Agent Application (amd64))は、ソフトウェアダウンロードページからダウンロードできます。
  2. 次のコマンドを使用して、テストエージェントソフトウェアのtarファイルを解凍します。
    content_copy zoom_out_map
    user@host:~# tar -xvzf paa-test-agent-application_<version_architecture>.tar.gz
                 #Remove the version from the directory name
    user@host:~$ mv paa-test-agent-application_<version> paa-test-agent-application/
  3. テストエージェントソフトウェアを解凍したディレクトリにDockerファイルを作成します。次の docker ファイルは、テスト エージェント ソフトウェアを opt/paa-test-agent-application の場所にコピーし、テスト エージェント ソフトウェアを実行するためのエントリ ポイントを構成します。
    content_copy zoom_out_map
    FROM debian:buster-slim
    
    RUN apt-get update && \
    apt-get install -y ca-certificates iproute2 socat && \
    rm -rf /var/lib/apt/lists/*
    
    COPY paa-test-agent-application/ /opt/paa-test-agent-application/
    ENTRYPOINT ["/opt/paa-test-agent-application/paa-test-agent-application"]
  4. docker build コマンドを使用して Docker イメージをビルドします。次のコマンドのmycustom任意の名前に置き換えます。ここで指定する名前は、今後使用する必要があるドッカーの名前です。
    user@host:~$ docker build -t mycustom/paa-test-agent-application
  5. 次のコマンドを使用して、作成したコンテナーを登録します。
    content_copy zoom_out_map
    user@hostname:~# docker run --rm \
    
                               -v $(pwd):/config \
                               -v /var/run/netns:/var/run/netns \
                               <Test Agent docker image> \
    
                     register --config /config/agent.conf -A\
                              --host <Host name>  \
                              --org <Organization UUID> \
                              --email <Control Center user email> \
                              --password <Control Center user password> \
                              --name <Test Agent name>
  6. テストエージェントを起動します。
    content_copy zoom_out_map
    user@host:~# docker run --network=host --cap-add=NET_ADMIN --device=/dev/net/tun -d \
                            --privileged -v $(pwd):/config -v /var/run/netns:/var/run/netns \
                            --log-opt max-size=10m --log-opt max-file=2 <Test Agent docker image> \
                            --config /config/agent.conf -A [-T]
    先端:

    引数 --privileged -v/var/run/netns:/var/run/netns を使用すると、テストエージェントはネットワーク名前空間を使用してトラフィックを個別にルーティングできます。

    Aオプションを使用すると、テストエージェントは使用可能なすべての名前空間とそのインターフェイスを検出できます。

    log-opt オプションは、テストエージェントによって生成されるログファイルのサイズと数を制限するために使用されます。

    docker logs <container ID> コマンドを使用すると、コンテナー ログ ファイルを検査できます。

Linuxにネイティブアプリケーションとしてのテストエージェントをインストールする

テスト エージェント アプリケーションは、x86 マシンにネイティブにインストールできます。

  1. テストエージェントの最新イメージをダウンロードします。テストエージェントソフトウェア(Test Agent Application (amd64))は、ソフトウェアダウンロードページからダウンロードできます。
  2. tar ファイルを解凍し、次のコマンドを使用してアプリケーションをインストールします。
    content_copy zoom_out_map
    user@hostname:~$ tar -xvzf paa-test-agent-application_<version_architecture>.tar.gz
    
    # Move the contents of the directory to a more permanent location
    
    user@hostname:~$ sudo mv paa-test-agent-application_<version> /opt/paa-test-agent-application
    
    # Set root as the user and group of the new directory
    
    user@hostname:~$ sudo chown -R root:root /opt/paa-test-agent-application
  3. 次のいずれかの方法でテスト エージェントを登録します。
    1. 電子メールとパスワードを使用してテストエージェントを登録します。
      content_copy zoom_out_map
      user@hostname:~$ sudo /opt/paa-test-agent-application/paa-test-agent-application register \
          --config /etc/paa-test-agent-application.conf \
          --host <Host name>  \
          --org <Organization UUID> \
          --email <Control Center user email> \
          --password <Control Center user password> \
          --name <Test Agent name>
    2. API トークンを使用してテスト エージェントを登録します。
      content_copy zoom_out_map
      user@hostname:~$ sudo /opt/paa-test-agent-application/paa-test-agent-application register \
          --config /etc/paa-test-agent-application.conf \
          --host <Host name>  \
          --org <Organization UUID> \
          --api-token <API token for user in Control Center> \
          --name <Test Agent name>
  4. テストエージェントアプリケーションを起動します。
    content_copy zoom_out_map
    user@hostname:~$ /opt/paa-test-agent-application/paa-test-agent-application run\
                     --config /etc/paa-test-agent-application.conf -A
    先端:

    A オプションを使用すると、テスト エージェントは使用可能なすべての名前空間とそのインターフェイスを検出できます。

external-footer-nav