App Engine ile sunucu tarafı etiketleme ayarlama

Bu kılavuzda aşağıdakilerin nasıl yapılacağı açıklanmaktadır:

• Google Cloud Platform (GCP) App Engine'de bir etiketleme sunucusu sağlayın.
• Canlı trafiği yönetmek için etiketleme sunucusunu yeni sürüme geçirin.
• Google Etiket Yöneticisi kapsayıcınızı çalıştıran sunucuların sayısını artırın veya azaltın.

Ön koşullar

1. Bir GCP hesabınız olmalıdır. Hesabınız yoksa yeni bir GCP hesabı oluşturun.
2. Bir GCP faturalandırma hesabınız olmalıdır. Hesabınız yoksa GCP faturalandırma hesabı oluşturun (Faturalandırma Hesabı Oluşturucu rolü gerektirir).
3. Proje Oluşturucu ve Faturalandırma Hesabı Kullanıcısı rolüne sahip olmanız gerekir. Rol ekleme hakkında daha fazla bilgi edinin.

Not: Proje sahibi ilk olarak App Engine'i etkinleştirmelidir. Aksi halde etiketleme sunucusunu dağıtırken bir izin hatasıyla karşılaşırsınız. Önceden tanımlanmış App Engine rolleri hakkında daha fazla bilgi edinin.

1. Sunucu temel hazırlığı yapma

App Engine hizmetlerinin temel hazırlığını Google Etiket Yöneticisi'nde otomatik olarak veya Google Cloud'da manuel olarak yapabilirsiniz.

Otomatik Temel Hazırlık Manuel Temel Hazırlık

Lütfen bir temel hazırlık yöntemi seçin

İlk sunucu yapılandırması (testing)

Test yapılandırması, az miktarda test trafiği göndererek ve Etiket Yöneticisi'ndeki Önizleme özelliğini kullanarak ürünü keşfetmek için uygundur. Bu yapılandırma, Standart ortamdaki bir App Engine F1 örnek sınıfıdır ve çoğu durumda ücret ödemeniz gerekmez.

2. App Engine'i üretimde kullanma

production yapılandırmasında her sunucunun maliyeti aylık yaklaşık 40 ABD dolarıdır. Her sunucu, Esnek ortamda 1 vCPU, 0,5 GB bellek, 10 GB disk içeren bir App Engine örneğidir.

App Engine faturalandırmasını ve faturalandırma uyarılarını nasıl yapılandıracağınızı öğrenmek için App Engine maliyetlerini yönetme bölümüne bakın. Faturalandırma uyarısı oluşturmanızı önemle öneririz.

Önerilen üretim ayarları

Sunucu kesintisi durumunda veri kaybı riskini azaltmak için en az 3 sunucu çalıştırmanızı öneririz. Ancak, daha az (veya daha fazla) sunucu çalıştırmayı tercih edebilirsiniz. 3-6 sunucuyu (varsayılan) otomatik ölçeklendirmenin saniyede 50-200 isteği yönetmesini bekleriz. Performans, etiketlerin sayısına ve bu etiketlerin ne yaptığına bağlıdır.

Dikkat: App Engine, varsayılan olarak her isteği günlüğe kaydeder. Sunucu kapsayıcınız her ay çok sayıda isteği işliyorsa (ör. 1 milyondan fazla) App Engine istek günlüğünü devre dışı bırakmanızı öneririz.

Etiketleme sunucunuzu yapılandırmak için:

1. Google Cloud Platform Cloud Shell'i açın.
2. Cloud Shell'de Cloud Platform projesini ayarlayın. project ID ifadesini, daha önce belirttiğiniz GCP projesi kimliğiyle değiştirin:

   gcloud config set project project ID

3. Etiketleme sunucusunu üretim ortamı için yeniden yapılandırmak için aşağıdaki kurulum komut dosyasını çalıştırın. Aşağıdaki görevleri gerçekleştirin:

   bash -c "$(curl -fsSL https://googletagmanager.com/static/serverjs/setup.sh)"

   1. Dağıtım türünü production olarak değiştirin.
   2. Üretim trafiği sağlamak için ek sunucular kurun. En az üç sunucu öneririz.

İsteğe bağlı: App Engine istek günlüğünü devre dışı bırak

Varsayılan olarak App Engine, aldığı her istekle ilgili bilgileri (ör.istek yolu, sorgu parametreleri vb.) günlüğe kaydeder. Etiketleme sunucunuz aylık çok sayıda isteği ele alıyorsa (ör. 1 milyondan fazla) bu günlük mesajları önemli ölçüde günlük kaydı ücretlerine neden olabilir. Günlük kaydı ücretlerini azaltmak veya ortadan kaldırmak için App Engine istek günlük kaydını devre dışı bırakmanızı öneririz.

App Engine istek günlük kaydını devre dışı bırakmak için:

1. Google Cloud Platform'da Günlük Yönlendirici'yi açın. Kapsayıcı kimliğinizle eşleşen projede olduğunuzdan emin olun:
   
2. Tür: Cloud Logging paketi, Ad: _Default satırı, taşma menüsünü seçin ve ardından Havuzu Düzenle'yi tıklayın.
3. Havuz hedefi bölümünde _Default günlük paketini seçin.

4. Havuza dahil edilecek günlükleri seçin bölümünde yeni bir satır ekleyin. Mevcut dahil etme filtresine aşağıdaki kuralı girin:

   NOT LOG_ID("appengine.googleapis.com/nginx.request") AND NOT
   LOG_ID("appengine.googleapis.com/request_log")
   

5. Yük dengeleyiciden günlük kaydını da devre dışı bırakmak için yeni bir satır ekleyin ve mevcut dahil etme filtresine aşağıdaki kuralı girin:

   NOT LOG_ID("requests")
   

   Not: Bu işlem, sunucu kapsayıcısına gönderilmeyen istekler de dahil olmak üzere yük dengeleyiciden kaydedilen tüm günlük kayıtlarını devre dışı bırakır.

6. Alt kısımdaki Havuzu Güncelle düğmesini tıklayın.

App Engine istekleri artık günlük kaydından hariç tutulacaktır. Yeni isteklerin günlüklerde bulunmadığından emin olmak için Günlük Gezgini'ni kontrol edin.

3. Dağıtımı özel alanınızla eşleme

Varsayılan sunucu tarafı etiketleme dağıtımı bir App Engine alanında barındırılır. Dağıtımı web sitenizin bir alt alanını kullanacak şekilde değiştirmenizi öneririz.

Web sitenizin alt alan adını etiketleme sunucunuzla eşleyin.

4. Google Etiket Yöneticisi'ne sunucu URL'sini ekleme

Artık bir sunucunuz olduğuna göre, Google Etiket Yöneticisi'nin sunucunuzu kullanması gerektiğini bilmesini sağlamanız gerekir.

1. Google Etiket Yöneticisi'ni açın.

2. Etiketleme sunucunuzu işaret etmek istediğiniz sunucu kapsayıcısını tıklayın.

3. Yönetici sekmesi > Kapsayıcı Ayarları'nda sunucu kapsayıcı ayarlarınızı açın.

4. URL Ekle'yi tıklayın ve sunucu URL'nizi yapıştırın.

5. Kaydedin ve çalışma alanınıza dönün.

5. Doğrulama

Etiketleme sunucunuzu oluşturduğunuza göre, beklendiği gibi çalıştığından emin olun. Etiket Yöneticisi çalışma alanınızda, Önizleme düğmesini tıklayın. Önizleme sayfası yüklenirse her şey doğru ayarlanmış demektir.

Birden çok URL'yi önizleme

Birden fazla alanı tek bir etiketleme sunucusuyla eşlediyseniz her URL'nin kapsayıcı ayarlarına eklendiğinden emin olun.

Birden fazla URL sağladıysanız tüm yollar (alan adından sonraki dize) eşleşmelidir.

Çalışmalar	Çalışmıyor
URL 1: example.com/abc URL 2: example2.com/abc	URL 1: example.com/abc URL 2: example2.com/def

Birden fazla URL eklenirse Önizle düğmesinin yanında, önizlenecek URL'yi seçmenize olanak tanıyan bir simge görürsünüz.

Etiketleme sunucusu sürümünü güncelleyin

Not: Etiketleme sunucularınızı Manuel kurulum kılavuzunu veya Cloud Run kurulum kılavuzunu kullanarak hazırladıysanız lütfen burada listelenen talimatları uygulayın.

Yeni etiketleme sunucusu güncellemeleri, güvenlik açığı düzeltmelerini ve yeni özellikleri içeriyor. Etiket Yöneticisi, güncelleme yapmanızı bildirdiğinde her önemli sürüm sürümü için (ör. 1.x.x sürümünden 2.x.x sürümüne yükseltme) en azından etiketleme sunucunuzu güncellemenizi öneririz.

Etiketleme sunucunuzu güncellemek için kurulum komut dosyasını daha önce kullandığınız ayarlarla yeniden çalıştırın. Mevcut ayarlar varsayılan olarak belirlenmiştir.

Etiketleme sunucunuzu güncellemek için:

1. Google Cloud Platform Cloud Shell'i açın.
2. Cloud Shell'de Cloud Platform projesini ayarlayın. project ID ifadesini, daha önce belirttiğiniz GCP projesi kimliğiyle değiştirin:

   gcloud config set project project ID

3. Kurulum komut dosyasını daha önce kullandığınız ayarlarla çalıştırın. Mevcut ayarlar varsayılan olarak belirlenir.

   bash -c "$(curl -fsSL https://googletagmanager.com/static/serverjs/setup.sh)"

Güncellemenin başarılı olduğunu doğrulamak için:

1. Sunucu kapsayıcınızda, Önizleme düğmesini tıklayarak yeni bir hata ayıklama oturumu başlatın ve ayrı bir sekmede istek gönderin.
2. Özet bölümünde Konsol sekmesini seçin ve etiketleme sunucusunu güncellemenizi isteyen herhangi bir mesaj olmadığından emin olun.

Etiket Yöneticisi, etiketleme sunucunuzu başarıyla güncellendikten sonra bir gün içinde etiketleme sunucunuzu güncellemenizi isteyen mesajlar gösterebilir. Ancak önizleme sayfasında etiketleme sunucusu sürümüyle ilgili güncel bir mesaj gösterilir.

Üretim dağıtımı zaman aşımlarında sorun giderme

Etiketleme sunucusunu oluşturmak veya yeniden yapılandırmak için kurulum komut dosyasını çalıştırdığınızda komut dosyası zaman aşımına uğrayabilir. Bu durumun birkaç nedeni olabilir. En yaygın iki sorun şunlardır:

1. Hizmet hesapları yanlış izinlere sahip - Compute Engine ve App Engine hizmet hesapları, üretim dağıtımının dağıtımından ve bakımından sorumludur. Varsayılan olarak, uygun izinlerle önceden yapılandırılırlar. Ancak bazı durumlarda bir kuruluşun politikası hatalı olabilir.

   1. Google Cloud Console'daki sol gezinme çubuğunda IAM ve Yönetici sayfasına gidin.
   2. Compute Engine hizmet hesabını (<project_number>[e-mail]) ve App Engine hizmet hesabını (<project_name>@appspot.gserviceaccount.com) bulun.
   3. Her iki hizmet hesabında da Editor rolüne sahip olunması. Her iki hesapta da Editor rolü yoksa hesabın sağındaki kalem simgesini, mevcut rolün açılır menüsünü yukarı doğru kaydırıp Proje'yi ve ardından Düzenleyici'yi tıklayarak rolü güncelleyin.

2. Yetersiz kota: Üretim dağıtımı, Compute Engine kotasını kullanır. Projede yeterli kota yoksa kaynak sağlamaya çalışırken dağıtım işlemi zaman aşımına uğrayabilir.

   1. Google Cloud Console'da soldaki gezinme çubuğunda bulunan IAM ve Yönetici sayfasına gidin ve ardından sol taraftaki gezinme çubuğunda Kotalar sekmesini tıklayın.
   2. Sayfanın üst kısmına yakın bir yerde Tabloyu filtrele yazan metin kutusunu tıklayın ve Compute Engine API yazın. Tek sonucu tıklayın.
   3. Tüm kota durumlarının sınır dahilinde olduğunu veya yeşil bir onay işaretine sahip olduğunu doğrulayın.
   4. CPU'u bulun ve tıklayın. Mevcut kullanımın ve dağıtılan örnek sayısının dağıtım bölgesi sınırını aşmaya devam edeceğini doğrulayın.