Set up a cloud-native API gateway for your application - Serverless App Engine

Arka plan

Cloud-native API Gateway; trafik, mikroservis, güvenlik ve AI ağ geçitlerini tek bir platformda birleştiren bütüncül bir çözümdür. Hizmet keşfi, yük dengeleme ve hizmetler arası iletişimi yöneterek geleneksel dağıtık ağ geçitlerinin gerektirdiği parçalı altyapının yerini alır. Daha fazla bilgi için bkz. Cloud-native API Gateway nedir?.

Önkoşullar

Başlamadan önce aşağıdakileri hazırladığınızdan emin olun:

MSE: Bir cloud-native API Gateway örneği. Bkz. Cloud-native API Gateway örneği oluşturma.
SAE: Ağ geçidi ile aynı bölgede bulunan ve aynı Virtual Private Cloud (VPC) ile ilişkilendirilmiş bir ad alanı. Bkz. Ad alanı oluşturma.
SAE: İlgili ad alanında dağıtılmış bir uygulama.

Ağ geçidi rotası oluşturma

SAE Gateway Routing sayfasına gidin, bir bölge ve ad alanı seçin, ardından Create Gateway Route düğmesini tıklayın.
Create Route sayfasında aşağıdaki parametreleri yapılandırın ve Save düğmesini tıklayın.

Temel ayarlar

Parametre	Açıklama	Örnek
Route name	Yönlendirme kuralı için özel bir ad belirtin.	`demo`
Network type	İsteklerin iletileceği ağ türünü belirleyin. Internet: Genel internet üzerinden gelen trafik; iletilen gerçek trafiğe göre ücretlendirilir. Private: Yalnızca mevcut VPC içindeki trafik; ücretlendirilmez.	Internet
Gateway type	Cloud-native API Gateway seçeneğini belirleyin.	Cloud-native API Gateway
Gateway instance	Gateway type olarak Cloud-native API Gateway seçildiğinde zorunludur. Ad alanıyla aynı bölge ve VPC'de bulunan bir örnek seçin. Yeni bir örnek oluşturmak için Create Cloud-native API Gateway düğmesini tıklayın. Bkz. Cloud-native API Gateway örneği oluşturma.	`demo`
Domain name	Eşleştirilecek bir veya daha fazla alan adı girin. Yeni bir alan adı eklemek için Create Domain Name düğmesini tıklayın. Bkz. Alan adı oluşturma.	`www.demo.com`

Eşleşme koşulları

Ağ geçidinin hangi istekleri bu rota üzerinden işleyeceğini belirleyen kuralları yapılandırın.

Yol eşleşmesi

HTTP isteklerinde eşleştirilecek yol desenini tanımlayın.

Eşleşme türü	Davranış	Örnek
Equals	Yalnızca tam eşleşmeleri kabul eder.	`/user` ifadesi yalnızca `/user` yoluyla eşleşir.
Prefix	Belirtilen değerle başlayan tüm yolları eşleştirir.	`/user` ifadesi `/user`, `/user/profile` ve `/user/settings` yollarını kapsar.
Regular expression	Yolları normal ifade (regex) desenine göre eşleştirir.	`user` (karakter sınıfı) bu deseni içeren yollarla eşleşir.

Birden fazla kural aynı eşleşme türünü paylaştığında, daha uzun yola sahip olan kural öncelik kazanır. Farklı eşleşme türleri arasında öncelik sırası şöyledir: Equals > Prefix > Regular expression.

Öncelik örneği

Aşağıdaki tabloda, örnek istekler için SAE'nin seçtiği rota gösterilmektedir:

İstek yolu	Seçilen rota	Neden
`/user`	`Equals: /user`	Tam eşleşme en yüksek önceliğe sahiptir.
`/user/profile`	`Prefix: /user`	Tam eşleşme yok; ön ek eşleşmesi devreye girer.
`/account`	`Regex: user`	Tam veya ön ek eşleşmesi yok; normal ifade uygulanır.

Diğer eşleşme koşulları

Parametre	Açıklama	Örnek
Method	Eşleştirilecek HTTP yöntemleri. Tüm yöntemleri eşleştirmek için boş bırakın.	`GET`
Request header	Üst bilgi adı, eşleşme türü ve değeri. Birden fazla kural aynı koşulları paylaştığında, daha fazla üst bilgi parametresi içeren kural öncelik kazanır.	Ad: `demo`, Koşul: Prefix, Değer: `value`
Request parameter (Query)	Sorgu dizesi anahtarı, eşleşme türü ve değeri. Birden fazla kural aynı koşulları paylaştığında, daha fazla sorgu parametresi içeren kural öncelik kazanır.	Anahtar: `key`, Koşul: Prefix, Değer: `value`

Hizmet kaynağı ve arka uç

Service source

Uygulamanızın kendini kaydettiği yönteme uygun hizmet kayıt defterini seçin.

Seçenek	Ne zaman kullanılır
MSE Nacos	Uygulama hizmet kaydı ve keşfi için MSE Nacos kullanır. Bir MSE Nacos instance ve MSE Nacos namespace seçilmesi gerekir.
K8s Service	Uygulama Kubernetes ServiceNames kullanır. Çok dilli hizmet kaydı ve keşfini destekler; dağıtımdan sonra IP adresi değişikliklerini önlemek için sabit alan adları atar.

Hizmet kaynağı, uygulamanız tarafından kullanılan hizmet kaydı ve keşfi yöntemiyle eşleşmelidir.

Senaryolar ve arka uç hizmeti

Parametre	Açıklama	Örnek
Scenarios	Single service: Eşleşen tüm istekleri tek bir arka uca yönlendirir. Multiple services (canary release): Trafiği ağırlıklara göre birden fazla arka uç arasında böler. Bkz. Yönlendirme yöntemlerine genel bakış.	Single service
Backend service	Hedef uygulama, hizmet adı, protokol ve bağlantı noktası. Çoklu hizmet kullanırken tüm trafik ağırlık yüzdelerinin toplamı %100 olmalıdır.	Uygulama: `demo`, Hizmet: `demo`, Protokol: Auto Read, Bağlantı Noktası: `80`

Canary release örneği

Canary release (çoklu hizmet senaryosu) sırasında, yeni bir sürümü tam dağıtımdan önce doğrulamak için trafiği yüzdelere göre bölebilirsiniz:

Kararlı sürüm (demo-v1): Trafiğin %90'ı
Canary sürümü (demo-v2): Trafiğin %10'u

Canary sürümü kararlı hale geldiğinde, trafiğin %100'ünü işleyene kadar oranı kademeli olarak artırın.

Gelişmiş yapılandırma

Parametre	Açıklama	Varsayılan	Örnek
Fallback	Bir yedek hizmet belirtmek için etkinleştirin. Birincil arka uçta sağlıklı bir düğüm bulunmadığında, ağ geçidi istekleri yedek hizmete iletir. Şu anda yalnızca HTTP hizmetleri arasında desteklenir.	Kapalı	Etkin
Timeout (s)	Ağ geçidinin arka uç yanıtını bekleyeceği maksimum süre (saniye). Zaman aşımı olmaması için `0` olarak ayarlayın.	60	`60`
Retries	Başarısız bir istekten sonra yapılacak yeniden deneme sayısı. Yeniden denemeyi devre dışı bırakmak için `0` olarak ayarlayın.	—	`2`
Retry conditions	Yeniden denemeyi tetikleyen olaylar. Bkz. Yeniden deneme ilkesi yapılandırma.	—	`connect-failure`, `cancelled`
Retry status codes	Yeniden denemeyi tetikleyen HTTP durum kodları.	—	`502`

Yönlendirme kurallarını yönetme

Bir rota oluşturduktan sonra, ağ geçidi rotalarını görüntülemek, düzenlemek veya silmek için Gateway Routing sayfasına gidin.

Sonraki adımlar

Yönlendirme yöntemlerine genel bakış — Tek hizmetli ve çok hizmetli yönlendirmenin nasıl çalıştığını öğrenin.
Yeniden deneme ilkesi yapılandırma — Rotalarınız için yeniden deneme davranışını ince ayarlarla optimize edin.