컨테이너화된 개인 미니언(CPM) 설치

버전, 종속성, 각 미니언으로 시작하는 러너 포드 수에 대한 기본값, 영구 볼륨 액세스 모드 등을 보려면 아래 도움말 및 예 표시 를 참조하세요.

CPM은 Docker에서 실행되며 Docker를 샌드박싱 기술로 활용할 수 있습니다. 이렇게 하면 모니터 실행이 완전히 격리되어 보안, 안정성 및 반복성이 향상됩니다. 스크립팅된 또는 브라우저 모니터가 실행될 때마다 CPM은 실행자라는 새로운 Docker 컨테이너를 생성하여 실행합니다.

추가 러너 컨테이너를 생성하려면 미니언 컨테이너를 Docker 엔진과 통신하도록 구성해야 합니다. 생성된 각 컨테이너는 미니언 컨테이너가 연결된 개인 위치에서 실행되는 합성 모니터 와 연결된 검사를 실행하는 데 전용됩니다.

시작 시 두 가지 중요한 종속성이 있습니다. 샌드박싱을 활성화하려면 다음을 확인하세요.

• 쓰기 가능하고 실행 가능한 디렉토리는 /tmp 에 마운트됩니다. 쓰기 가능한 디렉토리는 CPM이 쓰기를 원하는 모든 디렉토리일 수 있지만 New Relic은 작업을 쉽게 하기 위해 시스템 고유의 /tmp 를 권장합니다.

• 쓰기 가능한 Docker UNIX 소켓은 /var/run/docker.sock 또는 DOCKER_HOST 환경 변수 에 마운트됩니다. 자세한 내용은 Docker의 데몬 소켓 옵션 을 참조하십시오.

  주의

  호스트의 코어 수는 분당 호출이 호스트에서 동시에 실행할 수 있는 실행기 컨테이너 수를 결정합니다. 메모리 요구 사항은 예상되는 실행기 컨테이너 수에 따라 조정되므로 리소스 경합을 방지하려면 not running multiple CPMs on the same host 사용하는 것이 좋습니다.

  샌드박싱 및 루트 또는 루트가 아닌 사용자로 실행에 대한 추가 정보는 보안, 샌드박싱 및 루트가 아닌 사용자로 실행을 참조하십시오.

1. 개인 위치 키 를 찾습니다.

2. 샌드박싱에 대한 Docker 종속성 을 활성화하고 시스템에 CPM을 설치 했는지 확인합니다.

3. 시스템에 적합한 스크립트를 실행하십시오. 다음 예에서 /tmp 및 /var/run/docker.sock 에 대한 공통 기본값을 시스템에 맞게 조정합니다.

   • 리눅스/맥OS:

     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

   • Windows:

     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. New Relic Helm 저장소에서 Helm 차트를 복사합니다.

   • 차트를 처음 복사하는 경우:

     bash

     카피

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

   • 이전에 New Relic Helm 리포지토리에서 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이 작동되고 개인 위치에 할당된 모니터를 실행할 준비가 된 것입니다.

컨테이너 이름 또는 컨테이너 ID 로 Docker 컨테이너를 중지 할 수 있습니다.

• 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을 실행해야 하는 경우 이 절차를 따르십시오. 다음 예에서 루트가 아닌 사용자는 my_user 입니다.

1. my_user 이 호스트에서 Docker 엔진을 사용할 수 있는지 확인합니다.

   my_user 이(가) "docker" 시스템 그룹에 속 하는지 확인하십시오. 브리지 네트워크를 생성하려면 docker.sock 에 대한 범위가 지정된 루트 액세스가 여전히 필요합니다.

   또는

   Docker TCP 소켓 옵션 을 활성화하고 DOCKER_HOST 환경 변수 를 CPM에 전달합니다.

2. my_user 에 CPM에 전달된 모든 디렉터리 및 볼륨에 대한 읽기/쓰기 권한이 있는지 확인합니다. 이러한 권한을 설정하려면 chmod 명령을 사용하십시오.

3. 실행 명령 id -u my_user 에서 사용할 my_user 의 uid 을(를) 가져옵니다.

   이러한 조건이 충족되면 CPM을 시작할 때 "-u <uid>:<gid>" 옵션을 사용하십시오.

   bash

   카피

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

   또는

   bash

   카피

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