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.
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 cluster | Utiliser network.ipFamily | Notes |
|---|---|---|
| IPv4 uniquement (par défaut) | ipv4 | Rétrocompatible, aucun changement nécessaire |
| IPv6 uniquement | ipv6 | Tous les services utilisent uniquement des adresses IPv6 |
| Dual-stack | dualstack ou ipv6 | Voir les notes spécifiques aux plateformes ci-dessous |
Considérations spécifiques aux plateformes
AWS 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 CNI | Prise 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
-
Kubernetes 1.28+ (requis pour une prise en charge stable du dual-stack)
-
Cluster compatible IPv6 : vérifiez avec :
kubectl get nodes -o jsonpath='{.items[*].spec.podCIDRs}'Vous devriez voir des CIDR IPv6 comme
2001:db8::/64 -
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 cluster | Peut atteindre les services IPv4 | Peut atteindre les services IPv6 | Configuration courante |
|---|---|---|---|
| Dual-stack | ✅ Oui | ✅ Oui | Le plus courant, recommandé |
| IPv6 uniquement avec NAT64/DNS64 | ✅ Oui (via traduction) | ✅ Oui | Par défaut sur AWS EKS |
| IPv6 uniquement sans NAT64 | ❌ Non | ✅ Oui | Rare, non recommandé |
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
| Exigence | Notes |
|---|---|
| IPv6 uniquement | Requis - les composants ne peuvent pas communiquer sans cela |
| Dual-stack | Facultatif - les composants peuvent se replier sur IPv4 |
Déploiement
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)
La migration vers IPv6 uniquement nécessite une interruption de service car les adresses IP changent.
- Sauvegardez vos données
- Migrez PostgreSQL et Redis vers IPv6
- Mettez à jour les valeurs Helm :
network:ipFamily: 'ipv6'postgresql:host: '2001:db8::1234' # New IPv6 addressredis:main:host: '2001:db8::5678' # New IPv6 address
- Déployez :
helm upgrade gitguardian gitguardian/gitguardian \--namespace gitguardian \-f values.yaml \-f values-ipv6.yaml
- Mettez à jour les enregistrements DNS en enregistrements AAAA
- 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 :
- Vérifiez que le cluster possède un CIDR de service IPv6 :
kubectl cluster-info dump | grep -i service-cluster-ip-range - Vérifiez que
network.ipFamilyest correctement défini dans les valeurs Helm - 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 :
- Testez la connectivité :
kubectl run test-pg --rm -it --image=postgres:16 -- psql -h 2001:db8::1234 -U gitguardian - Vérifiez que le DNS renvoie des enregistrements AAAA (si vous utilisez un nom d'hôte)
- Vérifiez que
listen_addressesde PostgreSQL inclut:: - Vérifiez que
pg_hba.confautorise votre sous-réseau IPv6
Échecs de connexion à Redis
Symptômes : ConnectionError: Error connecting to Redis
Checklist :
- Testez la connectivité :
kubectl run test-redis --rm -it --image=redis:7 -- redis-cli -h 2001:db8::5678 PING - Vérifiez que la configuration
bindde Redis inclut:: - 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'avecredis.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
ip6tablesen complément de vos règlesiptables - Politiques réseau : incluez les CIDR IPv6 dans les règles
ipBlockde 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 EKS | 40 à 100 $/mois (pas de coûts de NAT Gateway ni d'IPv4 publique) |
| GCP GKE | Impact minimal (les adresses IPv6 sont gratuites) |
Ressources supplémentaires
- Documentation Kubernetes IPv6/Dual-stack
- Documentation AWS EKS IPv6
- Documentation GCP GKE IPv6
- Configuration IPv6 de PostgreSQL
- Configuration IPv6 de Redis
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