הגדרת שרת תצוגה מקדימה פרטי

המדריך הזה מיועד למפתחים שמשתמשים ב-Cloud Run לתיוג בצד השרת ורוצים להגדיר שרת בתצוגה מקדימה פרטית.

תיוג בצד השרת מאפשר לצפות בתצוגה מקדימה של שינויים בתיוג במצב תצוגה מקדימה וניפוי באגים לפני שמחילים אותם. זהו חלק קריטי בתהליך העבודה של הפיתוח, שנועד לוודא שהתגים פועלים כמצופה. כדי להפעיל את היכולת הזו, צריך פריסה של שני שירותי Cloud Run: אחד לשרת תיוג ואחד לשרת תצוגה מקדימה. במדריך הזה מוסבר איך שני השרתים מתקשרים ואיך אפשר להגדיר אותם בסביבה ארגונית.

סקירה כללית

כשפורסים תיוג בצד השרת ב-Cloud Run, אפשר לפרוס אותו עם מאזן עומסים או בלי. בפריסות בכמה אזורים, צריך מאזן עומסים כדי להפנות את התעבורה למופע הקרוב ביותר.

ללא מאזן עומסים

איור 1: פריסה ללא מאזן עומסים.

עם מאזן עומסים

איור 2: פריסה עם מאזן עומסים.

בשני הפריסות, נקודת הכניסה גם לשרת התצוגה המקדימה וגם לסביבת התיוג של הייצור היא אותה כתובת URL (לדוגמה, sgtm.example.com). שרת התיוג נפרס עם משתנה סביבה שנקרא PREVIEW_SERVER_URL, שמייצג את כתובת ה-URL של שרת התצוגה המקדימה.

כשנכנסים לכתובת tagmanager.google.com ופותחים את מצב התצוגה המקדימה, מערכת Tag Manager עוברת לכתובת sgtm.example.com?id=[gtm_server_id]&gtm_auth=[auth_id]&gtm_preview=[env_id] ומגדירה קובץ Cookie. כשמשתמשים באותו דפדפן כדי להיכנס לאתר היעד, הבקשות שנשלחות אל sgtm.example.com מעבירות גם את קובץ ה-Cookie. בגלל הקובץ הקוקי, שרת התיוג יודע שאלה האירועים שלכם, ולכן הוא מעביר רק את האירועים שלכם לשרת התצוגה המקדימה כדי שתוכלו לראות אותם ולפתור בעיות.

שרת התיוג מעביר את האירועים האלה על ידי שליחת בקשות HTTP לכתובת ה-URL שהוגדרה במשתנה הסביבה PREVIEW_SERVER_URL.

מידע על שרתי תצוגה מקדימה שפונים לציבור

כדי להשתמש בהתנהגות ברירת המחדל הזו, שרת התצוגה המקדימה צריך להיות ציבורי. עם זאת, יש ארגונים שזו בעיה מבחינתם, כי יש להם הגבלות לגבי התשתית שיכולה להיות חשופה לציבור, ובדרך כלל הם אוכפים אמצעי אבטחה נוספים באמצעות איזון עומסים. מאזן עומסים מספק לכם:

• שליטה רבה יותר בתכונות כמו מדיניות SSL להגבלת חבילות הצפנה.
• שילוב מקורי עם Cloud Armor לחומת אש ליישומי אינטרנט (WAF) או למניעת שירות מבוזרת (DDoS).
• יכולות מתקדמות לניהול תעבורת נתונים.

הפניית שרת התצוגה המקדימה דרך מאזן עומסים

כדי ליצור שרת תצוגה מקדימה פרטית, משתמשים בניתוב מבוסס-מארח דרך איזון העומסים עם תת-דומיין נוסף. בהמשך המדריך מוסבר איך להפנות את שרת התצוגה המקדימה דרך מאזן עומסים.

דרישות מוקדמות

• שרת התיוג נפרס ב-Cloud Run מאחורי מאזן עומסים.
• גישה לפרויקט בענן ב-Google Cloud.
• גישה לתת-דומיין חדש לשרת התצוגה המקדימה, לדוגמה, preview.sgtm.example.com.

שלב 1: מעדכנים את משתנה הסביבה עם תת-דומיין חדש

כדי להשתמש בדומיין החדש של שרת התצוגה המקדימה, צריך לעדכן את משתנה הסביבה של השרת PREVIEW_SERVER_URL בתיוג בצד השרת:

1. פותחים את Cloud Run.
2. בוחרים את שרת התיוג.
3. לוחצים על עריכה ואז על פריסת גרסה חדשה.
4. בכרטיסייה Variables and secrets (משתנים וסודות), בקטע Containers (מאגרי תגים), משנים את PREVIEW_SERVER_URL לדומיין החדש. לדוגמה: preview.sgtm.example.com.

שלב 2: הגדרת מאזן העומסים הקיים לשימוש בניתוב מבוסס-מארח

כדי להגדיר את מאזן העומסים הקיים, משתמשים בניתוב מבוסס-מארח ושולחים תעבורה לשרת הנכון:

1. ב-Cloud Run, פותחים את הדף Load balancing ולוחצים על השם של מאזן העומסים.
2. לוחצים על הלחצן עריכה.
3. לוחצים על הדף Backend configuration (הגדרת קצה עורפי) ופותחים את התפריט הנפתח Backend services and backend buckets (שירותי קצה עורפי ודלי קצה עורפי).
4. לוחצים על יצירת שירות לקצה העורפי ומבצעים את הפעולות הבאות:
   1. נותנים לו שם מתאים (לדוגמה, preview-backend-service).
   2. בוחרים את סוג ה-בק-אנד כקבוצה של נקודות קצה ברשת בלי שרת.
5. בקטע Backend (בק-אנד), יוצרים קבוצת נקודות קצה (endpoint) חדשה ברשת בלי שרת (serverless) ומבצעים את הפעולות הבאות:
   1. נותנים לו שם ובוחרים את האזור שבו שרת התצוגה המקדימה מאוחסן.
   2. בוחרים באפשרות Cloud Run בתור הסוג של קבוצת נקודות הקצה ברשת ללא שרת, ואת שרת התצוגה המקדימה בתור השירות.
   3. לוחצים על יצירה.
6. משנים הגדרות אחרות לפי הצורך או משאירים את הגדרות ברירת המחדל ולוחצים על Create.

שלב 3: הוספת כלל חדש ועדכון של שליטה בתעבורת נתונים נכנסת (ingress)

כדי להוסיף כלל לכתובת ה-URL החדשה של המארח ולעדכן את שליטה בתעבורת נתונים נכנסת (ingress):

1. פותחים את הדף כללי מארח ונתיב.
2. מוסיפים כלל חדש שבו:
   • המארח הוא כתובת ה-URL החדשה: preview.sgtm.example.com
   • הנתיב הוא: /*
   • הקצה העורפי הוא: preview-backend-service
3. לוחצים על הלחצן עדכון כדי לפרוס מחדש את מאזן העומסים.
4. חוזרים אל Cloud Run, פותחים את שרת התצוגה המקדימה ובוחרים בכרטיסייה Networking (רשת).
5. משנים את שליטה בתעבורת נתונים נכנסת (ingress) לפנימית ומסמנים את התיבה אפשר תעבורת נתונים ממאזני עומסים של אפליקציות (ALB) חיצוניות כדי שהגישה לא תהיה ציבורית.

תוצאה: ארכיטקטורת השרת שלכם צריכה להיראות עכשיו כמו איור 3, שבו כל בקשות התנועה מנותבות לשרת התיוג, ושרת התיוג יכול להעביר בקשות לשרת התצוגה המקדימה.

איור 3: שימוש בניתוב מבוסס-מארח.

הערה: אי אפשר להשתמש בניתוב מבוסס-נתיב, למשל מיפוי של /gtm/debug ל-preview-backend-service. באמצעות השיטה הזו אפשר לראות את חלון ניפוי הבאגים, אבל אי אפשר לראות את האירועים שמועברים. הסיבה לכך היא ששרת התיוג מעביר אירועים לנתיבים אחרים, והאירועים האלה לא יכולים להגיע ליעד הסופי הנכון. המארח מספק הפרדה ברורה בין שני היעדים.

בדיקת ההגדרות

כדי לבדוק את ההגדרה:

1. פותחים את Google Tag Manager.
2. פותחים את מאגר התגים בצד השרת.
3. לוחצים על Admin > Container settings (ניהול > הגדרות מאגר התגים) ומגדירים את כתובת ה-URL של מאגר התגים בצד השרת לכתובת ה-URL של שרת התיוג.
4. סוגרים את החלון ומציגים תצוגה מקדימה של סביבת העבודה. חלון ניפוי הבאגים ייפתח. במהלך הניווט באתר, האירועים אמורים להופיע בחלון ניפוי הבאגים.

קישורים רלוונטיים

• הגדרת תיוג בצד השרת באמצעות Cloud Run
• הפעלת התנהגות ספציפית לאזור בתיוג בצד השרת