NGINX Ingress desteğinin sona ermesiyle kullanıcıların yeni bir ağ geçidi çözümüne geçiş yapması gerekir. Cloud-native API Gateway, yönlendirme kurallarını aktaran ve trafiği kendi yönettiğiniz NGINX Ingress'ten Cloud-native API Gateway'e yönlendiren arayüz tabanlı bir geçiş aracı sunar.
Önkoşullar
ACK kümenizde bir NGINX Ingress Controller dağıtılmış olmalıdır.
Bir Cloud-native API Gateway örneği oluşturmuş olmalısınız. Henüz oluşturmadıysanız Ağ geçidi örneği oluşturun.
Kullanım notları
Cloud-native API Gateway, Ingress yapılandırmalarını kopyalamaz. Mevcut Ingress kaynaklarınızda yapılan değişiklikleri gerçek zamanlı olarak ayrıştırır.
Geçiş sırasında Ingress yapılandırmasındaki değişiklikler hem NGINX Ingress Controller hem de Cloud-native API Gateway üzerinde yansıtılır.
Geçişten sonra üretim ortamındaki Ingress yapılandırmalarını silmeyin. Cloud-native API Gateway, mevcut ve gelecekteki Ingress yapılandırmalarını ayrıştırmaya devam eder.
Mevcut ve gelecekteki Ingress yapılandırmaları, Cloud-native API Gateway'in izlediği IngressClass ile ilişkili kalmalıdır. Örneğin, ingressClassName nginx/higress/apig ise geçişten sonra bunu değiştirmeyin.
Geçiş prosedürü
Cloud'a Geçiş aracı, rota geçişi ve trafik değiştirme adımlarında size rehberlik eder.
Resmi bir AI Skill (alibabacloud-nginx-ingress-to-api-gateway) kullanarak Ingress uyumluluğunu toplu olarak kontrol edebilir, uyumsuz açıklamalar için Wasm eklentileri ve yeni Ingress rota yapılandırmaları oluşturabilir ve eksiksiz bir geçiş kılavuzu hazırlayabilirsiniz.
Adım 1: Yönlendirme kurallarını geçirin
API Gateway konsolu adresine gidin.
Sol gezinme bölmesinde Cloud Migration seçeneğini seçin.
Cloud Migration sayfasında Create a task düğmesini tıklayın.
-
Create Migration Configuration panelinde parametreleri belirtin.
Cloud-native API Gateway, seçilen kümedeki kaynak IngressClass ile ilişkili tüm Ingress kaynaklarını izler ve bunların alan adı ile rota yapılandırmalarını uygular.
ÖnemliHedef ağ geçidi zaten bu kümeyle ilişkiliyse ancak farklı bir IngressClass kullanıyorsa geçiş başarısız olur. Belirttiğiniz IngressClass, ilişkili küme için yapılandırılan IngressClass ile eşleşmelidir.
Parametre
Açıklama
Instance
Hedef ağ geçidi örneği.
Source Cluster
Geçirilecek NGINX Ingress'i barındıran konteyner kümesi. Cloud-native API Gateway ile aynı VPC içinde olmalıdır.
API Name
İçe aktarılan NGINX Ingress rotalarını alan HTTP API'si.
resource
Hedef kaynak grubu.
Namespace
Geçirilecek Ingress kaynaklarının ad alanı.
IngressClass
Geçirilecek Ingress kaynaklarının IngressClass değeri.
Not-
Yalnızca tek bir IngressClass belirtilebilir.
-
Boş bırakılırsa ağ geçidi, IngressClass fark etmeksizin tüm Ingress kaynaklarını izler.
-
-
Next düğmesini tıklayın.
Cloud-native API Gateway, kaynak IngressClass ile ilişkili tüm Ingress kaynaklarını izler ve alan adı ile rota yapılandırmalarını yeni API'ye uygular.
Örneğin, kaynak konteyner kümenizde nginx-route adlı bir Ingress kaynağınız olduğunu varsayalım.
Cloud-native API Gateway konsolunda, ağ geçidinin kaynak kümeden Ingress'i otomatik olarak senkronize ettiğini ve ilgili alan adı ile rota yapılandırmalarını oluşturduğunu görebilirsiniz.
Adım 2: Rotaları doğrulayın
Ingress kaynağı uyumluluğunu doğrulayın:
Uyumsuz Ingress açıklaması bulunmazsa sonraki adıma geçin.
-
Uyumsuz Ingress açıklamaları varsa HiClaw, CoPaw veya QoderWork gibi AI araçlarını resmi geçiş Skill'i alibabacloud-nginx-ingress-to-api-gateway ile birlikte kullanarak yapılandırmaları analiz edin, uyumsuz açıklamalar için Wasm eklentileri oluşturun ve bir çalışma kılavuzu hazırlayın. Sorunlar devam ederse bir destek talebi oluşturun.
ÖnemliDeğeri boş dize ("") ise
nginx.ingress.kubernetes.io/service-weightaçıklamasını yok sayabilirsiniz. Bu açıklama eski ACK konsol sürümlerinde varsayılan olarak eklenmiştir ve işlevsel bir etkisi yoktur.Geçiş sırasında uyumsuz açıklamaları silmeyin. NGINX Ingress Controller, üretim trafiği için hâlâ bu açıklamaları kullanır.
Adım 3: Bir trafik değiştirme yöntemi seçin
Trafiği değiştirmeden önce test edin
Canlı trafiği değiştirmeden önce yerel ortamda test yapın. Hizmet alan adınızı yerel hosts dosyanızda Cloud-native API Gateway SLB IP'sine yönlendirin ve ardından curl veya Postman kullanarak yönlendirmeyi doğrulayın.
Bir trafik değiştirme yöntemi seçin
Orijinal SLB'yi yeniden kullan
Bu yöntem, Cloud-native API Gateway düğümlerini orijinal SLB örneğinin arka uç vServer grubuna ekler. SLB, geçiş sırasında trafiği ağırlığa göre dağıtır ve işlem tamamlandığında tüm trafiği Cloud-native API Gateway'e yönlendirir.
Aşağıdaki parametreleri yapılandırın:
|
Parametre |
Açıklama |
|
ACK Cluster Namespace |
NGINX Ingress SLB ile ilişkili Kubernetes Service'in ad alanı. |
|
ACK Cluster SLB Service |
NGINX Ingress SLB ile ilişkili Kubernetes Service. |
|
SLB ID |
Sorgulanan SLB'nin geçiş hedefi olduğunu onaylayın. |
|
Ports and Backend Servers |
Orijinal SLB'nin dinleyici bağlantı noktası ve protokolü (HTTP/HTTPS). Hedef vServer grubu otomatik olarak görüntülenir. Not
Trafik kaybını önlemek için doğru bağlantı noktasını ve protokolü seçtiğinizden emin olun. |
DNS üzerinden trafiği değiştir
DNS sağlayıcınızın konsolunda, geçirilen alan adlarını Cloud-native API Gateway SLB adresine yönlendiren kayıtlar ekleyin. Aşamalı trafik geçişi için ağırlıklı DNS kayıtlarını kullanın.
Adım 4: Trafiği değiştirin
Orijinal SLB'yi yeniden kullan
Adım 1: Change SLB düğmesini tıklayın
Change SLB düğmesine tıklamak, SLB'yi konteyner hizmeti yönetiminden ayırır ve dinleyici zamanlamasını Weighted Round Robin olarak ayarlar.
Bu adım, SLB'yi konteyner hizmeti yönetiminden ayırır. Ayırma işleminden sonra SLB, NGINX Ingress Controller'daki Pod IP değişikliklerini algılayamaz. Açıklamaları değiştirmek ve Kubernetes Service'i SLB ile yeniden ilişkilendirmek için hemen sonraki adıma geçin.
Adım 2: Service açıklamalarını üzerine yazın
1. Adımdan sonra ACK konsoluna gidin. Reuse the original SLB adımında seçilen Kubernetes Service'teki mevcut tüm açıklamaları silin. Traffic Switching sayfasında oluşturulan açıklamaları kopyalayın ve hedef Service'e ekleyin. Bu işlem, Service'i SLB'yi yeniden kullanacak şekilde yeniden yapılandırır. İlerlemeden önce doğrulamak için Pre-check düğmesini tıklayın.
Adım 3: Ağırlığa göre trafiği değiştirin
Cloud-native API Gateway trafik ağırlığını (1-100) ayarlayın. 1 ile 10 arasında bir değerle başlayın.
Bu değer, tüm Cloud-native API Gateway düğümlerinin toplam ağırlığıdır. SLB, trafiği ağ geçidi düğümleri ile NGINX Ingress düğümleri arasındaki ağırlık oranına göre dağıtır (varsayılan toplam ağırlık: 100). Ağ geçidi ağırlığını 100 olarak ayarlamak trafiğin yarısını, 50 olarak ayarlamak ise üçte birini verir.
-
Cloud-native API Gateway panolarını kullanarak ağ geçidi sağlığını ve iş ölçümlerini izleyin.
Ölçümler sağlıklıysa ağırlığı kademeli olarak artırın. Değişiklikler arasında en az 3 dakika bekleyin (yapılandırma eşzamansız olarak uygulanır).
Ölçümler kötüleşirse ağırlığı 0'a ayarlayarak geçişi durdurun.
Orijinal SLB'yi yeniden kullan adımında seçilen Kubernetes Service'teki
service.beta.kubernetes.io/alibaba-cloud-loadbalancer-weightaçıklamasını düşürerek de ağ geçidi ağırlığını dolaylı yoldan artırabilirsiniz. Bu açıklamayı 0 olarak ayarlamak tüm trafiği Cloud-native API Gateway'e yönlendirir.SLB 4. Katmanda (bağlantı düzeyinde) çalıştığından ağırlık değerleri istek düzeyindeki dağıtımı tam olarak kontrol etmez.
Başarı oranı düşerse hızlı geri alma için ağırlığı 0'a ayarlayın.
NGINX Ingress ile Cloud-native API Gateway arasında trafik ağırlıklarını ayarlama yeteneğini korumak için bu adımda kalın. Trafik doğrulandığında ve geri alma yeteneğine artık ihtiyaç duyulmadığında ilerlemek için Complete Traffic Verification düğmesini tıklayın.
Complete Traffic Verification düğmesine tıkladıktan sonra ağırlığı artık değiştiremezsiniz.
Adım 4: Tüm trafiği değiştirin
ACK konsolunda, Adım 3: Bir trafik değiştirme yöntemi seçin bölümünde seçilen Kubernetes Service için service.beta.kubernetes.io/alibaba-cloud-loadbalancer-weight açıklamasını 0 olarak ayarlayın veya Service kaynağını silin. Sistem, NGINX Ingress Controller düğümlerini SLB'den kaldırır ve tüm trafiği Cloud-native API Gateway'e yönlendirir. İşlemi tamamlamak için Complete Migration düğmesini tıklayın.
DNS üzerinden trafiği değiştir
DNS sağlayıcınızın konsolunda, geçirilen alan adlarını Cloud-native API Gateway SLB adresine yönlendiren kayıtlar ekleyin. Aşamalı trafik geçişi için ağırlıklı DNS kayıtlarını kullanın.
Hızlı geri alma
Geçiş sırasında yönlendirme sorunları oluşursa trafiği NGINX Ingress Controller'a geri alın:
'Orijinal SLB'yi yeniden kullan' yöntemini kullanıyorsanız ağırlığı 0'a ayarlayın.
DNS anahtarlama kullanıyorsanız alan adlarınızı Cloud-native API Gateway SLB adresine yönlendiren DNS kayıtlarını kaldırın.
Adım 5: Geçişi tamamlayın
Orijinal SLB'yi yeniden kullan
Henüz tamamen değiştirilmemiş başka SLB'leriniz varsa bunların trafik değiştirmelerini tamamlayın. Tüm SLB trafiği değiştirildikten sonra Kubernetes Service'i ve gerekmiyorsa NGINX Ingress Controller'ı silin.
DNS üzerinden trafiği değiştir
Tüm alan adları Cloud-native API Gateway SLB'yi çözümlediğinde Kubernetes Service'i ve gerekmiyorsa NGINX Ingress Controller'ı silin.