Bu kılavuz, sunucu tarafı etiketleme için Cloud Run'ı kullanan ve özel önizleme sunucusu oluşturmak isteyen geliştiriciler içindir.
Sunucu tarafı etiketleme, etiketleme değişikliklerini uygulamadan önce önizleme ve hata ayıklama modunda önizlemenize olanak tanır. Bu, etiketlerinizin amaçlandığı şekilde çalıştığından emin olmak için geliştirme iş akışının kritik bir parçasıdır. Bu özelliği etkinleştirmek için iki Cloud Run dağıtımı gerekir: biri etiketleme sunucusu, diğeri ise önizleme sunucusu için. Bu kılavuzda, iki sunucunun nasıl iletişim kurduğu ve bunları kurumsal bir ortamda nasıl yapılandırabileceğiniz hakkında daha fazla bilgi verilmektedir.
Genel Bakış
Sunucu tarafı etiketlemeyi Cloud Run'a dağıtırken yük dengeleyiciyle veya yük dengeleyici olmadan dağıtabilirsiniz. Çok bölgeli dağıtımlar için trafiği en yakın örneğe yönlendirmek üzere bir yük dengeleyiciye ihtiyacınız vardır.
Yük dengeleyici olmadan

Şekil 1: Yük dengeleyici olmadan dağıtım.
Yük dengeleyiciyle

Şekil 2: Yük dengeleyiciyle dağıtım.
Her iki dağıtımda da hem önizleme sunucusu hem de üretim etiketleme ortamı için giriş noktası aynı URL'dir (ör. sgtm.example.com). Etiketleme sunucusu, önizleme sunucusunun URL'sini temsil eden PREVIEW_SERVER_URL adlı bir ortam değişkeniyle dağıtılır.
tagmanager.google.com adresini ziyaret edip önizleme modunu açtığınızda Etiket Yöneticisi, sgtm.example.com?id=[gtm_server_id]>m_auth=[auth_id]>m_preview=[env_id] adresine gider ve bir çerez ayarlar. Ardından hedef web sitesini keşfetmek için aynı tarayıcıyı kullandığınızda sgtm.example.com adresine gönderilen istekler de çerezi yönlendirir. Çerez sayesinde, etiketleme sunucusu bunların sizin etkinlikleriniz olduğunu bilir. Bu nedenle, etkinliklerinizi yalnızca görüntülemeniz ve sorun gidermeniz için önizleme sunucusuna yönlendirir.
Etiketleme sunucusu, PREVIEW_SERVER_URL ortam değişkeninde ayarlanan URL'ye HTTP istekleri göndererek bu etkinlikleri yönlendirir.
Herkese açık önizleme sunucuları hakkında
Bu varsayılan davranış için önizleme sunucunuzun herkese açık olması gerekir. Ancak bu durum, hangi altyapının herkese açık olabileceği konusunda kısıtlamaları olan ve genellikle bir yük dengeleyici aracılığıyla ek güvenlik önlemleri uygulayan bazı kuruluşlar için sorun teşkil eder. Yük dengeleyici size şunları sağlar:
- Şifreleme paketlerini kısıtlamak için SSL politikaları gibi özellikler üzerinde daha fazla kontrol.
- Web uygulaması güvenlik duvarı (WAF) veya dağıtılmış hizmet reddi (DDoS) için Cloud Armor ile yerel entegrasyon.
- Gelişmiş trafik yönetimi özellikleri.
Önizleme sunucunuzu yük dengeleyiciden geçirme
Özel önizleme sunucusu oluşturmak için yük dengeleyici üzerinden ek bir alt alan adıyla ana makine tabanlı yönlendirme kullanın. Bu kılavuzun geri kalanında, önizleme sunucunuzu yük dengeleyici üzerinden nasıl yönlendireceğiniz açıklanmaktadır.
Ön koşullar
- Etiketleme sunucusu, yük dengeleyicinin arkasında Cloud Run'da dağıtılır.
- Google Cloud projesine erişim.
- Önizleme sunucusu için yeni bir alt alan adına erişim (ör.
preview.sgtm.example.com).
1. adım: Ortam değişkenini yeni bir alt alanla güncelleyin
Yeni önizleme sunucusu alanını kullanmak için sunucu tarafı etiketleme sunucusu ortam değişkenini PREVIEW_SERVER_URL güncelleyin:
- Cloud Run'ı açın.
- Etiketleme sunucusunu seçin.
- Düzenle ve Yeni düzeltmeyi dağıt'ı tıklayın.
- Değişkenler ve sırlar sekmesindeki Container'lar bölümünde,
PREVIEW_SERVER_URLdeğerini yeni alan adıyla değiştirin. Örneğin:preview.sgtm.example.com.
2. adım: Mevcut yük dengeleyiciyi ana makine tabanlı yönlendirme kullanacak şekilde yapılandırın
Mevcut yük dengeleyiciyi yapılandırmak için ana makine tabanlı yönlendirmeyi kullanın ve trafiği doğru sunucuya gönderin:
- Cloud Run'da Yük dengeleme sayfasını açın ve yük dengeleyicinizin adını tıklayın.
- Düzenle düğmesini tıklayın.
- Backend configuration (Arka uç yapılandırması) sayfasını tıklayın ve Backend services and backend buckets (Arka uç hizmetleri ve arka uç paketleri) açılır menüsünü açın.
- Arka uç hizmeti oluştur'u tıklayın ve aşağıdaki adımları tamamlayın:
- İşleme uygun bir ad verin (ör.
preview-backend-service). - Arka uç türü olarak Sunucusuz ağ uç noktası grubu'nu seçin.
- İşleme uygun bir ad verin (ör.
- Arka uç bölümünde yeni bir sunucusuz ağ uç noktası grubu oluşturun ve aşağıdakileri tamamlayın:
- Önizleme sunucusunun barındırıldığı bölgeyi seçin ve sunucuya bir ad verin.
- Sunucusuz ağ uç noktası grubu türü olarak Cloud Run'ı, hizmet olarak da önizleme sunucusunu seçin.
- Oluştur'u tıklayın.
- Diğer ayarları gerektiği şekilde değiştirin veya varsayılan değerleri koruyup Oluştur'u tıklayın.
3. adım: Yeni bir kural ekleyin ve giriş kontrolünü güncelleyin
Yeni ana makine URL'si için bir kural eklemek ve giriş kontrolünü güncellemek için:
- Ana makine ve yol kuralları sayfasını açın.
- Aşağıdaki koşulların geçerli olduğu yeni bir kural ekleyin:
- Ana makine, yeni URL'dir:
preview.sgtm.example.com - Yol:
/* - Arka uç:
preview-backend-service
- Ana makine, yeni URL'dir:
- Yük dengeleyiciyi yeniden dağıtmak için Güncelle düğmesini tıklayın.
- Cloud Run'a geri dönün, önizleme sunucusunu açın ve Ağ sekmesini seçin.
- Giriş kontrolünü Dahili olarak değiştirin ve herkese açık olarak erişilememesi için Harici uygulama yük dengeleyicilerinden gelen trafiğe izin ver'i işaretleyin.
Sonuç: Sunucu mimariniz artık Şekil 3'teki gibi olmalıdır. Burada trafik isteklerinin tamamı etiketleme sunucusuna yönlendirilir ve etiketleme sunucusu, istekleri önizleme sunucusuna iletebilir.

Şekil 3: Ana makine tabanlı yönlendirmeyi kullanma.
Yapılandırmanızı kontrol edin
Yapılandırmanızı kontrol etmek için:
- Google Etiket Yöneticisi'ni açın.
- Sunucu kapsayıcınızı açın.
- Yönetici > Kapsayıcı ayarları'nı tıklayın ve sunucu kapsayıcısı URL'sini etiketleme sunucusu URL'sine ayarlayın.
- Pencereyi kapatın ve çalışma alanını önizleyin. Hata ayıklama penceresi açılır. Web sitenizde gezinirken etkinlikleriniz hata ayıklama penceresinde görünmelidir.