Azure CLI'dan Spring Boot uygulamaları dağıtma

Not

Temel, Standardve Enterprise planları 17 Mart 2025'te kullanımdan kaldırma dönemine girdi. Daha fazla bilgi için bkz . Azure Spring Apps kullanımdan kaldırma duyurusu.

Bu makale şunlar için geçerlidir:✅ Java ❎ C#

Bu makale şunlar için geçerlidir:✅ Temel/Standart ❎️ Kurumsal

Azure Spring Apps, Azure'da Spring Boot uygulamalarını etkinleştirir.

Uygulamaları doğrudan Java kaynak kodundan veya önceden oluşturulmuş bir JAR'dan başlatabilirsiniz. Bu makalede dağıtım yordamları açıklanmaktadır.

Önkoşullar

Başlamadan önce Azure aboneliğinizin gerekli bağımlılıklara sahip olduğundan emin olun:

  1. Git'i yükleyin
  2. JDK 8'i yükleme
  3. Maven 3.0 veya üzerini yükleme
  4. Azure CLI'yı yükleme
  5. Azure aboneliğine kaydolma

İpucu

Azure Cloud Shell, bu makaledeki adımları çalıştırmak için kullanabileceğiniz ücretsiz bir etkileşimli kabuktur. Git, JDK, Maven ve Azure CLI'nın en son sürümleri dahil olmak üzere önceden yüklenmiş yaygın Azure araçlarına sahiptir. Azure aboneliğinizde oturum açtıysanız Azure Cloud Shell'inizi shell.azure.com başlatın. Belgelerimizi okuyarak Azure Cloud Shell hakkında daha fazla bilgi edinebilirsiniz

Azure CLI uzantısını yükleme

Aşağıdaki komutla Azure CLI için Azure Spring Apps uzantısını yükleyin

az extension add --name spring

Azure CLI kullanarak hizmet örneği sağlama

Azure CLI'da oturum açın ve etkin aboneliğinizi seçin.

az login
az account list -o table
az account set --subscription <subscription-id>

Azure Spring Apps'te hizmetinizi içerecek bir kaynak grubu oluşturun. Azure Kaynak Grupları hakkında daha fazla bilgi edinebilirsiniz.

az group create --location eastus --name <resource-group-name>

Azure Spring Apps örneğini sağlamak için aşağıdaki komutları çalıştırın. Azure Spring Apps'te hizmetiniz için bir ad hazırlayın. Ad 4 ile 32 karakter arasında 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.

az spring create --resource-group <resource-group-name> --name <resource-name>

Hizmet örneğinin dağıtılması yaklaşık beş dakika sürer.

Aşağıdaki komutları kullanarak varsayılan kaynak grubu adınızı ve Azure Spring Apps örnek adınızı ayarlayın:

az config set defaults.group=<service-group-name>
az config set defaults.spring=<service-instance-name>

Uygulamayı Azure Spring Apps'te oluşturma

Aşağıdaki komut, aboneliğinizdeki Azure Spring Apps'te bir uygulama oluşturur. Bu, uygulamanızı yükleyebileceğiniz boş bir hizmet oluşturur.

az spring app create --name <app-name>

Spring Boot uygulamanızı dağıtma

Uygulamanızı önceden oluşturulmuş bir JAR'dan veya Gradle veya Maven deposundan dağıtabilirsiniz. Her durum için talimatları aşağıda bulabilirsiniz.

Önceden oluşturulmuş JAR dağıtma

Yerel makinenizde oluşturulmuş bir JAR'dan kullanıma sunmak için derlemenizin bir fat-JAR ürettiğinden emin olun.

Fat-JAR'ı etkin bir dağıtıma dağıtmak için

az spring app deploy --name <app-name> --artifact-path <path-to-fat-JAR>

Fat-JAR'ı belirli bir dağıtıma dağıtmak için

az spring app deployment create --app <app-name> \
    --name <deployment-name> \
    --artifact-path <path-to-fat-JAR>

Kaynak koddan dağıtım

Azure Spring Apps, projenizi oluşturmak için kpack kullanır. Kaynak kodunuzu karşıya yüklemek, kpack kullanarak projenizi derlemek ve hedef uygulamaya dağıtmak için Azure CLI'yi kullanabilirsiniz.

Uyarı

Projenin yalnızca bir JAR dosyası üretmesi ve bu dosyanın main-classMANIFEST.MF içinde bir target girişi (Maven dağıtımları için) veya build/libs içinde (Gradle dağıtımları için) bulunması gerekir. Girdileri olan main-class birden çok JAR dosyası dağıtımın başarısız olmasına neden olur.

Tek modül Maven / Gradle projeleri için:

cd <path-to-maven-or-gradle-source-root>
az spring app deploy --name <app-name> --source-path

Birden çok modüle sahip Maven / Gradle projeleri için her modül için tekrarlayın:

cd <path-to-maven-or-gradle-source-root>
az spring app deploy --name <app-name> --source-path \
    --target-module <relative-path-to-module>

Dağıtım günlüklerini göster

Aşağıdaki komutu kullanarak kpack derleme günlüklerini gözden geçirin:

az spring app show-deploy-log --name <app-name>

Not

Kpack günlükleri yalnızca dağıtımın kpack kullanılarak kaynaktan oluşturulmuş olması durumunda en son dağıtımı gösterir.

Bir uygulamaya genel uç nokta atama

  1. Hizmet örneğinizin uygulamalarını görüntülemek için Uygulamalar bölmesini açın.
  2. Genel Bakış sayfasını görüntülemek için bir uygulama seçin.
  3. Uygulamaya bir genel uç nokta atamak için Uç nokta ata seçeneğini seçin. Bu işlem birkaç dakika sürebilir.
  4. Url'yi Genel Bakış sayfasından kopyalayın ve çalışan uygulamayı görüntülemek için tarayıcınıza yapıştırın.

Sonraki adımlar

Hızlı Başlangıç Kılavuzu: Azure Spring Apps'i günlükler, ölçümler ve izleme ile gözlemleme

GitHub'da daha fazla örnek mevcuttur: Azure Spring Apps Örnekleri.

  • Last updated on