合成ジョブ マネージャーをインストールする

バージョン、依存関係、各シンセティック ジョブ マネージャーで起動するランタイム ポッドの数のデフォルト値などを表示するには、以下のヘルプと例を表示するを参照してください。

1. プライベートロケーションキーを見つけます。

2. サンドボックス用のDocker 依存関係が有効になっており、システムに合成ジョブ マネージャーがインストールされていることを確認してください。

3. システムに適したスクリプトを実行します。システムに合わせて、次の例の共通のデフォルト/var/run/docker.sockを調整します。

   • Linux / macOS：

     bash

     コピー

     $
     docker run \
     >
         --name YOUR_CONTAINER_NAME \
     >
         -e "PRIVATE_LOCATION_KEY=YOUR_PRIVATE_LOCATION_KEY" \
     >
         -v /var/run/docker.sock:/var/run/docker.sock:rw \
     >
         -d \
     >
         --restart unless-stopped \
     >
         newrelic/synthetics-job-manager:latest

   • ウィンドウズ：

     bash

     コピー

     $
     docker run ^
     $
         --name YOUR_CONTAINER_NAME ^
     $
         -e "PRIVATE_LOCATION_KEY=YOUR_PRIVATE_LOCATION_KEY" ^
     $
         -v /var/run/docker.sock:/var/run/docker.sock:rw ^
     $
         -d ^
     $
         --restart unless-stopped ^
     $
         newrelic/synthetics-job-manager:latest

   ミニオンコンテナのログを表示します。

   bash

   コピー

   $
   docker logs --follow YOUR_CONTAINER_NAME

1. プライベートロケーションキーを見つけます。

2. Kubernetes クラスターで合成ジョブ マネージャーの名前空間を設定します。

   bash

   コピー

   $
   kubectl create namespace YOUR_NAMESPACE

3. NewRelicHelmリポジトリからHelmチャートをコピーします。

   • チャートを初めてコピーする場合：

     bash

     コピー

     $
     helm repo add YOUR_REPO_NAME https://helm-charts.newrelic.com

   • 以前にNewRelicHelmリポジトリからHelmチャートをコピーした場合は、最新のものを入手してください。

     bash

     コピー

     $
     helm repo update

4. 次の Helm コマンドを使用して、synthetics ジョブ マネージャーをインストールします。

   • Synthetics ジョブ マネージャーの新規インストールの場合:

     helm install YOUR_JOB_MANAGER_NAME YOUR_REPO_NAME/synthetics-job-manager -n YOUR_NAMESPACE --set synthetics.privateLocationKey=YOUR_PRIVATE_LOCATION_KEY

     コピー

   • 既存の Synthetics ジョブ マネージャーのインストールを更新するには:

     bash

     コピー

     $
     helm upgrade YOUR_JOB_MANAGER_NAME YOUR_REPO_NAME/synthetics-job-manager -n YOUR_NAMESPACE --set synthetics.privateLocationKey=YOUR_PRIVATE_LOCATION_KEY

5. Synthetics ジョブ マネージャー ポッドが稼働しているかどうかを確認します。

   bash

   コピー

   $
   kubectl get -n YOUR_NAMESPACE pods

   各ポッドのstatus属性がrunningとして表示されると、Synthetics ジョブ マネージャーが起動し、プライベート ロケーションに割り当てられたモニターを実行する準備が整います。

Dockerコンテナーは、コンテナー名またはコンテナーIDのいずれかで停止できます。

• Linux、macOS、およびWindowsのコンテナー名の停止：

  bash

  コピー

  $
  docker stop YOUR_CONTAINER_NAME
  $
  docker rm YOUR_CONTAINER_NAME

• Linux / macOSのコンテナID停止：

  例では、コンテナは停止され、削除されます。コンテナのみを停止するには、 docker rm $CONTAINER_IDを省略します。

  bash

  コピー

  $
  CONTAINER_ID=$(docker ps -aqf name=YOUR_CONTAINER_NAME)
  $
  docker stop $CONTAINER_ID
  $
  docker rm $CONTAINER_ID

• WindowsのコンテナID停止：

  例では、コンテナは停止され、削除されます。コンテナのみを停止するには、 docker rm $CONTAINER_IDを省略します。

  bash

  コピー

  $
  FOR /F "tokens=*" %%CID IN ('docker ps -aqf name=YOUR_CONTAINER_NAME') do (SET CONTAINER_ID=%%CID)
  $
  docker stop %CONTAINER_ID%
  $
  docker rm %CONTAINER_ID%

1. 削除する外形監視ジョブ マネージャー ポッドのJOB_MANAGER_POD_INSTALLATION_NAMEを取得します。

   bash

   コピー

   $
   helm list -n YOUR_NAMESPACE

2. ミニオンポッドを削除します。

   bash

   コピー

   $
   helm uninstall -n YOUR_NAMESPACE JOB_MANAGER_POD_INSTALLATION_NAME

3. Kubernetes クラスターで合成ジョブ マネージャー用に設定された名前空間を削除します。

   bash

   コピー

   $
   kubectl delete namespace YOUR_NAMESPACE

Synthetics ジョブ マネージャーは Docker で実行され、Docker をサンドボックス テクノロジとして活用できます。これにより、モニターの実行が完全に分離され、セキュリティ、信頼性、再現性が向上します。スクリプト化されたモニターまたはブラウザー モニターが実行されるたびに、synthetics ジョブ マネージャーはまったく新しい Docker コンテナーを作成し、一致するランタイムを使用してそれを実行します。

追加のランタイム コンテナーを生成するには、Docker エンジンと通信するように合成ジョブ マネージャー コンテナーを構成する必要があります。生成された各コンテナーは、synthetics ジョブ マネージャー コンテナーが関連付けられているプライベートな場所で実行されている、 synthetic モニターに関連付けられたチェックを実行するために専用に使用されます。

起動時に重要な依存関係があります。サンドボックスを有効にするには、次のことを確認してください。

• 書き込み可能な Docker UNIX ソケットが/var/run/docker.sockまたはDOCKER_HOST 環境変数にマウントされています。詳細については、Docker のDaemon ソケット オプションを参照してください。

  注意

  ホスト上のコア数によって、外形監視ジョブ マネージャーがホスト上で同時に実行できるランタイム コンテナの数が決まります。 メモリ要件はランタイム コンテナーの予想される数に合わせて調整されるため、リソースの競合を回避するためにnot running multiple synthetics job managers on the same hostを推奨します。

  サンドボックス化とrootまたは非rootユーザーとしての実行の詳細については、セキュリティ、サンドボックス化、および非rootユーザーとしての実行を参照してください。

詳細については、セキュリティおよびAppArmorセキュリティプロファイルに関するDockerの公式ドキュメントを参照してください。

ご使用の環境で、synthetics ジョブ マネージャーを非ルート ユーザーとして実行する必要がある場合は、次の手順に従います。次の例では、root 以外のユーザーはmy_userです。

1. my_userがホストでDockerエンジンを使用できることを確認します。

   my_userが"docker"システム グループに属していることを確認します。ブリッジ ネットワークを作成するには、 docker.sockへの限定されたルート アクセスが引き続き必要です。

   また

   Docker TCP ソケット オプションを有効にし、 DOCKER_HOST環境変数を Synthetics Job Manager に渡します。

2. my_userに、合成ジョブ マネージャーに渡されたすべてのディレクトリとボリュームに対する読み取り/書き込み権限があることを確認してください。これらの権限を設定するには、 chmodコマンドを使用してください。

3. 実行コマンドで使用するmy_userのuidを取得します： id -u my_user 。

   これらの条件が満たされたら、synthetics ジョブ マネージャーを起動するときにオプション"-u <uid>:<gid>"を使用します。

   bash

   コピー

   $
   docker run ... -u 1002 ...

   また

   bash

   コピー

   $
   docker run ... -u 1002 -e DOCKER_HOST=http://localhost:2375 ...

必要に応じて、次のオプションを使用してください。

• Docker ログを追跡し、モニターの正常性を確認するには、 synthetics ジョブ マネージャーのメンテナンスと監視を参照してください。

• Kubernetes コンテナー オーケストレーション システム環境の合成ジョブ マネージャーの場合、次の Helm showコマンドを使用して、それぞれchart.yamlとvalues.yamlを表示できます。

  bash

  コピー

  $
  helm show chart YOUR_REPO_NAME/synthetics-job-manager

  bash

  コピー

  $
  helm show values YOUR_REPO_NAME/synthetics-job-manager

一部のオープンソースソフトウェアは複数のソフトウェアライセンスの下にリストされており、その場合は、使用することを選択したライセンスをリストしています。当社のライセンス情報は、当社のライセンスドキュメントでも入手できます。

Docker と Kubernetes の両方で、synthetics ジョブ マネージャーとそのランタイム コンテナーはホストからネットワーク設定を継承します。Docker コンテナー システム環境でのこの例については、 Docker サイトを参照してください。

ブリッジ ネットワークは、合成ジョブ マネージャーとランタイム コンテナー間の通信用に作成されます。つまり、 --networkや--dnsなどのネットワーク コマンド オプションは、起動時に (Docker コンテナー システム環境で Docker 実行コマンドを介して) 合成ジョブ マネージャー コンテナーに渡され、ランタイム コンテナーによって継承または使用されません。

これらのネットワークが作成されると、デーモン用に構成されたデフォルトのIPアドレスプールからプルされます。Dockerコンテナシステム環境でのこの例については、 Dockerサイトを参照してください。

単一の合成ジョブ マネージャー Docker イメージは、Docker コンテナー システム環境と Kubernetes コンテナー オーケストレーション システム環境の両方を提供します。Docker イメージは Docker Hub でホストされています。Docker イメージが最新であることを確認するには、 Docker Hub newrelic/synthetics-job-manager リポジトリを参照してください。