Web sitenizi dünya çapında kullanıma sunmak için tüm hazırlıkları tamamladınız. Ancak sitenizi yayınladıktan birkaç gün sonra, farklı konumlardaki kullanıcılar uzun yükleme sürelerinden şikâyet etmeye başladı.
Kullanıcılarınızı kaybetmekten endişe ediyor ve ne yapacağınızı bilmiyor musunuz? Endişelenmeyin! İşte tam da bu noktada Amazon CloudFront fark yaratıyor.
Amazon CloudFront, web sitenizin performansını artırmak için kullanabileceğiniz bir içerik dağıtım ağı (CDN) web hizmetidir. HTML, CSS, JavaScript dosyaları, görseller, uygulamalar ve API’ler gibi statik ve dinamik web içeriklerini dünya genelindeki müşterilere düşük gecikme süresi ve yüksek aktarım hızıyla güvenli bir şekilde sunmanızı sağlar.
Amazon CloudFront, dünya genelinde konumlanmış bir uç nokta (edge location) ağına ve içerikleri kullanıcılara en yakın veya en iyi performansı sağlayan konumdan ulaştıran bir teknolojiye sahiptir. Amazon CloudFront üzerinden sunduğunuz bir içeriği kullanıcı talep ettiğinde istek, en düşük gecikme süresini sağlayan uç noktaya yönlendirilir. Böylece içerik, mümkün olan en iyi performansla kullanıcıya ulaştırılır.
Bugün, işlevleri kullanarak uç noktada özelleştirme yapmayı öğreneceğiz. Haydi başlayalım!
Amazon CloudFront dağıtımlarınızın HTTP isteklerini ve yanıtlarını nasıl işlediğini değiştirmek için kendi kodunuzu yazabilirsiniz. Bu kodlar, gecikme süresini en aza indirmek amacıyla kullanıcılarınıza yakın konumlarda çalışır. Sunucuları veya başka bir altyapıyı yönetmeniz gerekmez.
Bu kodlara uç nokta işlevleri (edge functions) denir. Bunları yazmanın ve dağıtımlara bağlamanın iki farklı yolu vardır. Ancak bu yazıda yalnızca Amazon CloudFront Functions üzerinde duracağız.
Amazon CloudFront Functions, yüksek ölçekli ve gecikmeye duyarlı özelleştirmeler için tasarlanmış hafif JavaScript işlevleridir. Milisaniyenin altında başlatma süreleri sunar ve saniyede milyonlarca isteği işleyebilir.
Amazon CloudFront’un yerleşik bir özelliği olan CloudFront Functions, kodunuzu doğrudan Amazon CloudFront içerisinde yazmanıza, test etmenize ve dağıtmanıza olanak tanır.
Amazon CloudFront Functions’ın yeteneklerini daha iyi anlamak ve Lambda@Edge’den farklarını görmek için aşağıdaki tabloyu inceleyebilirsiniz.
Özellik | Amazon CloudFront Functions | Lambda@Edge |
|---|---|---|
Programlama dilleri | JavaScript (ECMAScript 5.1 uyumlu) | Node.js ve Python |
Olay kaynakları | Kullanıcı isteği (Viewer request), kullanıcı yanıtı (Viewer response) | Kullanıcı isteği, kullanıcı yanıtı, kaynak sunucu isteği (Origin request), kaynak sunucu yanıtı (Origin response) |
Ölçek | Saniyede 10.000.000 veya daha fazla istek | Bölge başına saniyede 10.000’e kadar istek |
İşlevin çalışma süresi | Milisaniyenin altında | Kullanıcı isteği ve yanıtı için 5 saniyeye kadar; kaynak sunucu isteği ve yanıtı için 30 saniyeye kadar |
Maksimum bellek | 2 MB | 128–3.008 MB |
İşlev kodu ve dahil edilen kütüphaneler için maksimum boyut | 10 KB | Kullanıcı isteği ve yanıtı için 1 MB; kaynak sunucu isteği ve yanıtı için 50 MB |
Ağ erişimi | Hayır | Evet |
Dosya sistemi erişimi | Hayır | Evet |
İstek gövdesine erişim | Hayır | Evet |
Coğrafi konum ve cihaz verilerine erişim | Evet | Kullanıcı isteğinde hayır; kaynak sunucu isteği, kaynak sunucu yanıtı ve kullanıcı yanıtında evet |
Tamamen Amazon CloudFront içinde geliştirme ve test | Evet | Hayır |
İşlev günlükleri ve metrikleri | Evet | Evet |
Fiyatlandırma | Ücretsiz kullanım katmanı mevcuttur; istek başına ücretlendirilir. | Ücretsiz kullanım katmanı yoktur; istek ve işlevin çalışma süresi üzerinden ücretlendirilir. |
Amazon CloudFront Functions, hafif ve kısa sürede tamamlanan işlemler için idealdir. Yaygın kullanım alanları şunlardır:
HTTP başlıkları, istek veya yanıt sırasında eklenebilir, değiştirilebilir ya da silinebilir. Örneğin, mevcut değilse yanıta Access-Control-Allow-Origin başlığını ekleyebilirsiniz.
CloudFront-Viewer-Country başlığını kullanarak belirli bir ülkeden gelen ziyaretçileri o ülkeye özel bir URL’ye yönlendirebilirsiniz.
JWT ve HMAC gibi kullanıcı tarafından oluşturulan belirteçleri doğrulayabilirsiniz. Belirteç geçerli değilse işlev bir hata yanıtı oluşturur.
Daha verimli bir önbellek anahtarı oluşturmak ve önbellek isabet oranını artırmak için HTTP isteklerine ait başlıklar, sorgu dizeleri ve çerezler gibi özellikleri dönüştürebilirsiniz.
Amazon CloudFront Functions hakkında yeterince bilgi edindik. Şimdi kullanıcı isteklerini ülkelerine göre nasıl yönlendirebileceğimize bakalım. Haydi başlayalım!
Dünya çapında ürün satan bir e-ticaret siteniz olduğunu varsayalım. Farklı ülkelerden gelen müşteriler web sitenizi ziyaret ediyor ve fiyatların ABD doları cinsinden gösterildiği aynı varsayılan sayfayla karşılaşıyor.
Bu durum, ABD doları kullanmayan müşterilerin kafasını karıştırabilir. Kullanıcılar genellikle fiyatları kendi para birimlerinde görerek ürünlerin maliyetini daha kolay anlamak ister.
Aşağıda, AWS Amazon CloudFront Functions kullanarak kullanıcıları ülkelerine özel URL’lere yönlendirmek için izleyebileceğiniz adım adım bir rehber yer alıyor.
Amazon CloudFront Functions kullanabilmek için öncelikle web siteniz için bir Amazon CloudFront dağıtımı oluşturmanız gerekir. Bu işlemi AWS Yönetim Konsolu veya AWS komut satırı arayüzü (CLI) üzerinden gerçekleştirebilirsiniz.
Bir dağıtım oluşturmak için kaynak sunucuya (origin) ihtiyacınız vardır. Kaynak sunucu, içeriğinizin orijinal sürümünü sakladığınız konumdur. Dağıtım bir istek aldığında, talep edilen dosyaları almak için kaynak sunucuya yönelir.
Kaynak sunucunuz olarak Amazon S3 bucket’larını, HTTP sunucularını veya bunların farklı kombinasyonlarını kullanabilirsiniz.
Bu örnekte, statik web sitesi barındırma özelliği etkinleştirilmiş bir Amazon S3 bucket’ı kullanacağım. Dağıtımı oluşturmak için distribution.json adlı bir dağıtım yapılandırma dosyası hazırlamanız gerekir.
Örnek yapılandırma dosyası:
{
"CallerReference": "cf-cli-distribution",
"Comment": "myownbucketforblogpost",
"Origins": {
"Quantity": 1,
"Items": [
{
"Id": "myownbucketforblogpost",
"DomainName": "http://myownbucketforblogpost.s3-website-eu-west-1.amazonaws.com",
"S3OriginConfig": {
"OriginAccessIdentity": ""
}
}
]
},
"DefaultCacheBehavior": {
"TargetOriginId": "myownbucketforblogpost",
"ViewerProtocolPolicy": "redirect-to-https",
"TrustedSigners": {
"Quantity": 0,
"Enabled": false
},
"ForwardedValues": {
"Cookies": {
"Forward": "all"
},
"Headers": {
"Quantity": 0
},
"QueryString": false,
"QueryStringCacheKeys": {
"Quantity": 0
}
},
"DefaultTTL": 86400,
"MinTTL": 3600
},
"Enabled": true
}Artık yeni bir dağıtım oluşturmak için aşağıdaki komutu kullanabilirsiniz:
aws CloudFront create-distribution --distribution-config file://distribution.jsonAmazon CloudFront dağıtımınızı kurduktan sonra yönlendirme mantığını uygulayacak bir Amazon CloudFront Function oluşturabilirsiniz.
İşlevleri AWS Yönetim Konsolu üzerinden oluşturabilir veya JavaScript ile kod yazıp kodu Amazon CloudFront’a yükleyebilirsiniz.
Aşağıda, kullanıcıları bulundukları ülkeye göre ülkeye özel bir URL’ye yönlendiren bir işlev örneği verilmiştir.
Öncelikle yukarıdaki örneği kullanarak function.js adlı bir dosya oluşturun. Ardından yeni bir işlev oluşturmak için şu komutu çalıştırın:
aws cloudfront create-function \
--name http-header-manipulation \
--function-config Comment="Http Header Manipulation",Runtime="CloudFront-js-1.0" \
--function-code fileb://function.jsHer şey yolunda giderse oluşturduğunuz işlevi açıklayan bir çıktı alırsınız.
Bu işlev, kullanıcılardan gelen isteklerdeki CloudFront-Viewer-Country başlığını kontrol ederek kullanıcının hangi ülkeden geldiğini belirler.
Kullanıcı Türkiye’den geliyorsa https://“host”/tr/index.html adresine yönlendirilir.
Kullanıcı ABD’den geliyorsa https://“host”/us/index.html adresine yönlendirilir.
Kullanıcı başka bir ülkeden geliyorsa varsayılan ana sayfayı görür.
İhtiyacınıza göre daha fazla ülke ekleyebilirsiniz.
İşlevi oluşturduktan sonra yayımlamanız ve ilk adımda oluşturduğunuz dağıtımla ilişkilendirmeniz gerekir.
Öncelikle yeni oluşturduğunuz işlevi LIVE aşamasına yayımlamalısınız. İşlevi yayımlamazsanız dağıtımınızla ilişkilendiremezsiniz.
Bunun için AWS CLI üzerinden aşağıdaki komutu kullanabilirsiniz:
aws CloudFront publish-function \
--name ExampleFunction \
--if-match ETVXYZEXAMPLEBurada:
--name, yayımladığınız işlevin adıdır.
--if-match, yayımladığınız işlevin ETag değeridir.
ETag değerini öğrenmek için aws CloudFront describe-function komutunu kullanabilirsiniz.
İşlevi başarıyla yayımladıktan sonra mevcut bir önbellek davranışıyla (cache behavior) ilişkilendirebilirsiniz. Bunun için önce ilişkilendirme yapmak istediğiniz dağıtımın yapılandırmasını almanız gerekir.
Aşağıdaki komutu kullanabilirsiniz:
aws CloudFront get-distribution-config \
--id DistributionID \
--output yaml > dist-config.yaml--id, işlevi ilişkilendirmek istediğiniz dağıtımın kimliğidir.
Bu komutu çalıştırdığınızda doğrudan bir çıktı görüntülenmez. Bunun yerine sonuçlar dist-config.yaml adlı bir dosyaya yazılır.
Oluşturduğunuz dist-config.yaml dosyasını açın ve aşağıdaki değişiklikleri yapın:
ETag alanını IfMatch olarak yeniden adlandırın. Alanın değerini değiştirmeyin.
Önbellek davranışında FunctionAssociations adlı nesneyi bulun. Bu örnekte olay türü viewer-request olmalıdır; bu değeri değiştirmeyin. FunctionARN alanının değerini, ilişkilendirmek istediğiniz işlevin Amazon Kaynak Adı (ARN) ile değiştirin.
İşlevin ARN değerini aşağıdaki komutla bulabilirsiniz:
aws CloudFront list-functionsDeğişiklikleri yaptıktan sonra dosyayı kaydedin.
Dağıtımı güncellemek için şu komutu çalıştırabilirsiniz:
aws CloudFront update-distribution \
--id DistributionID \
--cli-input-yaml file://dist-config.yamlKomut başarıyla çalıştığında güncellenen dağıtımı açıklayan bir çıktı alırsınız.
İşlevi yayımlayıp dağıtımla ilişkilendirdikten sonra doğru çalıştığını doğrulamak isteyebilirsiniz.
Bunun için aşağıdaki örnekte gösterildiği gibi test-function CLI komutunu kullanabilirsiniz:
aws CloudFront test-function \
--if-match EXXXXXXXXXXXX \
--name your-function-name \
--event-object fileb://test-object.jsonKomutta yer alan parametreler şunlardır:
--if-match: Test ettiğiniz işlevin mevcut sürümüne ait ETag değeridir.
--name: Test ettiğiniz işlevin adıdır.
--event-object: İşlevi test etmek için kullanılan olay nesnesidir.
Örnek olay nesnesi:
{
"version": "1.0",
"context": {
"eventType": "viewer-request"
},
"viewer": {
"ip": "0.0.0.0"
},
"request": {
"method": "GET",
"uri": "/index.html",
"querystring": {
"test": {
"value": "true"
},
"arg": {
"value": "val1",
"multivalue": [
{
"value": "val1"
},
{
"value": "val2"
}
]
}
},
"headers": {
"host": {
"value": "www.example.com"
},
"accept": {
"value": "text/html",
"multivalue": [
{
"value": "text/html"
},
{
"value": "application/xhtml+xml"
}
]
},
"CloudFront-viewer-country": {
"value": "US"
}
},
"cookies": {
"id": {
"value": "CookeIdValue"
},
"loggedIn": {
"value": "false"
}
}
}
}İşlev doğru şekilde yapılandırılmışsa aşağıdakine benzer bir yanıt görmelisiniz:
{
"TestResult": {
"FunctionSummary": {
"Name": "redirect-based-on-country",
"Status": "DEPLOYED",
"FunctionConfig": {
"Comment": "",
"Runtime": "CloudFront-js-1.0"
},
"FunctionMetadata": {
"FunctionARN": "arn:aws:CloudFront::511186633739:function/redirect-based-on-country",
"Stage": "DEVELOPMENT",
"CreatedTime": "2023-06-25T15:23:36.004000+00:00",
"LastModifiedTime": "2023-06-25T15:23:51.059000+00:00"
}
},
"ComputeUtilization": "28",
"FunctionExecutionLogs": [],
"FunctionErrorMessage": "",
"FunctionOutput": "{\"response\":{\"headers\":{\"location\":{\"value\":\"https://www.example.com/us/index.html\"}},\"statusDescription\":\"Found\",\"cookies\":{},\"statusCode\":302}}"
}
}Gördüğünüz gibi yönlendirme URL’si, JSON nesnesi içindeki FunctionOutput alanında yer alır.
Amazon CloudFront Functions hakkında bilgi edindik. Şimdi sıra sizde: öğrendiklerinizi kendi ortamınızda denemeyi unutmayın!
Mert, AWS sertifikalı bir Developer ve bulut teknolojileri meraklısıdır. Bilgisayar bilimlerine olan tutkusuyla, en yeni teknolojileri kullanarak yenilikçi çözümler sunmaktadır.
Teknoloji kullanımımız, çözümlerimiz ve rehberlerimizle ilgili en son güncellemeleri ve makaleleri keşfedin.
Size daha iyi bir deneyim sunmak için çerez kullanıyoruz.
Kişiselleştirilmiş içerikle size daha iyi bir deneyim sunmak için çerezleri kullanıyoruz.
Çerezler, ziyaret ettiğiniz web siteleri tarafından bilgisayarınıza gönderilen ve saklanan küçük dosyalardır. Bir sonraki ziyaretinizde tarayıcınız çerezi okuyarak bilgileri, çerezi oluşturan web sitesine veya öğeye iletir.
ㅤㅤㅤㅤㅤㅤ
Çerezler, web sitemizi her ziyaret ettiğinizde sizi otomatik olarak tanımamıza yardımcı olur, böylece deneyiminizi kişiselleştirebilir ve size daha iyi hizmet sunabiliriz.

