Azure Uygulaması Hizmetinde Tomcat, JBoss veya Java SE uygulaması dağıtma ve yapılandırma

Bu makalede, App Service'teki Java uygulamaları için en yaygın dağıtım ve çalışma zamanı yapılandırması gösterilmektedir. Azure Uygulaması Hizmeti'ni hiç kullanmadıysanız önce Java hızlı başlangıcını okumanız gerekir. Java geliştirmeye özgü olmayan App Service'i kullanma hakkındaki genel sorular App Service SSS bölümünde yanıtlandırılır.

Azure Uygulaması Hizmeti, tam olarak yönetilen bir hizmette Java web uygulamalarını üç farklı şekilde çalıştırır:

• Java SE - Eklenmiş bir sunucu (Spring Boot, Dropwizard, Quarkus gibi) veya katıştırılmış Tomcat veya Jetty sunucusu içeren bir JAR paketi olarak dağıtılan bir uygulamayı çalıştırabilir.
• Tomcat - Yerleşik Tomcat sunucusu WAR paketi olarak dağıtılan bir uygulamayı çalıştırabilir.
• JBoss EAP - Yalnızca Premium v3 ve Yalıtılmış v2 fiyatlandırma katmanlarında Linux uygulamaları için desteklenir. Yerleşik JBoss EAP sunucusu WAR veya EAR paketi olarak dağıtılan bir uygulamayı çalıştırabilir.

Java sürümünü göster

az webapp config show --resource-group <resource-group-name> --name <app-name> --query linuxFxVersion

az webapp list-runtimes --os linux | grep "JAVA\|TOMCAT\|JBOSSEAP"

az webapp config show --name <app-name> --resource-group <resource-group-name> --query "[javaVersion, javaContainer, javaContainerVersion]"

az webapp list-runtimes --os windows | grep java

Sürüm desteği hakkında daha fazla bilgi için bkz . App Service dil çalışma zamanı destek ilkesi.

Uygulamanızı dağıtma

Build Tools

Maven

Azure Web Apps için Maven Eklentisi ile Maven Java projenizi proje kökünde tek bir komutla Azure Web App için kolayca hazırlayabilirsiniz:

mvn com.microsoft.azure:azure-webapp-maven-plugin:2.13.0:config

Bu komut, mevcut bir azure-webapp-maven-plugin Azure Web App'i seçmenizi veya yeni bir uygulama oluşturmanızı isteyip istemediğinizi sorarak bir eklenti ve ilgili yapılandırma ekler. Yapılandırma sırasında uygulamanızın Java SE, Tomcat veya (yalnızca Linux) JBoss EAP'ye dağıtılıp dağıtılmayacağını algılamaya çalışır. Ardından aşağıdaki komutu kullanarak Java uygulamanızı Azure'a dağıtabilirsiniz:

mvn package azure-webapp:deploy

aşağıda içinde örnek bir yapılandırma verilmişti pom.xml:

<plugin> 
  <groupId>com.microsoft.azure</groupId>  
  <artifactId>azure-webapp-maven-plugin</artifactId>  
  <version>2.11.0</version>  
  <configuration>
    <subscriptionId>111111-11111-11111-1111111</subscriptionId>
    <resourceGroup>spring-boot-xxxxxxxxxx-rg</resourceGroup>
    <appName>spring-boot-xxxxxxxxxx</appName>
    <pricingTier>B2</pricingTier>
    <region>westus</region>
    <runtime>
      <os>Linux</os>      
      <webContainer>Java SE</webContainer>
      <javaVersion>Java 17</javaVersion>
    </runtime>
    <deployment>
      <resources>
        <resource>
          <type>jar</type>
          <directory>${project.basedir}/target</directory>
          <includes>
            <include>*.jar</include>
          </includes>
        </resource>
      </resources>
    </deployment>
  </configuration>
</plugin> 

Gradle

1. eklentisini öğesine build.gradleekleyerek Azure Web Apps için Gradle Eklentisini ayarlayın:

   plugins {
     id "com.microsoft.azure.azurewebapp" version "1.10.0"
   }
   

2. Web uygulamanızın ayrıntılarını yapılandırın. İlgili Azure kaynakları yoksa oluşturulur. Aşağıda örnek bir yapılandırma verilmiştir. Ayrıntılar için bu belgeye bakın.

   azurewebapp {
       subscription = '<your subscription id>'
       resourceGroup = '<your resource group>'
       appName = '<your app name>'
       pricingTier = '<price tier like 'P1v2'>'
       region = '<region like 'westus'>'
       runtime {
         os = 'Linux'
         webContainer = 'Tomcat 10.0' // or 'Java SE' if you want to run an executable jar
         javaVersion = 'Java 17'
       }
       appSettings {
           <key> = <value>
       }
       auth {
           type = 'azure_cli' // support azure_cli, oauth2, device_code and service_principal
       }
   }
   

3. Tek bir komutla dağıtın.

   gradle azureWebAppDeploy
   

IDE

Azure, popüler Java IDE'lerinde aşağıdakiler dahil olmak üzere sorunsuz Java App Service geliştirme deneyimi sağlar:

• VS Code: Visual Studio Code ile Java Web Apps
• IntelliJ IDEA:IntelliJ kullanarak Azure Uygulaması Hizmeti için Merhaba Dünya bir web uygulaması oluşturma
• Eclipse:Eclipse kullanarak Azure Uygulaması Hizmeti için Merhaba Dünya web uygulaması oluşturma

Kudu API'si

FTP kullanarak .war veya .jar dağıtmayın. FTP aracı başlangıç betiklerini, bağımlılıkları veya diğer çalışma zamanı dosyalarını karşıya yüklemek için tasarlanmıştır. Web uygulamalarını dağıtmak için en uygun seçenek bu değildir.

URL'yi yeniden yazma veya yeniden yönlendirme

URL'yi yeniden yazmak veya yeniden yönlendirmek için UrlRewriteFilter gibi kullanılabilir URL yeniden yazmalarından birini kullanın.

Uygulamaları günlüğe kaydetme ve hata ayıklama

Azure portalı üzerinden her uygulama için performans raporları, trafik görselleştirmeleri ve sistem durumu denetimleri kullanılabilir. Daha fazla bilgi için bkz. Azure Uygulaması Hizmet tanılamalarına genel bakış.

Tanılama günlüklerini akışla aktarma

az webapp log config --name <app-name> --resource-group <resource-group-name> --docker-container-logging filesystem

az webapp log tail --name <app-name> --resource-group <resource-group-name>

az webapp log config --resource-group <resource-group-name> --name <app-name> --docker-container-logging filesystem --level Verbose

az webapp log tail --resource-group <resource-group-name> --name <app-name>

Daha fazla bilgi için bkz . Cloud Shell'de akış günlükleri.

Linux'ta SSH konsol erişimi

Kapsayıcınızda doğrudan SSH oturumu başlatabilmek için uygulamanızın çalışıyor olması gerekir.

Aşağıdaki URL'yi tarayıcınıza yapıştırın ve <app-name> yerine kendi uygulamanızın adını yazın:

https://<app-name>.scm.azurewebsites.net/webssh/host

Kimlik doğrulamasından geçmediyseniz bağlantıyı kurabilmek için Azure aboneliğinizle kimliğinizi doğrulamanız gerekir. Kimliğiniz doğrulandıktan sonra kapsayıcınızda komut çalıştırmak için kullanabileceğiniz tarayıcı içi kabuk ortamını görürsünüz.

Yerel makinenizden uzak SSH oturumu açmak için bkz. Uzak kabuktan SSH oturumu açma.

Linux sorun giderme araçları

Yerleşik Java görüntüleri Alpine Linux işletim sistemini temel alır. apk Sorun giderme araçlarını veya komutlarını yüklemek için paket yöneticisini kullanın.

Java Profil Oluşturucu

Azure Uygulaması Hizmetindeki tüm Java çalışma zamanları, Java iş yüklerinin profilini oluşturmak için JDK Flight Recorder ile birlikte gelir. Bunu kullanarak JVM, sistem ve uygulama olaylarını kaydedebilir ve uygulamalarınızdaki sorunları giderebilirsiniz.

Java Profiler hakkında daha fazla bilgi edinmek için Azure Uygulaması lication Insights belgelerini ziyaret edin.

Uçuş Kaydedicisi

App Service'te tüm Java çalışma zamanları Java Flight Recorder ile birlikte gelir. Bunu kullanarak JVM, sistem ve uygulama olaylarını kaydedebilir ve Java uygulamalarınızdaki sorunları giderebilirsiniz.

078990bbcd11:/home# jcmd
Picked up JAVA_TOOL_OPTIONS: -Djava.net.preferIPv4Stack=true
147 sun.tools.jcmd.JCmd
116 /home/site/wwwroot/app.jar

jcmd 116 JFR.start name=MyRecording settings=profile duration=30s filename="/home/jfr_example.jfr"

az webapp config appsettings set -g <your_resource_group> -n <your_app_name> --settings JAVA_OPTS=-XX:StartFlightRecording=disk=true,name=continuous_recording,dumponexit=true,maxsize=1024m,maxage=1d

jcmd <pid> JFR.dump name=continuous_recording filename="/home/recording1.jfr"

jcmd <pid> JFR.start name=TimedRecording settings=profile duration=30s filename="C:\home\timed_recording_example.JFR"

Dosyaları analiz etme .jfr

JFR dosyanızı yerel makinenize indirmek için FTPS kullanın. JFR dosyasını analiz etmek için Java Mission Control'ü indirip yükleyin. Java Mission Control yönergeleri için JMC belgelerine ve yükleme yönergelerine bakın.

Uygulama günlüğü

Uygulamanız izleme için Logback veya Log4j kullanıyorsa, Application Insights'ta Java izleme günlüklerini keşfetme başlığındaki günlüğe kaydetme çerçevesi yapılandırma yönergelerini kullanarak bu izlemeleri gözden geçirme için Azure Uygulaması lication Insights'a iletebilirsiniz.

Özelleştirme ve ayarlama

Azure Uygulaması Hizmeti, Azure portalı ve CLI aracılığıyla kullanıma hazır ayarlamayı ve özelleştirmeyi destekler. Java'ya özgü olmayan web uygulaması yapılandırması için aşağıdaki makaleleri gözden geçirin:

• Uygulama ayarlarını yapılandırma
• Özel etki alanı ayarlama
• TLS/SSL bağlamalarını yapılandırma
• CDN ekleme
• Kudu sitesini yapılandırma

Uygulama İçeriğini Yerel Olarak Kopyalama

Uygulama içeriğinizi paylaşılan dosya sisteminden yerel çalışana kopyalamak için uygulama ayarını JAVA_COPY_ALL true olarak ayarlayın. Bu ayar, dosya kilitleme sorunlarını gidermeye yardımcı olur.

Java çalışma zamanı seçeneklerini ayarlama

Ayrılmış bellek veya diğer JVM çalışma zamanı seçeneklerini ayarlamak için, seçenekleriyle adlı JAVA_OPTS bir uygulama ayarı oluşturun. App Service bu ayarı java çalışma zamanı başlatıldığında ortam değişkeni olarak geçirir.

Maven eklentisinden uygulama ayarını yapılandırmak için Azure eklentisi bölümüne ayar/değer etiketleri ekleyin. Aşağıdaki örnek belirli bir en düşük ve en yüksek Java yığın boyutunu ayarlar:

<appSettings>
    <property>
        <name>JAVA_OPTS</name>
        <value>-Xms1024m -Xmx1024m</value>
    </property>
</appSettings>

App Service planlarında tek bir dağıtım yuvasına sahip tek bir uygulama çalıştıran geliştiriciler aşağıdaki seçenekleri kullanabilir:

• B1 ve S1 örnekleri: -Xms1024m -Xmx1024m
• B2 ve S2 örnekleri: -Xms3072m -Xmx3072m
• B3 ve S3 örnekleri: -Xms6144m -Xmx6144m
• P1v2 örnekleri: -Xms3072m -Xmx3072m
• P2v2 örnekleri: -Xms6144m -Xmx6144m
• P3v2 örnekleri: -Xms12800m -Xmx12800m
• P1v3 örnekleri: -Xms6656m -Xmx6656m
• P2v3 örnekleri: -Xms14848m -Xmx14848m
• P3v3 örnekleri: -Xms30720m -Xmx30720m
• I1 örnekleri: -Xms3072m -Xmx3072m
• I2 örnekleri: -Xms6144m -Xmx6144m
• I3 örnekleri: -Xms12800m -Xmx12800m
• I1v2 örnekleri: -Xms6656m -Xmx6656m
• I2v2 örnekleri: -Xms14848m -Xmx14848m
• I3v2 örnekleri: -Xms30720m -Xmx30720m

Uygulama yığını ayarlarını ayarlarken App Service planı ayrıntılarınızı gözden geçirin ve bellekte en uygun ayırmayı bulmak için birden çok uygulama ve dağıtım yuvası gerektiğini göz önünde bulundurun.

Web yuvalarını açma

Azure portalında web yuvaları desteğini uygulamanın Uygulama ayarları bölümünden açın. Ayarın geçerli olması için uygulamayı yeniden başlatmanız gerekir.

Aşağıdaki komutla Azure CLI kullanarak web yuvası desteğini açın:

az webapp config set --name <app-name> --resource-group <resource-group-name> --web-sockets-enabled true

Ardından uygulamanızı yeniden başlatın:

az webapp stop --name <app-name> --resource-group <resource-group-name>
az webapp start --name <app-name> --resource-group <resource-group-name>

Varsayılan karakter kodlamayı ayarlama

Azure portalında, web uygulaması için Uygulama Ayarları'nın altında değeriyle -Dfile.encoding=UTF-8adlı JAVA_OPTS yeni bir uygulama ayarı oluşturun.

Alternatif olarak, App Service Maven eklentisini kullanarak uygulama ayarını yapılandırabilirsiniz. Eklenti yapılandırmasına ayar adını ve değer etiketlerini ekleyin:

<appSettings>
    <property>
        <name>JAVA_OPTS</name>
        <value>-Dfile.encoding=UTF-8</value>
    </property>
</appSettings>

Günlüklerde robots933456

Kapsayıcı günlüklerinde şu iletiyi görebilirsiniz:

2019-04-08T14:07:56.641002476Z "-" - - [08/Apr/2019:14:07:56 +0000] "GET /robots933456.txt HTTP/1.1" 404 415 "-" "-"

Bu iletiyi güvenle yoksayabilirsiniz. /robots933456.txt, App Service hizmetinin kapsayıcının istek sunmak için uygun olup olmadığını denetlemek için kullandığı işlevsiz bir URL'dir. 404 yanıtı, yolun var olmadığını belirtir ancak App Service bu sayede iyi ve isteklere yanıt vermeye uygun durumda olan kapsayıcıları belirler.

Java çalışma zamanı sürümü seçme

App Service, kullanıcıların JVM'nin Java 8 veya Java 11 gibi ana sürümünü ve 1.8.0_232 veya 11.0.5 gibi düzeltme eki sürümünü seçmesine olanak tanır. Ayrıca, yeni ikincil sürümler kullanılabilir hale geldikçe düzeltme eki sürümünün otomatik olarak güncelleştirilmiş olmasını da seçebilirsiniz. Çoğu durumda üretim uygulamaları sabitlenmiş düzeltme eki JVM sürümlerini kullanmalıdır. Bu, düzeltme eki sürümü otomatik güncelleştirmesi sırasında öngörülemeyen kesintileri önler. Tüm Java web uygulamaları 64 bit JVM'ler kullanır ve yapılandırılamaz.

İkincil sürümü sabitlemeyi seçerseniz, uygulamadaki JVM ikincil sürümünü düzenli aralıklarla güncelleştirmeniz gerekir. Uygulamanızın daha yeni ikincil sürümde çalıştığından emin olmak için bir hazırlama yuvası oluşturun ve hazırlama yuvasında ikincil sürümü artırın. Uygulamanın yeni ikincil sürümde doğru şekilde çalıştığını onayladıktan sonra hazırlama ve üretim yuvalarını değiştirebilirsiniz.

<Connector port="${port.http}" address="127.0.0.1" maxHttpHeaderSize="16384" compression="on" URIEncoding="UTF-8" connectionTimeout="${site.connectionTimeout}" maxThreads="${catalina.maxThreads}" maxConnections="${catalina.maxConnections}" protocol="HTTP/1.1" redirectPort="8443"/>

az webapp config appsettings set --resource-group myResourceGroup --name myApp --settings WEBSITE_TOMCAT_CONNECTION_TIMEOUT=120000

az webapp config appsettings set --resource-group myResourceGroup --name myApp --settings WEBSITE_CATALINA_MAXTHREADS=100

az webapp config appsettings set --resource-group myResourceGroup --name myApp --settings WEBSITE_CATALINA_MAXCONNECTIONS=5000

<Host appBase="${site.appbase}" xmlBase="${site.xmlbase}" unpackWARs="${site.unpackwars}" workDir="${site.tempdir}" errorReportValveClass="com.microsoft.azure.appservice.AppServiceErrorReportValve" name="localhost" autoDeploy="true">

<Valve prefix="site_access_log.${catalina.instance.name}" pattern="%h %l %u %t &quot;%r&quot; %s %b %D %{x-arr-log-id}i" directory="${site.logdir}/http/RawLogs" maxDays="${site.logRetentionDays}" className="org.apache.catalina.valves.AccessLogValve" suffix=".txt"/>

Sonraki adımlar

Azure hızlı başlangıçları, öğreticileri ve Java başvuru belgelerini bulmak için Java geliştiricileri için Azure merkezini ziyaret edin.

• App Service Linux Hakkında SSS
• Ortam değişkenleri ve uygulama ayarları başvurusu