Hızlı Başlangıç: Mikro hizmet uygulamalarını Azure Spring Apps'e dağıtma

Not

İlk 50 vCPU saati ve 100 GB saat bellek her ay ücretsizdir. Daha fazla bilgi için Azure'da Uygulamalar Blogu'nda Fiyat Azaltma - Azure Spring Apps daha fazlasını yapıyor, maliyetleri daha az! bölümüne bakın.

Not

Azure Spring Apps, Azure Spring Cloud hizmetinin yeni adıdır. Hizmetin yeni bir adı olsa da, ekran görüntüleri, videolar ve diyagramlar gibi varlıkları güncelleştirmek için çalışırken bazı yerlerde eski adı bir süre görürsünüz.

Bu makalede, iyi bilinen örnek uygulama PetClinic kullanılarak Azure Spring Apps'e mikro hizmet uygulamalarının nasıl dağıtılacağı açıklanmaktadır.

Pet Clinic örneği mikro hizmet mimarisi desenini gösterir. Aşağıdaki diyagramda, Azure Spring Apps Enterprise planındaki PetClinic uygulamasının mimarisi gösterilmektedir.

Diyagramda Pet Clinic örneğinin aşağıdaki mimari akışları ve ilişkileri gösterilmektedir:

• Ön uç ve arka uç uygulamalarını yönetmek için Azure Spring Apps'i kullanır. Arka uç uygulamaları Spring Boot ile oluşturulur ve her uygulama kalıcı depo olarak HSQLDB kullanır. Yeniden uygulanan ön uç uygulaması, tek başına bir ön uç web uygulaması olarak hizmet veren Node.js ile Pet Clinic API Gateway Uygulaması'nı kullanır.
• Azure Spring Apps'te Service Registry, Application Configuration Service, Spring Cloud Gateway ve Application Live View gibi yönetilen bileşenleri kullanır. Uygulama Yapılandırma Hizmeti Git deposu yapılandırmasını okur.
• İsteği arka uç hizmet uygulamalarına yönlendirmek için Spring Cloud Gateway'in URL'sini ve arka uç uygulamalarını izlemek için Application Live View'un URL'sini kullanıma sunar.
• Log Analytics çalışma alanını kullanarak günlükleri analiz eder.
• Uygulama Analizler ile performansı izler.

Not

Bu makalede PetClinic'in basitleştirilmiş bir sürümü, Azure Spring Apps'e hızla dağıtılacak üretime hazır olmayan bellek içi bir veritabanı kullanılır.

Tanzu Geliştirici Araçları, bir risk noktası olan Application Live View için genel erişimi kullanıma sunar. Üretim ortamının erişimin güvenliğini sağlaması gerekir. Daha fazla bilgi için Azure Spring Apps Kurumsal planında Tanzu Geliştirme Araçlarını Yapılandırma'nın Geliştirme Araçları Portalını Yapılandırma bölümüne bakın.

Pet Clinic örneği mikro hizmet mimarisi desenini gösterir. Aşağıdaki diyagramda, Azure Spring Apps Standart planındaki PetClinic uygulamasının mimarisi gösterilmektedir.

Diyagramda Pet Clinic örneğinin aşağıdaki mimari akışları ve ilişkileri gösterilmektedir:

• Spring Boot uygulamalarını yönetmek için Azure Spring Apps'i kullanır. Her uygulama kalıcı depo olarak HSQLDB kullanır.
• Azure Spring Apps'te Spring Cloud Config Server ve Eureka Service Registry yönetilen bileşenlerini kullanır. Yapılandırma Sunucusu Git deposu yapılandırmasını okur.
• Hizmet uygulamalarına yönelik isteklerin yükünü dengelemek için API Gateway'in URL'sini kullanıma sunar ve uygulamaları yönetmek için Yönetici Sunucusunun URL'sini kullanıma sunar.
• Log Analytics çalışma alanını kullanarak günlükleri analiz eder.
• Uygulama Analizler ile performansı izler.

Not

Bu makalede PetClinic'in basitleştirilmiş bir sürümü, Azure Spring Apps'e hızla dağıtılacak üretime hazır olmayan bellek içi bir veritabanı kullanılır.

Dağıtılan uygulama admin-server , bir risk noktası olan genel erişimi kullanıma sunar. Üretim ortamının Spring Boot Yönetici uygulamasının güvenliğini sağlaması gerekir.

Bu makalede Azure Spring Apps'e dağıtmak için aşağıdaki seçenekler sağlanır:

• Azure portalı seçeneği, tek tıklamayla kaynak oluşturmanın ve uygulamaları dağıtmanın en kolay ve en hızlı yoludur. Bu seçenek, Uygulamaları Azure bulut hizmetlerine hızla dağıtmak isteyen Spring geliştiricileri için uygundur.
• Azure portalı + Maven eklentisi seçeneği, kaynakları oluşturmanın ve uygulamaları adım adım dağıtmanın daha geleneksel bir yoludur. Bu seçenek, Azure bulut hizmetlerini ilk kez kullanan Spring geliştiricileri için uygundur.
• Azure CLI seçeneği, Azure kaynaklarını yönetmek için güçlü bir komut satırı aracı kullanır. Bu seçenek, Azure bulut hizmetlerini bilen Spring geliştiricileri için uygundur.

• Azure portalı + Maven eklentisi seçeneği, kaynakları oluşturmanın ve uygulamaları adım adım dağıtmanın daha geleneksel bir yoludur. Bu seçenek, Azure bulut hizmetlerini ilk kez kullanan Spring geliştiricileri için uygundur.
• Azure Geliştirici CLI seçeneği, kaynakları otomatik olarak oluşturmanın ve uygulamaları basit komutlar aracılığıyla dağıtmanın daha verimli bir yoludur. Azure Geliştirici CLI'sı, gerekli Azure kaynaklarını sağlamak ve uygulama kodunu dağıtmak için bir şablon kullanır. Bu seçenek, Azure bulut hizmetlerini bilen Spring geliştiricileri için uygundur.

1. Önkoşullar

Azure portalı + Maven eklentisi

• Azure aboneliği. Azure aboneliğiniz yoksa başlamadan önce birücretsiz Azure hesabı oluşturun.
• Git.
• Java Development Kit (JDK), sürüm 17.

Azure Geliştirici CLI'sı

• Azure aboneliği. Aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.
• Git.
• Java Development Kit (JDK), sürüm 17.
• Azure Geliştirici CLI'sı, sürüm 1.2.0 veya üzeri.

Azure portalı

• Azure aboneliği. Aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.
• Hedef abonelikte ilk kez bir Azure Spring Apps Kurumsal plan örneği dağıtıyorsanız Azure Market'deki Kurumsal plan'ın Gereksinimler bölümüne bakın.
• (İsteğe bağlı) Git'i seçin.
• (İsteğe bağlı) Java Development Kit (JDK), sürüm 17.

Azure portalı + Maven eklentisi

• Azure aboneliği. Aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.
• Hedef abonelikte ilk kez bir Azure Spring Apps Kurumsal plan örneği dağıtıyorsanız Azure Market'deki Kurumsal plan'ın Gereksinimler bölümüne bakın.
• Git.
• (İsteğe bağlı) Java Development Kit (JDK), sürüm 17.
• (İsteğe bağlı) Node.js, sürüm 16.20 veya üzeri.
• Azure CLI, sürüm 2.45.0 veya üzeri.

Azure CLI

• Azure aboneliği. Aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.
• Hedef abonelikte ilk kez bir Azure Spring Apps Kurumsal plan örneği dağıtıyorsanız Azure Market'deki Kurumsal plan'ın Gereksinimler bölümüne bakın.
• Git.
• Java Development Kit (JDK), sürüm 17.
• Azure CLI, sürüm 2.55.0 veya üzeri.

2. Spring projesini hazırlama

Azure portalı + Maven eklentisi

Örneği yerel olarak hazırlamak için aşağıdaki adımları kullanın:

1. Aşağıdaki komutu kullanarak örnek projeyi kopyalayın:

   git clone https://github.com/Azure-Samples/spring-petclinic-microservices.git
   

2. Proje kök dizinine gidin ve aşağıdaki komutu kullanarak örnek projeyi yerel olarak çalıştırın:

   bash ./scripts/run_all_without_infra.sh
   

3. Betik başarıyla tamamlandıktan sonra, PetClinic uygulamasına erişmek için tarayıcınızda adresine gidin http://localhost:8080 .

Azure Geliştirici CLI'sı

Azure Geliştirici CLI şablonlarını kullanarak Pet Clinic uygulamasını başlatmak için aşağıdaki adımları kullanın:

1. Bash penceresinde yeni, boş bir klasör oluşturun ve bu klasöre gidin.

2. Projeyi başlatmak için aşağıdaki komutu kullanın:

   azd init --template Azure-Samples/spring-petclinic-microservices
   

   Aşağıdaki listede komut etkileşimi açıklanmaktadır:

   • Yeni bir ortam adı girin: Tüm Azure kaynaklarını barındırmak için oluşturulan kaynak grubunun son eki olarak kullanılan bir ortam adı girin. Bu ad, Azure aboneliğinizde benzersiz olmalıdır.

   Konsol, aşağıdaki örneğe benzer iletiler gönderir:

   Initializing a new project (azd init)
   
   Downloading template code to: <your-local-path>
   (✓) Done: Initialized git repository
   Enter a new environment name: <your-env-name>
   
   SUCCESS: New project initialized!
   You can view the template code in your directory: <your-local-path>
   Learn more about running 3rd party code on our DevHub: https://aka.ms/azd-third-party-code-notice
   

3. Bulut ortamını hazırlama

Bu bölümde Azure Spring Apps hizmet örneğinin nasıl oluşturulacağı ve Azure bulut ortamının nasıl hazırlandığı açıklanır.

Azure portalı + Maven eklentisi

3.1. Azure portalda oturum açma

Azure portalına gidin ve portalda oturum açmak için kimlik bilgilerinizi girin. Varsayılan görünüm hizmet panonuzu içerir.

3.2. Azure Spring Apps örneği oluşturma

Hizmet örneğini oluşturmak için aşağıdaki adımları kullanın:

1. Azure portalının köşesinde kaynak oluştur'u seçin.

2. Azure Hizmetleri sekmesinde İşlem>Azure Spring Apps'i seçin.

   

3. Azure Spring Apps Oluştur sayfasında, Temel Bilgiler sekmesindeki formu doldurun.

   

   Formu tamamlamak için kılavuz olarak aşağıdaki tabloyu kullanın. Önerilen Plan Standarttır.

   Ayar	Önerilen değer	Açıklama
   Abonelik	Abonelik adınız.	Sunucunuz için kullanmak istediğiniz Azure aboneliği. Birden çok aboneliğiniz varsa kaynak için faturalandırılacak aboneliği seçin.
   Kaynak grubu	myresourcegroup	Yeni bir kaynak grubu adı veya aboneliğinizde var olan bir kaynak grubu.
   Ad	myasa	Azure Spring Apps örneğinizi tanımlayan benzersiz bir ad. Ad 4 ile 32 karakter uzunluğunda olmalıdır ve yalnızca küçük harf, sayı ve kısa çizgi içerebilir. Hizmet adının ilk karakteri bir harf, son karakter ise harf veya sayı olmalıdır.
   Plan	Standart	Fiyatlandırma planı, örneğinizle ilişkili kaynakları ve maliyeti belirler.
   Bölge	Kullanıcılarınıza en yakın bölge.	Kullanıcılarınız için en yakın olan konum.
   Alanlar Arası Yedekli	Seçili değil	Azure Spring Apps hizmetinizi bir Azure kullanılabilirlik alanında oluşturur. Şu anda tüm bölgelerde desteklenmiyor.

4. Azure Spring Apps Oluştur sayfasındaki Tanılama ayarları sekmesine gidin ve yeni bir Log Analytics çalışma alanı örneği oluşturmak için Yeni oluştur'u seçin. Yeni Log Analytics çalışma alanı oluştur sayfasında Log Analytics çalışma alanının adını gerektiği gibi güncelleştirin ve ardından oluşturmayı onaylamak için Tamam'ı seçin.

   

5. Azure Spring Apps Oluştur sayfasındaki Uygulama Analizler sekmesine gidin ve yeni bir Uygulama Analizler örneği oluşturmak için Yeni oluştur'u seçin. Yeni Uygulama Analizler kaynağı oluştur sayfasında, Application insights adını gerektiği gibi güncelleştirin, Kaynak modu için Çalışma Alanı tabanlı'yı seçin ve ardından oluşturma işlemini onaylamak için Tamam'ı seçin.

   

6. Seçimlerinizi gözden geçirmek için Gözden Geçir ve Oluştur'u seçin. Ardından Oluştur'u seçerek Azure Spring Apps örneğini sağlayın.

7. Dağıtım işlemini izlemek için Bildirimler simgesini (zil) seçin. Dağıtım tamamlandıktan sonra Azure portalı panonuzda hizmetin Genel Bakış sayfasına kısayol oluşturmak için Panoya sabitle'yi seçebilirsiniz.

   

8. Azure Spring Apps'e Genel Bakış sayfasına gitmek için Kaynağa git'i seçin.

9. Gezinti bölmesinde Yapılandırma Sunucusu'nu seçin.

10. Yapılandırma Sunucusu sayfasında, URI için girin https://github.com/Azure-Samples/spring-petclinic-microservices-config.git ve Doğrula'yı seçin.

    

11. Doğrulamadan sonra, Yapılandırma Sunucusu yapılandırmasını tamamlamak için Uygula'yı seçin.

Azure Geliştirici CLI'sı

Gerekli kaynakları oluşturmak için aşağıdaki adımları kullanın:

1. OAuth2 ile Azure'da oturum açmak için aşağıdaki komutu kullanın. Zaten oturum açtıysanız bu adımı yoksayın.

   azd auth login
   

   Konsol, aşağıdaki örneğe benzer iletiler gönderir:

   Logged in to Azure.
   

2. Uygulamanızın dağıtılabilir bir kopyasını paketlemek, şablonun altyapısını Azure'a sağlamak ve ardından uygulama kodunu yeni sağlanan kaynaklara dağıtmak için aşağıdaki komutu kullanın:

   azd provision
   

   Aşağıdaki listede komut etkileşimleri açıklanmaktadır:

   • Kullanılacak azure aboneliğini seçin: Taşımak için okları kullanın, filtrelemek için yazın ve Enter tuşuna basın.
   • Kullanılacak azure konumunu seçin: Taşımak için okları kullanın, filtrelemek için yazın ve Enter tuşuna basın.

   Konsol, aşağıdaki örneğe benzer iletiler gönderir:

   SUCCESS: Your application was provisioned in Azure in xx minutes xx seconds.
   You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
   https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
   

   Not

   Bu komutun tamamlanması biraz zaman alabilir. Azure kaynaklarını sağlarken size bir ilerleme göstergesi gösterilir.

4. Uygulamaları Azure Spring Apps'e dağıtma

Artık uygulamayı Azure Spring Apps'e dağıtabilirsiniz.

Azure portalı + Maven eklentisi

Azure Spring Apps için Maven eklentisini kullanarak mikro hizmet uygulamalarını dağıtmak için aşağıdaki adımları kullanın:

1. Örnek proje dizinine gidin ve Azure Spring Apps uygulamalarını yapılandırmak için aşağıdaki komutu kullanın:

   ./mvnw -P spring-apps com.microsoft.azure:azure-spring-apps-maven-plugin:1.17.0:config
   

2. Aşağıdaki listede komut etkileşimleri açıklanmaktadır:

   • Yapılandıracak alt modülleri seçin(virgülle ayrılmış giriş numaraları, örneğin: [1-2,4,6], TÜMÜNÜ seçmek için ENTER): Tümünü seçmek için Enter tuşuna basın.
   • OAuth2 oturum açma: OAuth2 protokolüne göre Azure'da oturum açmayı yetkilendirilin.
   • Aboneliği seçin: Oluşturduğunuz Azure Spring Apps örneğinin abonelik listesi numarasını seçin ve varsayılan olarak listedeki ilk aboneliği seçin. Varsayılan sayıyı kullanıyorsanız doğrudan Enter tuşuna basın.
   • Dağıtım için Azure Spring Apps'i seçin: Oluşturduğunuz Azure Spring Apps örneğinin liste numarasını seçin. Varsayılan sayıyı kullanıyorsanız doğrudan Enter tuşuna basın.
   • Genel erişimi kullanıma açmak için uygulamaları seçin:(virgülle ayrılmış giriş numaraları, örneğin: [1-2,4,6], YOK'u seçmek için ENTER): ve api-gatewayiçin admin-server 1,5 girin.
   • Yukarıdaki tüm yapılandırmaları (Y/n) kaydetmeyi onaylayın: y tuşuna basın. n tuşuna basarsanız yapılandırma POM dosyalarına kaydedilmez.

3. Her uygulamayı derlemek ve dağıtmak için aşağıdaki komutu kullanın:

   ./mvnw azure-spring-apps:deploy
   

4. OAuth2 oturum açma istemi için OAuth2 protokolüne göre Azure'da oturum açmayı yetkilendirilin.

   Not

   Azure Spring Apps'e dağıtım 25 dakika kadar sürebilir.

Komut çalıştırıldıktan sonra günlük, tüm dağıtımların başarılı olduğunu gösteren aşağıdaki örneğe benzer bir çıktı görüntüler:

[INFO] Deployment(default) is successfully updated.
[INFO] Deployment Status: Running
[INFO]   InstanceName:admin-server-default-xx-xx-xxx  Status:Running Reason:null       DiscoverStatus:UP
[INFO] Getting public url of app(admin-server)...
[INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-admin-server.azuremicroservices.io

...

[INFO] Getting public url of app(api-gateway)...
[INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-api-gateway.azuremicroservices.io

Azure Geliştirici CLI'sı

Uygulamayı paketlemek, web uygulamasının gerektirdiği Azure kaynaklarını sağlamak ve ardından Azure Spring Apps'e dağıtmak için aşağıdaki adımları kullanın:

1. Uygulamanızın dağıtılabilir bir kopyasını paketlemek için aşağıdaki komutu kullanın:

   azd package
   

   Konsol, aşağıdaki örneğe benzer iletiler gönderir:

   SUCCESS: Your application was packaged for Azure in xx minutes xx seconds.
   

2. Uygulama kodunu yeni sağlanan kaynaklara dağıtmak için aşağıdaki komutu kullanın:

   azd deploy
   

   Konsol, aşağıdaki örneğe benzer iletiler gönderir:

   Deploying services (azd deploy)
   
   (✓) Done: Deploying service admin-server
   - Endpoint: https://<your-Azure-Spring-Apps-instance-name>-admin-server.azuremicroservices.io
   
   (✓) Done: Deploying service api-gateway
   - Endpoint: https://<your-Azure-Spring-Apps-instance-name>-api-gateway.azuremicroservices.io
   
   (✓) Done: Deploying service customers-service
   - No endpoints were found
   
   (✓) Done: Deploying service vets-service
   - No endpoints were found
   
   (✓) Done: Deploying service visits-service
   - No endpoints were found
   
   
   SUCCESS: Your application was deployed to Azure in xx minutes xx seconds.
   You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
   https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
   

Not

Önceki üç komutu birleştirmek için de kullanabilirsiniz azd up : azd package (uygulamanızın dağıtılabilir bir kopyasını paketler), azd provision (Azure kaynaklarını sağlar) ve azd deploy (uygulama kodunu dağıtır). Daha fazla bilgi için bkz . Azure-Samples/spring-petclinic-microservices.

2. Spring projesini hazırlama

Azure portalı

Sonraki bölümdeki Azure'a Dağıt düğmesi, GitHub'daki ASA-Samples-Web-Application yayınları sayfasından JAR paketi indiren bir Azure portalı deneyimi başlatır. Yerel hazırlık adımları gerekli değildir.

Azure portalı + Maven eklentisi

Uygulamayı buluta dağıtmadan önce doğrulamak istediğinizde yerel makinenizde aşağıdaki adımları kullanın:

1. Pet Clinic uygulamasını GitHub'dan kopyalamak için aşağıdaki komutu kullanın:

   git clone https://github.com/Azure-Samples/spring-petclinic-microservices.git
   

2. Proje kök dizinine gidin ve projeyi oluşturmak için aşağıdaki komutu kullanın:

   ./mvnw clean package -DskipTests
   

Uygulamayı yerel olarak çalıştırmak istiyorsanız aşağıdaki adımları kullanın. Aksi takdirde, bu adımları atlayabilirsiniz.

1. Yeni bir Bash penceresi açın ve yapılandırma sunucusunu başlatmak için aşağıdaki komutu kullanın:

   ./mvnw spring-boot:run -pl spring-petclinic-config-server
   

2. Yeni bir Bash penceresi açın ve bulma sunucusunu başlatmak için aşağıdaki komutu kullanın:

   ./mvnw spring-boot:run -pl spring-petclinic-discovery-server
   

3. Müşteriler, Vets, Ziyaretler ve Spring Cloud Gateway hizmetleri için yeni bir Bash penceresi açın ve hizmetleri başlatmak için aşağıdaki komutları kullanın:

   ./mvnw spring-boot:run -pl spring-petclinic-customers-service
   ./mvnw spring-boot:run -pl spring-petclinic-vets-service
   ./mvnw spring-boot:run -pl spring-petclinic-visits-service
   ./mvnw spring-boot:run -Dspring-boot.run.profiles=default,development \
       -pl spring-petclinic-api-gateway
   

4. Yeni bir Bash penceresi açın ve proje spring-petclinic-frontend dizinine gidin. Bağımlılıkları yüklemek ve ön uç uygulamasını çalıştırmak için aşağıdaki komutları kullanın:

   npm install
   npm run start
   

5. Betik başarıyla tamamlandıktan sonra, PetClinic uygulamasına erişmek için tarayıcınızda adresine gidin http://localhost:8080 .

Azure CLI

Uygulamayı buluta dağıtmadan önce doğrulamak istediğinizde yerel makinenizde aşağıdaki adımları kullanın:

1. Pet Clinic uygulamasını GitHub'dan kopyalamak için aşağıdaki komutu kullanın:

   git clone https://github.com/Azure-Samples/spring-petclinic-microservices.git
   

2. Proje kök dizinine gidin ve projeyi oluşturmak için aşağıdaki komutu kullanın:

   ./mvnw clean package -DskipTests
   

Uygulamayı yerel olarak çalıştırmak istiyorsanız aşağıdaki adımları kullanın. Aksi takdirde, bu adımları atlayabilirsiniz.

1. Yeni bir Bash penceresi açın ve yapılandırma sunucusunu başlatmak için aşağıdaki komutu kullanın:

   ./mvnw spring-boot:run -pl spring-petclinic-config-server
   

2. Yeni bir Bash penceresi açın ve bulma sunucusunu başlatmak için aşağıdaki komutu kullanın:

   ./mvnw spring-boot:run -pl spring-petclinic-discovery-server
   

3. Müşteriler, Vets, Ziyaretler ve Spring Cloud Gateway hizmetleri için yeni bir Bash penceresi açın ve hizmetleri başlatmak için aşağıdaki komutları kullanın:

   ./mvnw spring-boot:run -pl spring-petclinic-customers-service
   ./mvnw spring-boot:run -pl spring-petclinic-vets-service
   ./mvnw spring-boot:run -pl spring-petclinic-visits-service
   ./mvnw spring-boot:run -Dspring-boot.run.profiles=default,development \
       -pl spring-petclinic-api-gateway
   

4. Yeni bir Bash penceresi açın ve proje spring-petclinic-frontend dizinine gidin. Bağımlılıkları yüklemek ve ön uç uygulamasını çalıştırmak için aşağıdaki komutları kullanın:

   npm install
   npm run start
   

5. Betik başarıyla tamamlandıktan sonra, PetClinic uygulamasına erişmek için tarayıcınızda adresine gidin http://localhost:8080 .

3. Bulut ortamını hazırlama

Bu örneği çalıştırmak için ihtiyacınız olan ana kaynak bir Azure Spring Apps örneğidir. Bu bölümde bu kaynağın nasıl oluşturulacağı açıklanmaktadır.

Azure portalı

Bu bölümde, Azure portalında bir dağıtım deneyimi başlatmak için Azure'a Dağıt düğmesi kullanılır. Bu deneyim, Azure kaynakları oluşturmak için bir ARM şablonu kullanır.

3.1. Azure portalda oturum açma

Azure portalına gidin ve portalda oturum açmak için kimlik bilgilerinizi girin. Varsayılan görünüm hizmet panonuzu içerir.

3.2. Azure kaynakları oluşturma

Uygulamanın bağımlı olduğu tüm Azure kaynaklarını oluşturmak için aşağıdaki adımları kullanın:

1. Azure portalında dağıtım deneyimini başlatmak için aşağıdaki Azure'a dağıt düğmesini seçin:

   

2. Temel Bilgiler sekmesinde formu doldurun. Formu tamamlamak için kılavuz olarak aşağıdaki tabloyu kullanın:

   Ayar	Önerilen değer	Açıklama
   Abonelik	Abonelik adınız.	Sunucunuz için kullanmak istediğiniz Azure aboneliği. Birden çok aboneliğiniz varsa kaynak için faturalandırılacak aboneliği seçin.
   Kaynak grubu	myresourcegroup	Yeni bir kaynak grubu adı veya aboneliğinizde var olan bir kaynak grubu.
   Bölge	Kullanıcılarınıza en yakın bölge.	Bölge, kaynak grubunu oluşturmak için kullanılır.

   

3. Seçimlerinizi gözden geçirmek için Gözden Geçir ve Oluştur'u seçin. Ardından Oluştur'u seçerek uygulamayı Azure Spring Apps'e dağıtın.

4. Araç çubuğunda, dağıtım sürecini izlemek için Bildirimler simgesini (zil) seçin. Dağıtım tamamlandıktan sonra Panoya sabitle'yi seçerek Azure portalı panonuzda hizmetin Genel Bakış sayfasının kısayolu olarak bu hizmet için bir kutucuk oluşturabilirsiniz. Hizmetin Genel Bakış sayfasını açmak için Kaynağa git'i seçin.

   

Azure portalı + Maven eklentisi

3.1. Azure portalda oturum açma

Azure portalına gidin ve portalda oturum açmak için kimlik bilgilerinizi girin. Varsayılan görünüm hizmet panonuzu içerir.

3.2. Azure Spring Apps örneği oluşturma

Hizmet örneğini oluşturmak için aşağıdaki adımları kullanın:

1. Azure portalının köşesinde kaynak oluştur'u seçin.

2. İşlem>Azure Spring Apps'i seçin.

3. Temel Bilgiler sekmesinde formu doldurun. Formu tamamlamak için kılavuz olarak aşağıdaki tabloyu kullanın:

   Ayar	Önerilen değer	Açıklama
   Abonelik	Abonelik adınız.	Sunucunuz için kullanmak istediğiniz Azure aboneliği. Birden çok aboneliğiniz varsa kaynak için faturalandırılacak aboneliği seçin.
   Kaynak grubu	myresourcegroup	Yeni bir kaynak grubu adı veya aboneliğinizde var olan bir kaynak grubu.
   Ad	myasa	Azure Spring Apps hizmetinizi tanımlayan benzersiz bir ad. Ad 4 ile 32 karakter uzunluğunda olmalıdır ve yalnızca küçük harf, sayı ve kısa çizgi içerebilir. Hizmet adının ilk karakteri bir harf, son karakter ise harf veya sayı olmalıdır.
   Bölge	Kullanıcılarınıza en yakın bölge.	Kullanıcılarınız için en yakın olan konum.
   Barındırma seçenekleri ve planları	Kurumsal	Örneğinizle ilişkili kaynağı ve maliyeti belirleyen fiyatlandırma planı.
   Alanlar Arası Yedekli	Seçili değil	Azure Spring Apps hizmetinizi bir Azure kullanılabilirlik alanında oluşturma seçeneği. Bu özellik şu anda tüm bölgelerde desteklenmiyor.
   Yazılım IP Planı	Kullandıkça öde	Azure Spring Apps ile kullandıkça ödeme yapmanızı sağlayan fiyatlandırma planı.
   Örnek projeyi dağıtma	Seçili değil	Yerleşik örnek uygulamayı kullanma seçeneği.

4. Azure Spring Apps Oluştur sayfasındaki Tanılama ayarları sekmesine gidin ve yeni bir Log Analytics çalışma alanı örneği oluşturmak için Yeni oluştur'u seçin. Yeni Log Analytics çalışma alanı oluştur sayfasında Log Analytics çalışma alanının adını gerektiği gibi güncelleştirin ve ardından oluşturmayı onaylamak için Tamam'ı seçin.

5. Azure Spring Apps Oluştur sayfasındaki Uygulama Analizler sekmesine gidin ve yeni bir Uygulama Analizler örneği oluşturmak için Yeni oluştur'u seçin. Yeni Uygulama Analizler kaynağı oluştur sayfasında, Application insights adını gerektiği gibi güncelleştirin, Kaynak modu için Çalışma Alanı tabanlı'yı seçin ve ardından oluşturma işlemini onaylamak için Tamam'ı seçin.

6. Seçimlerinizi gözden geçirmek için Gözden Geçir ve Oluştur'u seçin. Ardından Oluştur'u seçerek Azure Spring Apps örneğini sağlayın.

7. Dağıtım işlemini izlemek için Bildirimler simgesini (zil) seçin. Dağıtım tamamlandıktan sonra Azure portalı panonuzda hizmetin Genel Bakış sayfasına kısayol oluşturmak için Panoya sabitle'yi seçebilirsiniz.

   

8. Azure Spring Apps'e Genel Bakış sayfasına gitmek için Kaynağa git'i seçin.

3.3. Azure Spring Apps örneğini yapılandırma

Aşağıdaki bölümlerde hizmet örneğinin nasıl yapılandırılır gösterilmektedir.

Uygulamaları oluşturma

Uygulamaları oluşturmak için aşağıdaki adımları kullanın:

1. Gezinti bölmesinde Uygulamalar'ı ve ardından Uygulama Oluştur'u seçin.

2. Uygulama Oluştur sayfasında, Uygulama adı için ön ucu kullanın ve diğer tüm alanları varsayılan değerleriyle bırakın.

3. Aşağıdaki uygulama adlarının her birini kullanarak önceki adımı yineleyin:

   • customers-service
   • vets-service
   • visits-service

4. Uygulama oluşturmayı tamamlamak için Oluştur'u seçin.

   

Hizmet Kayıt Defteri'ni yapılandırma

Service Registry'yi yapılandırmak için aşağıdaki adımları kullanın:

1. Gezinti bölmesinden Hizmet Kayıt Defteri'ni seçin.

2. Uygulama bağlama'yı seçin, Uygulamayı bağla'yı seçin, listeden öğesini customers-service seçin ve ardından Uygula'yı seçin.

3. Aşağıdaki uygulamaları bağlamak için önceki adımı yineleyin:

   • vets-service
   • visits-service

   

Uygulama Yapılandırma Hizmetini Yapılandırma

Uygulama Yapılandırma Hizmeti'ni yapılandırmak için aşağıdaki adımları kullanın:

1. Gezinti bölmesinde Uygulama Yapılandırma Hizmeti'ni ve ardından Ayarlar'ı seçin.

2. Depoyu aşağıdaki bilgilerle doldurun ve doğrula'yı seçin:

   • Ad: varsayılan
   • Desenler: uygulama,api-gateway,customers-service,vets-service,visits-service
   • URI: https://github.com/Azure-Samples/spring-petclinic-microservices-config.git.
   • Etiket: ana

   

3. Doğrulamadan sonra, Uygulama Yapılandırma Hizmeti yapılandırmasını tamamlamak için Uygula'yı seçin.

4. Uygulama bağlama'yı seçin, Uygulamayı bağla'yı seçin, listeden öğesini customers-service seçin ve ardından Uygula'yı seçin.

5. Aşağıdaki uygulamaları bağlamak için önceki adımı yineleyin:

   • vets-service
   • visits-service

   

Uygulamalar için yapılandırma dosyası desenlerini ayarlama

Yapılandırma dosyası desenlerini ayarlamak için aşağıdaki adımları kullanın:

1. Gezinti bölmesinde Uygulamalar'ı ve ardından uygulamayı seçincustomers-service.

2. Uygulamaya genel bakış sayfasında Yapılandırma'yı seçin, Genel ayarlar sekmesinde Yapılandırma dosyası desenleri'ni ve ardından uygulama ve customers-service'yi seçin. Yapılandırma dosyası desenlerini ayarlamak için Kaydet'i seçin.

3. Aşağıdaki uygulamalar için yapılandırma dosyası desenlerini kaydetmek için önceki adımı yineleyin:

   • vets-service: uygulama ve vets-serviceöğesini seçin.
   • visits-service: uygulama ve visits-serviceöğesini seçin.

Spring Cloud Gateway'i yapılandırma

Bu bölümde Spring Cloud Gateway'i nasıl yapılandırabileceğiniz gösterilmektedir.

İlk olarak, ağ geçidi erişimi için bir uç nokta atamak üzere aşağıdaki adımları kullanın:

1. Gezinti bölmesinde Spring Cloud Gateway'i seçin.

2. Genel Bakış sekmesinde, bir uç nokta atamak için Evet'i seçin. Daha sonra kullanmak için uç nokta URL'sini kaydedin.

Ardından Spring Cloud Gateway için yönlendirmeyi yapılandırın. Azure portalı şu anda Spring Cloud Gateway için yol yapılandırmasını desteklemediğinden bir Bash penceresi açın ve yönlendirmeyi yapılandırmak için aşağıdaki Azure CLI adımlarını kullanın:

1. Azure CLI'da oturum açmak için aşağıdaki komutu kullanın:

   az login
   

2. Azure CLI için Azure Spring Apps uzantısını yüklemek ve ad alanını Microsoft.SaaSkaydetmek için aşağıdaki komutları kullanın:

   az extension add --name spring --upgrade
   az provider register --namespace Microsoft.SaaS
   

3. Yasal koşulları ve gizlilik bildirimlerini kabul etmek için aşağıdaki komutu kullanın:

   Not

   Bu adım yalnızca aboneliğiniz Azure Spring Apps'in Kurumsal plan örneğini oluşturmak için hiç kullanılmamışsa gereklidir.

   az term accept \
       --publisher vmware-inc \
       --product azure-spring-cloud-vmware-tanzu-2 \
       --plan asa-ent-hr-mtr
   

4. Aşağıdaki komutları kullanarak kaynak adlarını tutmak için değişkenler oluşturun. Yer tutucuları kendi değerlerinizle değiştirmeyi unutmayın.

   export SUBSCRIPTION_ID=<subscription-ID>
   export RESOURCE_GROUP=<resource-group-name>
   export SPRING_APPS_NAME=<Azure-Spring-Apps-instance-name>
   export APP_CUSTOMERS_SERVICE=customers-service
   export APP_VETS_SERVICE=vets-service
   export APP_VISITS_SERVICE=visits-service
   export APP_FRONTEND=frontend
   

5. Varsayılan aboneliği ayarlamak için aşağıdaki komutu kullanın:

   az account set --subscription ${SUBSCRIPTION_ID}
   

6. Uygulamanın yönlendirmesini ayarlamak için customers-service aşağıdaki komutu kullanın:

   az spring gateway route-config create \
       --resource-group ${RESOURCE_GROUP} \
       --service ${SPRING_APPS_NAME} \
       --name ${APP_CUSTOMERS_SERVICE} \
       --app-name ${APP_CUSTOMERS_SERVICE} \
       --routes-json \
         '[
           {
             "predicates": [
               "Path=/api/customer/**"
             ],
             "filters": [
               "StripPrefix=2"
             ]
           }
         ]'
   

7. Uygulamanın yönlendirmesini ayarlamak için vets-service aşağıdaki komutu kullanın:

   az spring gateway route-config create \
       --resource-group ${RESOURCE_GROUP} \
       --service ${SPRING_APPS_NAME} \
       --name ${APP_VETS_SERVICE} \
       --app-name ${APP_VETS_SERVICE} \
       --routes-json \
         '[
            {
              "predicates": [
                "Path=/api/vet/**"
              ],
              "filters": [
                "StripPrefix=2"
              ]
            }
          ]'
   

8. Uygulamanın yönlendirmesini ayarlamak için visits-service aşağıdaki komutu kullanın:

   az spring gateway route-config create \
       --resource-group ${RESOURCE_GROUP} \
       --service ${SPRING_APPS_NAME} \
       --name ${APP_VISITS_SERVICE} \
       --app-name ${APP_VISITS_SERVICE} \
       --routes-json \
         '[
            {
              "predicates": [
                "Path=/api/visit/**"
              ],
              "filters": [
                "StripPrefix=2"
              ]
            }
          ]'
   

9. Ön uç uygulamasının yönlendirmesini ayarlamak için aşağıdaki komutu kullanın:

   az spring gateway route-config create \
       --resource-group ${RESOURCE_GROUP} \
       --service ${SPRING_APPS_NAME} \
       --name ${APP_FRONTEND} \
       --app-name ${APP_FRONTEND} \
       --routes-json \
         '[
            {
              "predicates": [
                "Path=/**"
              ],
              "filters": [
                "StripPrefix=0"
              ],
              "order": 1000
            }
          ]'
   

Geliştirici Araçlarını Yapılandırma

Geliştirici Araçları'nı yapılandırmak için aşağıdaki adımları kullanın.

1. Gezinti bölmesinde Geliştirici Araçları'nı seçin.

2. Geliştirici Araçları için uç nokta atamak için Uç nokta ata'yı seçin.

3. Daha sonra kullanmak için App Live View'un uç noktasını kaydedin.

Azure CLI

3.1. Her kaynak için ad sağlayın

Aşağıdaki komutları kullanarak kaynak adlarını tutmak için değişkenler oluşturun. Yer tutucuları kendi değerlerinizle değiştirmeyi unutmayın.

export LOCATION=<location>
export RESOURCE_GROUP=myresourcegroup
export SPRING_APPS=myasa
export APP_FRONTEND=frontend
export APP_CUSTOMERS_SERVICE=customers-service
export APP_VETS_SERVICE=vets-service
export APP_VISITS_SERVICE=visits-service
export GIT_CONFIG_REPO=default

3.2. Azure CLI'da oturum açma

Oturum açmak için aşağıdaki adımları kullanın:

1. Azure CLI'da oturum açmak için aşağıdaki komutu kullanın:

   az login
   

2. Kullanılacak abonelik kimliğini belirlemek üzere tüm kullanılabilir abonelikleri listelemek için aşağıdaki komutu kullanın:

   az account list --output table
   

3. Varsayılan aboneliği ayarlamak için aşağıdaki komutu kullanın:

   az account set --subscription <subscription-ID>
   

3.3. Yeni bir kaynak grubu oluşturma

Yeni bir kaynak grubu oluşturmak için aşağıdaki adımları kullanın:

1. Varsayılan konumu ayarlamak için aşağıdaki komutu kullanın:

   az configure --defaults location=${LOCATION}
   

2. Kaynak grubu oluşturmak için aşağıdaki komutu kullanın:

   az group create --resource-group ${RESOURCE_GROUP}
   

3. Yeni oluşturulan kaynak grubunu varsayılan kaynak grubu olarak ayarlamak için aşağıdaki komutu kullanın:

   az configure --defaults group=${RESOURCE_GROUP}
   

3.4. Uzantı yükleme ve ad alanını kaydetme

Azure CLI için Azure Spring Apps uzantısını yüklemek ve ad alanını kaydetmek Microsoft.SaaS için aşağıdaki komutları kullanın:

az extension add --name spring --upgrade
az provider register --namespace Microsoft.SaaS

3.5. Azure Spring Apps örneği oluşturma

Hizmet örneğini oluşturmak için aşağıdaki adımları kullanın:

1. Kurumsal plan için yasal koşulları ve gizlilik bildirimlerini kabul etmek için aşağıdaki komutu kullanın:

   Not

   Bu adım yalnızca aboneliğiniz Azure Spring Apps'in Kurumsal plan örneğini oluşturmak için hiç kullanılmamışsa gereklidir.

   az term accept \
       --publisher vmware-inc \
       --product azure-spring-cloud-vmware-tanzu-2 \
       --plan asa-ent-hr-mtr
   

2. Gerekli Tanzu bileşenleriyle bir Azure Spring Apps hizmet örneği oluşturmak için aşağıdaki komutu kullanın:

   az spring create \
       --name ${SPRING_APPS} \
       --sku Enterprise \
       --enable-application-configuration-service \
       --enable-service-registry \
       --enable-gateway \
       --enable-application-live-view
   

3.6. Azure Spring Apps örneğini yapılandırma

Hizmet örneğini yapılandırmak için aşağıdaki adımları kullanın:

1. Azure Spring Apps örneğinin tanılama ayarlarını yapılandırmak için aşağıdaki komutu kullanın:

   export SPRING_APPS_RESOURCE_ID=$(az spring show \
       --name ${SPRING_APPS} \
       --query id \
       --output tsv)
   az monitor diagnostic-settings create \
       --resource ${SPRING_APPS_RESOURCE_ID} \
       --name logs-and-metrics \
       --workspace ${SPRING_APPS} \
       --logs '[
         {
           "category": "ApplicationConsole",
           "enabled": true,
           "retentionPolicy": {
             "enabled": false,
             "days": 0
           }
         },
         {
            "category": "SystemLogs",
            "enabled": true,
            "retentionPolicy": {
              "enabled": false,
              "days": 0
            }
         },
         {
            "category": "IngressLogs",
            "enabled": true,
            "retentionPolicy": {
              "enabled": false,
              "days": 0
             }
         }
       ]' \
       --metrics '[
         {
           "category": "AllMetrics",
           "enabled": true,
           "retentionPolicy": {
             "enabled": false,
             "days": 0
           }
         }
       ]'
   

2. Azure Spring Apps örneğine yönelik uygulamalar oluşturmak için aşağıdaki komutları kullanın:

   az spring app create --service ${SPRING_APPS} --name ${APP_FRONTEND}
   az spring app create --service ${SPRING_APPS} --name ${APP_CUSTOMERS_SERVICE}
   az spring app create --service ${SPRING_APPS} --name ${APP_VETS_SERVICE}
   az spring app create --service ${SPRING_APPS} --name ${APP_VISITS_SERVICE}
   

3. Service Registry için uygulamaları bağlamak için aşağıdaki komutları kullanın:

   az spring service-registry bind --service ${SPRING_APPS} --app ${APP_CUSTOMERS_SERVICE}
   az spring service-registry bind --service ${SPRING_APPS} --app ${APP_VETS_SERVICE}
   az spring service-registry bind --service ${SPRING_APPS} --app ${APP_VISITS_SERVICE}
   

4. Uygulama Yapılandırma Hizmeti için bir yapılandırma deposu oluşturmak için aşağıdaki komutu kullanın:

   az spring application-configuration-service git repo add \
       --service ${SPRING_APPS} \
       --name ${GIT_CONFIG_REPO} \
       --patterns application,api-gateway,customers-service,vets-service,visits-service \
       --uri https://github.com/Azure-Samples/spring-petclinic-microservices-config.git \
       --label master
   

5. Uygulamaları Uygulama Yapılandırma Hizmeti'ne bağlamak için aşağıdaki komutları kullanın:

   az spring application-configuration-service bind \
       --service ${SPRING_APPS} \
       --app ${APP_CUSTOMERS_SERVICE}
   az spring application-configuration-service bind \
       --service ${SPRING_APPS} \
       --app ${APP_VETS_SERVICE}
   az spring application-configuration-service bind \
       --service ${SPRING_APPS} \
       --app ${APP_VISITS_SERVICE}
   

6. Spring Cloud Gateway'e bir uç nokta atamak için aşağıdaki komutu kullanın:

   az spring gateway update --service ${SPRING_APPS} --assign-endpoint
   

7. Uygulama için yönlendirmeyi ayarlamak için customers-service aşağıdaki komutu kullanın:

   az spring gateway route-config create \
       --service ${SPRING_APPS} \
       --name ${APP_CUSTOMERS_SERVICE} \
       --app-name ${APP_CUSTOMERS_SERVICE} \
       --routes-json '[
         {
           "predicates": [
             "Path=/api/customer/**"
           ],
           "filters": [
             "StripPrefix=2"
           ]
         }
      ]'
   

8. Uygulama için yönlendirmeyi ayarlamak için vets-service aşağıdaki komutu kullanın:

   az spring gateway route-config create \
       --service ${SPRING_APPS} \
       --name ${APP_VETS_SERVICE} \
       --app-name ${APP_VETS_SERVICE} \
       --routes-json '[
         {
           "predicates": [
             "Path=/api/vet/**"
           ],
           "filters": [
             "StripPrefix=2"
           ]
         }
       ]'
   

9. Uygulama için yönlendirmeyi ayarlamak için visits-service aşağıdaki komutu kullanın:

   az spring gateway route-config create \
       --service ${SPRING_APPS} \
       --name ${APP_VISITS_SERVICE} \
       --app-name ${APP_VISITS_SERVICE} \
       --routes-json '[
         {
           "predicates": [
             "Path=/api/visit/**"
           ],
           "filters": [
             "StripPrefix=2"
           ]
         }
       ]'
   

10. Uygulama için yönlendirmeyi ayarlamak için frontend aşağıdaki komutu kullanın:

    az spring gateway route-config create \
        --service ${SPRING_APPS} \
        --name ${APP_FRONTEND} \
        --app-name ${APP_FRONTEND} \
        --routes-json '[
          {
            "predicates": [
              "Path=/**"
            ],
            "filters": [
              "StripPrefix=0"
            ],
            "order": 1000
          }
        ]'
    

11. Application Live View'a bir uç nokta atamak için aşağıdaki komutu kullanın:

    az spring dev-tool update --service ${SPRING_APPS} --assign-endpoint
    

4. Uygulamaları Azure Spring Apps'e dağıtma

Azure portalı

Önceki bölümdeki Azure'a Dağıt düğmesi, uygulama dağıtımı içeren bir Azure portalı deneyimi başlatır, bu nedenle başka bir şey gerekmez.

Azure portalı + Maven eklentisi

Azure Spring Apps için Maven eklentisini kullanarak dağıtmak için aşağıdaki adımları kullanın:

1. Proje kök dizinine gidin ve Azure Spring Apps'te uygulamaları yapılandırmak için aşağıdaki komutu çalıştırın:

   ./mvnw -P spring-apps-enterprise com.microsoft.azure:azure-spring-apps-maven-plugin:1.19.0:config
   

   Aşağıdaki listede komut etkileşimleri açıklanmaktadır:

   • Yapılandırılan alt modülleri seçin: Tümünü seçmek için Enter tuşuna basın.
   • Aboneliği seçin: Oluşturduğunuz Azure Spring Apps örneğinin abonelik listesi numarasını seçin ve varsayılan olarak listedeki ilk aboneliği seçin. Varsayılan sayıyı kullanıyorsanız doğrudan Enter tuşuna basın.
   • Azure'da mevcut Azure Spring Apps'i kullanma: Mevcut Azure Spring Apps örneğini kullanmak için y tuşuna basın.
   • Genel erişimi kullanıma açmak için uygulamaları seçin: Yok seçeneğini seçmek için Enter tuşuna basın.
   • Yukarıdaki tüm yapılandırmaları kaydetmek için onaylayın: y tuşuna basın. n tuşuna basarsanız yapılandırma POM dosyalarına kaydedilmez.

2. Arka uç uygulamalarını dağıtmak için aşağıdaki komutu kullanın:

   ./mvnw azure-spring-apps:deploy
   

   Komut çalıştırıldıktan sonra, aşağıdaki günlük iletilerinden dağıtımın başarılı olduğunu görebilirsiniz:

   [INFO] Start deploying artifact(customers-service-3.0.1.jar) to deployment(default) of app(customers-service)...
   [INFO] Artifact(customers-service-3.0.1.jar) is successfully deployed to deployment(default) of app(customers-service).
   [INFO] Starting Spring App after deploying artifacts...
   [INFO] Deployment Status: Running
   
   ...
   
   [INFO] Start deploying artifact(vets-service-3.0.1.jar) to deployment(default) of app(vets-service)...
   [INFO] Artifact(vets-service-3.0.1.jar) is successfully deployed to deployment(default) of app(vets-service).
   [INFO] Starting Spring App after deploying artifacts...
   [INFO] Deployment Status: Running
   
   ...
   
   [INFO] Start deploying artifact(visits-service-3.0.1.jar) to deployment(default) of app(visits-service)...
   [INFO] Artifact(visits-service-3.0.1.jar) is successfully deployed to deployment(default) of app(visits-service).
   [INFO] Starting Spring App after deploying artifacts...
   [INFO] Deployment Status: Running
   

3. Azure portalı ön uç uygulamalarını dağıtmayı desteklemediğinden, ön uç uygulamasını dağıtmak için aşağıdaki Azure CLI komutunu kullanın:

   az spring app deploy \
       --resource-group ${RESOURCE_GROUP} \
       --service ${SPRING_APPS_NAME} \
       --name ${APP_FRONTEND} \
       --source-path spring-petclinic-frontend \
       --build-env BP_WEB_SERVER=nginx
   

   Komut çalıştırıldıktan sonra, aşağıdaki günlük iletilerinden dağıtımın başarılı olduğunu görebilirsiniz:

   [5/5] Updating deployment in app "frontend" (this operation can take a while to complete)
   Azure Spring Apps will use rolling upgrade to update your deployment, you have 1 instance, Azure Spring Apps will update the deployment in 1 round.
   The deployment is in round 1, 1 old instance is deleted/deleting and 1 new instance is started/starting
   Your application is successfully deployed.
   

Azure CLI

Uygulamaları dağıtmak için aşağıdaki adımları kullanın:

1. Proje kök dizinini girin ve ön uç uygulamasını derlemek ve dağıtmak için aşağıdaki komutu kullanın:

   az spring app deploy \
       --service ${SPRING_APPS} \
       --name ${APP_FRONTEND} \
       --build-env BP_WEB_SERVER=nginx \
       --source-path ./spring-petclinic-frontend
   

2. Uygulamayı derlemek ve dağıtmak customers-service için aşağıdaki komutu kullanın:

   az spring app deploy \
       --service ${SPRING_APPS} \
       --name ${APP_CUSTOMERS_SERVICE} \
       --source-path \
       --config-file-pattern application,customers-service \
       --build-env \
           BP_MAVEN_BUILT_MODULE=spring-petclinic-customers-service \
           BP_JVM_VERSION=17
   

3. Uygulamayı derlemek ve dağıtmak vets-service için aşağıdaki komutu kullanın:

   az spring app deploy \
       --service ${SPRING_APPS} \
       --name ${APP_VETS_SERVICE} \
       --source-path \
       --config-file-pattern application,vets-service \
       --build-env \
           BP_MAVEN_BUILT_MODULE=spring-petclinic-vets-service \
           BP_JVM_VERSION=17
   

4. Uygulamayı derlemek ve dağıtmak visits-service için aşağıdaki komutu kullanın:

   az spring app deploy \
       --service ${SPRING_APPS} \
       --name ${APP_VISITS_SERVICE} \
       --source-path \
       --config-file-pattern application,visits-service \
       --build-env \
           BP_MAVEN_BUILT_MODULE=spring-petclinic-visits-service \
           BP_JVM_VERSION=17
   

5. Uygulamaları doğrulama

Aşağıdaki bölümlerde dağıtımın nasıl doğrulandığı açıklanmaktadır.

Azure portalı

5.1. Uygulamalara erişme

Dağıtım tamamlandıktan sonra, aşağıdaki ekran görüntüsünde gösterildiği gibi dağıtım çıkışlarından Spring Cloud Gateway URL'sini bulabilirsiniz:

Ağ geçidi URL'sini açın. Uygulama aşağıdaki ekran görüntüsüne benzer görünmelidir:

5.2. Uygulama günlüklerini sorgulama

Pet Clinic'in her işlevine göz atdıktan sonra Log Analytics çalışma alanı her uygulamanın günlüklerini toplar. Aşağıdaki ekran görüntüsünde gösterildiği gibi özel sorgular kullanarak günlükleri de kontrol edebilirsiniz:

5.3. Uygulamaları izleme

Uygulama Analizler, aşağıdaki uygulama izleme haritasında gösterildiği gibi uygulama bağımlılıklarını izler:

Uygulama Canlı Görünümü URL'sini dağıtım çıkışlarından bulabilirsiniz. Aşağıdaki ekran görüntüsünde gösterildiği gibi uygulama çalışma zamanlarını izlemek için Uygulama Canlı Görünümü URL'sini açın:

Azure portalı + Maven eklentisi

5.1. Uygulamalara erişme

Spring Cloud Gateway'den atanan uç noktayı kullanın; örneğin, https://<your-Azure-Spring-Apps-instance-name>-gateway-xxxxx.svc.azuremicroservices.io. Uygulama aşağıdaki ekran görüntüsüne benzer görünmelidir:

5.2. Uygulama günlüklerini sorgulama

Pet Clinic'in her işlevine göz atdıktan sonra Log Analytics çalışma alanı her uygulamanın günlüklerini toplar. Aşağıdaki ekran görüntüsünde gösterildiği gibi özel sorgular kullanarak günlükleri de kontrol edebilirsiniz:

5.3. Uygulamaları izleme

Uygulama Analizler, aşağıdaki uygulama izleme haritasında gösterildiği gibi uygulama bağımlılıklarını izler:

Aşağıdaki ekran görüntüsünde gösterildiği gibi uygulama çalışma zamanlarını izlemek için Geliştirici Araçları tarafından sunulan Uygulama Canlı Görünümü URL'sini açın:

Azure CLI

5.1. Uygulamalara erişme

Spring Cloud Gateway URL'sini almak için aşağıdaki komutları kullanın:

export GATEWAY_URL=$(az spring gateway show \
    --service ${SPRING_APPS} \
    --query properties.url \
    --output tsv)
echo "https://${GATEWAY_URL}"

Uygulama aşağıdaki ekran görüntüsüne benzer görünmelidir:

5.2. Uygulama günlüklerini sorgulama

Pet Clinic'in her işlevine göz atdıktan sonra Log Analytics çalışma alanı her uygulamanın günlüklerini toplar. Aşağıdaki ekran görüntüsünde gösterildiği gibi özel sorgular kullanarak günlükleri de kontrol edebilirsiniz:

5.3. Uygulamaları izleme

Uygulama Analizler, aşağıdaki uygulama izleme haritasında gösterildiği gibi uygulama bağımlılıklarını izler:

Uygulama Canlı Görünümü URL'sini almak için aşağıdaki komutları kullanın:

export DEV_TOOL_URL=$(az spring dev-tool show \
    --service ${SPRING_APPS} \
    --query properties.url \
    --output tsv)
echo "https://${DEV_TOOL_URL}/app-live-view"

Aşağıdaki ekran görüntüsünde gösterildiği gibi uygulama çalışma zamanlarını izlemek için Uygulama Canlı Görünümü URL'sini açın:

5.1. Uygulamalara erişme

Dağıtım günlüğü çıkışındaki URL bilgilerini kullanarak adlı api-gateway uygulama tarafından sunulan URL'yi açın. Örneğin, https://<your-Azure-Spring-Apps-instance-name>-api-gateway.azuremicroservices.io. Uygulama aşağıdaki ekran görüntüsüne benzer görünmelidir:

5.2. Uygulama günlüklerini sorgulama

Pet Clinic'in her işlevine göz atdıktan sonra Log Analytics çalışma alanı her uygulamanın günlüklerini toplar. Aşağıdaki ekran görüntüsünde gösterildiği gibi özel sorgular kullanarak günlükleri de kontrol edebilirsiniz:

5.3. Uygulamaları izleme

Uygulama Analizler, aşağıdaki uygulama izleme haritasında gösterildiği gibi uygulama bağımlılıklarını izler:

Aşağıdaki ekran görüntüsünde gösterildiği gibi Spring Boot Yönetici Sunucusu aracılığıyla uygulamaları yönetmek için uygulama admin-server tarafından sunulan URL'yi açın:

6. Kaynakları temizleme

Sonraki hızlı başlangıçlar ve öğreticilerle çalışmaya devam etmek istiyorsanız, bu kaynakları yerinde bırakmak isteyebilirsiniz. Kaynaklara artık ihtiyacınız kalmadığında, Azure ücretlerinden kaçınmak için gereksiz kaynakları temizleyebilirsiniz.

Azure portalı + Maven eklentisi

Yeni oluşturulan hizmet örneği de dahil olmak üzere kaynak grubunun tamamını silmek için aşağıdaki adımları kullanın:

1. Azure portalında kaynak grubunuzu bulun. Gezinti menüsünde Kaynak grupları'nı ve ardından kaynak grubunuzun adını seçin.

2. Kaynak grubu sayfasında Sil'i seçin. Silme işlemini onaylamak için metin kutusuna kaynak grubunuzun adını girin ve Sil'i seçin.

Azure Geliştirici CLI'sı

Bu örnek uygulamada kullanılan tüm Azure kaynaklarını silmek için aşağıdaki komutu kullanın:

azd down

Aşağıdaki listede komut etkileşimi açıklanmaktadır:

• Silinecek toplam kaynak: <resources-total>, devam etmek istediğinizden emin misiniz?: y tuşuna basın.

Konsol, aşağıdaki örneğe benzer iletiler gönderir:

SUCCESS: Your application was removed from Azure in xx minutes xx seconds.

Artık ihtiyacınız kalmadığında bu makalede oluşturduğunuz kaynakları sildiğinizden emin olun. Kaynak grubundaki tüm kaynakları içeren Azure kaynak grubunu silebilirsiniz.

Azure portalı

Kaynak grubunun tamamını silmek için aşağıdaki adımları kullanın:

1. Azure portalında kaynak grubunuzu bulun. Gezinti menüsünde Kaynak grupları'nı ve ardından kaynak grubunuzun adını seçin.

2. Kaynak grubu sayfasında Sil'i seçin. Silme işlemini onaylamak için metin kutusuna kaynak grubunuzun adını girin ve Sil'i seçin.

Azure portalı + Maven eklentisi

Kaynak grubunun tamamını silmek için aşağıdaki adımları kullanın:

1. Azure portalında kaynak grubunuzu bulun. Gezinti menüsünde Kaynak grupları'nı ve ardından kaynak grubunuzun adını seçin.

2. Kaynak grubu sayfasında Sil'i seçin. Silme işlemini onaylamak için metin kutusuna kaynak grubunuzun adını girin ve Sil'i seçin.

Azure CLI

Kaynak grubunu silmek için aşağıdaki komutu kullanın:

az group delete --name ${RESOURCE_GROUP}

7. Sonraki adımlar

Hızlı Başlangıç: Azure Spring Apps'i MySQL için Azure Veritabanı ile tümleştirme

GitHub Actions ile Azure Spring Apps CI/CD kullanma

Azure Spring Apps'e uygulama dağıtımlarını otomatikleştirme

Azure Spring Apps için yapılandırılmış uygulama günlüğü

Azure Spring Apps'te uygulamalar için yönetilen kimlikleri kullanma

Hızlı Başlangıç: Log Analytics çalışma alanı ayarlama

Hızlı Başlangıç: Azure Spring Apps uygulamalarını günlükler, ölçümler ve izleme ile izleme

Mevcut özel etki alanını Azure Spring Apps ile eşleme

Hızlı Başlangıç: Örnek uygulamaya giriş

Fitness Mağazası örnek uygulamasına giriş

Daha fazla bilgi için aşağıdaki makaleleri inceleyin:

• Azure Pet Clinic mikro hizmetleri
• Azure Spring Apps Örnekleri
• Spring geliştiricileri için Azure
• Spring Cloud Azure belgeleri