Este guia aborda a configuração e a implantação do New Relic Synthetics Job Manager para oferecer suporte à rede de stack duplo (IPv4 e IPv6) em seu ambiente Kubernetes.
Pré-requisitos
Antes de começar, certifique-se de ter:
Kubernetes cluster: um cluster do Kubernetes em execução (versão 1.20 ou superior recomendada) com suporte a Dual Stack habilitado
Helm: Helm 3.x instalado na sua máquina
kubectl: kubectl instalado e configurado para se comunicar com seu cluster
Docker: Docker instalado e em execução com suporte a Dual Stack (se estiver usando Minikube ou clusters locais semelhantes)
Permissions: Permissões de administrador do cluster para criar namespaces e implantar recursos
Private location key: sua chave de localização privada do New Relic da interface
Public images: o suporte a dual stack requer as seguintes versões de imagem ou posteriores, disponíveis no Docker Hub:
- Gerenciador de trabalhos
519ou posterior:newrelic/synthetics-job-manager - Ping runtime
1.65.0ou posterior:newrelic/synthetics-ping-runtime - Runtime da API Node
rc1.15ou posterior:newrelic/synthetics-node-api-runtime - Runtime do navegador Node
rc1.15ou posterior:newrelic/synthetics-node-browser-runtime
- Gerenciador de trabalhos
Validar sua infraestrutura
Antes de prosseguir, verifique se o seu cluster do Kubernetes e a infraestrutura subjacente suportam rede Dual Stack.
Teste a conectividade IPv6 do seu host executando
ping6 ipv6.google.comouping -6 ipv6.google.com, ou o comando equivalente para sua máquina.Verifique o suporte a Dual Stack do cluster do Kubernetes:
bash$kubectl get nodes -o jsonpath='{.items[*].status.addresses[?(@.type=="InternalIP")].address}'Isso deve retornar ambos os endereços IPv4 e IPv6 se o seu cluster estiver habilitado para Dual Stack.
Verifique a configuração de dual stack do Docker (se aplicável):
bash$docker network inspect bridge | grep IPv6Importante
Se a validação falhar, certifique-se de que sua infraestrutura de rede, VPC, sub-redes e grupos de segurança estejam configurados para permitir o tráfego tanto IPv4 quanto IPv6. Seu cluster do Kubernetes deve ser configurado com suporte a Dual Stack antes de continuar.
Verifique se o Docker está pronto para dual stack
Se o seu cluster do Kubernetes for executado no Docker (como Minikube, kind ou Docker Desktop), certifique-se de que o Docker esteja configurado para lidar com tráfego IPv4 e IPv6. Para verificar se o Docker tem o IPv6 habilitado, execute:
$docker info | grep -i ipv6A saída deve confirmar que o IPv6 está ativado. Se não estiver, consulte a documentação do Docker para habilitar o suporte a dual stack antes de prosseguir.
Instalar com Helm
Implante o gerenciador de rotinas do Sintéticos usando o gráfico do Helm da New Relic.
Adicione o repositório Helm da New Relic:
bash$helm repo add YOUR_REPO_NAME https://helm-charts.newrelic.com$helm repo updateInstale o gerenciador de tarefas do Synthetics:
bash$helm install YOUR_JOB_MANAGER_NAME YOUR_REPO_NAME/synthetics-job-manager \>-n YOUR_NAMESPACE \>--set synthetics.privateLocationKey=YOUR_PRIVATE_LOCATION_KEYConfirme se os pods estão em execução:
bash$kubectl get -n YOUR_NAMESPACE pods
Verifique a instalação
Confirme que seu gerenciador de rotinas sintéticas pode acessar recursos IPv4 e IPv6.
Verifique o status do pod:
bash$kubectl get pods -n YOUR_NAMESPACETodos os pods devem mostrar um status
Running.Visualize os logs do job manager:
bash$kubectl logs -n YOUR_NAMESPACE <job-manager-pod-name>Teste a conectividade Dual Stack de dentro de um pod:
bash$# Test IPv6$kubectl exec -n YOUR_NAMESPACE <pod-name> -- curl -6 -v http://ipv6.google.com$$# Test IPv4$kubectl exec -n YOUR_NAMESPACE <pod-name> -- curl -4 -v http://google.comSe ambos os comandos curl forem bem-sucedidos, sua configuração de Dual Stack está funcionando corretamente.
Verifique o status da localização privada na interface do New Relic acessando one.newrelic.com > All capabilities > Synthetic monitoring > Private locations. Sua localização privada deve aparecer como saudável.
Resolução de problemas
Se você encontrar problemas com sua configuração de Dual stack:
Os pods não conseguem alcançar endereços IPv6:
- Verifique se o seu cluster do Kubernetes tem o suporte a Dual Stack habilitado
- Certifique-se de que os grupos de segurança e as políticas de rede permitam o tráfego tanto IPv4 quanto IPv6
Imagens não encontradas:
- Verifique se o seu cluster tem acesso ao Docker Hub para extrair as imagens públicas de runtime
- Use
kubectl describe pod <pod-name> -n YOUR_NAMESPACEpara inspecionar erros de pull
Gerenciador de trabalhos não conectando:
- Verifique se sua chave de localização privada está correta
- Verifique os logs do job manager em busca de erros de conexão:
kubectl logs -n YOUR_NAMESPACE <job-manager-pod-name>
Para orientações adicionais de resolução de problemas, consulte Resolução de problemas de localizações privadas.
Qual é o próximo?
Após configurar sua localização privada habilitada para Dual Stack com Kubernetes, você pode:
- Crie monitores sintéticos que testam endpoints IPv4 e IPv6 usando sua localização privada
- Configure as definições do Job Manager para opções avançadas
- Monitore a sua localização privada quanto à integridade e ao desempenho