Tüm Ürünler
Search
Belge Merkezi

Container Service for Kubernetes:Configure ApigConfig

Son Güncelleme:Oct 12, 2026

ApigConfig, APIG Controller tarafından sağlanan ve APIG ağ geçidi örneklerinin yaşam döngüsünü yönetmek, Ingress dinleyici seçeneklerini yapılandırmak ve IP erişim kontrolü, günlük toplama ile izleme gibi genel ayarları tanımlamak için kullanılan bir CRD'dir.

ApigConfig'a Genel Bakış

Yapılandırma

ApigConfig, APIG Controller tarafından sunulan ve APIG ağ geçidi örneklerinin yaşam döngüsü ile genel yapılandırmalarını yönetmek için kullanılan bir CRD'dir.

Her bir ApigConfig kaynağı tek bir APIG ağ geçidi örneğine karşılık gelir. Birden fazla APIG ağ geçidi örneği kullanmak istiyorsanız birden fazla ApigConfig kaynağı oluşturmanız gerekir.
Yeniden kullanım senaryoları hariç , bir ApigConfig kaydının silinmesi buna bağlı olan APIG ağ geçidi örneğini de siler.
Önemli

CRD (ApigConfig) kullanılarak oluşturulan bir APIG ağ geçidi örneğinde; API'ler, rotalar ve sertifikalar gibi iş yapılandırmalarını CRD üzerinden yönetin. Ölçeklendirme gibi işlemler için APIG konsolunu kullanabilirsiniz. Konsolda, CRD ile oluşturulmuş bir örneğin iş yapılandırmalarını değiştirmeyin; çünkü CRD senkronizasyonu yaptığınız değişikliklerin üzerine yazarak yapılandırma çakışmalarına neden olabilir.

Aşağıda eksiksiz bir ApigConfig yapılandırma örneği verilmiştir.

apiVersion: apig.alibabacloud.com/v1alpha1
kind: ApigConfig
metadata:
  name: apig-ingress
spec:
  name: apig-ingress
  common:
    pay:
      payType: POSTPAY
    instance:
      spec: apigw.small.x1
    network:
      vSwitches:
      - "vsw-1"
      - "vsw-2"
      networkType: Internet
    securityGroupType: enterprise
  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:  apig
      watchNamespace: "" # An empty string ("") indicates Ingress resources in all namespaces.

Parametre

Açıklama

Varsayılan

name

Ağ geçidi adı.

apig-ingress

common.pay.payType

Faturalandırma yöntemi.

Yalnızca kullandıkça öde desteklenir ve belirtilmediğinde varsayılan olarak bu yöntem seçilir.

POSTPAY

common.instance.spec

Ağ geçidi örneği türü.

Geçerli değerler:

  • apigw.small.x1

  • apigw.small.x2

  • apigw.small.x4

  • apigw.medium.x1

  • apigw.medium.x2

  • apigw.medium.x3

  • apigw.large.x1

  • apigw.large.x2

  • apigw.large.x3

apigw.small.x1

common.network.vSwitches

Birincil ve yedek vSwitch'ler (bu sırayla).

Bir veya iki vSwitch belirtin. Belirtilmezse vSwitch'ler, APIG Controller pod'unun çalıştığı düğümden devralınır.

Yok

common.network.networkType

Ağ geçidinin ağ erişilebilirliği.

Geçerli değerler:

  • Internet

  • Intranet

Internet

common.securityGroupType

Güvenlik grubu türü.

Geçerli değerler:

  • enterprise: gelişmiş güvenlik grubu

  • normal: temel güvenlik grubu

normal

global.tls.enableHardwareAcceleration

TLS donanım hızlandırmanın etkinleştirilip etkinleştirilmeyeceğini belirtir.

Bu özellik HTTPS trafiği performansını önemli ölçüde artırabilir.

Etkin

global.ipAccessControl.whitelist

Genel IP izin listesi.

Yapılandırılmamış

global.ipAccessControl.blacklist

Genel IP engelleme listesi.

Yapılandırılmamış

monitor.logging.sls

Simple Log Service (SLS) günlük toplamayı etkinleştirip etkinleştirmeyeceğinizi belirtir.

Bu özelliği etkinleştirmek için APIG Controller'a gerekli SLS izinlerini vermeniz gerekir.

Devre dışı

monitor.logging.sls.reuseProject

Erişim günlüklerinin saklanacağı SLS projesi.

Geçerli değerler:

  • Boş: Varsayılan bir proje oluşturulur ve kullanılır.

  • Belirtilen değer: Var olan bir proje kullanılır.

Boş

monitor.tracing.xTrace.sampleRate

Tracing Analysis (x-trace) için örnekleme oranı.

0

monitor.tracing.openTelemetry

OpenTelemetry izlemeyi etkinleştirir veya devre dışı bırakır.

Varsayılan olarak devre dışıdır. xTrace izleme seçeneği ile birlikte kullanılamaz.

monitor.tracing.openTelemetry.sampleRate

OpenTelemetry izleme için örnekleme oranı.

100

ingress.local.ingressClass

APIG ağ geçidi örneğinin hangi Ingress kaynaklarını işleyeceğini IngressClass'a göre belirler.

Geçerli değerler:

  • Yapılandırılmamış: Ağ geçidi herhangi bir Ingress kaynağını işlemez.

  • apig olarak ayarlandığında: Ağ geçidi, IngressClass değeri apig olan Ingress kaynaklarını işler.

  • Boş dize (""): Tüm Ingress kaynaklarını dinler.

  • nginx olarak ayarlandığında: IngressClass değeri nginx olan veya herhangi bir IngressClass ile ilişkilendirilmemiş Ingress kaynaklarını dinler.

  • Başka bir değer olarak ayarlandığında: Ağ geçidi, belirtilen değerle eşleşen IngressClass'a sahip Ingress kaynaklarını işler.

Not

Bu ayarın önceliği, bir IngressClass aracılığıyla ApigConfig ilişkilendirmesine göre daha düşüktür.

Yapılandırılmamış

ingress.local.watchNamespace

Ağ geçidinin Ingress kaynaklarını izlediği ad alanları.

Geçerli değerler:

  • Boş dize: Tüm ad alanlarını izler.

  • Belirtilen değer: Yalnızca belirtilen ad alanını izler. Tek bir ad alanı belirtilebilir.

Boş

Durum

Bir ApigConfig kaynağı oluşturduktan sonra durumunu kontrol etmek için kubectl get ApigConfig komutunu çalıştırın. Kaynak aşağıdaki durumlar arasında geçiş yapar: Pending > Running > Listening.

  • Pending: APIG ağ geçidi örneği oluşturuluyor. Bu işlem yaklaşık 3 dakika sürer.

  • Running: APIG ağ geçidi örneği oluşturuldu ve çalışıyor.

  • Listening: APIG ağ geçidi örneği çalışıyor ve kümedeki Ingress kaynaklarını dinliyor.

  • Failed: APIG ağ geçidi örneği geçersiz durumda. Nedenini öğrenmek için Status alanındaki Message bilgisini kontrol edin.

Etiketler

ApigConfig aracılığıyla oluşturulan veya yeniden kullanılan APIG ağ geçidi örneklerine kaynak etiketleri eklenir. Etiket bilgilerini APIG konsolu içindeki Temel Bilgiler bölümünde görüntüleyebilirsiniz.

Önemli

Bu etiketleri APIG konsolunda düzenlemeyin; aksi takdirde ağ geçidi örneğiniz bozulabilir.


Etiket


Açıklama


ack.aliyun.com


APIG ağ geçidinin bir Container Service for Kubernetes (ACK) kümesinin giriş trafiğini yönettiğini gösterir.


ingress.k8s.alibaba/ApigConfig


APIG ağ geçidi örneğini bir ApigConfig ile ilişkilendirir.


kubernetes.reused.by.user


APIG ağ geçidi örneğinin yeniden kullanılıp kullanılmadığını gösterir. Yeniden kullanılan bir örnek, ilişkili ApigConfig silindiğinde silinmez.

APIG Ağ Geçidi Örneği Oluşturma

  1. ApigConfig'i yapılandırın.

    Aşağıdaki örnek, apigw.small.x1 teknik özelliklerine sahip apig-ingress adlı bir APIG ağ geçidi örneği oluşturur. Diğer ApigConfig ayarlarını ihtiyacınıza göre değiştirin.

    apiVersion: apig.alibabacloud.com/v1alpha1
    kind: ApigConfig
    metadata:
      name: apig-ingress
    spec:
      name: apig-ingress
      common:
        instance:
          spec: apigw.small.x1
  2. Container Service for Kubernetes (ACK) kümenizde bir IngressClass oluşturun ve spec.parameters kullanarak bunu ApigConfig ile ilişkilendirin. Bu işlem kümede bir Ingress işlemcisi bildirir.

    Yapılandırma tamamlandığında, bağlantılı APIG ağ geçidi örneği bu IngressClass ile ilişkili tüm Ingress kaynaklarını işler.

    apiVersion: networking.k8s.io/v1
    kind: IngressClass
    metadata:
      name: apig
    spec:
      controller: apig.alibabacloud.com/ingress
      parameters:
        apiGroup: apig.alibabacloud.com
        kind: ApigConfig
        name: apig-ingress

Var Olan Bir APIG Ağ Geçidi Örneğini Yeniden Kullanma

Var olan bir APIG ağ geçidi örneğini yeniden kullanmak için ApigConfig'inizin spec.id alanına örnek ID'sini (örneğin gw-xxx) girin. ApigConfig ayarlarının var olan örnek yapılandırmasının üzerine yazıp yazmayacağını denetlemek için spec.override parametresini kullanın.

Aşağıdaki örnek var olan bir APIG ağ geçidi örneğini yeniden kullanır. ApigConfig, örneği bir kümeyle ilişkilendirir ve apig IngressClass'a sahip Ingress kaynaklarını işlemek üzere yapılandırır.

Önemli
  • Aşağıdaki yapılandırmada spec.override değeri false olarak ayarlanmıştır; bu, var olan bir APIG ağ geçidinin Ingress dinleyici seçenekleri ve genel yapılandırmasının üzerine yazılmayacağı anlamına gelir. Var olan bir ağ geçidi örneği konteyner kümesiyle ilişkilendirilmemişse otomatik olarak kümeyle ilişkilendirilir ve Ingress dinleyici seçenekleri, ingressClass değeri spec.ingress.local.ingressClass (bu örnekte apig) olan Ingress kaynaklarını dinleyecek şekilde yapılandırılır. Ağ geçidi örneği zaten konteyner kümesiyle ilişkilendirilmişse var olan Ingress dinleyici seçenekleri değiştirilmez.

  • Var olan bir APIG ağ geçidinin Ingress dinleyici seçenekleri ve genel yapılandırmalarının üzerine yazmak istiyorsanız spec.override özelliğini etkinleştirmeden önce ApigConfig içindeki ağ geçidi parametrelerinin (Ingress dinleyici seçenekleri, donanım hızlandırma, genel IP adresi engelleme ve izin listeleri ile gözlemlenebilirlik) doğru yapılandırıldığından emin olun. Bu yapılandırmalar ApigConfig'de belirtilmemişse spec.override etkinleştirildiğinde orijinal ağ geçidi parametreleri (Ingress dinleyici seçenekleri, donanım hızlandırma, genel IP adresi engelleme ve izin listeleri ile gözlemlenebilirlik) üzerine yazılır ve bu durum trafiği etkileyebilir.

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

Parametre

Açıklama

spec.id

Yeniden kullanılacak hedef APIG ağ geçidi örneğinin ID'si. ID gw- ile başlamalıdır.

spec.override

Yeniden kullanılan APIG ağ geçidi örneği yapılandırmalarının ApigConfig ayarlarına göre üzerine yazılıp yazılmayacağını belirtir.

  • true olarak ayarlandığında: Var olan ağ geçidi yapılandırması (Ingress dinleyici seçenekleri, donanım hızlandırma, genel izin ve engelleme listeleri ile gözlemlenebilirlik) üzerine yazılır.

  • Bu parametreyi false olarak ayarlarsanız ağ geçidinin var olan yapılandırmaları (Ingress dinleyici seçenekleri, donanım hızlandırma, genel izin ve engelleme listeleri ile gözlemlenebilirlik gibi) üzerine yazılmaz. Ancak var olan bir ağ geçidi örneği konteyner kümesiyle ilişkilendirilmemişse ağ geçidi örneği otomatik olarak konteyner kümesiyle ilişkilendirilir ve Ingress dinleyici seçenekleri, ingressClass değeri spec.ingress.local.ingressClass değerine ayarlanmış olan konteyner kümesindeki Ingress kaynaklarını dinleyecek şekilde yapılandırılır.

APIG Ağ Geçidi Örneğini Silme

Yeniden kullanılan örnekler hariç, bir ApigConfig silindiğinde buna bağlı APIG ağ geçidi örneği de silinir.

Aşağıdaki tabloda silme ilkesi açıklanmaktadır.


Faturalandırma yöntemi


APIG Controller tarafından oluşturuldu


Konsoldan yeniden kullanılan ağ geçidi


kullandıkça öde


ApigConfig silindiğinde ağ geçidi örneği otomatik olarak silinir.


ApigConfig silindiğinde ağ geçidi örneği korunur.

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

kubectl delete ApigConfig your-config-name

Genel IP Erişim Kontrolünü Yapılandırma

IP İzin Listesi Yapılandırma

APIG Ingress'e yalnızca belirli kaynak IP'lerden erişime izin vermek için genel bir IP izin listesi yapılandırın.

Aşağıdaki örnek yalnızca 1.1.XX.XX kaynak IP'sinden ve 2.0.XX.XX/8 CIDR bloğundan gelen erişime izin verir.

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

IP Engelleme Listesi Yapılandırma

Belirli kaynak IP'lerinden gelen erişimi reddetmek için genel, örnek düzeyinde bir IP engelleme listesi yapılandırın.

Aşağıdaki örnek 1.1.XX.XX kaynak IP'sinden ve 2.0.XX.XX/8 CIDR bloğundan gelen istekleri reddeder.

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

SLS Günlük Toplamayı Etkinleştirme

Günlük toplamayı etkinleştirmeden önce APIG Controller'ın gerekli SLS izinlerine sahip olduğundan emin olun.

Aşağıdaki örnek ağ geçidini, erişim günlüklerini demo adlı bir SLS projesine göndermek üzere yapılandırır.

apiVersion: apig.alibabacloud.com/v1alpha1
kind: ApigConfig
metadata:
   name: apig-ingress
spec:
   ...
  monitor:
    logging:
      sls:
        # Configure reuseProject to enable Simple Log Service. If you want to use the default project, leave this field blank.
        reuseProject: "demo"
    ...

OpenTelemetry İzlemeyi Etkinleştirme

Üretim sorunlarını teşhis etmek için uçtan uca bir izleme sistemi oluşturmak amacıyla ağ geçidi için OpenTelemetry izlemeyi yapılandırın.

Aşağıdaki örnek %100 örnekleme oranı (sampleRate) ile OpenTelemetry izlemeyi yapılandırır.

apiVersion: apig.alibabacloud.com/v1alpha1
kind: ApigConfig
metadata:
   name: apig-ingress
spec:
   ...
  monitor:
    tracing:
      openTelemetry:
        sampleRate: "100"
   ...

Ek Yapılandırmalar

APIG Ingress ağ geçidi örneği aşağıdaki ek yapılandırmaları destekler:

Bu ayarları uygulamak için Cloud-native API Gateway konsoluna gidin. APIG Gateway > Gateway List sayfasında ağ geçidi örneğini seçin ve ardından sol gezinme bölmesinde Parameter Settings öğesine tıklayın.


Parametre


Tür


Açıklama


EnableGenerateRequestId


Bool


Etkinleştirildiğinde izleme amacıyla istek üstbilgisinde bir istek ID'si oluşturulur.


EnableGzip


Bool


İstekler ve yanıtlar için Gzip sıkıştırmayı etkinleştirir; bu işlem ağ geçidi trafiğini azaltır ancak CPU tüketimini artırır.


EnableSlashMerge


Bool


Etkinleştirildiğinde istek yollarındaki yinelenen '/' karakterlerini birleştirir. Örneğin, www.a.com//b yolu www.a.com/b haline gelir.


DownstreamConnectionBufferLimits


Int

Tek bir bağlantının arabellek boyutu; bu değer aktarım hızını ve ağ geçidi bellek kullanımını etkiler.

Geçerli aralık: [0, 2147483647].


XffTrustedNum


Int

Ağ geçidinin önündeki güvenilir proxy sunucusu sayısı. Bu değer, ağ geçidinin x-forwarded-for ve x-request-id gibi proxy'ler tarafından eklenen istek üstbilgilerini kullanıp kullanmayacağını etkiler.

Değer aralığı: [0, 10]. Birim: öğe.


DownstreamHttp2MaxConcurrentStream


Int

İstemci HTTP/2 kullandığında tek bir bağlantıdaki eşzamanlı akışların maksimum sayısı.

Değer aralığı: [0, 2147483647]. Birim: bayt.


InitialStreamWindowSize


Int

Ağ geçidi ile istemci arasında yapılan ilk HTTP/2 stream pencere boyutu.

Değer aralığı: [65535, 2147483647]. Birim: bayt.


InitialConnectionWindowSize


Int

Ağ geçidi ile istemci arasında yapılan ilk HTTP/2 bağlantı düzeyi pencere boyutu.

Değer aralığı: [65535, 2147483647]. Birim: bayt.


EnableHttp3


Bool

HTTP/3 protokolünün desteklenip desteklenmeyeceğini belirtir.

HTTP/3, TLS donanım hızlandırma ile uyumlu değildir. HTTP/3'ü etkinleştirmeden önce donanım hızlandırmayı devre dışı bırakmanız gerekir.


PathWithEscapedSlashes


Dize

URI yollarında %2F, %2f, %5C veya %5c gibi kaçış karakterleri içeren istekler için yapılacak eylemi belirler. Varsayılan değer KEEP_UNCHANGED olup karakterleri olduğu gibi korur.

Geçerli değerler: KEEP_UNCHANGED, REJECT_REQUEST, UNESCAPE_AND_REDIRECT ve UNESCAPE_AND_FORWARD.


ZipAlgorithm


List<String>


Sıkıştırma etkinleştirildikten sonra kullanılacak sıkıştırma algoritması. Bu parametre ayarlandığında EnableGzip seçeneği etkin değilse otomatik olarak etkinleştirilir. Geçerli değerler: brotli, gzip.


EnableProxyProtocol


Bool


PROXY protokolünün etkinleştirilip etkinleştirilmeyeceğini belirtir. Giriş trafiği bir Network Load Balancer (NLB) üzerinden yönlendiriliyorsa gerçek istemci IP adresini almak için bu seçeneği etkinleştirin. Etkinleştirilmesi PROXY protokolü olmayan istekleri etkilemez.


EnableCustomAuthConfigPush


Bool


Kendi kendine yönetilen yetkilendirme hizmetleri için kullanılır. Etkinleştirildiğinde yetkilendirme kurallarındaki değişiklikler aktif bağlantıları kesmez; bu durum WebSocket ve diğer gerçek zamanlı senaryolar için uygundur.


KeepaliveHeaderTimeout


Int

İstemciye döndürülen Keep-Alive yanıt üstbilgisi değerini ayarlar. Örneğin, değer 10 olarak ayarlandığında yanıt keep-alive: timeout=10 içerir. Değer 0 olarak ayarlandığında bu üstbilgi döndürülmez.

Değer aralığı: [0, 600]. Birim: saniye.


WebsocketTermGracePeriod


Int

Ağ geçidi yükseltmeler veya yeniden başlatmalar sırasında bağlantıları kapattığında aktif WebSocket bağlantıları için tanılama süresi.

Değer aralığı: [20, 900]. Birim: saniye.


EnableGzipHardwareAccelerate


Bool


Donanım hızlandırmalı Gzip sıkıştırmayı etkinleştirir. Yazılım tabanlı Gzip'e kıyasla daha yüksek performans sağlar ve daha düşük CPU tüketir. Bu seçenek desteklenmeyen bölgelerde veya satın alma sırasında Gzip donanım hızlandırma belirtilmemişse kullanılamaz. Etkinleştirildiğinde EnableGzip ve ZipAlgorithm ayarları geçerli olmaz.


EnableK8sSourceWorkloadFilter


Bool


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

SSS

Bir APIG Ingress'i sildikten ve yeniden oluşturduktan sonra uç nokta boş kalıyorsa ne yapmalıyım?

Bir Ingress'i silip aynı YAML dosyasını kullanarak yeniden oluşturursanız ancak bir süre beklemenize rağmen uç nokta hala boş kalıyorsa genellikle ApigConfig'de Ingress dinleyici seçenekleri yapılandırılmamıştır. Bu nedenle APIG ağ geçidi örneği Ingress kaynağını izlemez. Sorunu şu şekilde giderin:

  1. ApigConfig'de spec.ingress.local.ingressClass alanının yapılandırılıp yapılandırılmadığını kontrol edin. Bu alan yapılandırılmamışsa APIG ağ geçidi örneği hiçbir Ingress kaynağını izlemez ve Ingress'i yeniden oluşturduktan sonra uç nokta geri gelmez. Bu alanı apig olarak ayarlayın.

  2. Ingress'in IngressClass değerinin ApigConfig'deki ingress.local.ingressClass değeriyle eşleştiğinden emin olun. Bir Ingress'in IngressClass değerini kubernetes.io/ingress.class: apig ek açıklaması veya spec.ingressClassName alanı kullanarak belirtebilirsiniz.

  3. kubectl get apigconfig komutunu çalıştırarak ApigConfig durumunun Listening olup olmadığını kontrol edin.

  4. Önceki yapılandırmalar doğru olduktan sonra Ingress'i yeniden oluşturun. Uç nokta otomatik olarak geri gelir. APIG ağ geçidi örneğini yeniden oluşturmanıza gerek yoktur.