Tüm Ürünler
Search
Belge Merkezi

Container Service for Kubernetes:Configure an MseIngressConfig

Son Güncelleme:Oct 08, 2026

MseIngressConfig, Microservices Engine (MSE) Ingress Controller tarafından sağlanan bir CustomResourceDefinition (CRD) kaynağıdır. Bu kaynağı kullanarak MSE cloud-native gateway oluşturabilir, yeniden kullanabilir veya silebilir; ayrıca IP erişim kontrolü, TLS donanım hızlandırma, erişim günlük kaydı ve dağıtılmış izleme gibi Ingress dinleme seçenekleri ile genel ayarları yapılandırabilirsiniz.

Çalışma Mantığı

MSE Ingress Controller, kümenizdeki MseIngressConfig kaynaklarını izler ve buna karşılık gelen cloud-native gateway'in yaşam döngüsünü ACK managed, ACK Serverless ve ACS kümeleriyle olan ilişkisiyle birlikte dinamik olarak yönetir. Gateway, bir ACK managed, ACK Serverless veya ACS kümesinin API sunucusuyla ilişkilendirildikten sonra kontrol düzlemi Ingress kaynak değişikliklerini eşzamanlar ve yönlendirme kurallarını gerçek zamanlı olarak günceller. Gateway bir istek aldığında, bu isteği Ingress yönlendirme kurallarıyla eşleştirir ve trafiği uygun arka uç pod'una iletir.

Aşağıdaki diyagram bileşenler arasındaki ilişkiyi göstermektedir.

ingress的应用场景

Temel bileşenler şunlardır:

  • Service: Arka uç hizmetlerinin soyutlamasıdır. Bir service, çoğaltılmış pod gruplarını temsil eder.

  • Ingress: HTTP veya HTTPS isteklerini ana bilgisayar adlarına ve yollara göre hizmetlere yönlendiren ters proxy kurallarını içerir.

  • IngressClass: Hangi Ingress controller uygulamasının belirli bir Ingress kaynak grubunu işleyeceğini bildirir. Bu Ingress kaynakları için MSE cloud-native gateway'i etkinleştirmek amacıyla bir IngressClass'ı MseIngressConfig ile ilişkilendirin.

  • MseIngressConfig: Gateway yapılandırmasını (örnek teknik özellikleri, ağ ayarları, genel ilkeler ve Ingress dinleme kapsamı) sağlayan CRD'dir.

  • MSE Ingress Controller: MSE cloud-native gateway örneklerini ve yapılandırmalarını yöneten kontrol düzlemidir. Ağ veri düzlemi değildir. Kümedeki MseIngressConfig kaynaklarını izler ve Ingress kaynakları tarafından tanımlanan trafik yönetimi kurallarını uygulamak üzere MSE cloud-native gateway örneklerini koordine eder.

Tek bir MseIngressConfig, tam olarak bir MSE cloud-native gateway ile eşleşir. Birden fazla gateway çalıştırmak için birden fazla MseIngressConfig oluşturun.

MseIngressConfig Referansı

Tam Yapılandırma Örneği

apiVersion: mse.alibabacloud.com/v1alpha1
kind: MseIngressConfig
metadata:
  name: test
spec:
  name: mse-ingress
  common:
    pay:
      payType: POSTPAY
    instance:
      spec: 4c8g
      replicas: 3
    network:
      vSwitches:
      - "vsw-1"
      - "vsw-2"
      publicSLBSpec: slb.s2.small
    securityGroupType: normal
  global:
    tls:
      enableHardwareAcceleration: true
    ipAccessControl:
      whitelist:
      - 1.1.XX.XX
      - 2.2.XX.XX
  monitor:
    logging:
      sls:
        reuseProject: "xxx"   # Leave blank to use the default project
    tracing:
      openTelemetry:
        sampleRate: "100"
  ingress:
    local:
      ingressClass: mse
      watchNamespace: ""      # Leave blank to listen to all namespaces

Parametreler


Parametre


Açıklama


Zorunlu


Varsayılan


name


Gateway adı


Hayır


mse-ingress


common.pay.payType


Faturalandırma yöntemi. Yalnızca POSTPAY (kullandıkça öde) desteklenir.


Hayır


POSTPAY


common.instance.spec


Gateway örnek boyutu. Geçerli değerler: 2c4g, 4c8g, 8c16g, 16c32g


Hayır


4c8g


common.instance.replicas


Gateway çoğaltma sayısı. Geçerli değerler: 0–30


Hayır


3


common.network.vSwitches


Birincil ve ikincil vSwitch'ler. En az bir, en fazla iki tane belirtin. Ayarlanmazsa, MSE Ingress Controller pod'unun çalıştığı düğümdeki vSwitch kullanılır.


Hayır


Yok


common.network.publicSLBSpec


İnternet yönelimli Server Load Balancer (SLB) örneği için teknik özellikler. Geçerli değerler: slb.s1.small, slb.s2.small, slb.s2.medium, slb.s3.small, slb.s3.medium, slb.s3.large


Hayır


slb.s2.small


common.network.privateSLBSpec


Dahili yönelimli SLB örneği için teknik özellikler. publicSLBSpec ile aynı geçerli değerlere sahiptir.


Hayır


slb.s2.small


common.securityGroupType


Güvenlik grubu türü. Geçerli değerler: enterprise (gelişmiş), normal (temel)


Hayır


normal


global.tls.enableHardwareAcceleration


HTTPS işlem performansını artırmak için Transport Layer Security (TLS) donanım hızlandırmayı etkinleştirin.


Hayır


true


global.ipAccessControl.whitelist


Genel IP adresi izin listesi. Tekil IP'leri ve CIDR bloklarını kabul eder.


Hayır


Yapılandırılmamış


global.ipAccessControl.blacklist


Genel IP adresi engelleme listesi. Tekil IP'leri ve CIDR bloklarını kabul eder.


Hayır


Yapılandırılmamış


monitor.logging.sls


Simple Log Service (SLS) erişim günlük kaydını etkinleştirin. Etkinleştirmeden önce MSE Ingress Controller'a SLS izinleri verin.


Hayır


Devre dışı


monitor.logging.sls.reuseProject


Erişim günlükleri için SLS projesi. Varsayılan projeyi kullanmak için boş bırakın; mevcut bir projeyi kullanmak için proje adını belirtin.


Hayır


Boş (varsayılan proje)


monitor.tracing.xTrace


xTrace izleme analizini etkinleştirin. openTelemetry ile birlikte etkinleştirilemez.


Hayır


Devre dışı


monitor.tracing.xTrace.sampleRate


xTrace için örnekleme oranı, dize yüzde olarak ifade edilir. Örneğin, "100" = %100.


Hayır


"0"


monitor.tracing.openTelemetry


OpenTelemetry izleme analizini etkinleştirin. xTrace ile birlikte etkinleştirilemez.


Hayır


Devre dışı


monitor.tracing.openTelemetry.sampleRate


OpenTelemetry için örnekleme oranı, dize yüzde olarak ifade edilir.


Hayır


"100"


ingress.local.ingressClass


Gateway'in dinlediği IngressClass. Geçerli değerler için aşağıdaki tabloya bakın.


Hayır


Yapılandırılmamış


ingress.local.watchNamespace


İzlenecek ad alanı. Tüm ad alanlarını dinlemek için boş bırakın. Yalnızca bir ad alanı belirtilebilir.


Hayır


Boş (tüm ad alanları)

ingress.local.ingressClass için geçerli değerler:


Değer


Davranış


Yapılandırılmamış


Hiçbir Ingress kaynağı dinlenmez.


mse


IngressClass değeri mse olan Ingress kaynaklarını dinler.


"" (boş dize)


Kümedeki tüm Ingress kaynaklarını dinler.


nginx


IngressClass değeri nginx olan veya IngressClass atanmamış Ingress kaynaklarını dinler.


Diğer herhangi bir değer


Belirtilen IngressClass ile ilişkili Ingress kaynaklarını dinler.

Bir IngressClass kaynağı, spec.parameters alanında açıkça bir MseIngressConfig'e referans veriyorsa, bu referans ingress.local.ingressClass değerinden önceliklidir.

Durum

Bir MseIngressConfig'in durumunu kontrol edin:

kubectl get mseingressconfig

Beklenen çıktı:

NAME   STATUS     MESSAGE
test   Listening

Durum şu sırayla ilerler: Pending → Running → Listening.


Durum


Açıklama


Pending


Cloud-native gateway oluşturuluyor. Oluşturma işlemi yaklaşık 3 dakika sürer.


Running


Gateway oluşturuldu ve çalışıyor.


Listening


Gateway çalışıyor ve kümedeki Ingress kaynaklarını dinliyor.


Failed


Gateway geçersiz. Nedeni öğrenmek için durum çıktısındaki Message alanını kontrol edin.

Kaynak Etiketleri

Bir MseIngressConfig tarafından oluşturulan veya yeniden kullanılan MSE cloud-native gateway'ler otomatik olarak etiketlenir. MSE konsolunda gateway örneğinin temel bilgiler bölümünde gateway etiketlerini görüntüleyebilirsiniz.

Önemli

Bu etiketleri MSE konsolunda düzenlemeyin. Bunları değiştirmek gateway operasyonunu bozabilir.


Etiket


Açıklama


ack.aliyun.com


Bu gateway'in giriş trafiğini yönettiği ACK kümesini tanımlar.


ingress.k8s.alibaba/MseIngressConfig


Bu gateway ile ilişkili MseIngressConfig'i tanımlar.


kubernetes.reused.by.user


Gateway'in yeniden kullanıldığını işaretler. İlişkili MseIngressConfig silindiğinde etiketlenmiş bir gateway silinmez.

MSE Cloud-Native Gateway Oluşturma

  1. Gateway'i oluşturmak için bir MseIngressConfig uygulayın. Aşağıdaki örnek, 2c4g teknik özelliklerine sahip 3 çoğaltmalı mse-ingress adında bir gateway oluşturur.

    apiVersion: mse.alibabacloud.com/v1alpha1
    kind: MseIngressConfig
    metadata:
      name: test
    spec:
      name: mse-ingress
      common:
        instance:
          spec: 2c4g
          replicas: 3
  2. Bir IngressClass kaynağı oluşturun ve bunu MseIngressConfig ile ilişkilendirin.

    apiVersion: networking.k8s.io/v1
    kind: IngressClass
    metadata:
      name: mse
    spec:
      controller: mse.alibabacloud.com/ingress
      parameters:
        apiGroup: mse.alibabacloud.com
        kind: MseIngressConfig
        name: test

    Her iki kaynağı da uyguladıktan sonra, IngressClass değeri mse olan Ingress kaynakları ilişkili cloud-native gateway tarafından işlenir.

  3. Gateway'in çalıştığını doğrulayın.

    kubectl get mseingressconfig test

    Durum Pending → Running → Listening aşamalarından geçer. Durum Listening gösterdiğinde gateway hazırdır.

Mevcut MSE Cloud-Native Gateway'i Yeniden Kullanma

Zaten var olan bir gateway'i yeniden kullanmak için spec.id alanını gateway ID'sine (gw-xxx formatında) ayarlayın ve yapılandırmasının üzerine yazılıp yazılmayacağını spec.override ile kontrol edin.

apiVersion: mse.alibabacloud.com/v1alpha1
kind: MseIngressConfig
metadata:
  name: reuse
spec:
  id: gw-xxxx
  override: false
  ingress:
    local:
      ingressClass: mse

spec.override davranışı:


spec.override değeri


Ingress dinleme seçenekleri, TLS hızlandırma, IP erişim kontrolü ve gözlemlenebilirlik üzerindeki etkisi


Küme ilişkisi üzerindeki etkisi


false


Mevcut gateway ayarları korunur.


Gateway henüz kümeyle ilişkili değilse, otomatik olarak ilişkilendirilir ve ingressClass dinlemesi yapılandırılır. Zaten ilişkiliyse orijinal Ingress ayarları değişmez.


true


Gateway ayarları, bu MseIngressConfig'de belirtilen değerlerle üzerine yazılır. Bir parametre MseIngressConfig'den atlanırsa orijinal ayar temizlenir.


Gateway'i kümeyle ilişkilendirir.

Önemli

spec.override: true ayarlarken, korumak istediğiniz tüm parametreleri belirtin. MseIngressConfig'den atlanan parametreler üzerine yazılır ve trafiğiniz olumsuz etkilenebilir.

MSE Cloud-Native Gateway Silme

Çoğu durumda bir MseIngressConfig silmek, ilişkili gateway'i de siler. İstisna, gateway'in korunduğu yeniden kullanım senaryolarıdır.

Bir MseIngressConfig'i silmek için aşağıdaki komutu çalıştırın:

kubectl delete mseingressconfig <your-config-name>

Senaryoya göre silme davranışı:


Faturalandırma yöntemi


MSE Ingress Controller tarafından oluşturulan gateway


Konsoldan yeniden kullanılan gateway


Kullandıkça öde


MseIngressConfig silindiğinde gateway de silinir.


MseIngressConfig silindiğinde gateway korunur.


Abonelik


Uygulanamaz


MseIngressConfig silindiğinde gateway korunur.

IP Erişim Kontrolü Yapılandırma

Belirli IP'lerden Gelen Trafiğe İzin Verme (İzin Listesi)

Aşağıdaki örnek, yalnızca 1.1.XX.XX IP adresinin ve 2.0.XX.XX/8 CIDR bloğunun gateway'e erişmesine izin verir.

apiVersion: mse.alibabacloud.com/v1alpha1
kind: MseIngressConfig
metadata:
  name: test
spec:
  name: mse-ingress
  global:
    ipAccessControl:
      whitelist:
      - 1.1.XX.XX
      - 2.0.XX.XX/8

Belirli IP'lerden Gelen Trafiği Engelleme (Engelleme Listesi)

Aşağıdaki örnek, 1.1.XX.XX IP adresinden ve 2.0.XX.XX/8 CIDR bloğundan gelen erişimi engeller.

apiVersion: mse.alibabacloud.com/v1alpha1
kind: MseIngressConfig
metadata:
  name: test
spec:
  name: mse-ingress
  global:
    ipAccessControl:
      blacklist:
      - 1.1.XX.XX
      - 2.0.XX.XX/8

Simple Log Service Etkinleştirme

Simple Log Service (SLS) etkinleştirmeden önce, küme türünüz için MSE Ingress Controller'a SLS izinleri verin:

Aşağıdaki örnek, gateway'i erişim günlüklerini demo adlı bir SLS projesine göndermek üzere yapılandırır. Bunun yerine varsayılan projeyi kullanmak için reuseProject alanını boş bırakın.

apiVersion: mse.alibabacloud.com/v1alpha1
kind: MseIngressConfig
metadata:
  name: test
spec:
  name: mse-ingress
  monitor:
    logging:
      sls:
        reuseProject: "demo"

Managed Service for OpenTelemetry Etkinleştirme

Managed Service for OpenTelemetry yapılandırmak, üretim sorunlarını teşhis etmek ve konumlandırmak için uçtan uca dağıtılmış izlemeyi sağlar.

Aşağıdaki örnek örnekleme oranını %100 olarak ayarlar.

apiVersion: mse.alibabacloud.com/v1alpha1
kind: MseIngressConfig
metadata:
  name: test
spec:
  name: mse-ingress
  monitor:
    tracing:
      openTelemetry:
        sampleRate: "100"

Daha Fazla Yapılandırma

MSE Ingress tarafından kullanılan MSE cloud-native gateway örneği aşağıdaki ek yapılandırmaları destekler.

Bu yapılandırmaları uygulamak için MSE konsoluna giriş yapın, Cloud-native Gateway > Gateways seçeneğine gidin, MSE Ingress Controller'ın kullandığı mevcut veya otomatik olarak oluşturulmuş gateway örneğini bulun (örnek ID'si mse_ingresspost-***** formatını kullanır), örnek ID'sine tıklayın ve ardından sol gezinme bölmesinde Parameters öğesine tıklayın.


Yapılandırma öğesi


Tür


Açıklama


EnableGenerateRequestId


Bool


İstekler için geçerlidir. Etkinleştirildiğinde gateway, isteği izlemeniz için istek başlığında bir requestId oluşturur.


EnableGzip


Bool


İstekler ve yanıtlar için geçerlidir. Etkinleştirildiğinde gzip, istekleri ve yanıtları sıkıştırır; bu durum gateway trafiğini azaltır ancak gateway CPU kullanımını artırır.


EnableSlashMerge


Bool


İstekler için geçerlidir. İstek yolundaki yinelenen eğik çizgilerin (/) birleştirilip birleştirilmeyeceğini belirtir. Etkinleştirildiğinde www.a.com//b içindeki yinelenen eğik çizgi birleştirilir ve yol www.a.com/b ile aynı şekilde işlenir.


DownstreamConnectionBufferLimits


Int. Geçerli değerler: [0, 2147483647]


Gateway bağlantıları için geçerlidir. Tek bir bağlantının arabellek boyutu. Bu değer aktarım hızını ve gateway bellek kullanımını etkiler.


XffTrustedNum


Int. Geçerli değerler: [0, 10]


İstekler için geçerlidir. Gateway önündeki güvenilir proxy sayısını belirtir. Bu değer, gateway'in x-forwarded-for ve x-request-id gibi istemci tarafından oluşturulan istek başlıklarını kullanıp kullanmayacağını belirler.


DownstreamHttp2MaxConcurrentStream


Int. Geçerli değerler: [0, 2147483647]


İstekler için geçerlidir. İstemci HTTP/2 kullandığında tek bir bağlantıdaki maksimum eşzamanlı akış sayısı.


InitialStreamWindowSize


Int. Geçerli değerler: [65535, 2147483647] (bayt)


İstekler için geçerlidir. HTTP/2 kullanıldığında gateway ile istemci arasında müzakere edilen başlangıç akış penceresi boyutu.


InitialConnectionWindowSize


Int. Geçerli değerler: [65535, 2147483647] (bayt)


İstekler için geçerlidir. HTTP/2 kullanıldığında gateway ile istemci arasında kullanılan bağlantı düzeyindeki başlangıç penceresi boyutu.


EnableHttp3


Bool


HTTP/3 desteğinin etkin olup olmadığını belirtir. HTTP/3, donanım hızlandırma ile uyumlu değildir. HTTP/3'ü etkinleştirmeden önce donanım hızlandırmayı devre dışı bırakın.


PathWithEscapedSlashes


Dize. Geçerli değerler: [KEEP_UNCHANGED, REJECT_REQUEST, UNESCAPE_AND_REDIRECT, UNESCAPE_AND_FORWARD]


URI yolunda %2F, %2f, %5C veya %5c kaçış karakterlerini içeren isteklerde gerçekleştirilen eylem. Varsayılan değer KEEP_UNCHANGED'tır ve yolu değiştirmez.


ZipAlgorithm


List<String>. Geçerli değerler: [brotli, gzip]


Sıkıştırma etkinleştirildikten sonra kullanılan algoritma. Brotli veya gzip seçebilirsiniz. Bu öğeyi ayarlarken EnableGzip devre dışıysa EnableGzip otomatik olarak etkinleştirilir.


EnableProxyProtocol


Bool


Proxy protokolünün etkin olup olmadığını belirtir. Gelen gateway trafiği bir Network Load Balancer (NLB) örneği üzerinden geliyorsa, bu öğe etkinleştirilmediği sürece gateway gerçek istemci IP adresini alamaz. Etkinleştirmenin Proxy protokolünü kullanmayan istekler üzerinde etkisi yoktur.


EnableCustomAuthConfigPush


Bool


Kendi yönettiğiniz kimlik doğrulama hizmeti kullanan senaryolar için geçerlidir. Etkinleştirildiğinde kimlik doğrulama kurallarındaki değişiklikler bağlantıları kesintiye uğratmaz; bu durum WebSocket ve çevrimiçi iş senaryolarına uygundur.


KeepaliveHeaderTimeout


Int. Geçerli değerler: [0, 600] (saniye)


İstemciye döndürülen Keep-Alive yanıt başlığını oluşturmak için kullanılır; bu başlık istemciye bağlantı keepalive süresini bildirir. Örneğin, bu öğeyi 10 olarak ayarlarsanız gateway keep-alive: timeout=10 döndürür. 0 olarak ayarlarsanız başlık döndürülmez.


WebsocketTermGracePeriod


Int. Geçerli değerler: [20, 900] (saniye)


Gateway örneği yükseltme veya yeniden başlatma gibi bağlantıların kapatılmasının gerektiği senaryolarda WebSocket bağlantıları için sürdürülen keepalive süresi.


EnableGzipHardwareAccelerate


Bool


Verileri özel donanım kullanarak sıkıştırır. Etkinleştirildiğinde istekler ve yanıtlar sıkıştırılır; bu durum gateway trafiğini önemli ölçüde azaltır ve yazılım tabanlı gzip'e kıyasla daha yüksek performans ile daha düşük CPU kullanımı sağlar. Bu öğeyi desteklemeyen bölgelerde veya gzip donanım hızlandırması olmadan satın alınan örneklerde etkinleştiremezsiniz. Etkinleştirdikten sonra EnableGzip ve ZipAlgorithm artık geçerli olmaz.


EnableK8sSourceWorkloadFilter


Bool


Bir hizmet kaynağı eklerken Ingress, Service ve Pod kaynaklarını belirtilen etiketlere göre filtreler. Olumsuzlama filtrelemesi desteklenir.