Esta guía cubre la configuración y el despliegue del New Relic Synthetics Job Manager para admitir redes de doble stack (IPv4 e IPv6) en su entorno de Kubernetes.
Requisitos previos
Antes de comenzar, cerciorar de tener:
Kubernetes cluster: un clúster de Kubernetes en ejecución (versión 1.20 o superior recomendada) con soporte para stack dual habilitado
Helm: Helm 3.x instalado en su máquina
kubectl: kubectl instalado y configurado para comunicarse con su clúster
Docker: Docker instalado y en ejecución con soporte para stack dual (si usa Minikube o clústeres locales similares)
Permissions: Permisos de administrador del Cluster para crear namespaces y desplegar recursos
Private location key: su clave de ubicación privada de New Relic desde la UI
Public images: el soporte de stack dual requiere las siguientes versiones de imagen o posteriores, disponibles en Docker Hub:
- Administrador de trabajos
519o posterior:newrelic/synthetics-job-manager - Tiempo de ejecución de Ping
1.65.0o posterior:newrelic/synthetics-ping-runtime - Entorno de ejecución de API de Node
rc1.15o posterior:newrelic/synthetics-node-api-runtime - Runtime de navegador Node
rc1.15o posterior:newrelic/synthetics-node-browser-runtime
- Administrador de trabajos
Valida tu infraestructura
Antes de continuar, verifique que su clúster de Kubernetes y la infraestructura subyacente admitan redes de stack dual.
Pruebe la conectividad IPv6 desde su host ejecutando
ping6 ipv6.google.comoping -6 ipv6.google.com, o el comando equivalente para su máquina.Verificar el soporte de stack dual del clúster de Kubernetes:
bash$kubectl get nodes -o jsonpath='{.items[*].status.addresses[?(@.type=="InternalIP")].address}'Esto debería devolver tanto direcciones IPv4 como IPv6 si su clúster está habilitado para Dual stack.
Verificar la configuración de stack dual de Docker (si corresponde):
bash$docker network inspect bridge | grep IPv6Importante
Si la validación falla, asegúrese de que su infraestructura de red, VPC, subredes y grupos de seguridad estén configurados para permitir el tráfico tanto IPv4 como IPv6. Su clúster de Kubernetes debe estar configurado con soporte para Dual Stack antes de continuar.
Verifique que Docker esté listo para dual stack
Si su clúster de Kubernetes se ejecuta en Docker (como Minikube, kind o Docker Desktop), asegúrese de que Docker esté configurado para manejar el tráfico IPv4 e IPv6. Para verificar que Docker tiene IPv6 habilitado, ejecute:
$docker info | grep -i ipv6La salida debería confirmar que IPv6 está habilitado. Si no es así, consulte la documentación de Docker para habilitar el soporte de dual stack antes de continuar.
Instalar con Helm
Despliegue el administrador de trabajos de Sintéticos usando el gráfico de Helm de New Relic.
Agregue el repositorio Helm de New Relic:
bash$helm repo add YOUR_REPO_NAME https://helm-charts.newrelic.com$helm repo updateInstala el administrador de trabajos de Sintéticos:
bash$helm install YOUR_JOB_MANAGER_NAME YOUR_REPO_NAME/synthetics-job-manager \>-n YOUR_NAMESPACE \>--set synthetics.privateLocationKey=YOUR_PRIVATE_LOCATION_KEYConfirme que los pods se estén ejecutando:
bash$kubectl get -n YOUR_NAMESPACE pods
Verificar la instalación
Confirme que su gerente de trabajo de monitoreo sintético pueda acceder a recursos tanto IPv4 como IPv6.
Verifique el estado del pod:
bash$kubectl get pods -n YOUR_NAMESPACETodos los pods deberían mostrar un estado
Running.Ver los logs del administrador de trabajos:
bash$kubectl logs -n YOUR_NAMESPACE <job-manager-pod-name>Pruebe la conectividad de stack dual desde dentro de un 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.comSi ambos comandos curl se ejecutan correctamente, su configuración de stack dual funciona correctamente.
Verifique el estado de la ubicación privada en la UI de New Relic yendo a one.newrelic.com > All capabilities > Synthetic monitoring > Private locations. Su ubicación privada debería mostrarse como saludable.
Resolución de problemas
Si encuentra problemas con su configuración de stack dual:
Los pods no pueden comunicarse con direcciones IPv6:
- Verifique que su clúster de Kubernetes tenga habilitado el soporte de dual stack
- Asegúrese de que los grupos de seguridad y las políticas de red permitan el tráfico tanto IPv4 como IPv6
Imágenes no encontradas:
- Verifique que su clúster tenga acceso a Docker Hub para extraer las imágenes públicas en tiempo de ejecución
- Utilice
kubectl describe pod <pod-name> -n YOUR_NAMESPACEpara inspeccionar los errores de pull
Administrador de trabajos no se conecta:
- Verifique que su clave de ubicación privada sea correcta
- Verifique los logs del job manager en busca de errores de conexión:
kubectl logs -n YOUR_NAMESPACE <job-manager-pod-name>
Para obtener una guía adicional de resolución de problemas, consulte Resolución de problemas de ubicaciones privadas.
¿Que sigue?
Después de configurar su ubicación privada habilitada para Dual stack con Kubernetes, puede:
- Cree monitores sintéticos que prueben extremos tanto IPv4 como IPv6 usando su ubicación privada
- Configure los ajustes del Job Manager para opciones avanzadas
- Monitoree el estado y el rendimiento de su ubicación privada