Configurer un serveur de prévisualisation privée

Ce guide s'adresse 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 s'assurer que vos balises se comportent comme prévu. Pour activer cette fonctionnalité, vous devez effectuer deux déploiements Cloud Run : un pour un serveur de taggage et un pour un serveur de prévisualisation. Ce guide fournit plus d'informations sur la façon dont les deux serveurs communiquent et sur la façon dont vous pouvez 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 rediriger le trafic vers l'instance la plus proche.

Sans équilibreur de charge

Figure 1 : Déploiement sans équilibreur de charge.

Avec un équilibreur de charge

Figure 2 : Déploiement avec un équilibreur de charge.

Dans les deux déploiements, le point d'entrée pour le serveur de prévisualisation et 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 transmettent également le cookie. Grâce au cookie, le serveur de taggage sait qu'il s'agit de vos événements. Il ne les transmet donc qu'au serveur de prévisualisation pour que vous puissiez les consulter et résoudre les problèmes.

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

À propos des serveurs Preview publics

Ce comportement par défaut nécessite que votre serveur de prévisualisation soit public. Toutefois, cela pose problème à certaines organisations, car elles imposent des restrictions sur l'infrastructure pouvant être exposée au public 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 contrôle plus précis des fonctionnalités, comme les règles SSL pour limiter les suites de chiffrement.
• Intégration native à Cloud Armor pour le pare-feu d'application Web (WAF) ou le déni de service distribué (DDoS).
• 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ée, 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 : Mettez à 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, puis sur Déployer la 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 : Configurez 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 et 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 et procédez comme suit :
   1. Donnez-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 et procédez comme suit :
   1. Donnez-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 : Ajoutez une règle et mettez à jour le contrôle d'entrée

Pour ajouter une règle pour la nouvelle URL de l'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 :
   • L'hôte est la nouvelle URL : preview.sgtm.example.com
   • Le chemin d'accès est le suivant : /*
   • 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 d'équilibreurs de charge d'application externes pour qu'il ne soit pas accessible publiquement.

Résultat : L'architecture de votre serveur devrait maintenant ressembler à celle de la figure 3, où toutes les demandes de trafic sont dirigées vers le serveur de taggage, et où le serveur de taggage est en mesure de transférer les demandes 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. Cette méthode vous permet d'afficher la fenêtre de débogage, mais pas les événements qui s'y affichent. En effet, le serveur de taggage transmet les événements à d'autres chemins d'accès, qui ne peuvent pas atteindre la destination finale appropriée. L'hôte permet de séparer clairement 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