• /
  • EnglishEspañolFrançais日本語한국어Português
  • EntrarComeçar agora

Esta tradução de máquina é fornecida para sua comodidade.

Caso haja alguma divergência entre a versão em inglês e a traduzida, a versão em inglês prevalece. Acesse esta página para mais informações.

Criar um problema

Instalar Sintéticos para Dual stack usando Kubernetes

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:

Validar sua infraestrutura

Antes de prosseguir, verifique se o seu cluster do Kubernetes e a infraestrutura subjacente suportam rede Dual Stack.

  1. Teste a conectividade IPv6 do seu host executando ping6 ipv6.google.com ou ping -6 ipv6.google.com, ou o comando equivalente para sua máquina.

  2. 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.

  3. Verifique a configuração de dual stack do Docker (se aplicável):

    bash
    $
    docker network inspect bridge | grep IPv6

    Importante

    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:

bash
$
docker info | grep -i ipv6

A 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.

  1. Adicione o repositório Helm da New Relic:

    bash
    $
    helm repo add YOUR_REPO_NAME https://helm-charts.newrelic.com
    $
    helm repo update
  2. Instale 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_KEY
  3. Confirme 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.

  1. Verifique o status do pod:

    bash
    $
    kubectl get pods -n YOUR_NAMESPACE

    Todos os pods devem mostrar um status Running.

  2. Visualize os logs do job manager:

    bash
    $
    kubectl logs -n YOUR_NAMESPACE <job-manager-pod-name>
  3. 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.com

    Se ambos os comandos curl forem bem-sucedidos, sua configuração de Dual Stack está funcionando corretamente.

  4. 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_NAMESPACE para 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:

Copyright © 2026 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.