Azure Spring Apps Kurumsal planında çok teknolojili uygulamaları dağıtma

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:❌ Temel/Standart ✔️ Kurumsal

Bu makalede, Azure Spring Apps Enterprise planında çok teknolojili uygulamaların nasıl dağıtılacağı ve bu çok teknolojili uygulamaların derleme paketleri tarafından sağlanan derleme hizmeti özelliklerini nasıl kullanabileceği gösterilir.

Önkoşullar

• Önceden sağlanmış bir Azure Spring Apps Kurumsal plan örneği. Daha fazla bilgi için bkz . Hızlı Başlangıç: Kurumsal planı kullanarak uygulamaları derleme ve Azure Spring Apps'e dağıtma.
• Azure CLI sürüm 2.45.0 veya üzeri. Azure Spring Apps uzantısını yüklemek için aşağıdaki komutu kullanın: az extension add --name spring

Hizmet örneğinde çok teknolojili uygulamaları dağıtma

Bu bölüm, derleme hizmeti etkinleştirildiğinde çok teknolojili uygulamalar oluşturmak ve dağıtmak için geçerlidir. Derleme hizmetini devre dışı bırakırsanız, uygulamaları yalnızca özel bir kapsayıcı görüntüsüyle dağıtabilirsiniz. Kendi görüntünüzü oluşturabilir veya Azure Spring Apps Enterprise örneği tarafından oluşturulmuş bir görüntü kullanabilirsiniz. Daha fazla bilgi için bkz . Özel kapsayıcı görüntüsüyle uygulama dağıtma.

Oluşturucuları yönetme

Azure Spring Apps Enterprise örneğini oluşturduğunuzda, aşağıdaki desteklenen dil ailesi derleme paketlerinden birinden varsayılan oluşturucuyu seçmeniz gerekir:

• VMware Tanzu için Java Azure Buildpack
• VMware Tanzu için .NET Core Buildpack
• VMware Tanzu için Go Buildpack
• VMware Tanzu için Web Sunucuları Derleme Paketi
• VMware Tanzu için Node.js Buildpack
• VMware Tanzu için Python Buildpack
• VMware Tanzu için Java Native Image Buildpack
• VMware Tanzu için PHP Buildpack

Daha fazla bilgi için bkz . VMware Tanzu için Dil Ailesi Derleme Paketleri.

Bu derleme paketleri Java, .NET Core, Go, web statik dosyaları, Node.js ve Python uygulamaları için kaynak kodu veya yapıtlarla derlemeyi destekler. Oluşturucu oluştururken veya görüntülerken derleme paketi sürümlerini de görebilirsiniz. Ayrıca derleme paketleri ve yığın belirterek özel bir oluşturucu oluşturabilirsiniz.

Azure Spring Apps hizmet örneğinde yapılandırılan tüm oluşturucular, aşağıdaki ekran görüntüsünde gösterildiği gibi Derleme Hizmeti sayfasında listelenir:

Yeni oluşturucu oluşturmak için Ekle'yi seçin. Aşağıdaki ekran görüntüsünde özel oluşturucu oluşturmak için kullanmanız gereken kaynaklar gösterilmektedir. İşletim Sistemi Yığını , , Bionic FullJammy Tiny, Jammy Baseve Jammy FulliçerirBionic Base. Bionic tabanlıdır Ubuntu 18.04 (Bionic Beaver) ve Jammy tabanlıdır Ubuntu 22.04 (Jammy Jellyfish). Daha fazla bilgi için işletim sistemi yığını önerileri bölümüne bakın.

VMware kullanım Bionic OS Stackdışı olduğundan oluşturucunuzu oluşturmak için komutunu kullanmanızı Jammy OS Stack öneririz.

Ayrıca, bir dağıtımda oluşturucu kullanılmadığında özel bir oluşturucuyu düzenleyebilirsiniz. Derleme paketlerini veya işletim sistemi yığınını güncelleştirebilirsiniz, ancak oluşturucu adı salt okunurdur.

Oluşturucu, dağıtımlarınıza sürekli katkıda bulunan bir kaynaktır. En son çalışma zamanı görüntülerini ve en son derleme paketleri sağlar.

Oluşturucu ile mevcut etkin dağıtımlar oluşturulurken oluşturucuyu silemezsiniz. Bu durumdaki bir oluşturucuyu silmek için aşağıdaki adımları kullanın:

1. Yapılandırmayı yeni bir oluşturucu olarak kaydedin.
2. Uygulamaları yeni oluşturucuyla dağıtın. Dağıtımlar yeni oluşturucuya bağlanır.
3. Önceki oluşturucunun altındaki dağıtımları yeni oluşturucuya geçirin.
4. Özgün oluşturucuyu silin.

İşletim sistemi yığını önerileri

Azure Spring Apps'te, VMware'in kullanımdan kaldırılmasına uygun olduğundan Bioinic OS Stack oluşturucunuzu oluşturmak için komutunu kullanmanızı Jammy OS Stack öneririz. Aşağıdaki listede kullanılabilir seçenekler açıklanmaktadır:

• Jammy Tiny: Mümkün olan en küçük boyut ve güvenlik ayak izi için minimum görüntü oluşturmak için uygundur. Java Yerel Görüntüsü oluşturmak gibi, son kapsayıcı görüntüsünü de küçültebilir. Tümleşik kitaplıklar sınırlıdır. Örneğin, kitaplık olmadığından shell sorun giderme için bir uygulama örneğine bağlanamazsınız.

  • Çoğu Go uygulaması.
  • Java uygulamaları. Tiny'nin kabuğu olmadığından, bölme/setenv.sh ayarlama gibi bazı Apache Tomcat yapılandırma seçenekleri kullanılamaz.

• Jammy Base: Yerel uzantıları olmayan çoğu uygulama için uygundur.

  • Java uygulamaları ve .NET Core uygulamaları.
  • Bazı C kitaplıkları gerektiren uygulamalar gidin.
  • Yerel uzantıları olmayan Node.js, Python veya Web Sunucuları uygulamaları.

• Jammy Full: Çoğu kitaplığı içerir ve yerel uzantılara sahip uygulamalar için uygundur. Örneğin, daha eksiksiz bir yazı tipi kitaplığı içerir. Uygulamanız yerel uzantıyı kullanıyorsa yığını kullanın Full .

  • yerel uzantılarla Node.js veya Python uygulamaları.

Daha fazla bilgi için VMware belgelerindeki Ubuntu Stacks bölümüne bakın.

Kapsayıcı kayıt defterini yönetme

Bu bölümde, derleme hizmetini kendi kapsayıcı kayıt defterinizle etkinleştirirseniz derleme hizmeti tarafından kullanılan kapsayıcı kayıt defterinin nasıl yönetileceği gösterilir. Derleme hizmetini Azure Spring Apps yönetilen kapsayıcı kayıt defteriyle etkinleştirirseniz bu bölümü atlayabilirsiniz.

Derleme hizmetiyle bir kullanıcı kapsayıcı kayıt defterini etkinleştirdikten sonra, Azure portalını veya Azure CLI'yı kullanarak kayıt defterini gösterebilir ve yapılandırabilirsiniz.

Azure portalı

Kapsayıcı kayıt defterini göstermek, eklemek, düzenlemek ve silmek için aşağıdaki adımları kullanın:

1. Azure portalını açın.

2. Gezinti bölmesinde Kapsayıcı kayıt defteri'ni seçin.

3. Kapsayıcı kayıt defteri oluşturmak için Ekle'yi seçin.

   

4. Kapsayıcı kayıt defteri için üç nokta (...) düğmesini ve ardından Düzenle'yi seçerek kayıt defteri yapılandırmasını görüntüleyin.

   

5. Kapsayıcı kayıt defterini düzenle sayfasındaki değerleri gözden geçirin.

   

6. Kapsayıcı kayıt defterini silmek için üç nokta (...) düğmesini ve ardından Sil'i seçerek kayıt defterini silin. Kapsayıcı kayıt defteri derleme hizmeti tarafından kullanılıyorsa silinemez.

   

Azure CLI

Hizmet örneğinin tüm kapsayıcı kayıt defterlerini listelemek için aşağıdaki komutu kullanın:

az spring container-registry list \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> 

Kapsayıcı kayıt defterini göstermek için aşağıdaki komutu kullanın:

az spring container-registry show \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <your-container-registry-name>

Kapsayıcı kayıt defterini güncelleştirmek için aşağıdaki komutu kullanın:

az spring container-registry update \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <your-container-registry-name> \
    --server <your-container-registry-login-server> \
    --username <your-container-registry-username> \
    --password <your-container-registry-password>

Kapsayıcı kayıt defterini silmek için aşağıdaki komutu kullanın:

az spring container-registry delete \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <your-container-registry-name> 

Derleme hizmeti kapsayıcı kayıt defterini kullanıyorsa silemezsiniz.

Derleme hizmeti bir kapsayıcı kayıt defteri kullanabilir ve ilişkili kapsayıcı kayıt defterini de değiştirebilir. Bu işlem zaman alır. Değişiklik gerçekleştiğinde, derleme hizmeti yeniden derlemesi altındaki tüm oluşturucu ve derleme kaynakları ve ardından son kapsayıcı görüntüleri yeni kapsayıcı kayıt defterine gönderilir.

Azure portalı

Derleme hizmetiyle ilişkili kapsayıcı kayıt defterini değiştirmek için aşağıdaki adımları kullanın:

1. Azure portalını açın.

2. Gezinti bölmesinde Hizmet Derle'yi seçin.

3. Derleme hizmetinin kapsayıcı kayıt defterini güncelleştirmek için Başvuruda bulunan kapsayıcı kayıt defteri'ni seçin.

   

Azure CLI

Derleme hizmetini göstermek için aşağıdaki komutu kullanın:

az spring build-service show \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name>

Derleme hizmetini belirli bir kapsayıcı kayıt defteriyle güncelleştirmek için aşağıdaki komutu kullanın:

az spring build-service update \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --registry-name <your-container-registry-name> 

Çok teknolojili uygulamalar oluşturma ve dağıtma

Kapsayıcı kayıt defterini kullanarak aşağıdaki yollarla çok teknolojili uygulamalar derleyebilir ve dağıtabilirsiniz:

• Azure Spring Apps yönetilen kapsayıcı kayıt defterini kullanarak derleme hizmeti için bir görüntüye uygulama derleyebilir ve ardından geçerli Azure Spring Apps hizmet örneğine dağıtabilirsiniz. Derleme ve dağıtım komutu kullanılarak az spring app deploy birlikte yürütülür.

• Kullanıcı tarafından yönetilen bir kapsayıcı kayıt defteri kullanan derleme hizmeti için bir kapsayıcı görüntüsüne uygulama oluşturabilir ve ardından görüntüyü geçerli Azure Spring Apps Enterprise örneğine ve diğer örneklere dağıtabilirsiniz. Derleme ve dağıtma komutları ayrıdır. Derleme oluşturmak veya güncelleştirmek için derleme komutunu kullanabilir, ardından kapsayıcı görüntüsünü hizmet örneğine dağıtmak için deploy komutunu kullanabilirsiniz.

Daha fazla bilgi için Tanzu Derleme Hizmeti'ni kullanma bölümünün İsteğe bağlı derleme hizmeti bölümüne bakın.

Aşağıdaki örneklerde, kullanılacak bazı yararlı derleme komutları gösterilmektedir.

az configure --defaults group=<resource-group-name> spring=<service-name>

az spring build-service build list
az spring build-service build show --name <build-name>
az spring build-service build create --name <build-name> --artifact-path <artifact-path>
az spring build-service build update --name <build-name> --artifact-path <artifact-path>
az spring build-service build delete --name <build-name>

Aşağıdaki Azure CLI örneklerinde iki kapsayıcı kayıt defteri senaryosu için yapıt dosyası oluşturma ve dağıtma işlemleri gösterilmektedir:

• Azure Spring Apps yönetilen kapsayıcı kayıt defteri.
• Kullanıcı tarafından yönetilen kapsayıcı kayıt defteri.

Azure Spring Apps yönetilen kapsayıcı kayıt defteri

Bu örnek, tek bir komutta derlenip dağıtılır. Aşağıdaki komut, kapsayıcı görüntüsüne uygulama derlemek için bir oluşturucu belirtir ve ardından uygulamayı doğrudan Azure Springs Apps Enterprise hizmet örneğine dağıtır.

Oluşturucuyu belirtmezseniz, bir default oluşturucu kullanılır.

az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --builder <builder-name> \
    --artifact-path <path-to-your-JAR-file>

Kullanıcı tarafından yönetilen kapsayıcı kayıt defteri

Bu örnek, bir uygulamayı oluşturur veya güncelleştirir ve iki komut kullanarak dağıtır. Kullanıcı tarafından yönetilen kapsayıcı kayıt defteriyle, bir uygulamayı yalnızca özel bir kapsayıcı görüntüsünden dağıtabilirsiniz. Daha fazla bilgi için bkz . Özel kapsayıcı görüntüsüyle uygulama dağıtma.

Aşağıdaki komut bir uygulama oluşturur:

az spring build-service build create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <build-name> \
    --builder <builder-name> \
    --artifact-path <path-to-your-JAR-file>

Aşağıdaki komut mevcut bir derlemeyi güncelleştirir:

az spring build-service build update \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <build-name> \
    --builder <builder-name> \
    --artifact-path <path-to-your-JAR-file>

Aşağıdaki komut bir uygulama dağıtır.

az spring app deploy \
   --resource-group <resource-group-name> \
   --service <Azure-Spring-Apps-instance-name> \
   --name <app-name> \
   --container-image <your-container-image> \
   --container-registry <your-container-registry> \
   --registry-password <your-password> \
   --registry-username <your-username>

Uygulamayı bir yapıt dosyasıyla dağıtırsanız, dosya yolunu belirtmek için kullanın --artifact-path . Hem JAR hem de WAR dosyaları kabul edilebilir.

Azure CLI WAR paketini ince bir JAR olarak algılarsa doğrulamayı devre dışı bırakmak için kullanın --disable-validation .

Aşağıdaki örnek, klasörü belirtmek için parametresini --source-path kullanarak kaynak kod klasörünü etkin bir dağıtıma dağıtır.

Azure Spring Apps yönetilen kapsayıcı kayıt defteri

az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --builder <builder-name> \
    --source-path <path-to-source-code>

Kullanıcı tarafından yönetilen kapsayıcı kayıt defteri

Aşağıdaki komut bir uygulama oluşturur:

az spring build-service build create \
   --resource-group <resource-group-name> \
   --service <Azure-Spring-Apps-instance-name> \
    --name <build-name> \
    --builder <builder-name> \
    --source-path <path-to-source-code>

Aşağıdaki komut mevcut bir derlemeyi güncelleştirir:

az spring build-service build update \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <build-name> \
    --builder <builder-name> \
    --source-path <path-to-source-code>

Uygulamayı dağıtmak için bkz . Özel kapsayıcı görüntüsüyle uygulama dağıtma.

Uygulamayı derlemek için derleme ortamını da yapılandırabilirsiniz. Örneğin, bir Java uygulamasında derleme ortamını kullanarak BP_JVM_VERSION JDK sürümünü belirtebilirsiniz.

Derleme ortamlarını belirtmek için, aşağıdaki örnekte gösterildiği gibi kullanın --build-env. Kullanılabilir derleme ortamı değişkenleri bu makalenin devamında açıklanmıştır.

Azure Spring Apps yönetilen kapsayıcı kayıt defteri

Aşağıdaki komut bir uygulama dağıtır:

az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --build-env <key1=value1> <key2=value2> \
    --builder <builder-name> \
    --artifact-path <path-to-your-JAR-file>

Kullanıcı tarafından yönetilen kapsayıcı kayıt defteri

Aşağıdaki komut bir uygulama oluşturur:

az spring build-service build create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <build-name> \
    --build-env <key1=value1> <key2=value2> \
    --builder <builder-name> \
    --artifact-path <path-to-your-JAR-file>

Aşağıdaki komut mevcut bir derlemeyi güncelleştirir:

az spring build-service build update \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <build-name> \
    --build-env <key1=value1> <key2=value2> \
    --builder <builder-name> \
    --artifact-path <path-to-your-JAR-file>

Uygulamayı dağıtmak için bkz . Özel kapsayıcı görüntüsüyle uygulama dağıtma.

Her derleme için, aşağıdaki örnekte gösterildiği gibi derleme kaynaklarını da belirtebilirsiniz.

Azure Spring Apps yönetilen kapsayıcı kayıt defteri

Aşağıdaki komut bir uygulama dağıtır:

az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --build-env <key1=value1> <key2=value2> \
    --build-cpu <build-cpu-size> \
    --build-memory <build-memory-size> \
    --builder <builder-name> \
    --artifact-path <path-to-your-JAR-file>

Kullanıcı tarafından yönetilen kapsayıcı kayıt defteri

Aşağıdaki komut bir uygulama oluşturur:

az spring build-service build create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <build-name> \
    --build-env <key1=value1> <key2=value2> \
    --build-cpu <build-cpu-size> \
    --build-memory <build-memory-size> \
    --builder <builder-name> \
    --artifact-path <path-to-your-JAR-file>

Aşağıdaki komut mevcut bir derlemeyi güncelleştirir:

az spring build-service build update \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <build-name> \
    --build-env <key1=value1> <key2=value2> \
    --build-cpu <build-cpu-size> \
    --build-memory <build-memory-size> \
    --builder <builder-name> \
    --artifact-path <path-to-your-JAR-file>

Uygulamayı dağıtmak için bkz . Özel kapsayıcı görüntüsüyle uygulama dağıtma.

Varsayılan derleme CPU/bellek kaynağıdır 1 vCPU, 2 Gi. Uygulamanızın daha küçük veya daha büyük miktarda belleğe ihtiyacı varsa, bellek kaynaklarını (örneğin, , , vb.) 500Mibelirtmek için kullanın--build-memory. 2Gi1Gi Uygulamanızın daha küçük veya daha büyük miktarda CPU kaynağına ihtiyacı varsa, cpu kaynaklarını (örneğin, , , vb.) 500mbelirtmek için kullanın--build-cpu. 21 Derleme için en yüksek CPU/bellek kaynak sınırıdır 8 vCPU, 16Gi.

CPU ve bellek kaynakları, derleme hizmeti aracısı havuz boyutuyla sınırlıdır. Daha fazla bilgi için Tanzu Derleme Hizmetini Kullanma'nın Derleme aracısı havuzu bölümüne bakın. İşleme derlemesi kaynak kotasının toplamı aracı havuzu boyutunu aşamaz.

Paralel derleme görevleri sayısı, aracı havuzu boyutuna ve her derleme kaynağına bağlıdır. Örneğin, derleme kaynağı varsayılan 1 vCPU, 2 Gi ve aracı havuzu boyutu ise 6 vCPU, 12 Giparalel derleme numarası 6'dır.

Kaynak kotası sınırlamaları nedeniyle diğer derleme görevleri bir süre engellenir.

Uygulamanızın 8080 numaralı bağlantı noktasını dinlemesi gerekir. Spring Boot uygulamaları 8080'i otomatik olarak kullanmak için öğesini SERVER_PORT geçersiz kılar.

Dağıtımlar için desteklenen diller

Aşağıdaki tabloda her dil için desteklenen özellikler gösterilir.

Özellik	Java	Python	Düğüm	.NET Core	Go	Statik Dosyalar	Java Yerel Görüntüsü	PHP
Uygulama yaşam döngüsü yönetimi	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️
Uç nokta atama	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️
Azure İzleyici	✔️	✔️	✔️	✔️	✔️	✔️		✔️
Kullanıma kullanıma ait APM tümleştirmesi	✔️
Mavi/yeşil dağıtım	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️
Özel etki alanı	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️
Ölçeklendirme - otomatik ölçeklendirme	✔️	✔️	✔️	✔️	✔️	✔️		✔️
Ölçeklendirme - el ile ölçeklendirme (içeri/dışarı, yukarı/aşağı)	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️
Yönetilen kimlik	✔️	✔️	✔️	✔️	✔️	✔️	️	✔️
VMware Tanzu için API portalı	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️
VMware Tanzu için Spring Cloud Gateway	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️
VMware Tanzu için Uygulama Yapılandırma Hizmeti	✔️						✔️
VMware Tanzu Service Registry	✔️						✔️
VMware Tanzu için App Live View	✔️						✔️
Sanal ağ	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️
Giden IP Adresi	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️
E2E TLS	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️
Gelişmiş sorun giderme - iş parçacığı/yığın/JFR dökümü	✔️
Kendi depolama alanınızı getirme	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️
Hizmet bağlamayı Kaynak Bağlan veya ile tümleştirme	✔️						✔️
Kullanılabilirlik Alanı	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️
Uygulama Yaşam Döngüsü olayları	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️
Azaltılmış uygulama boyutu - 0,5 vCPU ve 512 MB	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️
Terraform ve Azure Pipeline Görevi ile uygulama dağıtımlarını otomatikleştirme	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️
Geçici Silme	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️
Etkileşimli tanılama deneyimi (AppLens tabanlı)	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️
SLA	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️
Sistem durumu yoklamalarını özelleştirme	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️
Sorun giderme için web kabuğu bağlantısı	✔️	✔️	✔️	✔️	✔️	✔️	️ ✔️	✔️
Uzaktan hata ayıklama	✔️				️	️	️

Farklı dil uygulamaları için desteklenen yapılandırmalar hakkında daha fazla bilgi için bu makalenin devamında ilgili bölüme bakın.

Java Yerel Görüntü sınırlamaları

Yerel Görüntü , Java kodunu önceden yerel yürütülebilir dosyaya derlemeye yardımcı olan bir teknolojidir. Yerel görüntüler, anında başlatma ve azaltılmış bellek tüketimi gibi çeşitli avantajlar sağlar. Daha hızlı ve daha verimli dağıtım için yerel görüntüleri basit bir kapsayıcı görüntüsüne paketleyebilirsiniz. Kapalı Dünya İyileştirmesi nedeniyle aşağıdaki sınırlamalar geçerlidir:

• Aşağıdaki Java özellikleri yürütülebilir derleme zamanında yapılandırma gerektirir:
  • Dinamik Sınıf Yükleme
  • Yansıma
  • Dinamik Ara Sunucu
  • JNI (Java Yerel Arabirimi)
  • Serileştirme
• Bayt kodu artık çalışma zamanında kullanılamadığından, JVMTI'yi hedefleyen araçlarla hata ayıklama ve izleme mümkün değildir.

Aşağıdaki özellikler, Java Yerel Görüntüsü sınırlaması nedeniyle Azure Spring Apps'te desteklenmez. Java Yerel Görüntüsü ve topluluk sınırlamayı aştığında Azure Spring Apps bunları destekleyecektir.

Özellik	Neden desteklenmiyor?
Azure İzleyici	GraalVM tarafından oluşturulan yerel görüntüler JVM ölçümlerini desteklemez.
Ölçeklendirme – otomatik ölçeklendirme	GraalVM tarafından oluşturulan yerel görüntüler JVM ölçümlerini desteklemez.
Kullanıma kullanıma ait APM tümleştirmesi	APM Vendor &Buildpack yerel görüntüyü desteklemez.
Yönetilen kimlik	Azure SDK'ları yerel görüntüyü desteklemez.
Gelişmiş sorun giderme – iş parçacığı/yığın/JFR dökümü	GraalVM tarafından oluşturulan yerel görüntüler iş parçacığı/yığın/JFR dökümünü desteklemez.
Uzaktan hata ayıklama	GraalVM Yerel Görüntüsü Uzaktan Hata Ayıklamayı desteklemez.
Service Bağlan or kullanarak parolasız bağlantı	Azure Java SDK'sı yerel görüntüyü desteklemez.

Not

Aşağıdaki farklı dil derleme ve dağıtma yapılandırma bölümlerinde, --build-env ortamın derleme aşamasında kullanıldığı anlamına gelir. --env ortamın çalışma zamanı aşamasında kullanıldığı anlamına gelir.

Varsayılan sürümün değişmesi durumunda dil sürümünü belirtmenizi öneririz. Örneğin JDK sürümü olarak Java 11'i belirtmek için kullanın --build-env BP_JVM_VERSION=11.* . Diğer diller için ortam değişkeninin adını her dil için aşağıdaki açıklamalarda bulabilirsiniz.

Java uygulamalarını dağıtma

Java uygulamalarını dağıtmak için derleme paketi tanzu-buildpacks/java-azure'dır.

Aşağıdaki tabloda Azure Spring Apps'te desteklenen özellikler listelenmektedir:

Özellik açıklaması	Yorum	Ortam değişkeni	Kullanım
Microsoft OpenJDK'yi sağlar.	JVM sürümünü yapılandırıyor. Varsayılan JDK sürümü 17'dir. Şu anda desteklenmektedir: JDK 8, 11, 17 ve 21.	BP_JVM_VERSION	--build-env BP_JVM_VERSION=11.*
	Çalışma zamanı env. Java Yerel Bellek İzleme'nin (NMT) etkinleştirilip etkinleştirilmediğini yapılandırılır. Varsayılan değer true değeridir. JDK 8'de desteklenmez.	BPL_JAVA_NMT_ENABLED	--env BPL_JAVA_NMT_ENABLED=true
	Java Yerel Bellek İzleme (NMT) çıkışı için ayrıntı düzeyini yapılandırır. Varsayılan değer özettir. Ayrıntılı NMT çıkışı için ayrıntıya ayarlayın.	BPL_JAVA_NMT_LEVEL	--env BPL_JAVA_NMT_ENABLED=summary
Derleme ve çalışma zamanında sistem güven deposuna CA sertifikaları ekleyin.	APM tümleştirmesi ve CA sertifikalarını yapılandırma bölümünün Uygulama derlemeleri ve dağıtımları için CA sertifikalarını yapılandırma bölümüne bakın.	Yok	Yok
Application Analizler, Dynatrace, Elastic, New Relic, App Dynamic APM aracısı ile tümleştirin.	Bkz. APM tümleştirmesi ve CA sertifikalarını yapılandırma.	Yok	Yok
WAR paketini Apache Tomcat veya TomEE ile dağıtın.	Kullanılacak uygulama sunucusunu ayarlayın. Tomcat'i kullanmak için tomcat ve TomEE'yi kullanmak için tomee olarak ayarlayın. Varsayılan değer tomcat'tir.	BP_JAVA_APP_SERVER	--build-env BP_JAVA_APP_SERVER=tomee
Spring Boot uygulamalarını destekleyin.	Derleme zamanında görüntü için Spring Cloud Bindings desteğine katkıda bulunup bulunmayacağını gösterir. Varsayılan değer yanlış değeridir.	BP_SPRING_CLOUD_BINDINGS_DISABLED	--build-env BP_SPRING_CLOUD_BINDINGS_DISABLED=false
	Spring Boot ortam özelliklerinin çalışma zamanındaki bağlamalardan otomatik olarak yapılandırılıp yapılandırılmayacağını gösterir. Bu özellik, Spring Cloud Bindings'in derleme zamanında zaten yüklenmiş olmasını gerektirir veya hiçbir şey yapmaz. Varsayılan değer yanlış değeridir.	BPL_SPRING_CLOUD_BINDINGS_DISABLED	--env BPL_SPRING_CLOUD_BINDINGS_DISABLED=false
Kaynaktan Maven tabanlı uygulamalar oluşturma desteği.	Çok modüllü bir proje için kullanılır. içindeki uygulama yapıtını bulmak için modülü gösterir. Varsayılan olarak kök modülünü (boş) kullanır.	BP_MAVEN_BUILT_MODULE	--build-env BP_MAVEN_BUILT_MODULE=./gateway
Kaynaktan Gradle tabanlı uygulamalar oluşturma desteği.	Çok modüllü bir proje için kullanılır. içindeki uygulama yapıtını bulmak için modülü gösterir. Varsayılan olarak kök modülünü (boş) kullanır.	BP_GRADLE_BUILT_MODULE	--build-env BP_GRADLE_BUILT_MODULE=./gateway
Oluşturulan görüntüde etiketlerin yapılandırmasını etkinleştirin.	Tek bir ortam değişkeninde boşlukla ayrılmış söz dizimi kullanarak hem OCI tarafından belirtilen etiketleri kısa ortam değişkeni adlarıyla hem de rastgele etiketlerle yapılandırılır.	BP_IMAGE_LABELS BP_OCI_AUTHORS Daha fazla ortam değişkenine buradan bakın.	--build-env BP_OCI_AUTHORS=<value>
JProfiler aracısının tümleştirilmesi.	JProfiler desteğinin tümleştirilip tümleştirılmayacağını gösterir. Varsayılan değer yanlış değeridir.	BP_JPROFILER_ENABLED	derleme aşaması: --build-env BP_JPROFILER_ENABLED=true çalışma zamanı aşaması: --env BPL_JPROFILER_ENABLED=true BPL_JPROFILER_PORT=<port> (isteğe bağlı, varsayılan değer 8849'dır) BPL_JPROFILER_NOWAIT=true(isteğe bağlı). JProfiler eklenmeden önce JVM'nin yürütülip yürütülmeyeceğini gösterir. Varsayılan değer true'dur.)
	JProfiler desteğinin çalışma zamanında etkinleştirilip etkinleştirilmeyebileceğini gösterir. Varsayılan değer yanlış değeridir.	BPL_JPROFILER_ENABLED	--env BPL_JPROFILER_ENABLED=false
	JProfiler aracısının hangi bağlantı noktasını dinlediğini gösterir. Varsayılan değer 8849'dur.	BPL_JPROFILER_PORT	--env BPL_JPROFILER_PORT=8849
	JProfiler eklenmeden önce JVM'nin yürütülip yürütülmeyeceğini gösterir. Varsayılan değer true değeridir.	BPL_JPROFILER_NOWAIT	--env BPL_JPROFILER_NOWAIT=true
JRebel aracısının tümleştirilmesi.	Uygulama bir rebel-remote.xml dosyası içermelidir.	Yok	Yok
AES bir uygulamayı derleme zamanında şifreler ve ardından başlatma zamanında şifresini çözer.	Derleme zamanında kullanılacak AES anahtarı.	BP_EAR_KEY	--build-env BP_EAR_KEY=<value>
	Çalışma zamanında kullanılacak AES anahtarı.	BPL_EAR_KEY	--env BPL_EAR_KEY=<value>
AspectJ Weaver aracısının tümleştirilmesi.	<APPLICATION_ROOT>/ aop.xml ve aspectj-weaver.*.jar var.	Yok	Yok

.NET uygulamalarını dağıtma

.NET uygulamalarını dağıtmak için derleme paketi tanzu-buildpacks/dotnet-core şeklindedir.

Aşağıdaki tabloda Azure Spring Apps'te desteklenen özellikler listelenmektedir:

Özellik açıklaması	Yorum	Ortam değişkeni	Kullanım
.NET Core çalışma zamanı sürümünü yapılandırın.	Net6.0, Net7.0 ve Net8.0'ı destekler. runtimeconfig.json veya MSBuild Proje dosyası aracılığıyla yapılandırabilirsiniz. Varsayılan çalışma zamanı 6.0.*.	Yok	Yok
Derleme ve çalışma zamanında sistem güven deposuna CA sertifikaları ekleyin.	APM tümleştirmesi ve CA sertifikalarını yapılandırma bölümünün Uygulama derlemeleri ve dağıtımları için CA sertifikalarını yapılandırma bölümüne bakın.	Yok	Yok
Dynatrace ve New Relic APM aracılarıyla tümleştirin.	Bkz. APM tümleştirmesi ve CA sertifikalarını yapılandırma.	Yok	Yok
Oluşturulan görüntüde etiketlerin yapılandırmasını etkinleştirin.	Tek bir ortam değişkeninde boşlukla ayrılmış söz dizimi kullanarak hem OCI tarafından belirtilen etiketleri kısa ortam değişkeni adlarıyla hem de rastgele etiketlerle yapılandırılır.	BP_IMAGE_LABELS BP_OCI_AUTHORS Daha fazla ortam değişkenine buradan bakın.	--build-env BP_OCI_AUTHORS=<value>

Python uygulamalarını dağıtma

Python uygulamalarını dağıtmaya yönelik derleme paketi, tanzu-buildpacks/python'dır.

Aşağıdaki tabloda Azure Spring Apps'te desteklenen özellikler listelenmektedir:

Özellik açıklaması	Yorum	Ortam değişkeni	Kullanım
Bir Python sürümü belirtin.	3.8.*, 3.9.*, 3.10.*, 3.11.*, 3.12.* destekler. Varsayılan değer 3,10'dur .* Derleme sırasında ortam değişkeni aracılığıyla BP_CPYTHON_VERSION sürümü belirtebilirsiniz.	BP_CPYTHON_VERSION	--build-env BP_CPYTHON_VERSION=3.8.*
Derleme ve çalışma zamanında sistem güven deposuna CA sertifikaları ekleyin.	APM tümleştirmesi ve CA sertifikalarını yapılandırma bölümünün Uygulama derlemeleri ve dağıtımları için CA sertifikalarını yapılandırma bölümüne bakın.	Yok	Yok
Oluşturulan görüntüde etiketlerin yapılandırmasını etkinleştirin.	Tek bir ortam değişkeninde boşlukla ayrılmış söz dizimi kullanarak hem OCI tarafından belirtilen etiketleri kısa ortam değişkeni adlarıyla hem de rastgele etiketlerle yapılandırılır.	BP_IMAGE_LABELS BP_OCI_AUTHORS Daha fazla ortam değişkenine buradan bakın.	--build-env BP_OCI_AUTHORS=<value>

Go uygulamalarını dağıtma

Go uygulamalarını dağıtmak için derleme paketi tanzu-buildpacks/go şeklindedir.

Aşağıdaki tabloda Azure Spring Apps'te desteklenen özellikler listelenmektedir:

Özellik açıklaması	Yorum	Ortam değişkeni	Kullanım
Bir Go sürümü belirtin.	1.20.*, 1.21.* destekler. Varsayılan değer 1.20.*'dir. Go sürümü, uygulamanın go.mod dosyasından otomatik olarak algılanır. Derleme zamanında ortam değişkenini BP_GO_VERSION ayarlayarak bu sürümü geçersiz kılabilirsiniz.	BP_GO_VERSION	--build-env BP_GO_VERSION=1.20.*
Birden çok hedefi yapılandırın.	Go derlemesi için birden çok hedef belirtir.	BP_GO_TARGETS	--build-env BP_GO_TARGETS=./some-target:./other-target
Derleme ve çalışma zamanında sistem güven deposuna CA sertifikaları ekleyin.	APM tümleştirmesi ve CA sertifikalarını yapılandırma bölümünün Uygulama derlemeleri ve dağıtımları için CA sertifikalarını yapılandırma bölümüne bakın.	Yok	Yok
Dynatrace APM aracısı ile tümleştirme.	Bkz. APM tümleştirmesi ve CA sertifikalarını yapılandırma.	Yok	Yok
Oluşturulan görüntüde etiketlerin yapılandırmasını etkinleştirin.	Tek bir ortam değişkeninde boşlukla ayrılmış söz dizimi kullanarak hem OCI tarafından belirtilen etiketleri kısa ortam değişkeni adlarıyla hem de rastgele etiketlerle yapılandırılır.	BP_IMAGE_LABELS BP_OCI_AUTHORS Daha fazla ortam değişkenine buradan bakın.	--build-env BP_OCI_AUTHORS=<value>

Node.js uygulamaları dağıtma

Node.js uygulamaları dağıtmaya yönelik derleme paketi, tanzu-buildpacks/nodejs'dir.

Aşağıdaki tabloda Azure Spring Apps'te desteklenen özellikler listelenmektedir:

Özellik açıklaması	Yorum	Ortam değişkeni	Kullanım
Bir Node sürümü belirtin.	16.*, 18.*, 19.*, 20.* destekler. Varsayılan değer 20.*. Node sürümünü uygulama dizini kökünde bir .nvmrc veya .node-version dosyası aracılığıyla belirtebilirsiniz. BP_NODE_VERSION ayarları geçersiz kılar.	BP_NODE_VERSION	--build-env BP_NODE_VERSION=19.*
Derleme ve çalışma zamanında sistem güven deposuna CA sertifikaları ekleyin.	APM tümleştirmesi ve CA sertifikalarını yapılandırma bölümünün Uygulama derlemeleri ve dağıtımları için CA sertifikalarını yapılandırma bölümüne bakın.	Yok	Yok
Dynatrace, Elastic, New Relic, App Dynamic APM aracısı ile tümleştirme.	Bkz. APM tümleştirmesi ve CA sertifikalarını yapılandırma.	Yok	Yok
Oluşturulan görüntüde etiketlerin yapılandırmasını etkinleştirin.	Tek bir ortam değişkeninde boşlukla ayrılmış söz dizimi kullanarak hem OCI tarafından belirtilen etiketleri kısa ortam değişkeni adlarıyla hem de rastgele etiketlerle yapılandırılır.	BP_IMAGE_LABELS BP_OCI_AUTHORS Daha fazla ortam değişkenine buradan bakın.	--build-env BP_OCI_AUTHORS=<value>
Angular Live Development Server ile bir Angular uygulaması dağıtın.	package.json çalıştırmadan ng serveönce konağı belirtin: ng serve --host 0.0.0.0 --port 8080 --public-host <your application domain name>. Uygulamanın etki alanı adı, UYGULAMANıN Genel Bakış sayfasında, URL bölümünde bulunur. Devam etmeden önce protokolü https:// kaldırın.	BP_NODE_RUN_SCRIPTS NODE_ENV	--build-env BP_NODE_RUN_SCRIPTS=build NODE_ENV=development

WebServer uygulamalarını dağıtma

WebServer uygulamalarını dağıtmak için derleme paketi tanzu-buildpacks/web-servers'dır.

Daha fazla bilgi için bkz . Web statik dosyalarını dağıtma.

Java Yerel Görüntü uygulamalarını dağıtma (önizleme)

Java Yerel Görüntü uygulamalarını dağıtmak için derleme paketi tanzu-buildpacks/java-native-image şeklindedir.

Derleme paketini kullanarak tanzu-buildpacks/java-native-image Spring Boot yerel görüntü uygulamalarını dağıtabilirsiniz. Spring Native , Spring Boot uygulamalarını yerel yürütülebilir dosyalara derleme desteği sağlar. Derleme paketi, Spring Boot uygulamalarının yerel görüntülerini oluşturmak için Liberica Native Image Kit (NIK) kullanır ve bu uygulamalar tam olarak desteklenir.

Java Yerel Görüntüsü oluştururken, derleme ortamını BP_NATIVE_IMAGEtrue olarak ayarlamanız gerekir ve derleme bellek kaynağı 8Gi'den küçük olmamalıdır. Derleme hizmeti aracısı havuz boyutu değerinden 4 vCPU, 8 Giküçük olmamalıdır. Daha fazla bilgi için Tanzu Derleme Hizmetini Kullanma'nın Derleme aracısı havuzu bölümüne bakın.

Yerel görüntüyü daha küçük boyutlu bir kapsayıcı görüntüsüne oluşturmak istiyorsanız, işletim sistemi yığınına Jammy Tiny sahip bir oluşturucu kullanmanızı öneririz. Daha fazla bilgi için işletim sistemi yığını önerileri bölümüne bakın.

Aşağıdaki tabloda Azure Spring Apps'te desteklenen özellikler listelenmektedir:

Özellik açıklaması	Yorum	Ortam değişkeni	Kullanım
Bellsoft OpenJDK ile tümleştirme.	JDK sürümünü yapılandırır. Şu anda desteklenmektedir: JDK 8, 11, 17 ve 20.	BP_JVM_VERSION	--build-env BP_JVM_VERSION=17
Komutun native-image bağımsız değişkenlerini yapılandırın.	Doğrudan native-image komutuna geçirmek için bağımsız değişkenler. Bu bağımsız değişkenler geçerli ve doğru biçimlendirilmiş olmalıdır, aksi durumda native-image komutu başarısız olur.	BP_NATIVE_IMAGE_BUILD_ARGUMENTS	--build-env BP_NATIVE_IMAGE_BUILD_ARGUMENTS="--no-fallback"
Derleme ve çalışma zamanında sistem güven deposuna CA sertifikaları ekleyin.	Bkz. APM tümleştirmesi ve CA sertifikalarını yapılandırma.	Uygulanamaz.	Uygulanamaz.
Oluşturulan görüntüde etiketlerin yapılandırmasını etkinleştirme	Tek bir ortam değişkeninde boşlukla ayrılmış söz dizimi kullanarak hem OCI tarafından belirtilen etiketleri kısa ortam değişkeni adlarıyla hem de rastgele etiketlerle yapılandırılır.	BP_IMAGE_LABELS BP_OCI_AUTHORS Daha fazla ortam değişkenine buradan bakın.	--build-env BP_OCI_AUTHORS=<value>
Kaynaktan Maven tabanlı uygulamalar oluşturma desteği.	Çok modüllü bir proje için kullanılır. içindeki uygulama yapıtını bulmak için modülü gösterir. Varsayılan olarak kök modülünü (boş) kullanır.	BP_MAVEN_BUILT_MODULE	--build-env BP_MAVEN_BUILT_MODULE=./gateway

Java Yerel Görüntüsü için bazı sınırlamalar vardır. Daha fazla bilgi için Java Yerel Görüntü sınırlamaları bölümüne bakın.

PHP uygulamalarını dağıtma

PHP uygulamalarını dağıtmak için derleme paketi tanzu-buildpacks/php şeklindedir.

Tanzu PHP derleme paketi yalnızca Tam İşletim Sistemi Yığını ile uyumludur. bir oluşturucuyu işletim sistemi yığınıyla Jammy Full kullanmanızı öneririz. Daha fazla bilgi için işletim sistemi yığını önerileri bölümüne bakın.

Aşağıdaki tabloda Azure Spring Apps'te desteklenen özellikler listelenmektedir:

Özellik açıklaması	Yorum	Ortam değişkeni	Kullanım
PHP sürümünü belirtin.	PHP sürümünü yapılandırıyor. Şu anda desteklenmektedir: PHP 8.1.*, ve 8.2.*. Varsayılan değer 8,1'dir .*	BP_PHP_VERSION	--build-env BP_PHP_VERSION=8.0.*
Derleme ve çalışma zamanında sistem güven deposuna CA sertifikaları ekleyin.	APM tümleştirmesi ve CA sertifikalarını yapılandırma bölümünün Uygulama derlemeleri ve dağıtımları için CA sertifikalarını yapılandırma bölümüne bakın.	Yok	Yok
Dynatrace, New Relic, App Dynamic APM aracısı ile tümleştirme.	Bkz. APM tümleştirmesi ve CA sertifikalarını yapılandırma.	Yok	Yok
Bir Web Sunucusu seçin.	Ayar seçenekleri php-server, httpd ve nginx'tır. Varsayılan değer php-server'dır.	BP_PHP_SERVER	--build-env BP_PHP_SERVER=httpd
Web Dizini'nin yapılandırılması.	Web sunucusu HTTPD veya NGINX olduğunda, web dizini varsayılan olarak htdocs olarak ayarlanır. Web sunucusu PHP yerleşik sunucusu olduğunda, web dizini varsayılan olarak /workspace olarak ayarlanır.	BP_PHP_WEB_DIR	--build-env BP_PHP_WEB_DIR=htdocs

Sonraki adımlar

• Web statik dosyalarını dağıtma