Tüm Ürünler
Search
Belge Merkezi

API Gateway:ZooKeeper

Son Güncelleme:Oct 04, 2026

ZooKeeper'ı hizmet keşfi için API Gateway ile entegre edin. Bu sayede API Gateway, ZooKeeper'a kayıtlı arka uç mikroservislerine istekleri otomatik olarak yönlendirebilir.

Genel Bakış

Bu konudaki bölümler şunlardır:

  • Çalışma mantığı

  • VPC entegrasyonlu özel bir örnek oluşturun (Yalnızca VPC entegrasyon örnekleri ZooKeeper'ı destekler)

  • ZooKeeper hizmetini dağıtın ve bir mikroservis uygulaması kaydedin

  • Bir API grubu oluşturun

  • Bir arka uç hizmeti oluşturun

  • Bir API oluşturun

  • Bir uygulama oluşturun ve bu uygulamaya API çağırma izni verin

  • API'yi hata ayıklayın

Çalışma Mantığı

ZooKeeper verileri dosya sistemine benzer bir ağaç yapısında saklar. Her düğümün /provider/service gibi benzersiz bir erişim yolu vardır. Hizmet sağlayıcıları mikroservis örnek bilgilerini ZooKeeper hizmet düğümlerine kaydeder. API Gateway bu düğümleri dinler, IP adreslerini ve bağlantı noktalarını ayrıştırır ve yük dengeleme ilkelerine göre istemci isteklerini arka uç mikroservis örneklerine dağıtır.

image
  1. Hizmet sağlayıcıları mikroservis örneklerini ZooKeeper hizmet düğümlerine kaydeder.

  2. API Gateway erişim yollarına göre düğümleri ve alt düğümleri dinler; örnek IP adresi ve bağlantı noktası numarası gibi düğümlerde depolanan mikroservis örnek bilgilerini ayrıştırır. İletişim ek yükünü azaltmak için IP adresleri ve bağlantı noktası numaraları API Gateway'de önbelleğe alınır.

  3. Bir istemci isteği alındığında API Gateway önbelleğinden bir IP adresi ve bağlantı noktası numarası alır ve isteği ilgili mikroservis sunucusuna iletir. Ardından API Gateway sunucudan gelen yanıtı alır ve istemciye iletir.

  4. Mikroservis uygulamasında bir bilgi değişikliği olursa (örneğin bir mikroservis örneği çevrimdışı olur veya yeni bir örnek eklenirse) ZooKeeper bu değişikliği API Gateway ile senkronize eder. API Gateway kendi önbelleğindeki bilgileri güncelleyerek ZooKeeper ile tutarlılığı sağlar.

  5. Başka bir istemci isteği alındığında API Gateway isteği güncellenen bilgilere göre yönlendirir ve iletir.

Önemli

API Gateway, ZooKeeper ve mikroservis örnekleriyle sanal özel bulutlar (VPC) üzerinden iletişim kurar. Bu nedenle bir API oluştururken ZooKeeper'ın hizmet adresi olarak dahili bir adres belirtmeniz gerekir. Aksi takdirde API Gateway geçersiz bir ZooKeeper adresi özel durumu döndürür. Aynı nedenden dolayı arka uç mikroservis uygulamalarının URL'leri ZooKeeper'da dahili URL'ler olarak kaydedilmelidir. API Gateway bir API isteği aldıktan sonra ZooKeeper'dan genel bir URL alırsa isteği işleyemez. Bunun yerine API Gateway I504IA hata kodunu döndürür. API Gateway ZooKeeper'dan herhangi bir mikroservis URL'si alamazsa I504BA hata kodunu döndürür.

Adım 1: VPC entegrasyonlu bir örnek oluşturun

API Gateway, ZooKeeper ve mikroservis uygulamalarıyla dahili ağlar üzerinden iletişim kurar. Geleneksel özel örnekler özel dahili ağları desteklemediğinden API Gateway ile kullanıcı VPC'leri arasında doğrudan iletişim sağlamak amacıyla VPC entegrasyonlu örnek tanıtılmıştır. VPC entegrasyonlu bir örnek oluşturma hakkında daha fazla bilgi için bkz. VPC entegrasyonlu özel örnek.

Adım 2: ZooKeeper hizmetini dağıtın ve ZooKeeper'a bir mikroservis uygulaması kaydedin

1. ZooKeeper hizmetini dağıtın.

ZooKeeper, oluşturduğunuz VPC entegrasyonlu örnekle aynı VPC, alan ve vSwitch içinde dağıtılmalıdır. Yerel ZooKeeper hizmetini vSwitch üzerindeki bir Elastic Compute Service (ECS) örneğine dağıtabilirsiniz. Bu şekilde ZooKeeper'ın erişim adresi ECS örneğinin Dahili IP adresi: ZooKeeper bağlantı noktası olarak ayarlanabilir. Bir ECS örneği oluştururken Ağ seçeneğini VPC olarak ayarlayın ve VPC entegrasyonlu örneği oluştururken seçtiğiniz VPC, alan ve vSwitch ile aynı olanları seçin.

Not

ZooKeeper'ın nasıl dağıtılacağı hakkında daha fazla bilgi için bkz. ZooKeeper Başlangıç Kılavuzu. Bir ECS örneğinin nasıl oluşturulacağı hakkında daha fazla bilgi için bkz. Satın alma talimatları.

Alternatif olarak bir ZooKeeper hizmeti dağıtmak için Alibaba Cloud Microservice Engine (MSE) kullanabilirsiniz. Bunu yaparken ağ türünü VPC olarak ayarlayın ve oluşturduğunuz VPC entegrasyonlu örnekle aynı VPC ve vSwitch'i seçin. ZooKeeper hizmeti dağıtıldıktan sonra uç noktasını MSE örnek listesinde görüntüleyebilirsiniz.

Not

MSE kullanarak bir ZooKeeper hizmetinin nasıl dağıtılacağı hakkında daha fazla bilgi için bkz. ZooKeeper motoru oluşturma.

2. Bir mikroservis uygulaması kaydedin.

Mikroservis uygulamasını, oluşturduğunuz VPC entegrasyonlu örnekle aynı VPC, alan ve vSwitch içinde dağıtmanız gerekir. Bu sayede mikroservis uygulaması ZooKeeper hizmetine kaydedilir ve API Gateway tarafından erişilebilir hale gelir. Mikroservis uygulamasını bir ECS örneğine dağıtmayı seçebilirsiniz. ECS örneği, oluşturduğunuz VPC entegrasyonlu örnekle aynı vSwitch içinde oluşturulmalıdır.

ZooKeeper'a kaydedilen mikroservis uygulaması bilgileri için aşağıdaki biçimi kullanın:

{
    "address":"localhost",
    "enabled":true,
    "id":"cb1467f745c64d9f8cbfa5c2bd217cb8",
    "name":"provider",
    "payload":{

    },
    "port":8080,
    "registrationTimeUTC":1699525871398,
    "serviceType":"DYNAMIC",
    "sslPort":443,
    "uriSpec":{
        "parts":[
            {
                "value":"scheme",
                "variable":true
            },
            {
                "value":"://",
                "variable":false
            },
            {
                "value":"address",
                "variable":true
            },
            {
                "value":":",
                "variable":false
            },
            {
                "value":"port",
                "variable":true
            }
        ]
    }
}
Not

ZooKeeper düğümlerinde depolanan verilerin yapısı için açık kaynaklı Apache Curator projesi tarafından sağlanan org.apache.curator.x.discovery.ServiceInstance sınıfına bakın. uriSpec alanının boş bırakılamayacağını unutmayın. Bu alanı {scheme}://{address}:{port} şeklinde yapılandırmanızı öneririz. HTTPS protokolünü kullanmak istiyorsanız sslPort niteliğini yapılandırın.

Önemli

Geçersiz veri biçimleri, API Gateway'nin mikroservis örneklerinin arka uç adreslerini ayrıştıramamasına neden olabilir. ZooKeeper'a kaydedilen mikroservis uygulamaları HTTP çağrılarını desteklemelidir.

Adım 3: Bir API grubu oluşturun

API'ler gruplar halinde yönetilir. Bir API oluşturmadan önce bir API grubu oluşturun.

  1. API Gateway konsolunda oturum açın.

  2. Sol gezinme bölmesinde Manage APIs > API Groups seçeneğini belirleyin. Sayfanın sağ üst köşesinde Create Group seçeneğine tıklayın. Görüntülenen iletişim kutusunda oluşturulan VPC entegrasyonunu seçin, Group Name ve BasePath parametrelerini yapılandırın ve Confirm seçeneğine tıklayın.

Not

Grup oluşturulduktan sonra grup listesinden grup adına tıklayarak grup ayrıntıları sayfasına gidin. Burada bir etki alanı adı bağlayabilir, temel bilgileri değiştirebilir ve örnek türünü değiştirebilirsiniz.

API Gateway her API grubuna otomatik olarak bir genel ikinci düzey etki alanı adı atar. Bu etki alanı adı yalnızca hata ayıklama amaçlıdır. Çin anakarasındaki bölgelerde bu etki alanı adını kullanarak yapılan doğrudan API çağrıları günde 1.000 ile, Çin (Hong Kong) bölgesi ve Çin anakarası dışındaki diğer bölgelerde ise günde 100 ile sınırlıdır. API grubunuz için bağımsız bir etki alanı adı bağlamanızı öneririz. Daha fazla bilgi için bkz. API grubuna özel etki alanı adı bağlama.

Adım 4: Bir arka uç hizmeti oluşturun

Arka uç hizmeti türü olarak Hizmet keşfi seçeneğini içeren bir API oluşturmak için öncelikle bir arka uç hizmeti oluşturun.

  1. API Gateway konsolunda oturum açın.

  2. Sol gezinme bölmesinde Manage APIs > Backend Services seçeneğini belirleyin. Sayfanın sağ üst köşesinde Create Backend Service seçeneğine tıklayın. Görüntülenen iletişim kutusunda arka uç hizmetinin adını girin ve Type değerini Service discovery olarak ayarlayın. Arka uç hizmeti oluşturulduktan sonra arka uç hizmeti listesinde oluşturulan hizmeti bulabilir ve arka uç hizmeti ayrıntıları sayfasına gitmek için hizmet adına tıklayabilirsiniz.

Bu örnekte Production ortamı seçilmiştir. Bir API yayınlamadan önce bu ortamda bir arka uç hizmeti oluşturun. Sayfanın sağ tarafında Create seçeneğine tıklayarak Define Backend Service sayfasına gidin.

Define Backend Service sayfasında aşağıdaki ZooKeeper ve mikroservis bilgilerini girin:

  • Service URL: ZooKeeper'ın dahili uç noktası. Zorunludur.

  • Namespace: Mikroservis uygulaması bilgilerini depolayan üst düğümün adı. Zorunludur.

  • Service Name: Mikroservis uygulamasının adı. Zorunludur.

Not

Namespace ve service name birlikte bir hizmet düğümünün erişim yolunu oluşturur. Örneğin düğüm yolu "/provider/service" ise namespace değerini "provider", service name değerini ise "service" olarak ayarlayın. Hizmet sağlayıcı mikroservis örnek bilgilerini /provider/service düğümüne ve alt düğümlerine kaydedebilir.

Adım 5: Bir API oluşturun

API Gateway konsolunun sol gezinme bölmesinde Manage APIs-APIs seçeneğini belirleyin. Sayfanın sağ üst köşesinde Create API seçeneğine tıklayın.

  1. API için temel bilgileri yapılandırın.

    Bu adımda oluşturmak istediğiniz API'nin ait olduğu API grubu, API'nin adı, kimlik doğrulama yöntemi, türü ve açıklaması dahil olmak üzere temel bilgileri yapılandırın. Oluşturduğunuz API grubunu seçin, Security Authentication için Alibaba Cloud App seçeneğini belirleyin ve AppCode Authentication için Enable AppCode Authentication (Header & Query) seçeneğini işaretleyin. Özel bir API adı ve açıklaması belirtebilirsiniz.

Not

Security Authentication ve AppCode Authentication parametrelerini gereksinimlerinize göre yapılandırabilirsiniz. Bu örnek yalnızca referans amaçlı bir yapılandırma sunar.

  1. API isteklerini tanımlayın.

    Bu adımda bir tarayıcı, mobil uygulama veya iş sistemi gibi bir istemcinin API'nizi nasıl isteyeceğini tanımlayın. Parametreler arasında istek türü, protokol, istek yolu, HTTP yöntemi, giriş parametresi istek modu ve giriş parametresi tanımları yer alır. İş gereksinimlerinize göre istek yolunu ve HTTP yöntemini belirtebilirsiniz.

  2. Arka uç hizmetini tanımlayın.

    Bu adımda API Gateway'nin bir istek aldıktan sonra istek parametrelerini nasıl eşleyip işleyeceğini tanımlayın. Ayrıca API Gateway'nin hangi arka uç adresine bağlanacağını da belirtebilirsiniz. Bu örnekte Configuration Mode parametresi için Use Existing Backend Service seçeneği ve Backend Service Type parametresi için Service discovery seçeneği belirlenmiştir. Diğer parametreleri iş gereksinimlerinize göre ayarlayabilirsiniz.

  3. API için yanıtları tanımlayın.

    Bu adımda API belgelerini oluşturmak için yanıt bilgilerini yapılandırın. Belgeler API çağırıcılarının API'leri daha iyi anlamasına yardımcı olur. Ayrıca örnek bir başarılı yanıt ve örnek bir başarısız yanıt belirtebilirsiniz. Bu örnekte bu adım atlanır. Create seçeneğine tıklayın.

  4. API'yi yayınlayın.

    Yukarıdaki yapılandırmalar kaydedildikten sonra API'yi yayınlamanız gerekir. Bir API üzerinde gerçekleştirdiğiniz tüm yapılandırmalar ancak API bir ortama yayınlandıktan sonra etkili olur. Bu örnekte arka uç hizmeti production ortamında yapılandırılmıştır. Bu nedenle API production ortamına yayınlanır. API'yi başka bir ortama yayınlamak istiyorsanız öncelikle hedef ortamda arka uç hizmetini yapılandırmanız gerekir. Bu örnekte API oluşturmanın başarılı olduğunu belirten mesajda Publish seçeneğine tıklayın. Publish API iletişim kutusunda Stage parametresini Release olarak ayarlayın, açıklamalar girin ve ardından Publish seçeneğine tıklayın.

Adım 6: Bir uygulama oluşturun ve bu uygulamaya API çağırma izni verin

Uygulama bir API çağırıcısının API'yi çağırırken kullandığı kimliktir. Bu örnekte API oluşturulurken Security Authentication için Alibaba Cloud App seçilmiştir. API yayınlandıktan sonra bir uygulama oluşturun ve bu uygulamaya API'yi çağırma izni verin. Daha fazla bilgi için bkz. Yetkilendirme yönetimi.

Adım 7: API'yi hata ayıklayın

API Gateway çevrimiçi hata ayıklamayı destekler. Bir API'yi istemcilere sunmadan önce doğru şekilde yapılandırıldığını doğrulamak için bu özelliği kullanın.

APIs sayfasında oluşturulan API'ye tıklayın. API ayrıntıları sayfasının sol gezinme bölmesinde Debug API seçeneğine tıklayın. İstek parametreleri tanımladıysanız API'nin beklendiği gibi çalıştığını doğrulamak için farklı değerler girin.

Hata ayıklama sırasında yetkilendirilmiş uygulamayı kullandığınızdan ve hata ayıklama ortamının uygulamanın yetkilendirildiği ortamla eşleştiğinden emin olun. Aksi takdirde hata ayıklama başarısız olabilir.