Bu konu, MSE konsolundaki görsel geçiş aracını kullanarak kendi kendinize yönettiğiniz bir Nginx Ingress'i MSE Ingress'e nasıl geçireceğinizi açıklar.
Ön Koşullar
Container Service kümenizde bir Nginx Ingress Controller dağıtılmıştır.
Bir Cloud Native Gateway mevcuttur. Mevcut değilse bkz. MSE Cloud Native Gateway Oluşturma.
Kullanım Notları
Geçiş işlemi Ingress yapılandırmalarınızı kopyalamaz. Bunun yerine, MSE Ingress mevcut Ingress kaynaklarınızdaki değişiklikleri gerçek zamanlı olarak izleyip ayrıştırarak yapılandırmalarınızı yeniden kullanmanızı sağlar.
Geçiş sırasında hem Nginx Ingress Controller hem de MSE Ingress, Ingress yapılandırmalarınızda yaptığınız tüm değişiklikleri yansıtır.
Geçiş tamamlandıktan sonra, kullanımda olan herhangi bir Ingress yapılandırmasını silmeyin. Geçiş yalnızca MSE Ingress'in mevcut ve gelecekteki Ingress yapılandırmalarını izlemesini ve ayrıştırmasını sağlar.
Geçişten sonra, mevcut ve gelecekteki Ingress yapılandırmalarını orijinal IngressClass ile ilişkili tutmanız gerekir. Örneğin, bir Ingress kaynağı daha önce spec alanında
ingressClassName: nginxbelirtiyorsa, geçişten sonra da bunu belirtmeye devam etmelidir.
Geçiş Yöntemleri
Ayrıntılar
Geçiş İş Akışı
Cloud Native Gateway, yönlendirme yapılandırmalarınızı geçirmenize ve trafiği kaydırmanıza adım adım rehberlik eden bir Cloud Migration aracı sağlar.
Adım 1: Yönlendirme Kurallarını Geçirin
MSE konsolunda oturum açın. Üst gezinme çubuğunda bir bölge seçin.
Sol gezinme bölmesinde Cloud Native Gateway > Migration to Cloud seçeneğini belirleyin.
Migration to Cloud sayfasında Add Task öğesine tıklayın.
-
Create Migration Configuration panelinde parametreleri belirtin.
Cloud Native Gateway, seçilen konteyner kümesindeki kaynak IngressClass ile ilişkili tüm Ingress kaynaklarını izler. Ardından bunların alan adı ve yönlendirme yapılandırmalarını uygular.
ÖnemliHedef Cloud Native Gateway zaten farklı bir IngressClass kullanarak bu konteyner kümesiyle ilişkilendirilmişse geçişe izin verilmez. Burada belirtilen IngressClass'ın küme için zaten yapılandırılmış olanla eşleştiğinden emin olun.
Parametre
Açıklama
Cloud-native Gateway
Geçiş için hedef Cloud Native Gateway'i seçin. Ağ geçidi sürümü 1.2.22 veya üzeri olmalıdır.
Container Service ACK/ACK Serverless cluster
Geçirilecek Nginx Ingress'i içeren Container Service kümesini seçin. Cloud Native Gateway ile konteyner kümesinin aynı VPC'de olduğundan emin olun.
Source Ingress Class
Geçirmek istediğiniz Ingress kaynaklarıyla ilişkili IngressClass'ı belirtin.
NotYalnızca bir IngressClass belirtebilirsiniz.
Bu parametreyi boş bırakırsanız IngressClass yok sayılır ve ağ geçidi kümedeki tüm Ingress kaynaklarını izler.
Açıklama
En fazla 64 karakter uzunluğunda bir açıklama girin.
-
Next öğesine tıklayın.
Cloud Native Gateway artık seçilen konteyner kümesinde bulunan ve kaynak IngressClass ile ilişkili tüm Ingress kaynaklarının değişikliklerini otomatik olarak izler. Ardından bu kaynakların alan adı ve yönlendirme yapılandırmalarını uygular.
Kaynak konteyner kümesinde httpbin adlı bir Ingress'iniz olduğunu varsayalım.
-
Cloud Native Gateway konsolunda, kaynak kümeden gelen Ingress'in otomatik olarak hedef ağ geçidine senkronize edildiğini ve ilgili alan adı ile yönlendirme yapılandırmalarını oluşturduğunu görürsünüz. Routing Settings ayrıntıları sayfası aşağıda gösterildiği gibidir:
-
Configuration wizard:
-
Add service source
Hizmet kaynağı olarak K8s, Nacos, Zookeeper, SAE, EDAS ve Function Compute (FC) kullanabilirsiniz. Mevcut VPC'nizden mevcut bir kaynağı ekleyebilir ve ardından içinden kayıtlı bir hizmeti seçebilirsiniz.
Düğme: Add service source
-
Associate backend service
İstekleri bir arka uç hizmetine dağıtır. Bu hizmet, bir hizmet kaynağından dinamik olarak keşfedilebilir veya statik bir adres ya da alan adı ile belirtilebilir.
Düğme: Associate backend service
-
Bind domain name
Çoklu alan adı yönetimi sağlar. Bir alan adı bağlayarak protokolleri, sertifikaları ve yönlendirme yapılandırmalarını farklı alan adlarıyla ilişkilendirebilirsiniz.
Düğme: Bind domain name
-
Create route
Bir rota; alan adlarına, yollara, yöntemlere, istek parametrelerine ve istek üstbilgilerine dayalı eşleştirme kuralları içerir. Bir kullanıcı bir rotaya eriştiğinde istek ilgili arka uç hizmetine iletilir.
Düğme: Create route
-
Liste sütunları: Route name, Status, WAF protection, Source, Route condition, Associated domain name, Destination service type, Destination service ve Actions.
-
Adım 2: Rotaları Doğrulayın
İzlenen Ingress ek açıklamalarının uyumluluğunu kontrol edin:
Uyumsuz Ingress ek açıklaması yoksa sonraki adıma geçin.
-
Uyumsuz Ingress ek açıklamaları bulursanız çözüm için bir destek talebi gönderin.
ÖnemliDeğeri
""isenginx.ingress.kubernetes.io/service-weightek açıklamasını yok sayabilirsiniz. Bu ek açıklama, Container Service konsolunun önceki bir sürümü tarafından varsayılan olarak eklenir ve etkisi yoktur.Geçiş sırasında, kullanımda olan uyumsuz ek açıklamaları kaldırmayın. Bu ek açıklamalar hala Nginx Ingress Controller tarafından ayrıştırılır ve iş trafiğinizi etkiler. MSE Ingress'te aynı işlevselliği elde etmek için Ingress kaynağına genişletilmiş MSE ek açıklamaları ekleyebilirsiniz. Tüm trafik MSE Ingress'e geçirildikten sonra uyumsuz ek açıklamaları gerektiği gibi kaldırabilirsiniz.
Adım 3: Kaydırma Yöntemini Seçin
Trafiği Kaydırmadan Önce Test Edin
Üretim trafiğini kaydırmadan önce yerel bir test gerçekleştirin. İş alan adını Cloud Native Gateway SLB'ye çözmek için yerel hosts dosyanızı değiştirin. cURL veya Postman gibi bir araç kullanarak tüm trafiğin beklendiği gibi davrandığını doğrulayın.
Kaydırma Yöntemini Seçin
Kaynak SLB'yi Yeniden Kullan
Prensip: Süreç, Cloud Native Gateway düğüm örneklerini kaynak SLB'nin arka uç sunucu grubuna ekler. Geçiş sırasında SLB, yapılandırılan ağırlıklara göre iş trafiğini Cloud Native Gateway'e dağıtır. Geçiş tamamlandığında SLB tüm trafiği Cloud Native Gateway'e iletir.
Aşağıdaki tabloda parametreler açıklanmaktadır.
Parametre | Açıklama |
ACK Cluster Namespace | Nginx Ingress SLB ile ilişkili Kubernetes Hizmetinin bulunduğu ad alanını seçin. |
ACK Cluster SLB Service | Nginx Ingress SLB ile ilişkili Kubernetes Hizmetinin adını seçin. |
SLB ID | Doğru geçiş hedefi olduğunu onaylamak için SLB örneğine tıklayın. |
Ports and Backend Servers | Kaynak SLB örneğinin dinleyici bağlantı noktasını ve ağ geçidi protokolünü (HTTP/HTTPS) seçin. Hedef sanal sunucu grubu otomatik olarak görünür. Not Trafik kaybını önlemek için doğru bağlantı noktasını ve protokolü seçtiğinizden emin olun. |
DNS Çözümleme
DNS sağlayıcınızın alan adı çözümleme hizmetine gidin ve rota geçişine dahil edilen tüm alan adları için Cloud Native Gateway SLB adresine eşlemeler ekleyin. Trafiği kademeli olarak kaydırmak için DNS ağırlıklı çözümleme kullanmanızı öneririz.
Adım 4: Trafiği Kaydırın
Kaynak SLB'yi Yeniden Kullan
Adım 1: SLB'yi Değiştirin
Modify SLB öğesine tıkladıktan sonra sistem, SLB örneğini otomatik olarak Container Service yönetiminden ayırır ve dinleyicinin zamanlama algoritmasını Weighted Round Robin olarak değiştirir.
Bu adım, SLB örneğini Container Service yönetiminden ayırır. Ayırma işleminden sonra SLB örneği, Nginx Ingress Controller'daki Pod IP adresi değişikliklerini artık izlemez. Ek açıklamaları değiştirmek ve Kubernetes Hizmetini SLB örneğiyle yeniden ilişkilendirmek için bir sonraki adıma hızla geçin.
Adım 2: Hizmet Ek Açıklamalarını Üzerine Yazın
Adım 1'i tamamladıktan sonra Container Service konsoluna gidin. Switch Traffic adımında seçtiğiniz Kubernetes Hizmetinden mevcut tüm ek açıklamaları manuel olarak silin. Ardından, Traffic Switchover sayfasında otomatik olarak oluşturulan ek açıklamaları kopyalayın ve hedef Kubernetes Hizmetine ekleyin. Bu adım, orijinal Kubernetes Hizmetini SLB örneğini yeniden kullanacak şekilde yeniden yapılandırır. Değişiklikten sonra Precheck öğesine tıklayın. Kontrol başarılı olursa bir sonraki adıma geçebilirsiniz.
apiVersion: v1
kind: Service
metadata:
annotations:
service.beta.kubernetes.io/alibaba-cloud-loadbalancer-id: lb-bp1lc0huzf0o1ks333yo1
service.beta.kubernetes.io/alibaba-cloud-loadbalancer-weight: '100'
service.beta.kubernetes.io/alibaba-cloud-loadbalancer-vgroup-port: 'rsp-bp1uybv6iy50i:80,rsp-bp10s0ndrfvdt:443'
creationTimestamp: '2023-11-29T07:14:40Z'
finalizers:
- service.k8s.alibaba/resources
labels:
app: nginx-ingress-lb
service.beta.kubernetes.io/hash: 39a51bd97b88f6eaf232da33434ce2fe44ae094b7b4d2b9bb9126eb7
service.k8s.alibaba/loadbalancer-id: lb-bp1lc0huzf0o1ks333yo1
managedFields:
- apiVersion: v1
fieldsType: FieldsV1
fieldsV1:
'f:metadata':
'f:annotations':
.: {}
'f:kubectl.kubernetes.io/last-applied-configuration': {}
'f:service.beta.kubernetes.io/alibaba-cloud-loadbalancer-connection-drain': {}
'f:service.beta.kubernetes.io/alibaba-cloud-loadbalancer-connection-drain-timeout': {}
'f:service.beta.kubernetes.io/alibaba-cloud-loadbalancer-instance-charge-type': {}
'f:service.beta.kubernetes.io/alibaba-cloud-loadbalancer-resource-group-id': {}
'f:labels':
.: {}
'f:app': {}
Aynı konteyner kümesindeki uygulama podları Nginx Ingress ağ geçidine erişiyorsa, Hizmetinize service.beta.kubernetes.io/alibaba-cloud-loadbalancer-hostname: mse-ingress-migration ek açıklamasını da eklemeniz gerekir. Ek açıklamayı eklemeden önce Hizmetle ilişkili SLB örneği için IP erişim kontrolünün devre dışı bırakıldığından emin olun. Bu ek açıklama, uygulama podlarını Nginx Ingress ağ geçidine SLB üzerinden erişmeye zorlar ve Kube Proxy'nin trafiği optimize ederek SLB'yi atlayıp doğrudan Nginx Ingress poduna erişmesini engeller.
Adım 3: Ağırlıklı Trafik Kaydırma
Cloud Native Gateway örneği için trafik ağırlığını ayarlayın. İş ihtiyaçlarınıza göre 1 ile 100 arasında bir değer girin. İlk değer olarak 1 ile 10 arasında bir değer önerilir.
Bu değer, tüm Cloud Native Gateway düğümlerinin ağırlıklarının toplamıdır. SLB örneği, trafiği sanal sunucu grubundaki Cloud Native Gateway düğümleri ile Nginx Ingress düğümleri arasındaki ağırlık oranına göre dağıtır. Nginx Ingress düğümlerinin toplam ağırlığı varsayılan olarak 100'dür. Bu nedenle, Cloud Native Gateway ağırlığını 100 olarak ayarlarsanız trafiğin yarısını alır. Benzer şekilde, ağırlığı 50 olarak ayarlarsanız trafiğin üçte birini alır.
-
Geçiş sırasında, ağ geçidinin sağlık durumunu kontrol etmek ve iş ölçümlerinin kararlı olduğundan emin olmak için Cloud Native Gateway izleme panosundaki ağ geçidi ölçümlerini izleyebilirsiniz.
Sonuçlar beklendiği gibiyse ağırlığı kademeli olarak artırabilirsiniz. Ağırlık değişiklikleri arasında en az 3 dakika bekleyin, çünkü arka uç yapılandırmayı eşzamansız olarak uygular.
Sonuçlar beklendiği gibi değilse geçişi durdurmak için ağırlığı 0 olarak ayarlayın.
Container Service konsolunda, orijinal kümenin SLB'sini yeniden kullanmak için seçilen Kubernetes Hizmetinin
service.beta.kubernetes.io/alibaba-cloud-loadbalancer-weightek açıklamasının değerini düşürerek Cloud Native Gateway'in ağırlığını dolaylı yoldan artırabilirsiniz. Özellikle, bu ek açıklamanın değeri 0 olduğunda tüm trafik Cloud Native Gateway'e yönlendirilir.SLB bir Katman 4 yük dengeleyici olduğundan trafiği bağlantı düzeyinde kontrol eder. Ağırlık değeri, istek düzeyindeki dağıtım oranını hassas bir şekilde kontrol edemez.
Trafiği kaydırdıktan sonra başarı oranı düşerse bu ağırlığı 0 olarak ayarlayarak hızlı geri alma gerçekleştirebilirsiniz.
Uzun bir süre boyunca geçiş durumunda kalmak ve Nginx Ingress ile MSE Ingress arasındaki trafik ağırlıklarını istediğiniz zaman ayarlayabilmek istiyorsanız bu adımda kalın. Trafiğin beklendiği gibi davrandığını doğruladıktan ve tüm trafiği Nginx Ingress'e geri almanız gerekmeyeceğinden emin olduktan sonra ilerlemek için Complete Traffic Verification öğesine tıklayabilirsiniz.
Complete Traffic Verification öğesine tıkladıktan sonra artık ağırlıkları değiştiremezsiniz.
Adım 4: Trafik Anahtarlamasını Tamamlayın
Container Service konsolunda, Adım 3: Bir trafik kaydırma yöntemi seçin bölümünde seçtiğiniz K8s Hizmeti için service.beta.kubernetes.io/alibaba-cloud-loadbalancer-weight ek açıklamasının değerini 0 olarak ayarlayın veya Hizmet kaynağını silin. Nginx Ingress Controller düğümleri daha sonra SLB'den otomatik olarak kaldırılır ve tüm SLB trafiği Cloud Native Gateway'e anahtarlanır. Geçiş görevini bitirmek için Complete Migration öğesine tıklayın.
DNS Çözümleme
DNS sağlayıcınızın alan adı çözümleme hizmetine gidin ve rota geçişine dahil edilen tüm alan adları için Cloud Native Gateway SLB adresine eşlemeler ekleyin. Trafiği kademeli olarak kaydırmak için DNS ağırlıklı çözümleme kullanmanızı öneririz.
Hızlı Geri Alma
Trafik geçişi sırasında beklenmedik sorunlarla karşılaşırsanız trafiği Nginx Ingress Controller'a geri yüklemek için hızlı geri alma işlemi gerçekleştirmek üzere aşağıdaki yöntemleri kullanabilirsiniz.
Kaynak küme SLB'sini yeniden kullanma: Ağırlığı 0 olarak ayarlayın. Bu işlem geçişi durdurur.
Cloud Native Gateway SLB'ye çözümlemek için DNS kullanma: DNS sağlayıcınızda tüm iş alan adları için Cloud Native Gateway SLB adresini kaldırın.
Adım 5: Geçişi Tamamlayın
Kaynak SLB'yi Yeniden Kullan
SLB trafik kaydırma yöntemini kullandıysanız ilgili tüm SLB örnekleri için trafiğin tamamen kaydırıldığından emin olun. Tüm SLB örnekleri için trafik kaydırmayı tamamladıktan sonra Kubernetes Hizmetini ve Nginx Ingress Controller'ı gerektiği gibi silebilirsiniz.
DNS Çözümleme
DNS trafik kaydırma yöntemini kullandıysanız ve tüm iş alan adlarınızın IP adresleri artık MSE ağ geçidinin SLB adres listesine çözülüyorsa Kubernetes Hizmetini ve Nginx Ingress Controller'ı gerektiği gibi silebilirsiniz.
Sorun Giderme
Bad request: mse.backend.gw.MIGRATE_INGRESS_CLASS_CONFLICT
Bu hata, ağ geçidinizin zaten Container Service kümesiyle ilişkilendirildiğini ve Ingress izlemeyi etkinleştirdiğini ancak bu geçiş için belirtilen IngressClass'ın orijinal Ingress izleme yapılandırmasıyla eşleşmediğini gösterir. IngressClass yapılandırmalarının tutarlı olduğundan emin olun.
Daha önce yapılandırılan IngressClass'ı değiştirmeniz gerekiyorsa kurulumunuza bağlı olarak aşağıdaki yöntemlerden birini seçin:
MSE Ingress'i bir MseIngressConfig aracılığıyla yönetiyorsanız değiştirmek için bkz. MSE Ingress Kullanarak Container Service ve Container Compute Service'e Erişim.
MSE Ingress'i bir MseIngressConfig aracılığıyla yönetmiyorsanız ağ geçidi konsoluna gidin, hizmet kaynağını bulun ve ilgili konteyner kümesi için Ingress izleme seçeneklerini değiştirin.
Bad request: mse.backend.gw.MIGRATE_SERVICE_ANNOTATION_NOT_MATCH [annotation is not expected]
Bu hata, Kubernetes Hizmetinizdeki ek açıklamaların gereken değerlere güncellenmediğini gösterir.
Bad request: mse.backend.gw.MIGRATE_SERVICE_NOT_MATCH [weight hasn't been 0 or service hasn't been deleted]
Bu durum, K8s Hizmeti için service.beta.kubernetes.io/alibaba-cloud-loadbalancer-weight ek açıklamasının değerinin 0 olarak ayarlanmadığını veya K8s Hizmetinin silinmediğini gösterir. Container Service konsolunda service.beta.kubernetes.io/alibaba-cloud-loadbalancer-weight ek açıklamasının değerini 0 olarak ayarlayın veya K8s Hizmetini silin.

