Tüm Ürünler
Search

Bu Ürün

    API Gateway:Eklentileri yönetin

    Belge Merkezi

    API Gateway:Eklentileri yönetin

    Son Güncelleme:Oct 04, 2026

    Cloud-native API Gateway; kimlik doğrulama, trafik kontrolü ve güvenlik koruması için yerleşik eklentiler sağlar ve esnek ağ geçidi genişletmeleri amacıyla özel eklentileri destekler. Sorunsuz kademeli güncellemeler, yükseltmeler ve sürüm düşürme işlemleri dahil olmak üzere eklentileri yükleyebilir, etkinleştirebilir, kaldırabilir ve sürümlerini yönetebilirsiniz.

    Eklentilere giriş

    Cloud-native API Gateway eklentileri, kaynaklarına göre üç kategoriye ayrılır:

    • Resmi eklentiler: Higress ekibi tarafından yayınlanan eklentiler.

    • Topluluk eklentileri: Higress topluluğu tarafından katkıda bulunulan eklentiler.

    • Özel eklentiler: Kullanıcılar tarafından kendi kullanımları için yüklenen eklentiler.

    Bir eklentiyi yükleme ve etkinleştirme

    Bir eklentiyi kullanmak için Cloud-native API Gateway konsolunda ilgili eklentiyi seçin ve bir ağ geçidi örneğine yükleyin. Eklenti, yalnızca yüklendikten, kuralları yapılandırıldıktan ve etkinleştirildikten sonra çalışır. Eklentileri iki şekilde yükleyebilirsiniz:

    Not

    • MCP/Route Level Plugin Rules: Bu kurallar rotalara uygulanır ve istek belirli bir rota ile eşleştiğinde etkili olur.

    • Domain-level plug-in rules: Bu kurallar alan adlarına uygulanır. Belirli alan adları için tanımlanan kurallar, joker karakterli alan adları için tanımlanan kurallara göre daha yüksek önceliğe sahiptir.

    • Instance-level plug-in rules: Bu kurallar ağ geçidine genel olarak uygulanır ve yönlendirme veya alan adı düzeyinde hiçbir kural eşleşmediğinde devreye girer.

    Yöntem 1: Ağ geçidi örneği dışından yükleme

    1. Cloud-native API Gateway konsolundaki Eklentiler sayfasına gidin. Üst menü çubuğundan bir bölge seçin.

    2. Plug-in sayfasında, Quick Navigation bölmesinden bir eklenti türü seçin veya ada göre arama yapın. İlgili eklentinin kartındaki Install failed. düğmesine tıklayın. Açılan Install Plug-in iletişim kutusunda eklenti için hedef ağ geçidi örneğini seçin ve ardından OK öğesine tıklayın.

    3. Configuration bölümünde hedef ağ geçidi örneğini bulun ve Actions sütunundaki Rule Configuration seçeneğine tıklayın. Kural yapılandırma sayfasında bir Effective Scope seçin.

      • MCP/Route Level Plugin Rules veya Domain-level plug-in rules seçerseniz Add Rule düğmesine tıklayın. Add Routing Level Rule veya Add Domain Level Rule sayfasında varsayılan olarak etkin olan Status anahtarını açın. Bir Target seçin, Plug-in Rules ayarlarını yapılandırın ve ardından OK öğesine tıklayın.

      • Instance-level plug-in rules seçerseniz varsayılan olarak etkin olan Status anahtarını açın, Plug-in Rules ayarlarını yapılandırın ve ardından Save düğmesine tıklayın.

    Yöntem 2: Ağ geçidi örneği içinden yükleme

    1. Cloud-native API Gateway konsolundaki Örnekler sayfasına gidin. Üst menü çubuğundan bir bölge seçin.

    2. Hedef örneğin ayrıntılar sayfasına gidin. Sol gezinme bölmesinden Plug-in seçeneğini belirleyin.

    3. Install Plug-in düğmesine tıklayın. Eklenti Yükle sayfasında, bir eklenti türü seçmek veya ada göre arama yapmak için Quick Navigation bölmesini kullanın. Eklenti kartına tıklayın ve açılan iletişim kutusunda Install and Configure seçeneğine tıklayın.

    4. Rule Configuration iletişim kutusunda seçilen eklenti için kuralları yapılandırın, etki kapsamını seçin ve OK düğmesine tıklayın.

    5. (İsteğe bağlı) Ağ geçidi örneği sayfasında sol gezinme bölmesinden Plug-in seçeneğini belirleyin. Eklenti listesinde hedef eklentiyi bulun ve Actions sütunundaki Rule Configuration seçeneğine tıklayın. Ardından kuralları yapılandırın ve etki kapsamını seçin.

      • MCP/Route Level Plugin Rules veya Domain-level plug-in rules seçerseniz Add Rule düğmesine tıklayın. Add Routing Level Rule veya Add Domain Level Rule sayfasında varsayılan olarak etkin olan Status anahtarını açın, bir Target seçin, Plug-in Rules ayarlarını yapılandırın ve OK düğmesine tıklayın.

      • Instance-level plug-in rules seçerseniz varsayılan olarak etkin olan Status anahtarını açın, Plug-in Rules ayarlarını yapılandırın ve Save düğmesine tıklayın.

    Bir eklentiyi kaldırma

    Arka plan

    Bir eklentiyi kaldırmak, onu ağ geçidinden tamamen siler. Eklentileri iki şekilde kaldırabilirsiniz.

    Önemli

    Bir eklentiyi kaldırmadan önce tüm etkin eklenti kurallarını devre dışı bırakın. Eklenti etkin değilse, eklentiyi kaldırmak yapılandırılmış tüm kuralları da siler.

    Yöntem 1: Ağ geçidi örneği dışından kaldırma

    1. Cloud-native API Gateway konsolundaki Eklentiler sayfasına gidin. Üst menü çubuğundan bir bölge seçin.

    2. Plug-in sayfasında, Quick Navigation bölmesinden bir eklenti türü seçin veya ada göre arama yapın. Kaldırmak istediğiniz eklentinin kartına tıklayın.

    3. Configuration sekmesine tıklayın. Eklentiyi kaldırmak istediğiniz ağ geçidi örneğini bulun ve Actions sütunundaki Uninstall seçeneğine tıklayın.

    4. Açılan iletişim kutusunda OK düğmesine tıklayın. Eklentinin başarıyla kaldırıldığına dair bir onay mesajı görüntülenir.

    Yöntem 2: Ağ geçidi örneği içinden kaldırma

    1. Cloud-native API Gateway konsolundaki Örnekler sayfasına gidin. Üst menü çubuğundan bir bölge seçin.

    2. Hedef örneğin ayrıntılar sayfasına gidin ve sol gezinme bölmesinden Plug-in seçeneğini belirleyin.

    3. Eklenti listesinde kaldırmak istediğiniz eklentiyi bulun ve Actions sütunundaki Uninstall seçeneğine tıklayın.

    4. Açılan iletişim kutusunda OK düğmesine tıklayın. Eklentinin başarıyla kaldırıldığına dair bir onay mesajı görüntülenir.

    Özel bir eklentiye sürüm ekleme

    Önemli

    Özel Lua eklentilerine sürüm ekleyemezsiniz.

    Sürüm eklemek, özel bir eklentideki her değişiklik için yeni bir sürüm kaydı oluşturarak değişiklikleri izlemenize ve sürümleri kontrol etmenize yardımcı olur. Aşağıdaki adımları uygulayın:

    1. Cloud-native API Gateway konsolundaki Eklentiler sayfasına gidin. Üst menü çubuğundan bir bölge seçin.

    2. Plug-in sayfasında, Quick Navigation bölmesinde Plug-in Type değerini Custom olarak ayarlayın veya ada göre eklenti arayın. Eklenti kartındaki Add Version düğmesine tıklayın. Add Version panelinde Version Information alanlarını aşağıdaki gibi yapılandırın:

      • Version: Eklenti için sürüm numarasını girin. Sürüm numarası, anlamsal sürüm oluşturma (semver) standardına uygun olmalıdır; örneğin 1.0.1.

      • Version Description: Bu sürümdeki özellikler ve değişiklikler hakkında kısa bir açıklama yazın; örneğin Added rate limiting feature.

      • WASM File: Ağ geçidinde eklenti mantığını yürüten derlenmiş .wasm dosyası.

      • Execution Stage: Eklentinin çalıştırılacağı istek işleme akışı aşamasını seçin; örneğin Default Phase.

      • Execution Priority: Eklentinin çalışma sırasını belirtmek için bir sayı girin. Daha büyük sayı, daha yüksek öncelik anlamına gelir.

      • Adapt to Gateway Version: Bu eklentiyle uyumlu olan ağ geçidi motoru sürüm numarasını girin. Bu adım, eklentinin doğru çalışmasını sağlar.

        Not

        Bu, eklentinin kurulabileceği minimum ağ geçidi sürümüdür.

    Eklenti sürümü değiştirme

    Önemli

    Sorunsuz bir yükseltme sağlamak için yeni sürümün, orijinal sürümün kural yapılandırmasıyla uyumlu olduğundan emin olun.

    1. Cloud-native API Gateway konsolundaki Örnekler sayfasına gidin. Üst menü çubuğundan bir bölge seçin.

    2. Hedef örneğin ayrıntılar sayfasına gidin. Sol gezinme bölmesinden Plug-in seçeneğini belirleyin.

    3. Eklenti listesinde hedef eklentiyi bulun. Ardından Actions sütunundaki Version Change seçeneğine tıklayın.

    4. Version Change iletişim kutusunda istediğiniz sürümü seçin ve ardından OK düğmesine tıklayın.

    Sürüm silme

    1. Cloud-native API Gateway konsolundaki Eklentiler sayfasına gidin. Üst menü çubuğundan bir bölge seçin.

    2. Plug-in sayfasında, Quick Navigation bölmesinde Plug-in Type değerini Custom olarak ayarlayarak veya ada göre arama yaparak bir eklenti bulun. Eklenti kartındaki image simgesinin üzerine gelin.

    3. Ardından Deleted. seçeneğine tıklayın. Açılan iletişim kutusunda silinecek sürümü seçin ve OK düğmesine tıklayın.