How to use an official demo to deploy a Java application in a serverless Kubernetes cluster - Enterprise Distributed Application Service

ACK Serverless kümeleri, düğüm yönetimi gerektirmeden talebe göre ölçeklendirme sağlar; bu özellik, trafiği değişken olan iş yükleri için idealdir. Enterprise Distributed Application Service (EDAS), Container Service for Kubernetes (ACK) ile entegre olarak bu kümelerdeki konteynerleştirilmiş uygulamaların yaşam döngüsünün tamamını yönetir.

Bu kılavuzda, EDAS tarafından sağlanan bir demo JAR veya WAR paketi kullanarak ACK Serverless kümesinde Java uygulaması dağıtma adımları açıklanmaktadır.

Dağıtım işlemi üç aşamadan oluşur:

ACK konsolunda ACK Serverless kümesi oluşturun.
EDAS'in küme üzerindeki uygulamaları yönetebilmesi için kümeyi EDAS'e aktarın.
EDAS konsolu aracılığıyla JAR veya WAR paketi kullanarak uygulama dağıtın.

Procedure of deploying an application in a Kubernetes cluster

Zaten bir ACK Serverless kümeniz varsa doğrudan 2. Adım: Kümeyi EDAS'e aktarma bölümüne geçin. Kümeyi daha önce aktardıysanız doğrudan 3. Adım: Uygulamayı dağıtma bölümüne ilerleyin.

Ön koşullar

Başlamadan önce aşağıdaki gereksinimleri karşıladığınızdan emin olun:

Alibaba Cloud hesabınız için hem EDAS hem de ACK hizmetlerini etkinleştirdiniz. Bkz. EDAS'i Etkinleştirme ve ACK hızlı başlangıç kılavuzu
Mikroservis ad alanı oluşturdunuz
Hesabınıza ACK varsayılan rollerini atadınız. Bkz. ACK varsayılan rolleri

1. Adım: ACK Serverless kümesi oluşturma

ACK konsoluna giriş yapın ve bir ACK Serverless kümesi oluşturun. Talimatlar için bkz. ASK kümesi oluşturma.

2. Adım: Kümeyi EDAS'e aktarma

Bir ACK kümesini aktardığınızda EDAS aşağıdaki bileşenleri otomatik olarak yükler:

Bileşen	Amaç
ack-ahas-sentinel-pilot	Kısıtlama ve degradasyon koruması
ack-arms-pilot	Application Real-Time Monitoring Service (ARMS) aracı
ack-arms-prometheus	Prometheus izleme

Kümeyi aktarmak için:

EDAS konsoluna giriş yapın. Sol gezinme bölmesinde Resource Management > Serverless Kubernetes Clusters seçeneklerini seçin.
Üst gezinme çubuğunda ACK Serverless kümenizin bulunduğu bölgeyi ve mikroservis ad alanını seçin. Synchronize Serverless Kubernetes Cluster düğmesine tıklayın.
Hedef kümeyi bulun ve Actions sütunundaki Import seçeneğine tıklayın.
Warning mesajında OK düğmesine tıklayın.
Precheck for Import iletişim kutusunda Continue düğmesine tıklayın.
Import Kubernetes Cluster iletişim kutusunda Microservice Namespace açılır listesinden bir mikroservis ad alanı seçin, gereksinimlerinize göre Service Mesh özelliğini açıp kapatın ve Import düğmesine tıklayın.

Aktarımı doğrulama

Aktarma tamamlandıktan sonra Cluster Status sütununda Running ve Import Status sütununda Imported değerlerinin görüntülendiğini onaylayın.

3. Adım: Uygulamayı dağıtma

Bu adım, bir uygulama oluşturmayı ve bunu JAR veya WAR paketiyle dağıtmayı kapsar. Genel süreç her iki paket türü için de aynıdır. Tek fark çalışma zamanı ortamı seçimindedir:

Paket türü	Çalışma zamanı ortamı	Yapılandırılabilir parametreler
JAR	Java (Dubbo veya Spring Boot)	Java Environment
WAR	Tomcat (Dubbo veya Spring)	Java Environment, Container Version
WAR veya FatJar	EDAS-Container (HSF) (High-Speed Service Framework)	Java Environment, Pandora Version, Ali-Tomcat Version

Aşağıdaki adımlarda örnek olarak JAR paketi kullanılmıştır. WAR paketi dağıtıyorsanız Basic Information adımında Java yerine Tomcat veya EDAS-Container (HSF) seçeneğini belirleyin.

3a. Uygulama oluşturma

EDAS konsoluna giriş yapın. Sol gezinme bölmesinde Application Management > Applications seçeneklerini seçin.
Üst gezinme çubuğunda bir bölge ve mikroservis ad alanı seçin. Create Application düğmesine tıklayın.

3b. Temel bilgileri yapılandırma

Basic Information adımında aşağıdaki parametreleri yapılandırın ve Next düğmesine tıklayın.

Parametre	Açıklama
Cluster Type	Kubernetes Clusters seçeneğini belirleyin.
Application Source Type	Default seçeneğini belirleyin.
Hosted Applications	Programlama dilini seçin. Bu kılavuzda Java kullanılmaktadır. PHP veya çok dilli bir uygulama dağıtmak için bkz. Kaynak koddan PHP uygulamaları oluşturma ve ACK kümelerine dağıtma.
Select Application	Uygulama türünüze ve dağıtım paketinize göre çalışma zamanı ortamını seçin. Yukarıdaki çalışma zamanı seçenekleri tablosuna bakın. Bunun yerine görüntü kullanarak dağıtım yapmak için bkz. Kubernetes kümesinde Java mikroservis uygulamasını görüntü kullanarak dağıtma.

OpenJDK 17 uyumluluğu

OpenJDK 17, Dubbo 2.7.14 ve sonrası veya Dubbo 3.0.6 ve sonraki sürümlerle uyumludur. Aşağıdaki tabloda test edilmiş sürüm kombinasyonları listelenmiştir.

Dubbo sürümü	Spring Boot sürümü	Nacos istemci sürümü	API çağrısı	ARMS izleme	Hizmet listesi
2.7.14	2.7.9	1.4.4	Desteklenir	Desteklenir	Desteklenir
2.7.14	2.7.9	2.1.2	Desteklenir	Desteklenir	Desteklenir
2.7.14	2.7.9	2.2.0	Desteklenir	Desteklenir	Desteklenir
2.7.22	2.7.9	1.4.4	Desteklenir	Desteklenir	Desteklenir
2.7.22	2.7.9	2.1.2	Desteklenir	Desteklenir	Desteklenir
2.7.22	2.7.9	2.2.0	Desteklenir	Desteklenir	Desteklenir
3.0.6	2.7.9	1.4.4	Desteklenir	Desteklenir	Desteklenir
3.0.6	2.7.9	2.1.2	Desteklenir	Desteklenir	Desteklenir
3.0.6	2.7.9	2.2.0	Desteklenir	Desteklenir	Desteklenir
3.1.7	2.7.9	1.4.4	Desteklenir	Desteklenir	Desteklenir
3.1.7	2.7.9	2.1.2	Desteklenir	Desteklenir	Desteklenir
3.1.7	2.7.9	2.2.0	Desteklenir	Desteklenir	Desteklenir

3c. Dağıtım ayarlarını yapılandırma

Configurations adımında aşağıdaki parametreleri yapılandırın ve Next düğmesine tıklayın.

Ortam ve küme ayarları:

Parametre	Açıklama
Microservice Namespace	Oluşturduğunuz mikroservis ad alanını seçin. Hiçbiri seçilmezse varsayılan olarak Default atanır. Ad alanı oluşturmak için Create Microservice Namespace seçeneğine tıklayın. Bkz. Mikroservis ad alanlarını yönetme bölümündeki "Ad alanı oluşturma" kısmı.
Cluster	Aktarılan ACK Serverless kümesini seçin. Küme henüz EDAS'e aktarılmadıysa uygulama oluşturma sırasında aktarmak için This cluster is used for the first time in EDAS seçeneğini belirleyin. Kümenin uygulamanın bulunduğu mikroservis ad alanıyla aynı olması gerekmez.
K8s Namespace	Kubernetes ad alanını seçin. Geçerli değerler: default, kube-system, kube-public. Bu kılavuz için default seçeneğini belirleyin. Özel bir ad alanı oluşturmak için Create Kubernetes Namespace seçeneğine tıklayın ve bir ad girin (1-63 karakter; küçük harfler, rakamlar ve tirelerden oluşmalıdır; harf veya rakamla başlayıp bitmelidir).

Uygulama ayarları:

Parametre	Açıklama
Application Name	Bir ad girin (en fazla 36 karakter; harfle başlamalı; harfler, rakamlar ve tire içerebilir).
Application Description	İsteğe bağlı. En fazla 128 karakter.

Dağıtım paketi:

Parametre	Açıklama
Source of Deployment Package	Bir dağıtım kaynağı seçin.

Custom Program: Kendi paketinizi yükleyin. File Uploading Method ayarını Upload JAR Package (doğrudan yükleme) veya JAR Package Address (URL sağlama) olarak belirleyin.
Official Demo: Önceden oluşturulmuş bir demo seçin: Spring Cloud Server Application, Spring Cloud Client Application, Dubbo Server Application veya Dubbo Client Application.

Sürüm ve kaynak ayarları:

Parametre	Açıklama
Version	Bir sürüm numarası girin veya oluşturmak için Use Timestamp as Version Number seçeneğine tıklayın.
Time Zone	Uygulama saat dilimini seçin.
Total Pods	Uygulama için pod sayısını ayarlayın. Maksimum değer küme kapasitesine bağlıdır.
Single-pod Resource Quota	Pod başına CPU, bellek ve geçici depolama limitlerini ayarlayın. Varsayılan değer `0` limitsiz anlamına gelir. Maksimum kotlar küme kapasitesine bağlıdır.

OpenJDK temel görüntü ayarları

OpenJDK Base Image parametresi yalnızca Basic Information adımında Java Environment için Custom OpenJDK seçtiyseniz kullanılabilir.

Temel görüntü kaynağını yapılandırın:

Current Account: Region, Container Registry, Image Repository Namespace ve Image Repository Name değerlerini belirtin.
Other Alibaba Cloud Accounts: Genel bir depo için Full Image Address değerini belirtin.

Önemli

Yalnızca JDK 7 ve JDK 8 desteklenir. EDAS sunucusu uygulama görüntüsünü oluşturmak için temel görüntüyü çeker; bu nedenle temel görüntünün genel çekme izinlerine sahip olması gerekir.

Container Registry ayarları (yalnızca ACK kümeleri)

Container Registry Repository Type parametresi yalnızca ACK kümelerine dağıtılan Java, Tomcat veya EDAS-Container (HSF) uygulamaları için kullanılabilir. ACK Serverless kümeleri için kullanılamaz.

Parametre	Açıklama
Container Registry Repository Type	Oluşturulan görüntüyü depolamak için Container Registry Personal Edition veya Container Registry Enterprise Edition seçeneğini belirleyin. `aliyun-acr-credential-helper` bileşeni gereklidir. Bkz. Gizli dizileri kullanmadan görüntü çekmek için aliyun-acr-credential-helper bileşenini kullanma. Enterprise Edition için önce VPC erişimini yapılandırın. Bkz. VPC'ler üzerinden erişimi yapılandırma.
Region of Container Registry	Yalnızca Enterprise Edition için gereklidir. Container Registry (ACR) görüntünüzün bölgesini seçin.
Container Registry	Yalnızca Enterprise Edition için gereklidir. Konteyner görüntünüzü seçin.
Image Repository Namespace	Görüntü deponuz için ad alanını seçin veya oluşturmak için + Create Namespace seçeneğine tıklayın.

Görüntü oluşturma görevleri kümenizde çalışır ve küme kaynaklarını tüketir. Tek bir görüntü oluşturma görevi için varsayılan kaynak limiti çekirdek başına 1 GB'tır. Bu limiti ayarlamak için bkz. Görüntü oluşturma için kaynak limitlerini ayarlama.

Derleme görevi zamanlama kuralları:

Kural	Davranış
Dışlama	EDAS, `edas.image.build=disable` etiketli düğümlere derleme görevlerini zamanlamaz.
Tercih	EDAS, derleme görevlerini `edas.image.build=enable` etiketli düğümlere zamanlamayı tercih eder ancak etiketsiz düğümleri de kullanabilir.
Tolerans	Derleme görevleri, `key=edas.image.build, effect=NoSchedule` taint'ine sahip düğümleri tolere eder.

İpucu: Bir düğümü derleme görevlerine özel olarak ayırmak için edas.image.build=enable etiketini ve key=edas.image.build, effect=NoSchedule taint'ini ekleyin. Bu, diğer pod'ların o düğüme zamanlanmasını engeller.

3d. Gelişmiş ayarları yapılandırma (isteğe bağlı)

Advanced Settings adımında gerektiğinde aşağıdakilerden herhangi birini yapılandırın:

3e. Oluşturma ve dağıtma

Tüm ayarları yapılandırdıktan sonra Create Application düğmesine tıklayın. Creation Completed adımında tekrar Create Application düğmesine tıklayın.
Confirm Application Change Precheck iletişim kutusunda Start Precheck düğmesine tıklayın.
Ön kontrol sonuçlarını inceleyin ve Continue düğmesine tıklayın. Ön kontrol öğelerinde değişiklik yaptıysanız devam etmeden önce Check Again düğmesine tıklayın.

Dağıtımı doğrulama

Dağıtım birkaç dakika sürer. İlerlemeyi Change List sayfasından takip edin.

Dağıtım tamamlandıktan sonra Application Overview sayfasına gidin ve pod durumunu kontrol edin:

Tüm pod'lar running durumunu gösteriyorsa uygulama başarıyla dağıtılmış demektir.
Bir pod'un çalışan durumuna tıklayarak Deployments, pod ayrıntıları ve gelişmiş yapılandırmalarını görüntüleyin.

Pod'lar running durumuna ulaşmazsa sorunu belirlemek için Application Overview sayfasındaki pod olaylarını ve günlüklerini kontrol edin.

Yük dengeleyici ile uygulamayı dışa açma

Uygulamayı dağıttıktan sonra dışa açmak için bir Server Load Balancer (SLB) örneği ekleyin:

SLB türü	Kullanım durumu
İnternet yönelik	Uygulamayı İnternet'e açar
Dahili yönelik	Uygulamayı aynı VPC'deki tüm düğümlere dahili ağ üzerinden açar

Talimatlar için bkz. Kubernetes kümesindeki bir uygulamaya SLB örneği ekleme.

Destek

EDAS'teki ACK veya ACK Serverless kümeleriyle ilgili sorularınız için destek talebi oluşturun veya 23197114 numaralı DingTalk grubuna katılın.