Aller au contenu principal

Réseau IPv6

GitGuardian Self-Hosted prend en charge les configurations réseau IPv4, IPv6 et dual-stack pour une flexibilité maximale dans les environnements cloud et on-premises modernes. IPv6 est disponible exclusivement pour les installations basées sur Helm.

Quand utiliser IPv6

La prise en charge d'IPv6 est utile lorsque :

  • Votre cluster Kubernetes est IPv6 uniquement ou dual-stack
  • Vous migrez d'IPv4 vers IPv6
  • Des exigences de fournisseur cloud l'imposent (certaines régions AWS encouragent l'IPv6 uniquement)
  • Des politiques de sécurité d'entreprise requièrent IPv6

Démarrage rapide​

Valeurs Helm​

La prise en charge d'IPv6 peut être activée via la valeur du chart Helm network.ipFamily.

Configuration de votre clusterUtiliser network.ipFamilyNotes
IPv4 uniquement (par défaut)ipv4Rétrocompatible, aucun changement nécessaire
IPv6 uniquementipv6Tous les services utilisent uniquement des adresses IPv6
Dual-stackdualstack ou ipv6Voir les notes spécifiques aux plateformes ci-dessous

Considérations spécifiques aux plateformes​

AWS EKS​

Limitation dual-stack EKS

AWS EKS ne prend pas en charge les véritables services Kubernetes dual-stack. Même lorsque votre VPC est dual-stack, les services Kubernetes doivent être soit IPv4 soit IPv6, mais pas les deux.

Utilisez toujours ipFamily: 'ipv6' sur EKS, même lorsque votre VPC est dual-stack.

Vos pods dans un VPC EKS dual-stack peuvent toujours atteindre les services externes IPv4 et IPv6 (bases de données, Redis, API), mais les services Kubernetes eux-mêmes n'auront que des adresses IPv6.

Google GKE​

GKE prend entièrement en charge les services dual-stack où les services reçoivent simultanément des adresses IPv4 et IPv6.

Prérequis :

  • Cluster GKE avec stack_type = "IPV4_IPV6"
  • Advanced Datapath (Dataplane V2) activé
  • Kubernetes 1.28+

Vous pouvez utiliser n'importe quelle valeur ipFamily (ipv4, ipv6 ou dualstack) selon vos besoins.

Azure AKS​

AKS prend en charge les services dual-stack de manière similaire à GKE. Les services peuvent avoir à la fois des adresses IPv4 et IPv6.

Vous pouvez utiliser n'importe quelle valeur ipFamily selon vos besoins.

On-premises​

La prise en charge d'IPv6 dépend de votre plugin CNI et de la configuration de votre cluster :

Plugin CNIPrise en charge IPv6
Calico✅ Prise en charge complète
Cilium✅ Prise en charge complète
Flannel⚠️ Limitée (IPv6 uniquement, pas de dual-stack)
Weave Net⚠️ Expérimentale

Nous recommandons de tester les capacités IPv6 de votre cluster avant un déploiement en production.

Prérequis​

Exigences du cluster​

  1. Kubernetes 1.28+ (requis pour une prise en charge stable du dual-stack)

  2. Cluster compatible IPv6 : vérifiez avec :

    kubectl get nodes -o jsonpath='{.items[*].spec.podCIDRs}'

    Vous devriez voir des CIDR IPv6 comme 2001:db8::/64

  3. Plugin CNI avec prise en charge IPv6 : AWS VPC CNI, Calico, Cilium, etc.

PostgreSQL​

Votre PostgreSQL doit être accessible en IPv6 :

Fournisseurs cloud :

  • AWS RDS : définissez network_type = "DUAL"
  • Google Cloud SQL : IPv6 est automatiquement disponible
  • Azure Database for PostgreSQL : activez IPv6 dans les paramètres réseau

Self-hosted : assurez-vous que listen_addresses inclut IPv6 :

# postgresql.conf
listen_addresses = '::' # Listen on all IPv4 and IPv6 addresses

Et configurez pg_hba.conf pour les connexions IPv6 :

host all all 2001:db8::/32 md5

Redis​

Votre Redis doit être accessible en IPv6 :

Fournisseurs cloud :

  • AWS ElastiCache : définissez network_type = "dual_stack"
  • Google Memorystore : IPv6 est automatiquement disponible pour certains niveaux. Cependant, Memorystore pour les instances Redis n'est pas compatible avec IPv6.
  • Azure Cache for Redis : activez IPv6 dans les paramètres réseau

Self-hosted : assurez-vous que Redis écoute en IPv6 :

# redis.conf
bind :: 0.0.0.0

Connectivité réseau​

Les différentes configurations de cluster IPv6 ont des capacités de connectivité différentes :

Type de clusterPeut atteindre les services IPv4Peut atteindre les services IPv6Configuration courante
Dual-stack✅ Oui✅ OuiLe plus courant, recommandé
IPv6 uniquement avec NAT64/DNS64✅ Oui (via traduction)✅ OuiPar défaut sur AWS EKS
IPv6 uniquement sans NAT64❌ Non✅ OuiRare, non recommandé
NAT64/DNS64

NAT64 et DNS64 permettent aux pods IPv6 uniquement d'atteindre les services externes IPv4 uniquement en traduisant les requêtes IPv6 en IPv4. AWS EKS active cela par défaut pour les clusters IPv6.

Configuration​

Configuration des valeurs Helm​

Ajoutez la configuration network.ipFamily à votre fichier de valeurs Helm :

IPv4 uniquement (par défaut)​

# No configuration needed - this is the default
network:
ipFamily: 'ipv4'

IPv6 uniquement​

network:
ipFamily: 'ipv6'

# PostgreSQL and Redis must be IPv6-accessible
postgresql:
host: '2001:db8::1234' # IPv6 address or hostname with AAAA record
redis:
main:
host: '2001:db8::5678'

Vous devez également configurer Loki pour IPv6. Voir Configuration IPv6 de Loki ci-dessous.

Dual-stack (GKE/AKS)​

network:
ipFamily: 'dualstack'

postgresql:
host: 'postgres.example.com' # Must have A or AAAA DNS record
redis:
main:
host: 'redis.example.com'

La configuration IPv6 de Loki est facultative pour le dual-stack (les composants peuvent utiliser IPv4).

Configuration IPv6 de Loki​

Loki nécessite une configuration IPv6 explicite dans les clusters IPv6 uniquement car il utilise memberlist pour la découverte de services entre les composants. Ajoutez ceci à vos valeurs Helm :

loki:
loki:
commonConfig:
ring:
instance_enable_ipv6: true
kvstore:
store: "memberlist"
compactor:
compactor_ring:
instance_enable_ipv6: true
distributor:
ring:
instance_enable_ipv6: true
extraMemberlistConfig:
bind_addr:
- '::'
frontend:
instance_enable_ipv6: true
index_gateway:
ring:
instance_enable_ipv6: true
ingester:
lifecycler:
enable_inet6: true
pattern_ingester:
enabled: true
lifecycler:
enable_inet6: true
query_scheduler:
scheduler_ring:
instance_enable_ipv6: true
ruler:
ring:
instance_enable_ipv6: true
ExigenceNotes
IPv6 uniquementRequis - les composants ne peuvent pas communiquer sans cela
Dual-stackFacultatif - les composants peuvent se replier sur IPv4

Déploiement​

Preflights

Lorsque vos bases de données externes sont prêtes pour IPv6, testez la connectivité à l'aide de nos preflights.

Mettre à niveau un déploiement IPv4 existant​

Vers le dual-stack (GKE/AKS - sans interruption)​

Les mises à niveau vers le dual-stack sont transparentes car les services IPv4 existants continuent de fonctionner pendant que l'IPv6 est ajouté :

# values-ipv6.yaml
network:
ipFamily: 'dualstack'
helm upgrade gitguardian gitguardian/gitguardian \
--namespace gitguardian \
-f values.yaml \
-f values-ipv6.yaml

Vers IPv6 uniquement (nécessite une planification)​

Interruption requise

La migration vers IPv6 uniquement nécessite une interruption de service car les adresses IP changent.

  1. Sauvegardez vos données
  2. Migrez PostgreSQL et Redis vers IPv6
  3. Mettez à jour les valeurs Helm :
    network:
    ipFamily: 'ipv6'

    postgresql:
    host: '2001:db8::1234' # New IPv6 address

    redis:
    main:
    host: '2001:db8::5678' # New IPv6 address
  4. Déployez :
    helm upgrade gitguardian gitguardian/gitguardian \
    --namespace gitguardian \
    -f values.yaml \
    -f values-ipv6.yaml
  5. Mettez à jour les enregistrements DNS en enregistrements AAAA
  6. Testez la connectivité

Validation​

Après le déploiement, vérifiez que l'IPv6 fonctionne :

Vérifier les adresses IP des services​

kubectl get svc -n gitguardian -o wide

Les services doivent afficher des adresses IPv6 (par exemple, 2001:db8:1234:5678::a) ou à la fois IPv4 et IPv6 pour le dual-stack.

Tester la connectivité​

# Get service IP and test health endpoint
SERVICE_IP=$(kubectl get svc internal-api -n gitguardian -o jsonpath='{.spec.clusterIP}')
kubectl run test-ipv6 --rm -it --image=curlimages/curl -- \
curl -v "http://[$SERVICE_IP]:5050/api/v1/health"

Vérifier les logs de l'application​

kubectl logs -n gitguardian deployment/webapp-internal-api --tail=50

Recherchez le binding de Gunicorn sur [::] et l'absence d'erreurs de connexion à PostgreSQL/Redis.

Dépannage​

Les services n'obtiennent pas d'adresses IPv6​

Symptômes : les services affichent <none> ou uniquement des adresses IPv4

Checklist :

  1. Vérifiez que le cluster possède un CIDR de service IPv6 : kubectl cluster-info dump | grep -i service-cluster-ip-range
  2. Vérifiez que network.ipFamily est correctement défini dans les valeurs Helm
  3. Pour EKS, vérifiez que le cluster a été créé avec ip_family = "ipv6"

Échecs de connexion à PostgreSQL​

Symptômes : could not translate host name to address

Checklist :

  1. Testez la connectivité : kubectl run test-pg --rm -it --image=postgres:16 -- psql -h 2001:db8::1234 -U gitguardian
  2. Vérifiez que le DNS renvoie des enregistrements AAAA (si vous utilisez un nom d'hôte)
  3. Vérifiez que listen_addresses de PostgreSQL inclut ::
  4. Vérifiez que pg_hba.conf autorise votre sous-réseau IPv6

Échecs de connexion à Redis​

Symptômes : ConnectionError: Error connecting to Redis

Checklist :

  1. Testez la connectivité : kubectl run test-redis --rm -it --image=redis:7 -- redis-cli -h 2001:db8::5678 PING
  2. Vérifiez que la configuration bind de Redis inclut ::
  3. Utilisez le format d'URL correct : redis://[2001:db8::5678]:6379 (crochets requis pour IPv6)

Nginx ne démarre pas​

Symptômes : bind() to [::]:80 failed (99: Cannot assign requested address)

Solution : votre cluster ne prend pas en charge IPv6. Vérifiez que le plugin CNI prend en charge IPv6 ou utilisez network.ipFamily: 'ipv4'.

L'application plante avec une erreur d'analyse de port​

Symptômes : '' is not a valid port number

Solution : ne définissez pas à la fois redis.main.url et redis.main.host. Utilisez l'un ou l'autre :

  • Format URL : redis.main.url: 'redis://[2001:db8::5678]:6379'
  • Ou host/port : redis.main.host: '2001:db8::5678' avec redis.main.port: 6379

Loki ne démarre pas ou les composants ne peuvent pas communiquer​

Symptômes : failed to join memberlist, no healthy instances in ring, ou too many unhealthy instances in the ring

Solution : assurez-vous que la configuration IPv6 de Loki complète est appliquée. Le paramètre le plus souvent oublié est extraMemberlistConfig.bind_addr: ['::'].

Après avoir corrigé la configuration, redémarrez Loki :

kubectl rollout restart deployment/loki-backend -n gitguardian
kubectl rollout restart statefulset/loki-write -n gitguardian
kubectl rollout restart statefulset/loki-read -n gitguardian

Ingress et load balancers​

AWS Application Load Balancer (ALB)​

ingress:
controller: aws_alb
annotations:
alb.ingress.kubernetes.io/scheme: internet-facing
alb.ingress.kubernetes.io/ip-address-type: dualstack
alb.ingress.kubernetes.io/target-type: ip

Nginx Ingress Controller​

controller:
service:
ipFamilyPolicy: PreferDualStack
ipFamilies: [IPv4, IPv6]

Istio Gateway​

kubectl patch svc istio-ingressgateway -n istio-system \
-p '{"spec":{"ipFamilyPolicy":"PreferDualStack","ipFamilies":["IPv4","IPv6"]}}'

Considérations de performance​

IPv6 offre des performances comparables à IPv4 avec une différence de latence négligeable. Dans les clusters IPv6 uniquement avec NAT64/DNS64, attendez-vous à une surcharge de traduction d'environ 5 à 10 ms lors de l'accès aux services externes IPv4 uniquement.

Considérations de sécurité​

  • Règles de pare-feu : ajoutez des règles ip6tables en complément de vos règles iptables
  • Politiques réseau : incluez les CIDR IPv6 dans les règles ipBlock de votre NetworkPolicy Kubernetes
  • TLS/SSL : fonctionne de manière identique à IPv4 (mêmes certificats, protocoles et suites de chiffrement)

Rétrocompatibilité​

Tous les changements IPv6 sont 100 % rétrocompatibles. Les déploiements IPv4 existants continuent de fonctionner sans changement : aucun changement de valeur Helm ni de code applicatif n'est requis, sauf si vous activez IPv6.

Optimisation des coûts​

PlateformeÉconomies potentielles
AWS EKS40 à 100 $/mois (pas de coûts de NAT Gateway ni d'IPv4 publique)
GCP GKEImpact minimal (les adresses IPv6 sont gratuites)

Ressources supplémentaires​

Support​

Lorsque vous signalez des problèmes liés à IPv6, veuillez fournir :

# Kubernetes version
kubectl version --short

# Cluster IP families
kubectl cluster-info dump | grep -i service-cluster-ip-range

# CNI plugin
kubectl get pods -n kube-system | grep -i cni

# Service configuration
kubectl get svc internal-api -n gitguardian -o yaml

# Pod logs
kubectl logs deployment/webapp-internal-api -n gitguardian --tail=100

# Helm values (redact sensitive information)
helm get values gitguardian -n gitguardian