Ce document explique comment configurer le NAT précis de Google Kubernetes Engine (GKE) pour attribuer des adresses IP de sortie dédiées à des espaces de noms Kubernetes spécifiques.
Avec le NAT granulaire, vous pouvez configurer des adresses IP externes sources spécifiques pour le Public NAT, ou vous pouvez configurer des adresses IP internes sources spécifiques pour le Private NAT, optimisé par les passerelles Cloud NAT.
Pour configurer le NAT précis, vous déclarez vos règles de routage à l'aide de deux ressources personnalisées au niveau du cluster :
- CloudNATGateway : utilisez cette ressource pour provisionner une nouvelle passerelle Cloud NAT publique ou privée pour votre cluster, ou pour configurer votre cluster afin qu'il utilise une passerelle Cloud NAT existante. La passerelle Cloud NAT doit se trouver dans la région et le réseau VPC de votre cluster.
- TrafficSelector : utilisez cette ressource pour définir vos règles de routage de sortie en mappant les espaces de noms sources (
namespaceSelector) et les CIDR de destination à une ressource CloudNATGateway cible.
Avant de commencer
Avant de configurer GKE Granular NAT, remplissez les conditions préalables suivantes :
- Vérifiez les exigences du cluster : vérifiez que votre cluster de VPC natif exécute GKE version 1.37.1-gke.2611000 ou ultérieure avec GKE Dataplane V2 activé. Le NAT granulaire GKE est compatible avec les clusters Autopilot et Standard, ainsi qu'avec les clusters régionaux et zonaux.
- Vérifiez les autorisations IAM :
- Vérifiez que vous disposez du rôle Administrateur Kubernetes Engine (
roles/container.admin) sur le cluster pour appliquer des ressources personnalisées. - Si vous utilisez un VPC partagé : l'administrateur du projet hôte doit attribuer à l'agent de service GKE de votre projet de service (
service-SERVICE_PROJECT_NUMBER@container-engine-robot.iam.gserviceaccount.com) le rôle d'administrateur de réseau Compute (roles/compute.networkAdmin) dans la stratégie IAM du projet hôte. Ce rôle permet à GKE de créer et de gérer les passerelles Cloud NAT, les routeurs Cloud Router et les adresses IP sous-jacents dans le réseau VPC partagé. Les réseaux VPC autonomes ne nécessitent pas cette autorisation manuelle.
- Vérifiez que vous disposez du rôle Administrateur Kubernetes Engine (
- Mettez à jour les règles de pare-feu pour inclure les adresses IP de liaison locale si nécessaire : avant que les paquets sortants ne quittent un nœud, GKE Granular NAT traduit leur adresse IP source en une adresse de liaison locale dans la plage
169.254.32.0/20. Si votre organisation applique des règles de pare-feu personnalisées strictes, vérifiez que vos règles tiennent compte de ce comportement :- Règles de sortie : évitez de spécifier un paramètre source dans les règles d'autorisation de sortie dont les cibles sont des nœuds de cluster. Si vous spécifiez un paramètre source, vous devez inclure la plage d'adresses de liaison locale (
169.254.32.0/20). - Règles d'entrée : évitez de spécifier le paramètre de destination dans les règles d'autorisation d'entrée dont les cibles sont des nœuds de cluster. Si vous spécifiez un paramètre de destination, vous devez inclure la plage d'adresses link-local (
169.254.32.0/20).
- Règles de sortie : évitez de spécifier un paramètre source dans les règles d'autorisation de sortie dont les cibles sont des nœuds de cluster. Si vous spécifiez un paramètre source, vous devez inclure la plage d'adresses de liaison locale (
- Trafic intra-VPC : assurez-vous que les ressources TrafficSelector n'incluent pas de CIDR de destination des plages de sous-réseaux au sein du réseau VPC du cluster ou d'un autre réseau VPC connecté à l'aide de l'appairage de réseaux VPC. Private NAT ne fournit que la connectivité pour les spokes NCC ou la connectivité à l'aide de Hybrid NAT.
- Exigences concernant les routes VPC : pour chaque CIDR à gérer par Public NAT, le réseau VPC du cluster doit inclure une route statique dont la plage de destination inclut le CIDR et dont le prochain saut est la passerelle Internet par défaut.
Limites
- Précision au niveau de l'espace de noms : vous ne pouvez appliquer les règles NAT précises GKE qu'au niveau de l'espace de noms Kubernetes. Pour la version preview, vous ne pouvez pas sélectionner des pods ou des comptes de service individuels à l'aide de sélecteurs d'étiquettes dans un espace de noms.
- Capacité des règles de passerelle : chaque passerelle Cloud NAT accepte jusqu'à 128 règles NAT, ce qui vous permet de configurer des règles pour un maximum de 128 espaces de noms GKE distincts par passerelle. Si votre cluster nécessite des règles de sortie pour plus de 128 espaces de noms, vous devez provisionner des passerelles supplémentaires.
- Limites de Cloud NAT : consultez les limites standards de Cloud NAT, car elles s'appliquent également à votre trafic de sortie NAT granulaire. Pour en savoir plus, consultez les limites de Public NAT et de Private NAT.
Activer GKE Granular NAT sur un cluster
Vous pouvez activer le NAT précis lorsque vous créez un cluster ou que vous mettez à jour un cluster existant.
Créer un cluster
Autopilot
Pour créer un cluster avec le NAT granulaire et GKE Dataplane V2 activés, exécutez la commande suivante :
gcloud container clusters create-auto "CLUSTER_NAME" \
--LOCATION_FLAG="LOCATION" \
--network="VPC_NETWORK_NAME" \
--enable-granular-nat \
--network-suite=STANDARD
Remplacez les éléments suivants :
CLUSTER_NAME: nom de votre nouveau clusterLOCATION_FLAG: spécifiez--regionpour un cluster régional.LOCATION: région ou zone Compute Engine de votre cluster (par exemple,us-central1ouus-central1-a).VPC_NETWORK_NAME: nom de votre réseau VPC.
Standard
Pour créer un cluster avec le NAT granulaire et GKE Dataplane V2 activés, exécutez la commande suivante :
gcloud container clusters create <var>CLUSTER_NAME</var> \
--LOCATION_FLAG="LOCATION" \
--network="VPC_NETWORK_NAME" \
--enable-dataplane-v2 \
--enable-granular-nat \
--network-suite=STANDARD
Remplacez les éléments suivants :
CLUSTER_NAME: nom de votre nouveau clusterLOCATION_FLAG: spécifiez--regionpour un cluster régional ou--zonepour un cluster zonal.LOCATION: région ou zone Compute Engine de votre cluster (par exemple,us-central1ouus-central1-a).VPC_NETWORK_NAME: nom de votre réseau VPC.
Mettre à jour un cluster existant
Autopilot
Pour activer le NAT précis sur un cluster existant, exécutez la commande suivante :
gcloud container clusters update `CLUSTER_NAME` \
--LOCATION_FLAG="LOCATION" \
--enable-granular-nat
Remplacez les éléments suivants :
CLUSTER_NAME: nom de votre cluster existant.LOCATION_FLAG: spécifiez--regionsi votre cluster existant est régional ou--zones'il est zonal.LOCATION: région ou zone Compute Engine où se trouve votre cluster.
Standard
Pour activer le NAT précis sur un cluster Standard existant, exécutez la commande suivante :
gcloud container clusters update `CLUSTER_NAME` \
--LOCATION_FLAG="LOCATION" \
--enable-granular-nat \
--network-suite=STANDARD
Remplacez les éléments suivants :
CLUSTER_NAME: nom de votre cluster existant.LOCATION_FLAG: spécifiez--regionsi votre cluster existant est régional ou--zones'il est zonal.LOCATION: région ou zone Compute Engine où se trouve votre cluster.
Configurer un NAT granulaire public avec des adresses IP de sortie externes statiques
Configurez Granular NAT public lorsque les charges de travail de différents espaces de noms doivent présenter des adresses IP publiques statiques distinctes aux services tiers externes, tels que les API partenaires ou les passerelles de paiement qui appliquent des listes d'autorisation d'adresses IP strictes.
Créez un routeur Cloud Router régional pour votre passerelle Cloud NAT. GKE ne crée pas automatiquement le routeur Cloud Router pour vous.
gcloud compute routers create ROUTER_NAME \ --network=VPC_NETWORK_NAME \ --region=REGIONRemplacez les éléments suivants :
ROUTER_NAME: nom de votre nouveau routeur Cloud Router régional.VPC_NETWORK_NAME: nom de votre réseau VPC.REGION: région Compute Engine où se trouve votre cluster (par exemple,us-central1).
Réservez des adresses IP externes statiques dans la même région que votre cluster GKE pour allouer des adresses IP de sortie externes dédiées à vos espaces de noms, ainsi qu'une adresse IP par défaut pour la passerelle :
gcloud compute addresses create nat-ip-default \ --region=REGION gcloud compute addresses create nat-ip-1 \ --region=REGION gcloud compute addresses create nat-ip-2 \ --region=REGIONRemplacez
REGIONpar la région Compute Engine où se trouve votre cluster (par exemple,us-central1).Enregistrez le fichier manifeste suivant sous le nom
cloud-nat-public.yamlpour définir une passerelle Cloud NAT régionale gérée :kind: CloudNATGateway apiVersion: networking.gke.io/v1 metadata: name: cloud-nat-public-managed spec: type: Public cloudRouter: name: projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME publicNATOptions: defaultNatExternalIPs: - name: nat-ip-default connectionOptions: udpTimeoutSeconds: 30 tcpEstablishedTimeoutSeconds: 1200 tcpTransitoryTimeoutSeconds: 30 tcpTimeWaitSeconds: 120 icmpTimeoutSeconds: 30 portOptions: minPortsPerVM: 32 maxPortsPerVM: 65536 logOptions: enable: true filter: ALLRemplacez les éléments suivants :
PROJECT_ID: ID de votre projet Google Cloud .REGION: région Compute Engine dans laquelle se trouvent votre cluster et votre routeur Cloud Router.ROUTER_NAME: nom de votre routeur Cloud Router.
Enregistrez le fichier manifeste suivant sous le nom
traffic-selectors-public.yamlpour mapper chaque espace de noms cible à l'adresse IP Public NAT qui lui est attribuée :kind: TrafficSelector apiVersion: networking.gke.io/v2 metadata: name: ns-red-public-route annotations: cloud.google.com/cloud-nat: '{"nat-external-ips":"nat-ip-1"}' spec: action: kind: CloudNATGateway name: cloud-nat-public-managed subject: pods: namespaceSelector: matchLabels: app: namespace-red-app egress: to: ipBlock: cidrs: - 0.0.0.0/0 --- kind: TrafficSelector apiVersion: networking.gke.io/v2 metadata: name: ns-green-public-route annotations: cloud.google.com/cloud-nat: '{"nat-external-ips":"nat-ip-2"}' spec: action: kind: CloudNATGateway name: cloud-nat-public-managed subject: pods: namespaceSelector: matchLabels: app: namespace-green-app egress: to: ipBlock: cidrs: - 0.0.0.0/0Dans ces fichiers manifestes :
- L'annotation
cloud.google.com/cloud-natspécifie l'adresse IP externe statique réservée qui traduit le trafic de sortie pour l'espace de noms correspondant. - Le champ
namespaceSelector.matchLabelscorrespond aux étiquettes appliquées à vos espaces de noms Kubernetes cibles. - La liste
egress.to.ipBlock.cidrscontenant0.0.0.0/0dirige tout le trafic Internet sortant via la passerelle Cloud NAT désignée.
- L'annotation
Appliquez les deux fichiers manifestes à votre cluster :
kubectl apply -f cloud-nat-public.yaml -f traffic-selectors-public.yaml
GKE provisionne automatiquement la passerelle Cloud NAT, configure les règles de traduction en fonction des sélecteurs de charge de travail de votre espace de noms et attribue les adresses IP externes réservées.
Configurer Cloud NAT granulaire privé pour la connectivité VPC ou NCC
Utilisez Granular Cloud NAT privé pour attribuer des plages d'adresses IP internes spécifiques aux charges de travail qui se connectent à des réseaux sur site ou à d'autres spokes VPC sur un hub NCC.
Créez des sous-réseaux dédiés avec l'objectif
PRIVATE_NATdans votre réseau VPC :gcloud compute networks subnets create private-nat-subnet-1 \ --region=REGION \ --network=VPC_NETWORK_NAME \ --range=10.0.0.0/29 \ --purpose=PRIVATE_NAT gcloud compute networks subnets create private-nat-subnet-2 \ --region=REGION \ --network=VPC_NETWORK_NAME \ --range=10.0.1.0/29 \ --purpose=PRIVATE_NATRemplacez les éléments suivants :
REGION: région Compute Engine dans laquelle se trouve votre cluster.VPC_NETWORK_NAME: nom de votre réseau VPC.
Enregistrez le fichier manifeste suivant sous le nom
cloud-nat-private.yamlpour créer une ressource CloudNATGateway privée :kind: CloudNATGateway apiVersion: networking.gke.io/v1 metadata: name: cloud-nat-private-managed spec: type: Private privateNATOptions: # Optional: Specify hubLink only if you are routing traffic through Network Connectivity Center hubLink: //networkconnectivity.googleapis.com/projects/PROJECT_ID/locations/global/hubs/HUB_NAME cloudRouter: name: projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME connectionOptions: udpTimeoutSeconds: 30 tcpEstablishedTimeoutSeconds: 1200Remplacez les éléments suivants :
PROJECT_ID: ID de votre projet Google Cloud .HUB_NAME: facultatif. Nom de votre hub Network Connectivity Center. Ne spécifiez cette option que si vous acheminez le trafic via Network Connectivity Center. Si vous n'utilisez pas Network Connectivity Center, omettez complètement le blocprivateNATOptions.ROUTER_NAME: nom de votre routeur Cloud Router.
Enregistrez le fichier manifeste suivant sous le nom
traffic-selectors-private.yamlpour créer des ressources TrafficSelector privées qui mappent vos espaces de noms à la passerelle Private NAT :kind: TrafficSelector apiVersion: networking.gke.io/v2 metadata: name: ns-red-private-route annotations: cloud.google.com/cloud-nat: '{"nat-subnet":"private-nat-subnet-1"}' spec: action: kind: CloudNATGateway name: cloud-nat-private-managed subject: pods: namespaceSelector: matchLabels: app: namespace-red-app egress: to: ipBlock: cidrs: - 10.200.0.0/24 --- kind: TrafficSelector apiVersion: networking.gke.io/v2 metadata: name: ns-green-private-route annotations: cloud.google.com/cloud-nat: '{"nat-subnet":"private-nat-subnet-2"}' spec: action: kind: CloudNATGateway name: cloud-nat-private-managed subject: pods: namespaceSelector: matchLabels: app: namespace-green-app egress: to: ipBlock: cidrs: - 10.200.1.0/24Appliquez la configuration Private NAT :
kubectl apply -f cloud-nat-private.yaml -f traffic-selectors-private.yaml
Utiliser une passerelle Cloud NAT existante
Si vous gérez plusieurs clusters GKE dans le même réseau VPC ou si vous avez des clusters qui partagent des plages d'adresses IP secondaires de pods, vous pouvez configurer Granular NAT pour utiliser une passerelle Cloud NAT existante dans la même région et le même réseau VPC. Cette configuration permet aux charges de travail de clusters distincts de présenter un pool unifié d'adresses IP externes sources lors de la connexion à des points de terminaison externes.
Répertoriez les passerelles Cloud NAT existantes dans votre région pour identifier le nom d'une passerelle existante, le routeur Cloud Router associé et le réseau VPC. La région et le réseau VPC doivent correspondre à ceux utilisés par les clusters GKE :
gcloud beta compute routers nats list \ --router=ROUTER_NAME \ --region=REGION \ --format=yamlRemplacez les éléments suivants :
ROUTER_NAME: nom du routeur Cloud Router gérant la passerelle existante.REGION: région Compute Engine où se trouvent votre cluster et votre passerelle existante (par exemple,us-central1).
Enregistrez le fichier manifeste suivant sous le nom
cloud-nat-shared.yamlpour associer votre cluster à la passerelle existante :kind: CloudNATGateway apiVersion: networking.gke.io/v1 metadata: name: cloud-nat-public-shared spec: type: Public # type is a required field even for shared gateways. Can be either Public or Private. gatewayName: SHARED_NAT_GATEWAY_NAME cloudRouter: name: projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAMERemplacez les éléments suivants :
SHARED_NAT_GATEWAY_NAME: nom de la passerelle Cloud NAT existante.PROJECT_ID: ID de votre projet Google Cloud .REGION: région Compute Engine dans laquelle se trouvent votre cluster et votre passerelle existante.ROUTER_NAME: nom du routeur Cloud Router régional gérant la passerelle existante.
Enregistrez le fichier manifeste suivant sous le nom
traffic-selector-shared.yamlpour acheminer le trafic sortant de votre espace de noms via la passerelle partagée :kind: TrafficSelector apiVersion: networking.gke.io/v2 metadata: name: ns-shared-public-route annotations: cloud.google.com/cloud-nat: '{"nat-external-ips":"NAT_IP_NAME"}' spec: action: kind: CloudNATGateway name: cloud-nat-public-shared subject: pods: namespaceSelector: matchLabels: app: NAMESPACE_APP_LABEL egress: to: ipBlock: cidrs: - 0.0.0.0/0Remplacez les éléments suivants :
NAT_IP_NAME: nom de l'adresse IP statique externe réservée configurée sur la passerelle partagée.NAMESPACE_APP_LABEL: libellé appliqué à votre espace de noms Kubernetes cible.
Appliquez les fichiers manifestes à chaque cluster GKE qui doit partager la passerelle :
kubectl apply -f cloud-nat-shared.yaml -f traffic-selector-shared.yamlRépétez cette étape sur chaque cluster où les charges de travail de l'espace de noms sélectionné doivent sortir via la passerelle partagée.
Nettoyer et désactiver le NAT précis
Pour éviter des frais de facturation continus et empêcher la création de ressources Google Cloud orphelines, suivez un ordre d'opérations strict lorsque vous supprimez le NAT précis de votre cluster.
Pour nettoyer les ressources NAT précises, procédez comme suit :
Supprimez les ressources TrafficSelector créées par l'utilisateur :
Supprimez les ressources personnalisées TrafficSelector que vous avez créées pour vos espaces de noms. N'utilisez pas l'option
--all, car la suppression des sélecteurs créés par le système (tels quegnat-intra-clusterougnat-default-internet) peut interrompre le trafic du cluster.kubectl delete trafficselector SELECTOR_NAMERemplacez
SELECTOR_NAMEpar le nom de la ressource TrafficSelector.Les contrôleurs NAT précis se coordonnent avec la mise en réseau Google Cloud pour supprimer les règles NAT et les mappages de charges de travail spécifiques associés à vos espaces de noms.
Vérifiez que toutes les ressources TrafficSelector ont été arrêtées avant de continuer.
Supprimez les ressources CloudNATGateway :
Supprimez toutes les ressources personnalisées CloudNATGateway du cluster :
kubectl delete cloudnatgateway --all- Passerelles gérées : GKE supprime automatiquement la passerelle Cloud NAT sous-jacente dans Google Cloud après la suppression de toutes les règles de traduction.
- Passerelles partagées : GKE nettoie les règles NAT pertinentes associées à vos espaces de noms. GKE ne supprime pas les associations d'adresses IP secondaires des pods de votre cluster, et la passerelle Cloud NAT partagée reste active pour les autres clusters.
Désactivez la fonctionnalité sur le cluster :
Une fois que toutes les ressources personnalisées Granular NAT ont été complètement supprimées, désactivez la fonctionnalité sur votre cluster :
gcloud container clusters update CLUSTER_NAME \ --location=LOCATION \ --no-enable-granular-natRemplacez les éléments suivants :
CLUSTER_NAME: nom du clusterLOCATION: région ou zone Compute Engine où se trouve votre cluster (par exemple,us-central1ouus-central1-a).
Dépannage
Si vous rencontrez des problèmes de connectivité, utilisez les méthodes suivantes pour diagnostiquer les défaillances de configuration et de plan de données de Granular NAT.
Vérifier l'état et les journaux des ressources
Inspecter l'état des ressources personnalisées : recherchez les conditions d'erreur sur vos ressources personnalisées CloudNATGateway ou TrafficSelector :
kubectl describe cloudnatgateway GATEWAY_NAME kubectl describe trafficselector SELECTOR_NAMERemplacez les éléments suivants :
GATEWAY_NAME: nom de votre ressource CloudNATGateway.SELECTOR_NAME: nom de votre ressource TrafficSelector.
Vérifiez les règles Cloud NAT : vérifiez que les règles de sélecteur de charge de travail GKE sont actives sur la passerelle Cloud NAT sous-jacente :
gcloud beta compute routers nats rules list \ --router=ROUTER_NAME \ --nat=NAT_NAME \ --region=REGION \ --format=yamlRemplacez les éléments suivants :
ROUTER_NAME: nom de votre routeur Cloud Router régional.NAT_NAME: nom de votre passerelle Cloud NAT.REGION: région Compute Engine où se trouvent vos ressources.
Analyser les journaux Cloud NAT : si le trafic sortant est supprimé ou ne parvient pas à être traduit, consultez les entrées de journal Cloud NAT dans Cloud Logging. Filtrez le champ
gke_workload_identitypour mettre en corrélation les événements de connexion directement avec des espaces de noms GKE spécifiques.
Pour en savoir plus sur le diagnostic des erreurs Cloud NAT générales, consultez Résoudre les problèmes liés à Cloud NAT.
Étapes suivantes
- En savoir plus sur Cloud NAT
- Consultez GKE Dataplane V2.