Les équilibreurs de charge réseau proxy classiques Google Cloud vous permettent d'utiliser une adresse IP unique pour vos utilisateurs du monde entier. Les équilibreurs de charge réseau proxy classiques acheminent automatiquement le trafic vers les instances backend les plus proches de l'utilisateur.
Cette page contient des instructions pour configurer un équilibreur de charge réseau proxy classique avec un proxy TCP cible et des backends de groupe d'instances de VM. Avant de commencer, consultez la page Présentation de l'équilibreur de charge réseau proxy externe pour en savoir plus sur le fonctionnement de ces équilibreurs de charge.
Vue d'ensemble de la configuration
Cet exemple montre comment configurer un équilibreur de charge réseau proxy externe pour un service existant dans deux régions : us-central1
et us-east1
.
Pour les besoins de cet exemple, le service est un ensemble de serveurs Apache configurés pour répondre sur le port 110
. De nombreux navigateurs n'autorisent pas le port 110
. La section consacrée aux tests utilise donc curl
.
Dans cet exemple, vous configurez les éléments suivants :
- Quatre instances réparties entre deux régions
- Des groupes d'instances contenant les instances
- Une vérification d'état pour examiner l'état de l'instance
- Un service de backend qui surveille les instances et les empêche de dépasser le taux d'utilisation configuré
- Un proxy TCP cible
- Une adresse IPv4 externe statique et une règle de transfert permettant d'envoyer le trafic utilisateur au proxy
- Une adresse IPv6 externe statique et une règle de transfert permettant d'envoyer le trafic utilisateur au proxy
- Une règle de pare-feu qui autorise le trafic provenant de l'équilibreur de charge et du vérificateur d'état à accéder aux instances
Une fois l'équilibreur de charge configuré, vous pouvez tester la configuration.
Autorisations
Pour suivre ce guide, vous devez savoir comment créer des instances et modifier un réseau dans un projet. Vous devez être propriétaire ou éditeur du projet, ou disposer de tous les rôles IAM Compute Engine suivants :
Tâche | Rôle requis |
---|---|
Créer des réseaux, des sous-réseaux et des composants de l'équilibreur de charge | Administrateur réseau |
Ajouter et supprimer des règles de pare-feu | Administrateur de sécurité |
Créer des instances | Administrateur d'instances Compute |
Pour en savoir plus, consultez les guides suivants :
- Access control (Contrôle des accès)
- Conditions IAM
Configurer des backends du groupe d'instances
Cette section explique comment créer des groupes d'instances simples et y ajouter des instances, puis ajouter ces instances au service de backend avec une vérification d'état. Un système de production utilise normalement des groupes d'instances gérés qui s'appuient sur des modèles d'instances, mais cette configuration est plus rapide pour la phase de test initiale.
Configurer les instances
À des fins de test, installez Apache sur quatre instances réparties équitablement entre deux groupes d'instances. En règle générale, les équilibreurs de charge réseau proxy externes ne sont pas utilisés pour le trafic HTTP. Néanmoins, Apache offre l'avantage d'être couramment utilisé et facile à configurer dans le cadre de ces tests.
Dans cet exemple, vous créez des instances avec le tag tcp-lb
. Ce tag sera utilisé ultérieurement par la règle de pare-feu.
Console
Créer des instances
Dans Google Cloud Console, accédez à la page Instances de VM.
Cliquez sur Créer une instance.
Pour Nom, définissez
ig-us-central1-1
.Définissez le paramètre Région sur
us-central1
.Définissez le paramètre Zone sur
us-central1-b
.Cliquez sur Options avancées.
Cliquez sur Mise en réseau et configurez les champs suivants :
- Pour Tags réseau, saisissez
tcp-lb
.
- Pour Tags réseau, saisissez
Cliquez sur Gestion. Saisissez le script suivant dans le champ Script de démarrage.
sudo apt-get update sudo apt-get install apache2 -y sudo sed -i '/Listen 80/c\Listen 110' /etc/apache2/ports.conf sudo service apache2 restart echo '<!doctype html><html><body><h1>ig-us-central1-1</h1></body></html>' | sudo tee /var/www/html/index.html
Cliquez sur Créer.
Créez une instance nommée
ig-us-central1-2
en utilisant les mêmes paramètres, excepté pour le champ Script de démarrage, dans lequel vous allez insérer le script suivant :sudo apt-get update sudo apt-get install apache2 -y sudo sed -i '/Listen 80/c\Listen 110' /etc/apache2/ports.conf sudo service apache2 restart echo '<!doctype html><html><body><h1>ig-us-central1-2</h1></body></html>' | sudo tee /var/www/html/index.html
Créez
ig-us-east1-1
en utilisant les mêmes paramètres, excepté pour les champs Région et Zone, que vous définissez respectivement surus-east1
etus-east1-b
. Dans le champ Script de démarrage, saisissez le script suivant :sudo apt-get update sudo apt-get install apache2 -y sudo sed -i '/Listen 80/c\Listen 110' /etc/apache2/ports.conf sudo service apache2 restart echo '<!doctype html><html><body><h1>ig-us-east1-1</h1></body></html>' | sudo tee /var/www/html/index.html
Créez
ig-us-east1-2
en utilisant les mêmes paramètres, excepté pour les champs Région et Zone, que vous définissez respectivement surus-east1
etus-east1-b
. Dans le champ Script de démarrage, saisissez le script suivant :sudo apt-get update sudo apt-get install apache2 -y sudo sed -i '/Listen 80/c\Listen 110' /etc/apache2/ports.conf sudo service apache2 restart echo '<!doctype html><html><body><h1>ig-us-east1-2</h1></body></html>' | sudo tee /var/www/html/index.html
gcloud
Créez
ig-us-central1-1
dans la zoneus-central1-b
gcloud compute instances create ig-us-central1-1 \ --image-family debian-10 \ --image-project debian-cloud \ --tags tcp-lb \ --zone us-central1-b \ --metadata startup-script="#! /bin/bash sudo apt-get update sudo apt-get install apache2 -y sudo sed -i '/Listen 80/c\Listen 110' /etc/apache2/ports.conf sudo service apache2 restart echo '<!doctype html><html><body><h1>ig-us-central1-1</h1></body></html>' | tee /var/www/html/index.html EOF"
Créez
ig-us-central1-2
dans la zoneus-central1-b
gcloud compute instances create ig-us-central1-2 \ --image-family debian-10 \ --image-project debian-cloud \ --tags tcp-lb \ --zone us-central1-b \ --metadata startup-script="#! /bin/bash sudo apt-get update sudo apt-get install apache2 -y sudo sed -i '/Listen 80/c\Listen 110' /etc/apache2/ports.conf sudo service apache2 restart echo '<!doctype html><html><body><h1>ig-us-central1-2</h1></body></html>' | tee /var/www/html/index.html EOF"
Créez
ig-us-east1-1
dans la zoneus-east1-b
gcloud compute instances create ig-us-east1-1 \ --image-family debian-10 \ --image-project debian-cloud \ --tags tcp-lb \ --zone us-east1-b \ --metadata startup-script="#! /bin/bash sudo apt-get update sudo apt-get install apache2 -y sudo sed -i '/Listen 80/c\Listen 110' /etc/apache2/ports.conf sudo service apache2 restart echo '<!doctype html><html><body><h1>ig-us-east1-1</h1></body></html>' | tee /var/www/html/index.html EOF"
Créez
ig-us-east1-2
dans la zoneus-east1-b
gcloud compute instances create ig-us-east1-2 \ --image-family debian-10 \ --image-project debian-cloud \ --tags tcp-lb \ --zone us-east1-b \ --metadata startup-script="#! /bin/bash sudo apt-get update sudo apt-get install apache2 -y sudo sed -i '/Listen 80/c\Listen 110' /etc/apache2/ports.conf sudo service apache2 restart echo '<!doctype html><html><body><h1>ig-us-east1-2</h1></body></html>' | tee /var/www/html/index.html EOF"
Créer des groupes d'instances
Dans cette section, vous allez créer un groupe d'instances dans chaque zone et ajouter les instances.
Console
Dans la console Google Cloud, accédez à la page Groupes d'instances.
Cliquez sur Créer un groupe d'instances.
Cliquez sur Nouveau groupe d'instances non géré.
Définissez le paramètre Nom sur
us-ig1
.Définissez le paramètre Zone sur
us-central1-b
.Sous Mappage des ports, cliquez sur Ajouter un port. Un équilibreur de charge envoie le trafic à un groupe d'instances via un port nommé. Créez un port nommé pour mapper le trafic entrant sur un numéro de port spécifique.
- Définissez le paramètre Nom du port sur
tcp110
. - Définissez le paramètre Numéros de ports sur
110
.
- Définissez le paramètre Nom du port sur
Dans la liste des instances de VM, sélectionnez
ig-us-central1-1
etig-us-central1-2
.Ne modifiez pas les autres paramètres.
Cliquez sur Créer.
Répétez ces étapes, mais définissez les valeurs suivantes :
- Nom :
us-ig2
- Région :
us-east1
- Zone :
us-east1-b
- Nom du port :
tcp110
- Numéros de ports :
110
- Instances : ig-us-east1-1 et ig-us-east1-2
- Nom :
gcloud
Créez le groupe d'instances
us-ig1
.gcloud compute instance-groups unmanaged create us-ig1 \ --zone us-central1-b
Définissez un port désigné pour le groupe d'instances.
gcloud compute instance-groups set-named-ports us-ig1 \ --named-ports tcp110:110 \ --zone us-central1-b
Ajoutez
ig-us-central1-1
etig-us-central1-2
àus-ig1
gcloud compute instance-groups unmanaged add-instances us-ig1 \ --instances ig-us-central1-1,ig-us-central1-2 \ --zone us-central1-b
Créez le groupe d'instances
us-ig2
.gcloud compute instance-groups unmanaged create us-ig2 \ --zone us-east1-b
Définissez un port désigné pour le groupe d'instances.
gcloud compute instance-groups set-named-ports us-ig2 \ --named-ports tcp110:110 \ --zone us-east1-b
Ajoutez
ig-us-east1-1
etig-us-east1-2
àus-ig2
gcloud compute instance-groups unmanaged add-instances us-ig2 \ --instances ig-us-east1-1,ig-us-east1-2 \ --zone us-east1-b
Vous disposez désormais d'un groupe d'instances dans chaque région. Chaque groupe d'instances possède deux instances de VM.
Créer une règle de pare-feu pour l'équilibreur de charge réseau proxy externe
Configurez le pare-feu pour autoriser le trafic provenant de l'équilibreur de charge et du vérificateur d'état à accéder aux instances. Dans ce cas, nous ouvrons le port TCP 110. La vérification d'état utilise le même port. Comme le trafic entre l'équilibreur de charge et vos instances utilise le protocole IPv4, seules les plages IPv4 doivent être ouvertes.
Console
Dans la console Google Cloud, accédez à la page Règles d'administration.
Cliquez sur Créer une règle de pare-feu.
Dans le champ Nom, saisissez
allow-tcp-lb-and-health
.Sous Réseau, sélectionnez default.
Sous Cibles, sélectionnez Tags cibles spécifiés.
Définissez Tags cibles sur
tcp-lb
.Définissez Filtre source sur Plages IPv4.
Définissez le paramètre Plages IPv4 sources sur
130.211.0.0/22
,35.191.0.0/16
.Sous Protocoles et ports, définissez le paramètre Protocoles et ports spécifiés sur
tcp:110
.Cliquez sur Créer.
gcloud
gcloud compute firewall-rules create allow-tcp-lb-and-health \ --source-ranges 130.211.0.0/22,35.191.0.0/16 \ --target-tags tcp-lb \ --allow tcp:110
Configurer l'équilibreur de charge
Console
Démarrer la configuration
Dans Google Cloud Console, accédez à la page Équilibrage de charge.
- Cliquez sur Créer un équilibreur de charge.
- Sous Type d'équilibreur de charge, sélectionnez Équilibreur de charge réseau (TCP/UDP/SSL), puis cliquez sur Suivant.
- Pour Proxy ou passthrough, sélectionnez Équilibreur de charge proxy, puis cliquez sur Suivant.
- Pour Public ou interne, sélectionnez Public (externe), puis cliquez sur Suivant.
- Pour Déploiement global ou dans une seule région, sélectionnez Recommandé pour les charges de travail globales, puis cliquez sur Suivant.
- Pour Génération de l'équilibreur de charge, sélectionnez Équilibreur de charge réseau proxy classique, puis cliquez sur Suivant.
- Cliquez sur Configurer.
Configuration de base
Définissez le paramètre Nom sur my-tcp-lb
.
Configurer le backend
- Cliquez sur Configuration du backend.
- Sous Type de backend, sélectionnez Groupes d'instances.
- Sous Protocole, sélectionnez TCP.
- Configurez le premier backend :
- Sous Nouveau backend, sélectionnez le groupe d'instances
us-ig1
. - Conservez les valeurs par défaut restantes.
- Sous Nouveau backend, sélectionnez le groupe d'instances
- Configurez le deuxième backend :
- Cliquez sur Ajouter un backend.
- Sélectionnez le groupe d'instances
us-ig2
. - Sous Numéros de port, supprimez
80
et ajoutez110
.
- Configurez la vérification de l'état :
- Sous Vérification d'état, sélectionnez Créer une vérification d'état.
- Définissez le paramètre Nom de la vérification d'état sur
my-tcp-health-check
. - Sous Protocole, sélectionnez TCP.
- Définissez le paramètre Port sur
110
. - Conservez les valeurs par défaut restantes.
- Cliquez sur Save and continue (Enregistrer et continuer).
- Dans la console Google Cloud, vérifiez qu'une coche apparaît à côté de Configuration du backend. Si ce n'est pas le cas, vérifiez que vous avez bien suivi la procédure ci-dessous dans son intégralité.
Configuration du frontend
- Cliquez sur Configuration de l'interface.
- Ajoutez la première règle de transfert :
- Saisissez le nom
my-tcp-lb-forwarding-rule
. - Sous Protocole, sélectionnez TCP.
- Sous Adresse IP, sélectionnez Créer une adresse IP :
- Saisissez le nom
tcp-lb-static-ip
. - Cliquez sur Réserver.
- Saisissez le nom
- Définissez le paramètre Port sur
110
. - Dans cet exemple, n'activez pas le protocole PROXY, car il ne fonctionne pas avec le logiciel Apache HTTP Server. Pour en savoir plus, consultez la section Protocole de proxy.
- Cliquez sur OK.
- Saisissez le nom
- Ajoutez la deuxième règle de transfert :
- Cliquez sur Ajouter une adresse IP et un port frontend.
- Saisissez le nom
my-tcp-lb-ipv6-forwarding-rule
. - Sous Protocole, sélectionnez TCP.
- Définissez Version IP sur
IPv6
. - Sous Adresse IP, cliquez sur Créer une adresse IP.
- Saisissez un nom de
tcp-lb-ipv6-static-ip
. - Cliquez sur Réserver.
- Saisissez un nom de
- Définissez le paramètre Port sur
110
. - Dans cet exemple, n'activez pas le protocole PROXY, car il ne fonctionne pas avec le logiciel Apache HTTP Server. Pour en savoir plus, consultez la section Protocole de proxy.
- Cliquez sur OK.
Dans la console Google Cloud, vérifiez qu'une coche apparaît à côté de Configuration du frontend. Dans le cas contraire, vérifiez que vous avez bien suivi la procédure ci-dessus dans son intégralité.
Vérifier et finaliser
- Cliquez sur Vérifier et finaliser.
- Vérifiez les paramètres de configuration de votre équilibreur de charge.
- Facultatif : cliquez sur Code équivalent pour afficher la requête API REST qui sera utilisée pour créer l'équilibreur de charge.
- Cliquez sur Créer.
gcloud
- Créez une vérification d'état.
gcloud compute health-checks create tcp my-tcp-health-check --port 110
- Créez un service de backend.
gcloud compute backend-services create my-tcp-lb \ --load-balancing-scheme EXTERNAL \ --global-health-checks \ --global \ --protocol TCP \ --health-checks my-tcp-health-check \ --timeout 5m \ --port-name tcp110
- Ajoutez des groupes d'instances au service de backend.
gcloud compute backend-services add-backend my-tcp-lb \ --global \ --instance-group us-ig1 \ --instance-group-zone us-central1-b \ --balancing-mode UTILIZATION \ --max-utilization 0.8
gcloud compute backend-services add-backend my-tcp-lb \ --global \ --instance-group us-ig2 \ --instance-group-zone us-east1-b \ --balancing-mode UTILIZATION \ --max-utilization 0.8
- Configurez un proxy TCP cible. Si vous souhaitez activer l'en-tête de proxy, définissez ce paramètre sur
PROXY_V1
au lieu deNONE
.gcloud compute target-tcp-proxies create my-tcp-lb-target-proxy \ --backend-service my-tcp-lb \ --proxy-header NONE
- Réservez des adresses IPv4 et IPv6 statiques globales.
Vos clients utilisent ces adresses IP pour accéder à votre service avec équilibrage de charge.
gcloud compute addresses create tcp-lb-static-ipv4 \ --ip-version=IPV4 \ --global
gcloud compute addresses create tcp-lb-static-ipv6 \ --ip-version=IPV6 \ --global
- Configurez des règles de transfert globales pour les deux adresses.
gcloud compute forwarding-rules create my-tcp-lb-ipv4-forwarding-rule \ --load-balancing-scheme EXTERNAL \ --global \ --target-tcp-proxy my-tcp-lb-target-proxy \ --address tcp-lb-static-ipv4 \ --ports 110
gcloud compute forwarding-rules create my-tcp-lb-ipv6-forwarding-rule \ --load-balancing-scheme EXTERNAL \ --global \ --target-tcp-proxy my-tcp-lb-target-proxy \ --address tcp-lb-static-ipv6 \ --ports 110
Tester l'équilibreur de charge
Obtenez l'adresse IP de l'équilibreur de charge.
Pour obtenir l'adresse IPv4, exécutez la commande suivante :
gcloud compute addresses describe tcp-lb-static-ipv4
Pour obtenir l'adresse IPv6, exécutez la commande suivante :
gcloud compute addresses describe tcp-lb-static-ipv6
Envoyez du trafic à votre équilibreur de charge en exécutant la commande suivante. Remplacez
LB_IP_ADDRESS
par l'adresse IPv4 ou IPv6 de votre équilibreur de charge.curl -m1 LB_IP_ADDRESS:110
Par exemple, si l'adresse IPv6 attribuée est
[2001:db8:1:1:1:1:1:1/96]:110
, la commande doit se présenter comme suit :curl -m1 http://[2001:db8:1:1:1:1:1:1]:110
Si vous ne parvenez pas à atteindre l'équilibreur de charge, suivez la procédure décrite dans la section Résoudre les problèmes de configuration.
Options de configuration supplémentaires
Cette section développe l'exemple de configuration et propose d'autres options de configuration. Toutes les tâches décrites ici sont facultatives. Vous pouvez les exécuter dans n'importe quel ordre.
Protocole de PROXY pour la conservation des informations de connexion client
L'équilibreur de charge réseau proxy met fin aux connexions TCP du client et crée des connexions aux instances. Par défaut, l'adresse IP et les informations de port d'origine du client ne sont pas conservées.
Pour conserver et envoyer les informations de connexion d'origine à vos instances, activez le protocole de PROXY (version 1). Dans le cadre de la requête, ce protocole envoie à l'instance un en-tête supplémentaire contenant les éléments d'origine : l'adresse IP source, l'adresse IP de destination, ainsi que les numéros de ports.
Assurez-vous que les instances backend de l'équilibreur de charge réseau proxy exécutent des serveurs compatibles avec les en-têtes de protocole de PROXY. Si les serveurs ne sont pas configurés pour accepter les en-têtes de protocole de PROXY, les instances backend renvoient des réponses vides.
Si vous définissez le protocole de PROXY pour le trafic utilisateur, vous pouvez également le définir pour vos vérifications de l'état. Si vous effectuez la vérification d'état et la diffusion de contenu sur le même port, définissez l'en-tête --proxy-header
de la vérification d'état pour qu'il corresponde aux paramètres de votre équilibreur de charge.
L'en-tête de protocole de PROXY est généralement constitué d'une seule ligne de texte parfaitement lisible, au format suivant :
PROXY TCP4 <client IP> <load balancing IP> <source port> <dest port>\r\n
L'exemple suivant illustre un protocole de PROXY :
PROXY TCP4 192.0.2.1 198.51.100.1 15221 110\r\n
Dans l'exemple précédent, l'adresse IP du client est 192.0.2.1
, l'adresse IP d'équilibrage de charge est 198.51.100.1
, le port client est 15221
et le port de destination est 110
.
Lorsque l'adresse IP du client n'est pas connue, l'équilibreur de charge génère un en-tête de protocole de PROXY au format suivant :
PROXY UNKNOWN\r\n
Mettre à jour l'en-tête du protocole de PROXY pour le proxy cible
L'exemple de configuration d'équilibreur de charge de cette page vous montre comment activer l'en-tête du protocole de PROXY lors de la création de l'équilibreur de charge réseau proxy. Pour modifier l'en-tête du protocole de PROXY pour un proxy cible existant, suivez les instructions suivantes.
Console
Dans la console Google Cloud, accédez à la page Équilibrage de charge.
- Cliquez sur Modifier à côté du nom de votre équilibreur de charge.
- Cliquez sur Configuration de l'interface.
- Définissez la valeur du champ Protocole de proxy sur On (Activé).
- Cliquez sur Mettre à jour pour enregistrer vos modifications.
gcloud
Dans la commande suivante, modifiez le champ --proxy-header
et définissez-le sur NONE
ou PROXY_V1
en fonction de vos besoins.
gcloud compute target-tcp-proxies update TARGET_PROXY_NAME \ --proxy-header=[NONE | PROXY_V1]
Configurer l'affinité de session
L'exemple de configuration crée un service de backend sans affinité de session.
Ces procédures vous montrent comment mettre à jour un service de backend pour l'exemple d'équilibreur de charge afin que ce service utilise l'affinité basée sur les adresses IP client ou l'affinité basée sur les cookies générés.
Lorsque l'affinité basée sur les adresses IP client est activée, l'équilibreur de charge dirige les requêtes d'un client particulier toujours vers la même VM de backend, grâce à un hachage créé à partir de l'adresse IP du client et de l'adresse IP de l'équilibreur de charge (l'adresse IP externe d'une règle de transfert externe).
Console
Pour activer l'affinité de session basée sur les adresses IP client, procédez comme suit :
Dans la console Google Cloud, accédez à la page Équilibrage de charge.
Cliquez sur Backends.
Cliquez sur my-tcp-lb (nom du service de backend que vous avez créé pour cet exemple), puis sur Modifier.
Sur la page Détails du service de backend, cliquez sur Configuration avancée.
Sous Affinité de session, sélectionnez IP client dans le menu.
Cliquez sur Mettre à jour.
gcloud
Utilisez la commande gcloud suivante pour mettre à jour le service de backend my-tcp-lb
, en spécifiant l'affinité de session basée sur les adresses IP client :
gcloud compute backend-services update my-tcp-lb \ --global \ --session-affinity=CLIENT_IP
API
Pour définir l'affinité de session basée sur les adresses IP client, envoyez une requête PATCH
à la méthode backendServices/patch
.
PATCH https://www.googleapis.com/compute/v1/projects/[PROJECT_ID]/global/us-west1/backendServices/my-tcp-lb
{
"sessionAffinity": "CLIENT_IP"
}
Activer le drainage de connexion
Vous pouvez activer le drainage de connexion sur les services de backend afin de garantir à vos utilisateurs un temps d'interruption minimal lorsqu'une instance assurant la diffusion du trafic est arrêtée, supprimée manuellement ou supprimée par un autoscaler. Pour en savoir plus sur le drainage de connexion, consultez la documentation Activer le drainage de connexion.
Étapes suivantes
- Présentation de l'équilibreur de charge réseau proxy externe
- Journalisation et surveillance de l'équilibreur de charge réseau proxy
- Nettoyer une configuration d'équilibrage de charge