Instale o gerenciador de tarefas Sintético

Para visualizar versões, dependência, valores padrão de quantos pods de tempo de execução iniciam com cada gerenciador de tarefas Sintético e muito mais, consulte Mostrar ajuda e exemplos abaixo.

1. Localize sua chave de localização privada.

2. Certifique-se de ter habilitado a dependência do Docker para sandbox e instalado o gerenciador de tarefas Sintético em seu sistema.

3. Execute o script apropriado para o seu sistema. Adapte o padrão comum /var/run/docker.sock nos exemplos a seguir para corresponder ao seu sistema.

   • Linux/macOS:

     bash

     Copiar

     $
     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

   • Windows:

     bash

     Copiar

     $
     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

   Veja o log do seu contêiner minion:

   bash

   Copiar

   $
   docker logs --follow YOUR_CONTAINER_NAME

1. Localize sua chave de localização privada.

2. Configure um namespace para o gerenciador de tarefas Sintético em seu cluster do Kubernetes:

   bash

   Copiar

   $
   kubectl create namespace YOUR_NAMESPACE

3. Copie os gráficos do Helm do repositório do Helm do New Relic.

   • Se você estiver copiando os gráficos pela primeira vez:

     bash

     Copiar

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

   • Se você copiou anteriormente os gráficos do Helm do repositório do New Relic Helm, obtenha os mais recentes:

     bash

     Copiar

     $
     helm repo update

4. Instale o gerenciador de tarefas Sintético com o seguinte comando do Helm:

   • Para uma nova instalação do gerenciador de tarefas Sintético:

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

     Copiar

   • Para atualizar uma instalação existente do gerenciador de tarefas Sintético:

     bash

     Copiar

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

5. Verifique se o pod do gerenciador de tarefas Sintético está instalado e funcionando:

   bash

   Copiar

   $
   kubectl get -n YOUR_NAMESPACE pods

   Assim que o atributo status de cada pod for mostrado como running, seu gerenciador de tarefas Sintético estará ativo e pronto para executar o monitoramento atribuído à sua localização privada.

Você pode parar um contêiner Docker pelo nome do contêiner ou pelo ID do contêiner.

• Parada de nome de contêiner para Linux, macOS e Windows:

  bash

  Copiar

  $
  docker stop YOUR_CONTAINER_NAME
  $
  docker rm YOUR_CONTAINER_NAME

• Parada de ID do contêiner para Linux/macOS:

  Nos exemplos o contêiner é parado e removido. Para parar apenas o contêiner, omita docker rm $CONTAINER_ID.

  bash

  Copiar

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

• Parada de ID do contêiner para Windows:

  Nos exemplos o contêiner é parado e removido. Para parar apenas o contêiner, omita docker rm $CONTAINER_ID.

  bash

  Copiar

  $
  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. Obtenha o JOB_MANAGER_POD_INSTALLATION_NAME do pod do gerenciador de tarefas do Sintético que você deseja excluir:

   bash

   Copiar

   $
   helm list -n YOUR_NAMESPACE

2. Exclua o pod minion:

   bash

   Copiar

   $
   helm uninstall -n YOUR_NAMESPACE JOB_MANAGER_POD_INSTALLATION_NAME

3. Exclua o namespace configurado para o gerenciador de tarefas Sintético em seu cluster do Kubernetes:

   bash

   Copiar

   $
   kubectl delete namespace YOUR_NAMESPACE

O gerenciador de tarefas Sintético é executado em Docker e é capaz de aproveitar Docker como uma tecnologia de sandbox. Isso garante o isolamento completo da execução do monitor, o que melhora a segurança, a confiabilidade e a repetibilidade. Cada vez que um monitor de script ou browser é executado, o gerenciador de tarefas Sintético cria um novo contêiner Docker para executá-lo usando o tempo de execução correspondente.

O contêiner do gerenciador de tarefas Sintético precisa ser configurado para se comunicar com o mecanismo docker para gerar contêineres de tempo de execução adicionais. Cada contêiner gerado é então dedicado a executar uma verificação associada ao monitor Sintético em execução na localização privada à qual o contêiner do gerenciador de tarefas Sintético está associado.

Há uma dependência crucial no lançamento. Para ativar o sandbox, certifique-se de que:

• Seu soquete UNIX docker gravável é montado na variável de ambiente /var/run/docker.sock ou DOCKER_HOST. Para obter mais informações, consulte Opção de soquete Daemon do Docker.

  Cuidado

  A contagem de núcleos no host determina quantos contêineres de tempo de execução o gerenciador de tarefas Sintético pode executar simultaneamente no host. Como os requisitos de memória são dimensionados para a contagem esperada do contêiner de tempo de execução, recomendamos not running multiple synthetics job managers on the same host para evitar contenção de recursos.

  Para obter informações adicionais sobre sandbox e execução como usuário root ou não root, consulte Segurança, sandbox e execução como não root.

Para obter mais informações, consulte a documentação oficial do Docker sobre segurança e perfis de segurança do AppArmor.

Se o seu ambiente exigir que você execute o gerenciador de tarefas Sintético como um usuário não-root, siga este procedimento. No exemplo a seguir, o usuário não root é my_user.

1. Certifique-se de que my_user possa usar o mecanismo Docker no host:

   Verifique se my_user pertence ao grupo de sistemas "docker" . O acesso raiz com escopo ao docker.sock ainda é necessário para criar redes de ponte.

   OU

   Habilite a opção de soquete Docker TCP e passe a variável de ambiente DOCKER_HOST para o gerenciador de tarefas Sintético.

2. Verifique se my_user tem permissões de leitura/gravação para todos os diretórios e volumes passados para o gerenciador de tarefas Sintético. Para definir essas permissões, use o comando chmod .

3. Obtenha o uid de my_user para uso no comando de execução: id -u my_user.

   Uma vez atendidas essas condições, use a opção "-u <uid>:<gid>" ao iniciar o gerenciador de tarefas Sintético:

   bash

   Copiar

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

   OU

   bash

   Copiar

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

Use estas opções conforme aplicável:

• Para acompanhar o log docker e verificar a integridade do seu monitor, consulte Manutenção e monitoramento do gerenciador de tarefas Sintético.

• Para um gerenciador de tarefas Sintético no ambiente do sistema de orquestração de contêineres Kubernetes, os seguintes comandos Helm show podem ser usados para visualizar o chart.yaml e o values.yaml, respectivamente:

  bash

  Copiar

  $
  helm show chart YOUR_REPO_NAME/synthetics-job-manager

  bash

  Copiar

  $
  helm show values YOUR_REPO_NAME/synthetics-job-manager

Alguns de nossos softwares de código aberto estão listados sob diversas licenças de software e, nesse caso, listamos a licença que escolhemos usar. Nossas informações de licença também estão disponíveis em nossa documentação de licenças.

Tanto para docker quanto para Kubernetes, o gerenciador de tarefas Sintético e seu contêiner de runtime herdarão as configurações de rede do host. Para obter um exemplo disso em um ambiente de sistema de contêiner docker , consulte o sitedocker .

Uma rede bridge é criada para comunicação entre o gerenciador de tarefas Sintético e o contêiner runtime. Isso significa que opções de comando de rede como --network e --dns passadas para o contêiner do gerenciador de tarefas Sintético no lançamento (como por meio de comandos docker run em um ambiente de sistema docker contêiner) não são herdadas ou usadas pelos contêineres de tempo de execução.

Quando essas redes são criadas, elas extraem do pool de endereços IP padrão configurado para o daemon. Para obter um exemplo disso em um ambiente de sistema de contêiner Docker , consulte o site Docker .

Uma única imagem docker do gerenciador de tarefas Sintético atende tanto o ambiente do sistema de contêineres docker quanto o ambiente do sistema de orquestração de contêineres Kubernetes. A imagem docker está hospedada no docker Hub. Para garantir que sua imagem docker esteja atualizada, consulte o repositóriodocker Hub newrelic/Sintético-job-manager.