Bu konu, ALB yönlendirme kurallarının nasıl yapılandırılacağına ilişkin örnekler sunar; alan adı ve yol eşleştirme, yeniden yazma ve yönlendirme işlemlerini kapsar.
Yapılandırma örnekleri
Senaryo 1: HTTP'yi HTTPS'ye yönlendirme
Verilerin aktarım sırasında şifrelenmesini sağlamak için HTTP isteklerini HTTPS'ye yönlendirin. Bunu, HTTP dinleyicisine (bağlantı noktası 80) bir yönlendirme kuralı ekleyerek yapabilirsiniz.
Parametre | Açıklama |
Add Condition | Path değerini Exact Match and Wildcard olarak ayarlayın ve |
Action | Redirect to seçeneğini belirleyin.
|
Sonuç: Bir kullanıcı http://www.example.com/page adresine eriştiğinde, tarayıcı otomatik olarak https://www.example.com/page adresine yönlendirilir.
Bu kuralı HTTP dinleyicisinde (bağlantı noktası 80) yapılandırın. Ayrıca, geçerli bir SSL sertifikasıyla ilişkilendirilmiş bir HTTPS dinleyicisinin (bağlantı noktası 443) oluşturulduğundan emin olun. Ön koşullar ve prosedürlerin tamamı için bkz. ALB kullanarak HTTP isteklerini HTTPS'ye yönlendirme .
Senaryo 2: Trafiği yola göre yönlendirme
Tek bir alan adı için farklı yollara sahip istekleri farklı sunucu gruplarına iletebilirsiniz. Örneğin, API isteklerini ve statik varlık isteklerini ayrı arka uçlara iletebilirsiniz.
Kural 1: /api/* için gelen istekleri API sunucu grubuna iletin.
|
|
|
|
|
|
|
|
|
Kural 2: /static/* için gelen istekleri statik varlık sunucu grubuna iletin.
|
|
|
|
|
|
|
|
|
ALB, yönlendirme kurallarını öncelik numaralarına göre sırayla değerlendirir. Daha genel joker karakter kurallarının önce eşleşmesini önlemek için daha özel yol kurallarını (daha düşük öncelik numaralı) daha geniş olanlardan önce yerleştirin. Örneğin,/api/v2/*kuralı,/api/*kuralından daha düşük bir öncelik numarasına sahip olmalıdır.
Senaryo 3: Birden çok alan adını yönlendirme
Tek bir ALB örneğinde birden çok alan adı barındırın ve her alan adı için gelen istekleri ilgili arka uç sunucu grubuna iletin.
Kural 1: www.example.com için gelen istekleri web sunucu grubuna iletin.
|
|
|
|
|
|
|
|
|
Kural 2: api.example.com için gelen istekleri API sunucu grubuna iletin.
|
|
|
|
|
|
|
|
|
Senaryo 4: Yönlendirmeden önce yol ön ekini kaldırma
İsteği arka uca iletmeden önce istek yolundan belirli bir ön eki kaldırın, ancak ön ekin sonrasındaki çok seviyeli yolları yakalamaya devam edin. Örneğin, ALB www.example.com/api/aaa/bbb/... isteklerini ilettiğinde, yoldan /api kısmını kaldırmanız ancak /aaa/bbb/... gibi sonraki çok seviyeli yolları yakalamaya devam etmeniz gerekir.
Yeniden yazma işlemi, yolu ALB içinde dahili olarak değiştirir; istemcinin tarayıcı adres çubuğundaki URL değişmez. Yönlendirme ise istemciye yeni bir URL döndürür ve tarayıcının adres çubuğu yeni URL'ye güncellenir. Yalnızca arka ucun ön ek olmadan yolu alması gerekiyorsa yeniden yazma kullanın. İstemcinin URL değişikliğinden haberdar olması gerekiyorsa yönlendirme kullanın.
Yeniden Yazma
Parametre | Açıklama | |
Add Condition | Domain Name | Değeri Exact Match and Wildcard olarak ayarlayın ve |
Path | Değeri Regex Match | Case-Insensitive olarak ayarlayın ve | |
Action | Rewrite |
|
Forward to | Hedef sunucu grubunu seçin. | |
Yönlendirme
Parametre | Açıklama | |
Add Condition | Domain Name | Değeri Exact Match and Wildcard olarak ayarlayın ve |
Path | Değeri Regex Match | Case-Insensitive olarak ayarlayın ve | |
Action | Redirect to |
|
Sonuç: www.example.com/api/aaa/bbb/... adresine yapılan bir istek için, arka uç sunucusu /aaa/bbb/... yolunu alır.
Senaryo 5: Temel alan adını www'ye yönlendirme
Temel bir alan adından (örneğin example.com) gelen istekleri www.example.com adresine yönlendirin. Bu işlem, daha iyi SEO ve daha kolay yönetim için giriş noktasını birleştirir.
Parametre | Açıklama |
Add Condition | Domain Name değerini Exact Match and Wildcard olarak ayarlayın ve |
Action | Redirect to seçeneğini belirleyin.
|
Sonuç: Bir kullanıcı example.com adresine eriştiğinde, tarayıcı otomatik olarak www.example.com adresine yönlendirilir. Protokol ve bağlantı noktası değişmez.
HTTP isteklerini de HTTPS'ye yönlendirmeniz gerekiyorsa, bu yapılandırmayı Senaryo 1 ile birleştirin.
Senaryo 6: Joker karakterli alan adıyla eşleşme
Tüm alt alan adlarını eşleştirmek ve isteklerini aynı sunucu grubuna iletmek için joker karakterli bir alan adı kullanın.
|
|
|
|
|
|
|
|
|
Sonuç: a.example.com, b.example.com ve tenant1.example.com gibi eşleşen tüm alt alan adlarına gelen istekler aynı sunucu grubuna iletilir.
Belirli bir alt alan adını farklı bir sunucu grubuna iletmek için, o kesin alan adı için bir kural oluşturun ve buna joker karakter kuralından daha düşük bir öncelik numarası verin. ALB, kuralları alan adı eşleşmesinin özgüllüğüne göre değil, öncelik numaralarına göre değerlendirir.
Senaryo 7: HTTP üst bilgisine göre kanarya sürümü yayınlama
Kanarya sürümü yayınlamayı uygulamak için bir HTTP üst bilgisi kullanın. Bu yöntem, belirli bir üst bilgi içeren istekleri yeni sürüm sunucu grubuna iletirken diğer istekleri mevcut sürüm sunucu grubuna iletir.
Kural 1 (Kanarya kuralı, daha yüksek öncelik): X-Canary: true üst bilgisini içeren istekleri yeni sürüm sunucu grubuna iletin.
|
|
|
|
|
|
|
|
|
Kural 2 (Varsayılan kural, daha düşük öncelik): Kanarya üst bilgisini içermeyen istekler mevcut sürüm sunucu grubuna iletilir. Bu, dinleyicinin varsayılan yönlendirme kuralı kullanılarak uygulanabilir.
Sonuç: Bir istemci isteği X-Canary: true üst bilgisini içerdiğinde, trafik yeni sürüm sunucu grubuna iletilir. Bu üst bilgiyi içermeyen istekler mevcut sürüm sunucu grubuna iletilir.
Kanarya trafiğinin önce eşleşmesini sağlamak için kanarya kuralının, varsayılan kuraldan daha düşük bir öncelik numarasına (yani daha yüksek önceliğe) sahip olması gerekir. Çerezlere ve sunucu grubu ağırlıklarına dayalı kanarya sürümü yayınlama yöntemleri hakkında bilgi için bkz. ALB kullanarak kanarya sürümü yayınlama uygulama .
Yönlendirme kurallarında alan adı eşleşmesi
ALB yönlendirme kurallarını öncelik numaralarına göre en düşükten en yükseğe doğru değerlendirir ve eşleşen ilk kuralda durur. Kurallar, alan adı özgüllüğüne göre otomatik olarak sıralanmaz. Bu davranış, kuralları özgüllüğe göre otomatik olarak önceliklendiren CLB'den farklıdır (örneğin, tam eşleşme > daha dar joker karakter > daha geniş joker karakter).
Örneğin, aşağıdaki iki kurala sahip bir dinleyiciyi ele alalım:
|
|
|
|
|
|
|
|
|
www.example.com adresine yapılan bir istek, Kural 2 (tam eşleşme kuralı) yerine Kural 1'i (joker karakter kuralı) eşleştirir çünkü Kural 1 daha düşük bir öncelik numarasına sahiptir.
En iyi uygulama : Daha özel bir kuralın önce değerlendirilmesini sağlamak için ona daha az özel bir kuraldan daha düşük bir öncelik numarası atayın. Örneğin,www.example.comkuralını Öncelik 1'e ve*.example.comkuralını Öncelik 2'ye ayarlayın.
Eşleşme türü | Açıklama |
Tam eşleşme ve joker karakter eşleşmesi |
|
Düzenli ifade eşleşmesi |
|
Yönlendirme kuralı yol eşleşmesi
ALB yol eşleşme kuralları Nginx'ten farklıdır. ALB en uzun ön ek eşleşme ilkesini desteklemez. Örneğin, Nginx location /api gibi yaygın bir yapılandırma için en uzun ön ek eşleme yöntemini kullanır. ALB'de aynı etkiyi elde etmek için bir joker karakter kullanmanız gerekir. Yolu /api/* (tam eşleşme ve joker karakter kombinasyonu) olarak yapılandırabilirsiniz.
Bir dinleyicide hem/api/*hem de/api/v2/*için kurallar varsa,/api/v2/*kuralını/api/*kuralından önce yerleştirmek için ona daha düşük bir kural numarası atamalısınız. Aksi takdirde,/api/*kuralı tüm istekleri önce eşleştirir.
Eşleşme türü | Açıklama |
Tam ve joker karakter eşleşmesi |
|
Düzenli ifade eşleşmesi |
|
Düzenli ifade eşleşme modunda, yoldaki sondaki eğik çizginin (/) eşleşme sonucu üzerinde etkisi vardır. Örneğin, ~^/ws/(.*) düzenli ifadesi yalnızca /ws/ ile başlayan yollarla (örneğin /ws/ ve /ws/abc) eşleşir ve /ws (sonda eğik çizgi olmayan) ile eşleşmez. Hem /ws hem de /ws/ ile başlayan yolları eşleştirmek istiyorsanız ~^/ws(/.*)?$ düzenli ifadesini kullanın.
Yeniden yazma ve yönlendirmeler için gelişmiş yol yapılandırması
Bir yönlendirme koşulunda yolu tanımlamak için düzenli ifade kullanıyorsanız, yeniden yazma veya yönlendirme eyleminin yolunda düzenli ifade değiştirmesi kullanabilirsiniz.
-
Notlar
Yönlendirme koşulundaki düzenli ifadedeki parantezlerle
( )tanımlanan yakalama gruplarının sayısı, yönlendirme eyleminin yeniden yazma veya yönlendirme yolundaki ${n} değişkenlerinin sayısıyla eşleşmelidir.Yönlendirme eylemindeki yeniden yazma veya yönlendirme yolu,
${1},${2}ve${3}değişkenlerinden bir veya daha fazlasını içermelidir. Bu değişkenleri başka karakterlerle değiştirmeyin.Yeniden yazma veya yönlendirme yolunda,
$karakterini yalnızca aşağıdaki değişkenlere başvurmak için kullanın:${host},${path},${port},${protocol}ve${1},${2}ve${3}gibi düzenli ifade yakalama grubu değişkenleri. Diğer değişkenler desteklenmez.
-
Nasıl çalışır
Yol eşleşmesi: İstemci, bir yönlendirme kuralındaki düzenli ifadeyle eşleşen bir istek gönderir.
Çıkarma ve değiştirme: Sistem, parantezlerle
( )tanımlanan ilk üç yakalama grubundan içeriği çıkarır ve bunu${1},${2}ve${3}değişkenlerine kaydeder. Bu değişkenler daha sonra yönlendirme eyleminin yeniden yazma veya yönlendirme yolunda değiştirme için kullanılır.Yol oluşturma: Sistem,
${1},${2}ve${3}değişkenlerini yakalanan değerleriyle değiştirir ve yeniden yazma veya yönlendirme için nihai yolu oluşturur.
No.
Adım
Örnek
1
Bir yönlendirme kuralı için yönlendirme koşulunu ve yönlendirme eylemini yapılandırın.
Yönlendirme koşulundaki yol:
/app/(.)/(.)/settingsYeniden yazma veya yönlendirme eylemi için yol:
/${1}/${2}
2
İstemci, yolla eşleşen bir istek gönderir.
İstemciden gelen istek yolu:
/app/users/profile/settingsYönlendirme koşulunda eşleşen yol:
/app/(.)/(.)/settings
3
Değerleri çıkarın ve değiştirin.
Sistem, yönlendirme koşulu yolundaki iki
(.*)yakalama grubundanusersveprofiledeğerlerini çıkarır ve bunları yönlendirme eylemi için ${1} ve ${2} değişkenlerine kaydeder.${1}değeriusersile değiştirilir.${2}değeriprofileile değiştirilir.
4
Yolu oluşturun.
Arka uç sunucusu tarafından alınan yol:
/users/profile -
Yapılandırma örnekleri
Konsolda yönlendirme kuralları eklerken önceki notlara ve iş akışı açıklamasına bakın.
Örnek 1: Yönlendirme eylemini Rewrite ve Forward to olarak ayarlama
Bu örnek,
/app/users/profile/settingsyolunun/users/profileolarak nasıl yeniden yazılacağını ve ardından isteğin bir arka uç sunucusuna nasıl iletileceğini gösterir./app/(.*)/(.*)/settingsdüzenli ifadesi,usersveprofiledeğerlerini çıkarmak için iki yakalama grubu kullanır. Yeniden yazılan yol daha sonra nihai yolu oluşturmak için/${1}/${2}kullanır.Parametre
Açıklama
Add Condition
Path
Regex Match | Case-Insensitive seçeneğini belirleyin ve
/app/(.)/(.)/settingsdüzenli ifadesini girin.Örneğin, bir istemci
/app/users/profile/settingsyolunu isterse kural eşleşir. Yakalama gruplarıusersveprofiledeğerlerini çıkarır ve bunları sırasıyla${1}ve${2}değişkenlerine kaydeder.Action
Rewrite
Domain Name:
${host}Path:
/${1}/${2}Search:
${query}
Search, URL'nin soru işaretini izleyen kısmıdır. Örneğin,
www.example.com/test/test1?x=1URL'si için Search değerix=1olur.Forward to
Sunucu grubu listesinden hedef sunucu grubunu seçin.
Örnek 2: Yönlendirme eylemini yönlendirmeye ayarlama
Aşağıdaki örnek,
/app/users/profile/settingsyolunu/users/profileadresine yönlendirir. Örnek 1'in aksine, bu yönlendirme 301 durum kodu döndürür ve tarayıcının adres çubuğundaki URL değişir.Parametre
Açıklama
Add Condition
Path
Regex Match | Case-Insensitive seçeneğini belirleyin ve
/app/(.)/(.)/settingsdüzenli ifadesini girin.Örneğin, bir istemci
/app/users/profile/settingsyolunu isterse kural eşleşir. Yakalama gruplarıusersveprofiledeğerlerini çıkarır ve bunları sırasıyla${1}ve${2}değişkenlerine kaydeder.Action
Redirect to
Protocol:
${protocol}Domain Name:
${host}Port:
${port}Path:
/${1}/${2}Search:
${query}Status Code:
301
SSS
Yalnızca bir alan adını yeniden yazma
İstenen alan adını yol ve sorgu dizesini değiştirmeden başka birine yeniden yazmak için kuralı aşağıdaki gibi yapılandırın:
Add Condition: Alan adını orijinal alan adına ayarlayın, örneğin
old.example.com.Action: Yeniden yazmayı seçin. Alan adını yeni alan adına (örneğin
new.example.com), yolu${path}ve sorguyu${query}olarak ayarlayın. Ayrıca, bir sunucu grubu belirtmek için Forward to seçeneğini yapılandırın.
Yola ön ek ekleme
Bir yola ön ek eklemek için (örneğin, /users/list yolunu /v2/users/list olarak yeniden yazma) kuralı aşağıdaki gibi yapılandırın:
Add Condition: Yolu
^/(.*)düzenli ifadesiyle eşleşecek şekilde ayarlayın.Action: Yeniden yazmayı seçin ve yolu
/v2/${1}olarak ayarlayın. Ayrıca, bir sunucu grubu belirtmek için Forward to seçeneğini yapılandırın.
Kuralı yapılandırdıktan sonra, ALB /users/list isteğini /v2/users/list olarak yeniden yazar ve arka uç sunucusuna iletir.
Yol ön ekini kaldırma
Bu konudaki Kullanım durumu 4: Yol ön ekini kaldırdıktan sonra istekleri iletme bölümüne bakın. Bu kullanım durumu, yeniden yazma veya yönlendirme eylemiyle düzenli ifade eşleşmesi kullanarak /api/* gibi bir ön eki kaldırmak için eksiksiz bir yapılandırma örneği sağlar.
Yönlendirme kuralı eşleşmesi ve yönlendirmesinde sorun giderme
Yönlendirme kurallarınız istekleri beklendiği gibi yönlendirmiyorsa aşağıdaki sorun giderme adımlarını uygulayın:
Kural önceliğini kontrol edin: ALB, kuralları öncelik numaralarına göre artan sırada değerlendirir ve ilk eşleşmede durur. Daha geniş bir kural daha düşük bir öncelik numarasına sahipse (ve bu nedenle önce değerlendirilirse), daha yüksek bir öncelik numarasına sahip daha özel bir kural eşleşmez.
Eşleşme türünü kontrol edin: Doğru eşleşme türünü (tam eşleşme, joker karakter veya düzenli ifade) kullandığınızdan emin olun. Örneğin,
/apiiçin tam eşleşme,/api/usersile eşleşmez. Her ikisini de eşleştirmek için/api/*gibi bir joker karakter kullanmanız gerekir.Birden çok koşulu kontrol edin: Tek bir yönlendirme kuralı için birden çok koşul yapılandırırken, farklı türdeki koşullar VE işleciyle birleştirilirken aynı koşul türü için birden çok değer VEYA işleciyle birleştirilir. Daha fazla bilgi için bkz. Dinleyici yönlendirme kurallarını yapılandırma.
Erişim günlüklerini kontrol edin: ALB'nin aldığı istek ayrıntılarının beklentilerinizle eşleştiğini doğrulamak için ALB erişim günlüğündeki
hostverequest_urialanlarını kullanın.
Yeniden yazma ile yönlendirme karşılaştırması
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
İlgili belgeler
Bir ALB için dinleyici yönlendirme kurallarını yapılandırmaya ilişkin talimatlar için bkz. Dinleyici yönlendirme kurallarını yapılandırma.