Alibaba Cloud Service Mesh:GitOps için Argo CD'yi ASM ile Entegre Etme

Ön Koşullar

• Sürümü 1.12.4.50 veya üzeri olan bir ASM örneği oluşturdunuz. Daha fazla bilgi için bkz. ASM örneği oluşturma.

• Küme, ASM örneğine eklendi.

• Bir Git deposu oluşturdunuz.

Arka Plan Bilgileri

Adım 1: Argo CD'yi Yükleme

Argo CD'yi manuel olarak yükleyebilir veya Container Service for Kubernetes (ACK) Uygulama Merkezi'ndeki yerleşik Argo CD özelliğini kullanabilirsiniz. Bu konuda, GitOps iş akışı için ASM ile entegre edilmiş Argo CD'nin manuel kurulumu gösterilmektedir.

• Argo CD'yi manuel olarak yüklemek için Argo CD belgelerine bakın.

• ACK Uygulama Merkezi, manuel yükleme yapmanıza gerek kalmayan yerleşik bir Argo CD özelliği sunar. ACK Uygulama Merkezi sayesinde uygulama durumlarını kontrol edebilir, Git depolarını ve Helm grafiklerini kullanarak uygulama sürümlerini Kubernetes kümelerine dağıtabilir ve geri alma ile sürüm yayınlama işlemlerini yönetebilirsiniz. Daha fazla bilgi için bkz. Uygulama Merkezine genel bakış.

Adım 2: Veri Düzlemi KubeAPI Erişimini Etkinleştirme

Alibaba Cloud Service Mesh (ASM), yönetilen ve Istio uyumlu bir kontrol düzlemidir; bu nedenle Service Mesh ASM kontrol düzlemi ile veri düzlemi (Container Service for Kubernetes (ACK)) farklı Kubernetes kümelerinde bulunur. Bu yüzden, Argo CD'nin ACK kümesindeki kaynaklara eriştiği şekilde ASM kümesindeki Istio kaynaklarına erişebilmesi için ASM'de veri düzlemi KubeAPI erişimini etkinleştirmeniz gerekir.

1. ASM konsoluna giriş yapın. Sol gezinme bölmesinde Service Mesh > Mesh Management seçeneklerini seçin.

2. Mesh Management sayfasında, yapılandırmak istediğiniz ASM örneğini bulun. ASM örneğinin adına tıklayın veya Actions sütunundaki Manage seçeneğine tıklayın.

3. Basic Information bölümünde, Enable Data-plane KubeAPI access yanındaki Enable seçeneğine tıklayın.

4. Açılan iletişim kutusunda Submit seçeneğine tıklayın.

Adım 3: Bir ASM Ağ Geçidi Oluşturma

1. ASM konsoluna giriş yapın. Sol gezinme bölmesinde Service Mesh > Mesh Management seçeneklerini seçin.

2. Mesh Management sayfasında ASM örneğinin adına tıklayın. Sol gezinme bölmesinde ASM Gateways > Ingress Gateway seçeneklerini seçin.

3. Ingress Gateway sayfasında Create seçeneğine tıklayın. Ayarları yapılandırın ve ardından Create seçeneğine tıklayın.

   Aşağıdaki tabloda bazı parametreler açıklanmaktadır. Tüm parametreler hakkında daha fazla bilgi için bkz. Ingress ağ geçidi oluşturma.

   Parametre	Açıklama
   Name	Bu konuda örnek olarak ingressgateway kullanılmaktadır.
   Gateway types	North-South IngressGateway için Kuzey-Güney-Ingress öğesini seçin.
   Port Mapping	Add Port seçeneğine tıklayın ve aşağıdaki protokolleri ve bağlantı noktalarını yapılandırın. Protocol değerini HTTP ve Service Port değerini 80 olarak ayarlayın. Protocol değerini HTTPS ve Service Port değerini 443 olarak ayarlayın.

Adım 4: Istio Kaynaklarını Argo CD ile Dağıtma

Istio kaynaklarını Kubernetes manifestoları olarak tanımlayıp uygulamanızın manifestolarıyla birlikte Git deposunda saklayabilirsiniz.

1. Bookinfo örnek uygulamasını oluşturun.

   1. Argo CD kullanıcı arayüzünde NEW APP seçeneğine tıklayın ve aşağıdaki ayarları yapılandırın.

      • GENERAL bölümünde Application Name değerini bookinfo, Project değerini default olarak ayarlayın ve PRUNE RESOURCES seçeneğini işaretleyin.

      • SOURCE bölümünde Repository URL değerini https://github.com/AliyunContainerService/asm-labs.git, Revision değerini argocd-asm ve Path değerini argo-cd/bookinfo olarak ayarlayın.

      • DESTINATION bölümünde Cluster URL değerini https://kubernetes.default.svc ve Namespace değerini default olarak ayarlayın.

   2. Yapılandırmayı tamamladıktan sonra sayfanın üst kısmındaki CREATE seçeneğine tıklayın.

      Oluşturma işlemi tamamlandığında, Argo CD uygulama listesinde bookinfo uygulaması Healthy (yeşil kalp simgesi) ve Synced (yeşil onay işareti simgesi) durumuyla görünür. Bu durum, uygulamanın hedef kümeye başarıyla senkronize edildiğini gösterir. Uygulama ayrıntıları sayfasına gitmek için bookinfo öğesine tıklayın; burada APP HEALTH değeri Healthy ve CURRENT SYNC STATUS değeri Synced olarak görüntülenir. Kaynak ağacında Deployment kaynakları (details-v1, productpage-v1, ratings-v1, reviews-v1, reviews-v2 ve reviews-v3), bunlarla ilişkili ReplicaSet'ler ve Pod'lar (çalışan 2/2 durumunda) ile DestinationRule (details, productpage ve reviews), Gateway (bookinfo-gateway) ve VirtualService (bookinfo) kaynakları bulunur; tüm kaynaklar senkronize ve sağlıklı durumdadır.

2. Kaynak durumunu ASM konsolunda doğrulayın.

   1. ASM konsoluna giriş yapın. Sol gezinme bölmesinde Service Mesh > Mesh Management seçeneklerini seçin.

   2. Mesh Management sayfasında ASM örneğinin adına tıklayın. Sol gezinme bölmesinde Traffic Management Center > VirtualService seçeneklerini seçin.

   3. Virtual Service sayfasında bookinfo VirtualService'in oluşturulduğunu doğrulayın.

3. Kaynak durumunu ACK konsolunda doğrulayın.

   1. ACK konsoluna giriş yapın. Sol gezinme bölmesinde Clusters seçeneğine tıklayın.

   2. Clusters sayfasında kümenizin adına tıklayın. Sol gezinme bölmesinde Workloads > Deployments seçeneklerini seçin.

   3. Deployment'ların oluşturulduğunu doğrulayın. Sayfada, her biri çalışan bir Pod'a sahip altı Deployment'ın (details-v1, productpage-v1, ratings-v1, reviews-v1, reviews-v2 ve reviews-v3) başarıyla oluşturulduğu gösterilir.

4. Uygulamaya ASM ağ geçidi üzerinden erişin.

   1. ASM ağ geçidi adresini alın.

      1. ASM konsoluna giriş yapın. Sol gezinme bölmesinde Service Mesh > Mesh Management seçeneklerini seçin.

      2. Mesh Management sayfasında ASM örneğinin adına tıklayın. Sol gezinme bölmesinde ASM Gateways > Ingress Gateway seçeneklerini seçin.

      3. Ingress Gateway sayfasında hedef ağ geçidinin Service address değerini kopyalayın.

   2. Tarayıcınızda http://{YOUR_ASM_GATEWAY_ADDRESS}/productpage adresine gidin.

      Bookinfo uygulama sayfası yüklenir ve The Comedy of Errors adlı kitabın ayrıntıları gösterilir. Reviews hizmeti üç sürüme sahip olduğundan ve henüz belirli yönlendirme kuralları uygulanmadığından, sayfayı her yenilediğinizde reviews bölümü değişir. Örneğin, bir yenileme işleminde reviews bölümünün altında Reviews served by: reviews-v3-xxx ifadesi görünebilir. Bu davranış, uygulamanın ASM ağ geçidi üzerinden erişilebilir olduğunu ve Istio kaynaklarının başarıyla dağıtıldığını doğrular.

Adım 5: GitOps Tabanlı Trafik Yönlendirmeyi Uygulama

Trafik kurallarını yapılandırdıktan sonra http://{your ASM Gateway address}/productpage adresine erişin. Oturum açmadığınızda yalnızca Reviews'ün v1 sürümü görüntülenirken, jason kullanıcı adıyla oturum açtığınızda Reviews'ün v2 sürümü görüntülenir.

1. Yerel VirtualService ve Deployment YAML dosyalarını değiştirin.

   • VirtualService YAML dosyasını aşağıdaki gibi değiştirin:

     apiVersion: networking.istio.io/v1alpha3
     kind: VirtualService
     metadata:
       name: reviews
     spec:
       hosts:
         - reviews
       http:
       - match:
         - headers:
             end-user:
               exact: jason
         route:
         - destination:
             host: reviews
             subset: v2
       - route:
         - destination:
             host: reviews
             subset: v1
     ---

   • Deployment YAML dosyasını aşağıdaki gibi değiştirin:

     apiVersion: apps/v1
     kind: Deployment
     metadata:
       namespace: argocd
       name: reviews-v1
       labels:
         app: reviews
         version: v1
     spec:
       replicas: 2

2. Değişiklikleri Git deponuza gönderin ve push edin.

   git add *
   git commit -m "reviews-v1"
   git push

3. Git yapılandırmasını kümeyle senkronize edin.

   Argo CD'de otomatik senkronizasyonu etkinleştirdiyseniz yapılandırmalar kümeyle otomatik olarak senkronize edilir. Aksi takdirde, bunları manuel olarak senkronize etmek için aşağıdaki adımları izleyin.

   1. Argo CD yönetim arayüzündeki bookinfo kartında SYNC seçeneğine tıklayın.

      Bir dosya değiştiğinde, bookinfo kartında Status öğesinin sağında OutOfSync durumu belirir. bookinfo uygulamasının durumu artık OutOfSync şeklindedir.

   2. Açılan panelde SYNCHRONIZE seçeneğine tıklayın.

      Senkronizasyon tamamlandıktan sonra oluşturulan kaynakları ASM konsolunda ve güncellenen kaynakları ACK konsolunda görüntüleyebilirsiniz. Daha fazla bilgi için bkz. Kaynak durumunu ASM konsolunda doğrulama ve Kaynak durumunu ACK konsolunda doğrulama.

4. Erişim sonucunu doğrulayın.

   1. Oturum açmadan tarayıcınızda http://{YOUR_ASM_GATEWAY_ADDRESS}/productpage adresine gidin.

      Sonuç: Reviews hizmetine yönelik tüm trafik v1'e yönlendirilir (yıldız derecelendirmesi yok). Bookinfo ürün ayrıntıları sayfası yüklenir ve The Comedy of Errors özeti, Book Details (Type: paperback, Pages: 200, Publisher: PublisherA, Language: English, ISBN-10: 1234567890, ISBN-13: 123-1234567890) ile Book Reviews bilgileri gösterilir. Reviews bölümünün altında, reviews-v1-55b668fc65-s48wm gibi mikro hizmet örneğinin Pod adı görünür; bu durum, uygulamanın başarıyla dağıtıldığını ve erişilebilir olduğunu gösterir.

   2. jason kullanıcı adı ve herhangi bir parola ile oturum açın.

      Sonuç: Oturum açtıktan sonra Reviews hizmetine yönelik trafik v2'ye yönlendirilir (siyah yıldız derecelendirmeleri). Sayfanın sağ üst köşesinde jason kullanıcı adı ve bir sign out bağlantısı görünür. Yıldız derecelendirmeleri ve jason kullanıcı adının görünmesi, başarıyla oturum açtığınızı ve trafiğin v2 hizmetine yönlendirildiğini doğrular.