Configurare un server di anteprima privato

Questa guida è rivolta agli sviluppatori che utilizzano Cloud Run per il tagging lato server e che vogliono configurare un server di anteprima privato.

Il tagging lato server ti consente di visualizzare l'anteprima delle modifiche del tagging in modalità di anteprima e debug prima di applicarle. Questa è una parte fondamentale del flusso di lavoro di sviluppo per assicurare che i tag si comportino come previsto. Per abilitare questa funzionalità sono necessari due deployment Cloud Run: uno per un server di tagging e uno per un server di anteprima. Questa guida fornisce ulteriori informazioni sulle modalità di comunicazione tra i due server e su come configurarli in un ambiente aziendale.

Panoramica

Quando esegui il deployment del tagging lato server in Cloud Run, puoi eseguirne il deployment con o senza un bilanciatore del carico. Per i deployment in più regioni, è necessario un bilanciatore del carico che indirizzi il traffico all'istanza più vicina.

Senza bilanciatore del carico

Senza un bilanciatore del carico

Figura 1: deployment senza bilanciatore del carico.

Con bilanciatore del carico

Con un bilanciatore del carico

Figura 2: deployment con un bilanciatore del carico.

In entrambi i deployment, il punto di ingresso sia per il server di anteprima sia per l'ambiente di tagging di produzione è lo stesso URL (ad esempio, sgtm.example.com). Il deployment del server di tagging viene eseguito con una variabile di ambiente denominata PREVIEW_SERVER_URL, che rappresenta l'URL del server di anteprima.

Quando visiti tagmanager.google.com e apri la modalità di anteprima, Tag Manager va a sgtm.example.com?id=[gtm_server_id]&gtm_auth=[auth_id]&gtm_preview=[env_id] e imposta un cookie. Quando poi utilizzi lo stesso browser per esplorare il sito web di destinazione, anche le richieste inviate a sgtm.example.com inoltrano il cookie. Grazie al cookie, il server di tagging sa che si tratta dei tuoi eventi, pertanto inoltra i tuoi eventi solo al server di anteprima, affinché tu possa visualizzarli e risolvere i problemi.

Il server di tagging inoltra questi eventi effettuando richieste HTTP all'URL impostato nella variabile di ambiente PREVIEW_SERVER_URL.

Informazioni sui server di anteprima rivolti al pubblico

Questo comportamento predefinito richiede che il server di anteprima sia pubblico. Tuttavia, questo rappresenta un problema per alcune organizzazioni, in quanto hanno limitazioni su quale infrastruttura può essere rivolta al pubblico e di solito applicano misure di sicurezza aggiuntive tramite un bilanciatore del carico. Un bilanciatore del carico offre:

  • Maggiore controllo su funzionalità come i criteri SSL per limitare le suite di crittografia.
  • Integrazione nativa con Cloud Armor per web application firewall (WAF) o Distributed Denial-of-Service (DDoS).
  • Funzionalità avanzate di gestione del traffico.

Instrada il server di anteprima tramite un bilanciatore del carico

Per creare un server di anteprima privato, utilizza il routing basato su host tramite il bilanciatore del carico con un sottodominio aggiuntivo. La parte rimanente di questa guida spiega come indirizzare il server di anteprima attraverso un bilanciatore del carico.

Prerequisiti

  • Viene eseguito il deployment del server di tagging su Cloud Run dietro un bilanciatore del carico.
  • Accesso al progetto Google Cloud.
  • Accesso a un nuovo sottodominio per il server di anteprima, ad esempio preview.sgtm.example.com.

Passaggio 1: aggiorna la variabile di ambiente con un nuovo sottodominio

Per utilizzare il nuovo dominio del server di anteprima, aggiorna la variabile di ambiente del server per il tagging lato server PREVIEW_SERVER_URL:

  1. Apri Cloud Run.
  2. Seleziona il server di tagging.
  3. Fai clic su Modifica e poi su Esegui il deployment di una nuova revisione.
  4. Nella scheda Variabili e secret, nella sezione Contenitori, modifica PREVIEW_SERVER_URL nel nuovo dominio. Ad esempio: preview.sgtm.example.com.

Passaggio 2: configura il bilanciatore del carico esistente per utilizzare il routing basato su host

Per configurare il bilanciatore del carico esistente, utilizza il routing basato su host e invia il traffico al server corretto:

  1. In Cloud Run, apri la pagina Bilanciamento del carico e fai clic sul nome del bilanciatore del carico.
  2. Fai clic sul pulsante Modifica.
  3. Fai clic sulla pagina Configurazione backend e apri il menu a discesa Servizi e bucket di backend.
  4. Fai clic su Crea un servizio di backend e completa quanto segue:
    1. Assegna un nome appropriato (ad esempio, preview-backend-service).
    2. Seleziona il tipo di backend come Gruppo di endpoint di rete serverless.
  5. Nella sezione Backend, crea un nuovo gruppo di endpoint di rete serverless e completa quanto segue:
    1. Assegna un nome e seleziona la regione in cui è ospitato il server di anteprima.
    2. Seleziona Cloud Run come tipo di gruppo di endpoint di rete serverless e il server di anteprima come servizio.
    3. Fai clic su Crea.
  6. Modifica altre impostazioni in base alle tue esigenze o mantieni i valori predefiniti e fai clic su Crea.

Passaggio 3: aggiungi una nuova regola e aggiorna il controllo in entrata

Per aggiungere una regola per il nuovo URL host e aggiornare il controllo in entrata:

  1. Apri la pagina Regole host e percorso.
  2. Aggiungi una nuova regola in cui:
    • L'host è il nuovo URL: preview.sgtm.example.com
    • Il percorso è: /*
    • Il backend è: preview-backend-service
  3. Fai clic sul pulsante Aggiorna per eseguire nuovamente il deployment del bilanciatore del carico.
  4. Tornando in Cloud Run, apri il server di anteprima e seleziona la scheda Networking.
  5. Modifica il Controllo Ingress in Interno e seleziona Consenti il traffico dai bilanciatori del carico delle applicazioni esterni in modo che non sia accessibile pubblicamente.

Risultato: l'architettura del server ora dovrebbe essere simile alla Figura 3, in cui le richieste di traffico sono tutte indirizzate al server di tagging e il server di tagging è in grado di inoltrare le richieste al server di anteprima.

Routing basato su host

Figura 3: utilizzo del routing basato su host.

Controlla la configurazione

Per verificare la configurazione:

  1. Apri Google Tag Manager.
  2. Apri il contenitore del server.
  3. Fai clic su Amministrazione > Impostazioni contenitore e imposta l'URL del contenitore del server sull'URL del server di anteprima.
  4. Chiudi la finestra e visualizza l'anteprima dello spazio di lavoro. Si apre la finestra di debug. Quando navighi nel sito web, gli eventi dovrebbero essere visualizzati nella finestra di debug.