Hızlı Başlangıç: Azure Spring Apps'e olay temelli uygulama 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 makale şunlar için geçerlidir: ✔️ Standart tüketim ve ayrılmış (Önizleme) ✔️ Temel/Standart ✔️ Kurumsal

Bu makalede Spring Boot olay temelli bir uygulamanın Azure Spring Apps'e nasıl dağıtılacağı açıklanmaktadır.

Örnek proje adlı bir Service Bus kuyruğuna abone olan ve ardından iletiyi işleyen ve adlı upper-caselower-casebaşka bir kuyruğa başka bir ileti gönderen olay temelli bir uygulamadır. Uygulamayı basit hale getirmek için ileti işleme yalnızca iletiyi büyük harfe dönüştürür. Aşağıdaki diyagramda bu işlem gösterilmiştir:

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 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.

• 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.

1. Önkoşullar

Azure portalı

• Azure aboneliği. Azure aboneliğiniz yoksa başlamadan önce birücretsiz Azure hesabı oluşturun.

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. Azure aboneliğiniz yoksa başlamadan önce birücretsiz Azure hesabı oluşturun.
• Git.
• Java Development Kit (JDK), sürüm 17.
• Azure Developer CLI (AZD), sürüm 1.2.0 veya üzeri.

Azure portalı

• Azure aboneliği. Azure aboneliğiniz yoksa başlamadan önce birücretsiz Azure hesabı oluşturun.
• Hedef abonelikte ilk kez bir Azure Spring Apps Kurumsal plan örneği dağıtıyorsanız, Azure Market'de Azure Spring Apps Kurumsal katmanı teklifini görüntüleme'nin Gereksinimler bölümüne bakın.

Azure portalı + Maven eklentisi

• Azure aboneliği. Azure aboneliğiniz yoksa başlamadan önce birücretsiz Azure hesabı oluşturun.
• Hedef abonelikte ilk kez bir Azure Spring Apps Kurumsal plan örneği dağıtıyorsanız, Azure Market'de Azure Spring Apps Kurumsal katmanı teklifini görüntüleme'nin Gereksinimler bölümüne bakın.
• Git.
• Java Development Kit (JDK), sürüm 17.

Azure CLI

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

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

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

1. Örnek proje GitHub'da hazırdır. Aşağıdaki komutu kullanarak örnek projeyi kopyalayın:

   git clone https://github.com/Azure-Samples/ASA-Samples-Event-Driven-Application.git
   

2. Aşağıdaki komutları kullanarak örnek projeyi oluşturun:

   cd ASA-Samples-Event-Driven-Application
   ./mvnw clean package
   

Azure Geliştirici CLI'sı

Örneği yerel olarak hazırlamak için aşağıdaki adımları kullanın. Bu adımlarda, Azure Geliştirici CLI şablonlarından olay temelli uygulamayı başlatmak için AZD kullanılır.

1. Bir terminal açın, yeni, boş bir klasör oluşturun ve ardından bu klasöre gidin.

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

   azd init --template Azure-Samples/ASA-Samples-Event-Driven-Application
   

   Aşağıdaki listede komut etkileşimleri 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)
   
   (✓) Done: Initialized git repository
   (✓) Done: Downloading template code to: <your-local-path>
   
   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 örneği çalıştırmak için ihtiyacınız olan ana kaynaklar bir Azure Spring Apps örneği, bir Azure Key Vault ve bir Azure Service Bus örneğidir. Bu kaynakları oluşturmak için aşağıdaki adımları kullanın.

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

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

3.2. Service Bus örneği oluşturma

Service Bus örneği 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. Arama hizmeti s ve market arama kutusunda service bus için arama yapın.

3. Service Bus bölümünde Oluştur'u seçin.

4. 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 alanı adı	my-srvbus	Service Bus hizmetinizi tanımlayan benzersiz bir ad.
   Konum	Kullanıcılarınıza en yakın konum.	Kullanıcılarınız için en yakın olan konum.
   Barındırma seçenekleri ve planları	Temel	Fiyatlandırma planı, örneğinizle ilişkili kaynağı ve maliyeti belirler.

5. Oluşturma parametrelerini gözden geçirmek için Gözden Geçir ve Oluştur'u seçin. Ardından, Service Bus örneğini oluşturmayı tamamlamak için Oluştur'u seçin.

6. 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.

   

7. Service Bus Ad Alanı sayfasına gitmek için Kaynağa git'i seçin.

8. Gezinti menüsünde Paylaşılan erişim ilkeleri'ni ve ardından RootManageSharedAccessKey'i seçin.

9. SAS İlkesi: RootManageSharedAccessKey sayfasında, Spring uygulamasından bağlantıları ayarlamak için kullanılan Birincil Bağlan ion Dizesi değerini kopyalayın ve kaydedin.

10. Gezinti menüsünde Kuyruklar'ı ve ardından Kuyruk'ı seçin.

11. Kuyruk Oluştur sayfasında Ad için küçük harf girin ve Oluştur'u seçin.

12. Ad için büyük harf kullanarak önceki adımı yineleyerek başka bir kuyruk oluşturun.

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

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

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

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

3. Standart tüketim ve ayrılmış (önizleme) formunu aşağıdaki bilgilerle doldurun:

   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.
   Plan	Standart tüketim ve ayrılmış (önizleme)	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.
   Container Apps Ortamı	myacaenv	Ortam, birbiriyle iletişim kurabilen ve bir sanal ağ, günlük kaydı ve Dapr yapılandırmasını paylaşabilen bir veya daha fazla kapsayıcı uygulaması çevresinde güvenli bir sınırdır.

4. (İsteğe bağlı) Container Apps Ortamı oluşturmak için aşağıdaki adımları kullanın:

   Tüketim iş yükü

   1. Temel Bilgiler sekmesini aşağıdaki bilgilerle doldurun:

      • Ortam adı: myacaenv
      • Plan: Tüketim
      • Alanlar arası yedeklilik: Devre dışı

   2. Container Apps Ortamını oluşturmak için Oluştur'u seçin.

   Ayrılmış iş yükü

   1. Temel Bilgiler sekmesini aşağıdaki bilgilerle doldurun:

      • Ortam adı: myacaenv
      • Plan: (Önizleme) Tüketim ve Ayrılmış iş yükü profilleri
      • Alanlar arası yedeklilik: Devre dışı

   2. İş yükü profilleri (Önizleme) sekmesini seçin ve ardından iş yükü profili eklemek için İş yükü profili ekle'yi seçin.

   3. İş yükü profili ekle (Önizleme) sayfasında aşağıdaki bilgileri ekleyin:

      • İş yükü profili adı: my-wlp
      • İş yükü profili boyutu: Ayrılmış-D4'i seçin
      • Otomatik ölçeklendirme örneği sayısı aralığı: 3 ve 5'i seçin

   4. Ekle'yi seçin. Bu seçim sizi İş yükü profili ekle (Önizleme) sayfasına geri götürür. My-wlp öğesini ve ardından Oluştur'u seçerek Container Apps Ortamı'nı oluşturun.

5. Seçimlerinizi gözden geçirmek için Gözden Geçir ve Oluştur'u seçin. Azure Spring Apps örneğini sağlamak için Oluştur'u seçin.

6. 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. Kaynağa git'i seçtiğinizde hizmetin Genel Bakış sayfası açılır.

   

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

8. Sol gezinti menüsünde Uygulamalar'ı ve ardından Uygulama Oluştur'u seçin.

9. Uygulama Oluştur sayfasında Uygulama simple-event-driven-app adı yazın ve ardından Uygulama oluşturmak için Hızlı başlangıç örnek uygulamasını kullan'ı seçin.

   

10. Azure Spring Apps örneğini oluşturmayı tamamlamak için Oluştur'u seçin.

11. Uygulama oluşturulduktan sonra, önceki adımda oluşturduğunuz uygulama adını seçin.

12. Gezinti bölmesinden Yapılandırma'yı seçin ve ortam değişkenleri sekmesinde aşağıdaki özelliği yapılandırın.

    • SERVICE_BUS_CONNECTION_STRING: Service Bus birincil bağlantı dizesi girin.

    

13. Bağlantı özelliklerini kaydetmek için Kaydet'i seçin.

Azure Geliştirici CLI'sı

1. Azure'da OAuth2 ile 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. Şablonun altyapısını Azure'a sağlamak 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>-<random-string>> 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 bir ilerleme göstergesi görürsünüz.

4. Uygulamayı 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. Tam dizine gidin ve uygulamayı Azure Spring Apps'te yapılandırmak için aşağıdaki komutu çalıştırın:

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

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

   • OAuth2 oturum açma: OAuth2 protokolüne göre Azure'da oturum açmayı yetkilendirmeniz gerekir.
   • 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.
   • 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.
   • Azure Spring Apps'te <mevcut uygulamayı kullanın örnek-adınız>: Oluşturulan uygulamayı kullanmak için y 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. Uygulamayı dağıtmak için aşağıdaki komutu kullanın:

   ./mvnw azure-spring-apps:deploy
   

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

   • OAuth2 oturum açma: OAuth2 protokolüne göre Azure'da oturum açmayı yetkilendirmeniz gerekir.

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

   [INFO] Deployment(default) is successfully created
   [INFO] Starting Spring App after deploying artifacts...
   [INFO] Deployment Status: Running
   

Azure Geliştirici CLI'sı

AzD kullanarak uygulamayı paketleyin, web uygulamasının gerektirdiği Azure kaynaklarını sağlayın ve ardından Azure Spring Apps'e dağıtı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 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 simple-event-driven-app
   - 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 provision (Azure kaynaklarını sağlar), azd package (uygulamanızın dağıtılabilir bir kopyasını paketler) ve azd deploy (uygulama kodunu dağıtır). Daha fazla bilgi için bkz . Azure-Samples/ASA-Samples-Event-Driven-Application.

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

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

1. Örnek proje GitHub'da hazırdır. Aşağıdaki komutu kullanarak örnek projeyi kopyalayın:

   git clone https://github.com/Azure-Samples/ASA-Samples-Event-Driven-Application.git
   

2. Aşağıdaki komutları kullanarak örnek projeyi oluşturun:

   cd ASA-Samples-Event-Driven-Application
   ./mvnw clean package
   

Azure Geliştirici CLI'sı

Örneği yerel olarak hazırlamak için aşağıdaki adımları kullanın. Bu adımlarda, Azure Geliştirici CLI şablonlarından olay temelli uygulamayı başlatmak için AZD kullanılır.

1. Bir terminal açın, yeni, boş bir klasör oluşturun ve ardından bu klasöre gidin.

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

   azd init --template Azure-Samples/ASA-Samples-Event-Driven-Application
   

   Aşağıdaki listede komut etkileşimleri 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)
   
   (✓) Done: Initialized git repository
   (✓) Done: Downloading template code to: <your-local-path>
   
   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 örneği çalıştırmak için ihtiyacınız olan ana kaynaklar bir Azure Spring Apps örneği, bir Azure Key Vault örneği ve bir Azure Service Bus örneğidir. Bu kaynakları oluşturmak için aşağıdaki adımları kullanın.

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

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

3.2. Service Bus örneği oluşturma

Service Bus örneği 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. Arama hizmeti s ve market arama kutusunda service bus için arama yapın.

3. Service Bus bölümünde Oluştur'u seçin.

4. 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 alanı adı	my-srvbus	Service Bus hizmetinizi tanımlayan benzersiz bir ad.
   Konum	Kullanıcılarınıza en yakın konum.	Kullanıcılarınız için en yakın olan konum.
   Barındırma seçenekleri ve planları	Temel	Fiyatlandırma planı, örneğinizle ilişkili kaynağı ve maliyeti belirler.

5. Oluşturma parametrelerini gözden geçirmek için Gözden Geçir ve Oluştur'u seçin. Ardından, Service Bus örneğini oluşturmayı tamamlamak için Oluştur'u seçin.

6. 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.

   

7. Service Bus Ad Alanı sayfasına gitmek için Kaynağa git'i seçin.

8. Gezinti menüsünde Paylaşılan erişim ilkeleri'ni ve ardından RootManageSharedAccessKey'i seçin.

9. SAS İlkesi: RootManageSharedAccessKey sayfasında, Spring uygulamasından bağlantıları ayarlamak için kullanılan Birincil Bağlan ion Dizesi değerini kopyalayın ve kaydedin.

10. Gezinti menüsünde Kuyruklar'ı ve ardından Kuyruk'ı seçin.

11. Kuyruk Oluştur sayfasında Ad için küçük harf girin ve Oluştur'u seçin.

12. Ad için büyük harf kullanarak önceki adımı yineleyerek başka bir kuyruk oluşturun.

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

Azure Spring Apps örneği 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 formunu aşağıdaki bilgilerle 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 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.
   Plan	Standart	Plan, örneğinizle ilişkili kaynağı 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şturup oluşturmayacağınız, şu anda yalnızca birkaç bölgede desteklenebilir.

4. Seçimlerinizi gözden geçirmek için Gözden Geçir ve Oluştur'u seçin. Azure Spring Apps örneğini sağlamak için Oluştur'u seçin.

5. 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ına kısayol olarak bu hizmet için bir kutucuk oluşturabilirsiniz. Kaynağa git'i seçtiğinizde hizmetin Genel Bakış sayfası açılır.

   

3.4. Uygulama örneğini Service Bus örneğine Bağlan

1. Azure portalında Azure Spring Apps örneğine gidin.

2. Gezinti menüsünde Uygulamalar'ı ve ardından Uygulama Oluştur'u seçin.

3. Uygulama Oluştur sayfasında Uygulama adı için simple-event-driven-app girin ve Çalışma Zamanı platformu için Java 17'yi seçin.

   

4. Uygulama oluşturulduktan sonra, önceki adımda oluşturduğunuz uygulama adını seçin.

5. Yapılandırma sayfasında Ortam değişkenleri sekmesini seçin, Anahtar için SERVICE_BUS_CONNECTION_STRING girin, Değer için Service Bus bağlantı dizesi yapıştırın ve kaydet'i seçin.

   

Azure Geliştirici CLI'sı

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. Standart planı kullanarak şablonu ayarlamak için aşağıdaki komutu kullanın:

   azd env set PLAN standard
   

3. Uygulamanızın dağıtılabilir bir kopyasını paketlemek, şablonun altyapısını Azure'a sağlamak ve 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. Uygulamayı 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. Tam dizine gidin ve uygulamayı Azure Spring Apps'te yapılandırmak için aşağıdaki komutu çalıştırın:

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

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

   • OAuth2 oturum açma: OAuth2 protokolüne göre Azure'da oturum açmayı yetkilendirmeniz gerekir.
   • 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.
   • 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.
   • Azure Spring Apps'te <mevcut uygulamayı kullanın örnek-adınız>: Oluşturulan uygulamayı kullanmak için y 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. Uygulamayı dağıtmak için aşağıdaki komutu kullanın:

   ./mvnw azure-spring-apps:deploy
   

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

   • OAuth2 oturum açma: OAuth2 protokolüne göre Azure'da oturum açmayı yetkilendirmeniz gerekir.

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

   [INFO] Deployment(default) is successfully created
   [INFO] Starting Spring App after deploying artifacts...
   [INFO] Deployment Status: Running
   

Azure Geliştirici CLI'sı

AzD kullanarak uygulamayı paketleyin, web uygulamasının gerektirdiği Azure kaynaklarını sağlayın ve ardından Azure Spring Apps'e dağıtı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 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 simple-event-driven-app
   - 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 provision (Azure kaynaklarını sağlar), azd package (uygulamanızın dağıtılabilir bir kopyasını paketler) ve azd deploy (uygulama kodunu dağıtır). Daha fazla bilgi için bkz . Azure-Samples/ASA-Samples-Event-Driven-Application.

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

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

1. Örnek proje GitHub'da hazırdır. Aşağıdaki komutu kullanarak örnek projeyi kopyalayın:

   git clone https://github.com/Azure-Samples/ASA-Samples-Event-Driven-Application.git
   

2. Aşağıdaki komutları kullanarak örnek projeyi oluşturun:

   cd ASA-Samples-Event-Driven-Application
   ./mvnw clean package
   

Azure CLI

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

1. Örnek proje GitHub'da hazırdır. Aşağıdaki komutu kullanarak örnek projeyi kopyalayın:

   git clone https://github.com/Azure-Samples/ASA-Samples-Event-Driven-Application.git
   

2. Aşağıdaki komutları kullanarak örnek projeyi oluşturun:

   cd ASA-Samples-Event-Driven-Application
   ./mvnw clean package
   

3. Bulut ortamını hazırlama

Bu örneği çalıştırmak için ihtiyacınız olan ana kaynaklar bir Azure Spring Apps örneği ve bir Azure Service Bus örneğidir. Aşağıdaki bölümlerde bu kaynakları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. Service Bus örneği oluşturma

Service Bus örneği 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. Arama hizmeti s ve market arama kutusunda service bus için arama yapın.

3. Service Bus bölümünde Oluştur'u seçin.

4. 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 alanı adı	my-srvbus	Service Bus hizmetinizi tanımlayan benzersiz bir ad.
   Konum	Kullanıcılarınıza en yakın konum.	Kullanıcılarınız için en yakın olan konum.
   Barındırma seçenekleri ve planları	Temel	Fiyatlandırma planı, örneğinizle ilişkili kaynağı ve maliyeti belirler.

5. Oluşturma parametrelerini gözden geçirmek için Gözden Geçir ve Oluştur'u seçin. Ardından, Service Bus örneğini oluşturmayı tamamlamak için Oluştur'u seçin.

6. 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.

   

7. Service Bus Ad Alanı sayfasına gitmek için Kaynağa git'i seçin.

8. Gezinti menüsünde Kuyruklar'ı ve ardından Sıra'yı seçin.

9. Kuyruk Oluştur sayfasında Ad için küçük harf girin ve Oluştur'u seçin.

10. Ad için büyük harf kullanarak önceki adımı yineleyerek başka bir kuyruk oluşturun.

3.3. 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 formunu aşağıdaki bilgilerle doldurun:

   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. 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.

5. 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.

   

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

3.4. Uygulama örneğini Service Bus örneğine Bağlan

Hizmet örneklerinizi bağlamak için aşağıdaki adımları kullanın:

1. Azure portalında Azure Spring Apps örneğine gidin.

2. Gezinti bölmesinden Uygulamalar bölmesini açın ve Ardından Uygulama Oluştur'u seçin.

3. Uygulama Oluştur sayfasında, uygulama adı için simple-event-driven-app kullanın ve diğer tüm alanları varsayılan değerleriyle bırakın.

4. Uygulamayı oluşturmayı tamamlamak için Oluştur'u seçin ve ardından ayrıntıları görüntülemek için uygulamayı seçin.

5. Gezinti bölmesinden Hizmet Bağlan ve ardından Oluştur'u seçerek yeni bir hizmet bağlantısı oluşturun.

6. Temel Bilgiler sekmesini aşağıdaki bilgilerle doldurun:

   • Hizmet türü: Service Bus'ı seçin.
   • Bağlan ion adı: Değiştirebileceğiniz otomatik olarak oluşturulan bir adla doldurulur.
   • Abonelik: Aboneliğinizi seçin.
   • Ad Alanı: Oluşturduğunuz ad alanını seçin.
   • İstemci türü: SpringBoot'ı seçin.

7. Sonraki: Kimlik Doğrulaması sekmesini aşağıdaki bilgilerle yapılandırın:

   • İşlem hizmetinizle hedef hizmet arasında kullanmak istediğiniz kimlik doğrulama türünü seçin.: Bağlan ion dizesini seçin.

8. İleri: Ağ'ı seçin. Hedef hizmete erişimi etkinleştirmek için Güvenlik duvarı kurallarını yapılandırma varsayılan seçeneğini kullanın.

9. Seçimlerinizi gözden geçirmek için İleri: Gözden Geçir ve Oluştur'u, ardından bağlantıyı oluşturmak için Oluştur'u seçin.

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 RESOURCE_GROUP=<event-driven-app-resource-group-name>
export LOCATION=<desired-region>
export SERVICE_BUS_NAME_SPACE=<event-driven-app-service-bus-namespace>
export AZURE_SPRING_APPS_INSTANCE=<Azure-Spring-Apps-instance-name>
export APP_NAME=<event-driven-app-name>

3.2. Yeni bir kaynak grubu oluşturma

Yeni bir kaynak grubu oluşturmak 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. Varsayılan konumu ayarlamak için aşağıdaki komutu kullanın:

   az configure --defaults location=${LOCATION}
   

3. 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
   

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

   az account set --subscription <subscription-ID>
   

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

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

6. 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.3. 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.4. Azure Spring Apps örneği oluşturma

Azure Spring Apps örneğinizi oluşturmak için aşağıdaki komutu kullanın:

az spring create \
    --name ${AZURE_SPRING_APPS_INSTANCE} \
    --sku Enterprise

Ardından aşağıdaki komutu kullanarak Azure Spring Apps örneğinde bir uygulama oluşturun:

az spring app create \
    --service ${AZURE_SPRING_APPS_INSTANCE} \
    --name ${APP_NAME}

3.5. Service Bus örneği oluşturma

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

1. Service Bus ad alanı oluşturmak için aşağıdaki komutu kullanın:

   az servicebus namespace create --name ${SERVICE_BUS_NAME_SPACE}
   

2. ve upper-caseadlı lower-case iki kuyruk oluşturmak için aşağıdaki komutları kullanın:

   az servicebus queue create \
       --namespace-name ${SERVICE_BUS_NAME_SPACE} \
       --name lower-case
   az servicebus queue create \
       --namespace-name ${SERVICE_BUS_NAME_SPACE} \
       --name upper-case
   

3.6. Uygulama örneğini Service Bus örneğine Bağlan

Azure Spring Apps'te hem Service Bus'ı hem de uygulamayı oluşturdunuz, ancak uygulama Service Bus'a bağlanamıyor. Uygulamanın Service Bus'a bağlanmasını ve ardından uygulamayı dağıtmasını sağlamak için aşağıdaki adımları kullanın:

1. Aşağıdaki komutu kullanarak Service Bus'ın bağlantı dizesi alın:

   export SERVICE_BUS_CONNECTION_STRING=$( \
       az servicebus namespace authorization-rule keys list \
           --namespace-name ${SERVICE_BUS_NAME_SPACE} \
           --name RootManageSharedAccessKey \
           --query primaryConnectionString \
           --output tsv)
   

2. Bir ortam değişkeni aracılığıyla uygulamaya bağlantı dizesi sağlamak için aşağıdaki komutu kullanın:

   az spring app update \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name ${APP_NAME} \
       --env SPRING_CLOUD_AZURE_SERVICEBUS_CONNECTIONSTRING=${SERVICE_BUS_CONNECTION_STRING} \
             SPRING_CLOUD_AZURE_KEYVAULT_SECRET_PROPERTYSOURCEENABLED=false
   

4. Uygulamayı 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. Tam dizine gidin ve uygulamayı Azure Spring Apps'te yapılandırmak için aşağıdaki komutu çalıştırın:

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

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

   • OAuth2 oturum açma: OAuth2 protokolüne göre Azure'da oturum açmayı yetkilendirmeniz gerekir.
   • 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.
   • 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.
   • Azure Spring Apps'te <mevcut uygulamayı kullanın örnek-adınız>: Oluşturulan uygulamayı kullanmak için y 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. Uygulamayı dağıtmak için aşağıdaki komutu kullanın:

   ./mvnw azure-spring-apps:deploy
   

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

   • OAuth2 oturum açma: OAuth2 protokolüne göre Azure'da oturum açmayı yetkilendirmeniz gerekir.

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

   [INFO] Starting Spring App after deploying artifacts...
   [INFO] Deployment Status: Running
   

Azure CLI

Bulut ortamı artık hazır. Aşağıdaki komutu kullanarak uygulamayı dağıtın:

az spring app deploy \
    --service ${AZURE_SPRING_APPS_INSTANCE} \
    --name ${APP_NAME} \
    --artifact-path target/simple-event-driven-app-0.0.2-SNAPSHOT.jar

5. Uygulamayı doğrulama

Olay temelli uygulamanın düzgün çalıştığını onaylamak için aşağıdaki adımları kullanın. Kuyruğa ileti lower-case göndererek uygulamayı doğrulayabilir ve ardından kuyrukta upper-case bir ileti olduğunu onaylayabilirsiniz.

1. Service Bus Gezgini ile kuyruğa bir ileti lower-case gönderin. Daha fazla bilgi için Service Bus'ta veri işlemlerini çalıştırmak için Service Bus Gezgini'ni kullanma konusunun Kuyruğa veya konuya ileti gönderme bölümüne bakın.

2. Kuyruğa yeni bir ileti gönderildiğini upper-case onaylayın. Daha fazla bilgi için Service Bus'ta veri işlemlerini çalıştırmak için Service Bus Gezgini'ni kullanma bölümünün İletiye göz atma bölümüne bakın.

3. Uygulamanın günlüklerini denetlemek için Azure Spring Apps örneğine Genel Bakış sayfasına gidin ve Günlükler'i seçin.

   

Azure portalı

1. Service Bus Gezgini ile kuyruğa bir ileti lower-case gönderin. Daha fazla bilgi için Service Bus'ta veri işlemlerini çalıştırmak için Service Bus Gezgini'ni kullanma konusunun Kuyruğa veya konuya ileti gönderme bölümüne bakın.

2. Kuyruğa yeni bir ileti gönderildiğini upper-case onaylayın. Daha fazla bilgi için Service Bus'ta veri işlemlerini çalıştırmak için Service Bus Gezgini'ni kullanma bölümünün İletiye göz atma bölümüne bakın.

3. Uygulamanın günlüklerini denetlemek için Azure Spring Apps örneğine Genel Bakış sayfasına gidin ve Günlükler'i seçin.

   

4. Dağıtım sorunlarını araştırmak için yararlı olan her kaynak dağıtımının ayrıntılarını denetleyin.

Azure portalı + Maven eklentisi

1. Service Bus Gezgini ile kuyruğa bir ileti lower-case gönderin. Daha fazla bilgi için Service Bus'ta veri işlemlerini çalıştırmak için Service Bus Gezgini'ni kullanma konusunun Kuyruğa veya konuya ileti gönderme bölümüne bakın.

2. Kuyruğa yeni bir ileti gönderildiğini upper-case onaylayın. Daha fazla bilgi için Service Bus'ta veri işlemlerini çalıştırmak için Service Bus Gezgini'ni kullanma bölümünün İletiye göz atma bölümüne bakın.

3. Uygulamanın günlüklerini denetlemek için Azure Spring Apps örneğine Genel Bakış sayfasına gidin ve Günlükler'i seçin.

   

4. Dağıtım sorunlarını araştırmak için yararlı olan her kaynak dağıtımının ayrıntılarını denetleyin.

Azure CLI

1. Service Bus Gezgini ile kuyruğa bir ileti lower-case gönderin. Daha fazla bilgi için Service Bus'ta veri işlemlerini çalıştırmak için Service Bus Gezgini'ni kullanma konusunun Kuyruğa veya konuya ileti gönderme bölümüne bakın.

2. Kuyruğa yeni bir ileti gönderildiğini upper-case onaylayın. Daha fazla bilgi için Service Bus'ta veri işlemlerini çalıştırmak için Service Bus Gezgini'ni kullanma bölümünün İletiye göz atma bölümüne bakın.

3. Uygulamanın günlüklerini denetlemek için Azure Spring Apps örneğine Genel Bakış sayfasına gidin ve Günlükler'i seçin.

   

4. Herhangi bir dağıtım sorununu araştırmak üzere uygulamanın günlüğünü denetlemek için aşağıdaki komutu kullanın:

   az spring app logs \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name ${APP_NAME}
   

6. Kaynakları temizleme

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ı

Yeni oluşturulan hizmet 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 portalı + Maven eklentisi

Yeni oluşturulan hizmet 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 CLI

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

az group delete --name ${RESOURCE_GROUP}

Azure portalı

Yeni oluşturulan hizmet 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 portalı + Maven eklentisi

Yeni oluşturulan hizmet 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şimleri açıklanmaktadır:

• Silinecek toplam kaynak: <your-resources-total>, devam etmek istediğinizden emin misiniz?: y tuşuna basın.
• Bunun yerine bu kaynakları kalıcı olarak silip adlarının yeniden kullanılmasına izin vermek istiyor musunuz?: y tuşuna basın. Key Vault'un yeniden kullanılmasını istiyorsanız n 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.

7. Sonraki adımlar

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

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

GitHub Actions ile Azure Spring Apps CI/CD'yi ayarlama

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

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

Azure CLI ile Azure Spring Apps'te hizmet bağlantısı oluşturma

Mikro hizmet uygulamalarını çalıştırma (Pet Clinic)

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

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

• Azure Spring Apps Örnekleri.
• Azure’da Spring
• Spring Cloud Azure