コンテナ化されたプライベートミニオン（CPM）をインストールする

バージョン、依存関係、各ミニオンで開始するランナーポッドの数のデフォルト値、永続ボリュームアクセスモードなどを表示するには、以下のヘルプと例を表示するを参照してください。

CPMはDockerで実行され、Dockerをサンドボックステクノロジーとして活用できます。これにより、モニターの実行が完全に分離され、セキュリティ、信頼性、再現性が向上します。スクリプトモニターまたはブラウザーモニターが実行されるたびに、CPMはランナーと呼ばれる新しいDockerコンテナーを作成して実行します。

ミニオンコンテナーは、追加のランナーコンテナーを生成するために、Dockerエンジンと通信するように構成する必要があります。次に、生成された各コンテナは、ミニオンコンテナが関連付けられているプライベートロケーションで実行されている合成モニターに関連付けられたチェックを実行するために使用されます。

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

• 書き込み可能で実行可能なディレクトリは/tmpにマウントされます。書き込み可能なディレクトリは、CPMに書き込みたい任意のディレクトリにすることができますが、New Relicは、作業を簡単にするためにシステム独自の/tmpを推奨しています。

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

  注意

  ホスト上のコア数によって、1分間あたりの呼発信回数がホスト上で同時に実行できるランナー コンテナの数が決まります。 メモリ要件はランナー コンテナの予想される数に合わせて調整されるため、リソースの競合を避けるためにnot running multiple CPMs on the same hostを推奨します。

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

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

2. サンドボックス化のためにDocker依存関係を有効にし、システムにCPMをインストールしたことを確認してください。

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

   • Linux / macOS：

     bash

     コピー

     $
     docker run \
     >
         --name YOUR_CONTAINER_NAME \
     >
         -e "MINION_PRIVATE_LOCATION_KEY=YOUR_PRIVATE_LOCATION_KEY" \
     >
         -v /tmp:/tmp:rw \
     >
         -v /var/run/docker.sock:/var/run/docker.sock:rw \
     >
         -d \
     >
         --restart unless-stopped \
     >
         quay.io/newrelic/synthetics-minion:latest

   • ウィンドウズ：

     bash

     コピー

     $
     docker run ^
     $
         --name YOUR_CONTAINER_NAME ^
     $
         -e "MINION_PRIVATE_LOCATION_KEY=YOUR_PRIVATE_LOCATION_KEY" ^
     $
         -v /tmp:/tmp:rw ^
     $
         -v /var/run/docker.sock:/var/run/docker.sock:rw ^
     $
         -d ^
     $
         --restart unless-stopped ^
     $
         quay.io/newrelic/synthetics-minion:latest

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

   bash

   コピー

   $
   docker logs --follow YOUR_CONTAINER_NAME

   Synthetics Minion is ready and servicing location YOUR_PRIVATE_LOCATION_LABELのようなメッセージが表示されると、CPMが起動し、その場所に割り当てられたモニターを実行する準備ができています。

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

2. KubernetesクラスターでCPMの名前空間を設定します。

   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コマンドを使用してCPMをインストールします。

   • CPMの新規インストールの場合：

     bash

     コピー

     $
     helm install YOUR_CPM_NAME YOUR_REPO_NAME/synthetics-minion -n YOUR_NAMESPACE --set synthetics.privateLocationKey=YOUR_PRIVATE_LOCATION_KEY

   • 既存のCPMインストールを更新するには：

     bash

     コピー

     $
     helm upgrade YOUR_CPM_NAME YOUR_REPO_NAME/synthetics-minion -n YOUR_NAMESPACE --set synthetics.privateLocationKey=YOUR_PRIVATE_LOCATION_KEY

5. ミニオンポッドが稼働しているかどうかを確認します。

   bash

   コピー

   $
   kubectl get -n YOUR_NAMESPACE pods

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

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. 削除するミニオン ポッドのMINION_POD_INSTALLATION_NAMEを取得します。

   bash

   コピー

   $
   helm list -n YOUR_NAMESPACE

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

   bash

   コピー

   $
   helm uninstall -n YOUR_NAMESPACE MINION_POD_INSTALLATION_NAME

3. KubernetesクラスタでCPM用に設定されたネームスペースを削除します。

   bash

   コピー

   $
   kubectl delete namespace YOUR_NAMESPACE

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

ご使用の環境でCPMをroot以外のユーザーとして実行する必要がある場合は、次の手順に従ってください。次の例では、root以外のユーザーはmy_userです。

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

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

   また

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

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

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

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

   bash

   コピー

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

   また

   bash

   コピー

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