コンテナ化されたプライベートミニオン（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：

     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

     コピー

   • ウィンドウズ：

     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

     コピー

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

   docker logs --follow YOUR_CONTAINER_NAME

   コピー

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

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

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

   kubectl create namespace YOUR_NAMESPACE

   コピー

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

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

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

     コピー

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

     helm repo update

     コピー

4. 次のHelmコマンドを使用してCPMをインストールします。

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

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

     コピー

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

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

     コピー

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

   kubectl get -n YOUR_NAMESPACE pods

   コピー

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

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

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

  docker stop YOUR_CONTAINER_NAME
    docker rm YOUR_CONTAINER_NAME

  コピー

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

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

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

  コピー

• WindowsのコンテナID停止：

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

  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 を取得します。

   helm list -n YOUR_NAMESPACE

   コピー

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

   helm uninstall -n YOUR_NAMESPACE MINION_POD_INSTALLATION_NAME

   コピー

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

   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>"を使用します。

   docker run ... -u 1002 ...

   コピー

   また

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

   コピー