Configurer un serveur de prévisualisation privée

Ce guide est destiné aux développeurs qui utilisent Cloud Run pour le taggage côté serveur et qui souhaitent configurer un serveur de prévisualisation privé.

Le taggage côté serveur vous permet de prévisualiser les modifications de taggage en mode Aperçu et Débogage avant de les appliquer. Il s'agit d'une étape essentielle du workflow de développement pour vous assurer que vos balises se comportent comme prévu. Pour activer cette fonctionnalité, vous devez effectuer deux Cloud Run déploiements : un pour un serveur de taggage et un pour un serveur de prévisualisation. Ce guide fournit plus d'informations sur la communication entre les deux serveurs et sur la manière de les configurer dans un environnement d'entreprise.

Présentation

Lorsque vous déployez le taggage côté serveur sur Cloud Run, vous pouvez le faire avec ou sans équilibreur de charge. Pour les déploiements multirégionaux, vous avez besoin d'un équilibreur de charge pour diriger le trafic vers l'instance la plus proche.

Sans équilibreur de charge

Figure 1 : Déploiement sans équilibreur de charge

Avec équilibreur de charge

Figure 2 : Déploiement avec équilibreur de charge

Dans les deux déploiements, le point d'entrée de l'environnement de prévisualisation et de l'environnement de taggage de production est la même URL (par exemple, sgtm.example.com). Le serveur de taggage est déployé avec une variable d'environnement appelée PREVIEW_SERVER_URL, qui représente l'URL du serveur de prévisualisation.

Lorsque vous accédez à tagmanager.google.com et que vous ouvrez le mode Aperçu, Tag Manager accède à sgtm.example.com?id=[gtm_server_id]&gtm_auth=[auth_id]&gtm_preview=[env_id] et définit un cookie. Lorsque vous utilisez ensuite le même navigateur pour explorer le site Web cible, les requêtes envoyées à sgtm.example.com transfèrent également le cookie. Grâce au cookie, le serveur de taggage sait qu'il s'agit de vos événements. Il ne les transfère donc qu'au serveur de prévisualisation pour que vous puissiez les afficher et résoudre les problèmes.

Le serveur de taggage transfère ces événements en effectuant des requêtes HTTP vers l'URL définie dans la variable d'environnement PREVIEW_SERVER_URL.

À propos des serveurs de prévisualisation publics

Ce comportement par défaut nécessite que votre serveur de prévisualisation soit public. Toutefois, cela pose problème pour certaines organisations, car elles imposent des restrictions sur l'infrastructure qui peut être publique et appliquent généralement des mesures de sécurité supplémentaires via un équilibreur de charge. Un équilibreur de charge vous offre les avantages suivants :

• Un meilleur contrôle des fonctionnalités telles que les règles SSL pour limiter les suites de chiffrement.
• Une intégration native à Cloud Armor pour le pare-feu d'applications Web (WAF) ou la protection contre les attaques par déni de service distribué (DDoS).
• Des fonctionnalités avancées de gestion du trafic.

Acheminer votre serveur de prévisualisation via un équilibreur de charge

Pour créer un serveur de prévisualisation privé, utilisez le routage basé sur l'hôte via l'équilibreur de charge avec un sous-domaine supplémentaire. Le reste de ce guide explique comment acheminer votre serveur de prévisualisation via un équilibreur de charge.

Prérequis

• Le serveur de taggage est déployé sur Cloud Run derrière un équilibreur de charge.
• Accès au projet Google Cloud.
• Accès à un nouveau sous-domaine pour le serveur de prévisualisation, par exemple preview.sgtm.example.com.

Étape 1 : Mettre à jour la variable d'environnement avec un nouveau sous-domaine

Pour utiliser le nouveau domaine du serveur de prévisualisation, mettez à jour la variable d'environnement du serveur de taggage côté serveur PREVIEW_SERVER_URL :

1. Ouvrez Cloud Run.
2. Sélectionnez le serveur de taggage.
3. Cliquez sur Modifier et Déployer une nouvelle révision.
4. Dans l'onglet Variables et secrets, dans la section Conteneurs , remplacez PREVIEW_SERVER_URL par le nouveau domaine. Par exemple : preview.sgtm.example.com.

Étape 2 : Configurer l'équilibreur de charge existant pour utiliser le routage basé sur l'hôte

Pour configurer l'équilibreur de charge existant, utilisez le routage basé sur l'hôte et envoyez le trafic vers le serveur approprié :

1. Dans Cloud Run, ouvrez la page Équilibrage de charge, puis cliquez sur le nom de votre équilibreur de charge.
2. Cliquez sur le bouton Modifier.
3. Cliquez sur la page Configuration du backend , puis ouvrez le menu déroulant Services de backend et buckets backend.
4. Cliquez sur Créer un service de backend , puis procédez comme suit :
   1. Attribuez-lui un nom approprié (par exemple, preview-backend-service).
   2. Sélectionnez le type de backend Groupe de points de terminaison du réseau sans serveur.
5. Dans la section Backend , créez un groupe de points de terminaison du réseau sans serveur, puis procédez comme suit :
   1. Attribuez-lui un nom et sélectionnez la région dans laquelle le serveur de prévisualisation est hébergé.
   2. Sélectionnez Cloud Run comme type de groupe de points de terminaison du réseau sans serveur et le serveur de prévisualisation comme service.
   3. Cliquez sur Créer.
6. Modifiez les autres paramètres si nécessaire ou conservez les valeurs par défaut, puis cliquez sur Créer.

Étape 3 : Ajouter une règle et mettre à jour le contrôle d'entrée

Pour ajouter une règle pour la nouvelle URL d'hôte et mettre à jour le contrôle d'entrée :

1. Ouvrez la page Règles d'hôte et de chemin d'accès.
2. Ajoutez une règle où :
   • L'hôte est la nouvelle URL : preview.sgtm.example.com
   • Le chemin d'accès est : /*
   • Le backend est : preview-backend-service
3. Cliquez sur le bouton Mettre à jour pour redéployer l'équilibreur de charge.
4. De retour dans Cloud Run, ouvrez le serveur de prévisualisation, puis sélectionnez l'onglet Mise en réseau.
5. Définissez le Contrôle d'entrée sur Interne et cochez la case Autoriser le trafic provenant des équilibreurs de charge d'application externes afin qu'il ne soit pas accessible au public.

Résultat : L'architecture de votre serveur doit maintenant ressembler à la Figure 3, où toutes les requêtes de trafic sont dirigées vers le serveur de taggage, et où le serveur de taggage est en mesure de transférer les requêtes vers le serveur de prévisualisation.

Figure 3 : Utilisation du routage basé sur l'hôte

Remarque : Vous ne pouvez pas utiliser le routage basé sur le chemin d'accès, par exemple en mappant /gtm/debug sur preview-backend-service. Avec cette méthode, vous pouvez afficher la fenêtre de débogage, mais vous ne pouvez pas voir les événements. En effet, le serveur de taggage transfère les événements vers d'autres chemins d'accès, qui ne peuvent pas atteindre la destination finale appropriée. L'hôte assure une séparation claire entre les deux destinations.

Vérifier votre configuration

Pour vérifier votre configuration :

1. Ouvrez Google Tag Manager.
2. Ouvrez votre conteneur serveur.
3. Cliquez sur Admin > Paramètres du conteneur , puis définissez l'URL du conteneur serveur sur l'URL du serveur de taggage.
4. Fermez la fenêtre et prévisualisez l'espace de travail. La fenêtre de débogage s'ouvre. Lorsque vous naviguez sur votre site Web, vos événements doivent s'afficher dans la fenêtre de débogage.

Liens associés

• Configurer le taggage côté serveur avec Cloud Run
• Activer un comportement spécifique à une région dans le taggage côté serveur