Azure App Service için bir Java uygulaması yapılandırma

Geçerli Java sürümünü göstermek için Cloud Shellaşağıdaki komutu çalıştırın:

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

Desteklenen tüm Java sürümlerini göstermek için Cloud Shellaşağıdaki komutu çalıştırın:

az webapp list-runtimes | grep java

Geçerli Java sürümünü göstermek için Cloud Shellaşağıdaki komutu çalıştırın:

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

Desteklenen tüm Java sürümlerini göstermek için Cloud Shellaşağıdaki komutu çalıştırın:

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

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

mvn package azure-webapp:deploy

<plugin> 
  <groupId>com.microsoft.azure</groupId>  
  <artifactId>azure-webapp-maven-plugin</artifactId>  
  <version>2.2.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 11</javaVersion>
    </runtime>
    <deployment>
      <resources>
        <resource>
          <type>jar</type>
          <directory>${project.basedir}/target</directory>
          <includes>
            <include>*.jar</include>
          </includes>
        </resource>
      </resources>
    </deployment>
  </configuration>
</plugin> 

JBoss EAP

. War dosyalarını Jpato 'a dağıtmak için, /api/wardeploy/ Arşiv DOSYANıZı göndermek için uç noktasını kullanın. Bu API hakkında daha fazla bilgi için Bu belgeyebakın.

. Ear dosyalarını dağıtmak için FTP 'yi kullanın. . Ear uygulamanız, uygulamanızın yapılandırmasında tanımlanan bağlam köküne dağıtılır. Örneğin, uygulamanızın bağlam kökü ise <context-root>myapp</context-root> , şu yolda siteye gözatabilmeniz gerekir /myapp : http://my-app-name.azurewebsites.net/myapp . Web uygulamasının kök yolda sunulmasını istiyorsanız, uygulamanızın bağlam kökünü kök yola ayarlarsa emin olun: <context-root>/</context-root> . Daha fazla bilgi için bkz. bir Web uygulamasının bağlam kökünü ayarlama.

App Service’te uygulama kodunuzun içinden oluşturulan konsol günlüklerine erişmek için şu komutu Cloud Shell’de çalıştırarak tanılama günlüğüne kaydetmeyi açın:

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

--level için olası değerler: Error, Warning, Info ve Verbose. Her düzey kendisinden önceki düzeyi içerir. Örneğin: Error yalnızca hata iletilerini içerir, Verbose ise tüm iletileri içerir.

Tanılama günlüğüne kaydetme açıldıktan sonra günlük akışını görmek için şu komutu çalıştırın:

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

Konsol günlüklerini hemen görmüyorsanız, 30 saniye içinde yeniden kontrol edin.

Günlük akışını dilediğiniz zaman durdurmak için Ctrl+C yazın.

Kapsayıcının içinden oluşturulan konsol günlüklerine erişebilirsiniz.

İlk olarak, aşağıdaki komutu çalıştırarak kapsayıcı günlüğünü açın:

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

<app-name>Ve ' i <resource-group-name> Web uygulamanız için uygun adlarla değiştirin.

Kapsayıcı günlüğü açıldıktan sonra, günlük akışını görmek için şu komutu çalıştırın:

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

Konsol günlüklerini hemen görmüyorsanız, 30 saniye içinde yeniden kontrol edin.

Günlük akışını istediğiniz zaman durdurmak için CTRL + C yazın.

Günlük dosyalarını konumundaki bir tarayıcıda da inceleyebilirsiniz https://<app-name>.scm.azurewebsites.net/api/logs/docker .

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.

Sorun giderme araçları

Yerleşik Java görüntüleri, alp Linux işletim sistemini temel alır. apkHerhangi bir sorun giderme aracını veya komutunu yüklemek için paket yöneticisini kullanın.

Zamanlanmış kayıt

Zamanlanmış bir kayıt almak için Java uygulamasının PID (Işlem KIMLIĞI) gereklidir. PID 'yi bulmak için, Web uygulamanızın SCM sitesinde bir tarayıcıyı açın https://<your-site-name>.scm.azurewebsites.net/ProcessExplorer/ . Bu sayfada Web uygulamanızdaki çalışan süreçler gösterilmektedir. Tabloda "Java" adlı işlemi bulun ve karşılık gelen PID 'yi (Işlem KIMLIĞI) kopyalayın.

Ardından, SCM sitesinin üst araç çubuğunda hata ayıklama konsolunu açın ve aşağıdaki komutu çalıştırın. <pid>Daha önce kopyaladığınız Işlem kimliğiyle değiştirin. Bu komut, Java uygulamanızın 30 saniyelik profil oluşturucu kaydını başlatır ve dizininde adlı bir dosya oluşturur timed_recording_example.jfr D:\home .

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

App Service SSH 'yi çalıştırın ve jcmd çalıştıran tüm Java işlemlerinin bir listesini görmek için komutunu çalıştırın. Jcmd 'nin yanı sıra, bir işlem KIMLIK numarası (PID) ile çalışan Java uygulamanızı görmeniz gerekir.

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

JVM 'nin 30 saniyelik bir kaydını başlatmak için aşağıdaki komutu yürütün. Bu, JVM profilini oluşturacak ve giriş dizininde jfr_example. jfr adlı bir jfr dosyası oluşturacaktır. (116 değerini Java uygulamanızın pid 'si ile değiştirin.)

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

30 saniyelik Aralık sırasında, çalışırken kaydın gerçekleşdiğini doğrulayabilirsiniz jcmd 116 JFR.check . Bu, verilen Java işleminin tüm kayıtlarını gösterir.

Sürekli kayıt

Çalışma zamanı performansı üzerinde en az etkiyle Java uygulamanızı sürekli olarak profil oluştururken, Zulu uçuş kaydedicisini kullanabilirsiniz. Bunu yapmak için, gerekli yapılandırmayla JAVA_OPTS adlı bir uygulama ayarı oluşturmak için aşağıdaki Azure CLı komutunu çalıştırın. Uygulamanız başlatıldığında JAVA_OPTS uygulama ayarının içeriği java komutuna geçirilir.

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

Kayıt başladıktan sonra, komutunu kullanarak istediğiniz zaman geçerli kayıt verilerinin dökümünü alabilirsiniz JFR.dump .

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

uygulamanızın standart konsol çıkışını ve standart konsol hata akışlarını yerel dosya sistemine veya azure Blob Depolama yazmak üzere App Service yapılandırmak için Azure portal veya azure clı aracılığıyla uygulama günlüğünü etkinleştirin. Yerel App Service dosya sistemi örneğine günlük kaydı, yapılandırıldıktan sonra 12 saat devre dışı bırakılır. Daha uzun süre bekletmeye ihtiyacınız varsa, uygulamayı bir BLOB depolama kapsayıcısına çıktı yazacak şekilde yapılandırın. Java ve Tomcat uygulama günlüklerinizi /Home/LogFiles/Application/ dizininde bulabilirsiniz.

uygulamanızın standart konsol çıkışını ve standart konsol hata akışlarını yerel dosya sistemine veya azure Blob Depolama yazmak üzere App Service yapılandırmak için Azure portal veya azure clı aracılığıyla uygulama günlüğünü etkinleştirin. Daha uzun süre bekletmeye ihtiyacınız varsa, uygulamayı bir BLOB depolama kapsayıcısına çıktı yazacak şekilde yapılandırın. Java ve Tomcat uygulama günlüklerinizi /Home/LogFiles/Application/ dizininde bulabilirsiniz.

Linux tabanlı uygulama hizmetleri için azure Blob Depolama günlüğü, yalnızca azure izleyici kullanılarak yapılandırılabilir

<appSettings>
    <property>
        <name>JAVA_OPTS</name>
        <value>-Xms512m -Xmx1204m</value>
    </property>
</appSettings>

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

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

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

Map<String, Collection<String>> map = (Map<String, Collection<String>>) request.getUserPrincipal();

for (Object key : map.keySet()) {
        Object value = map.get(key);
        if (value != null && value instanceof Collection {
            Collection claims = (Collection) value;
            for (Object claim : claims) {
                System.out.println(claims);
            }
        }
    }

public boolean isSecure()
public String getRemoteAddr()
public String getRemoteHost()
public String getScheme()
public int getServerPort()

Java anahtar deposunu kullanma

Varsayılan olarak, App Service Linux 'a yüklenen tüm ortak veya özel sertifikalar, kapsayıcı başladığında Ilgili Java anahtar depolarına yüklenir. Sertifikanızı karşıya yükledikten sonra, Java anahtar deposuna yüklenmek üzere App Service yeniden başlatmanız gerekir. Ortak sertifikalar, konumundaki anahtar deposuna yüklenir $JAVA_HOME/jre/lib/security/cacerts ve özel sertifikalar içinde depolanır $JAVA_HOME/lib/security/client.jks .

Daha fazla yapılandırma, JDBC bağlantınızı Java anahtar deposundaki sertifikalarla şifrelemek için gerekli olabilir. Seçtiğiniz JDBC sürücünüz için belgelere bakın.

• PostgreSQL
• SQL Server
• MySQL
• MongoDB
• Cassandra

Java anahtar deposunu başlatma

Nesneyi başlatmak için import java.security.KeyStore , anahtar deposu dosyasını parolasıyla yükleyin. Her iki anahtar deposu için de varsayılan parola changeit .

KeyStore keyStore = KeyStore.getInstance("jks");
keyStore.load(
    new FileInputStream(System.getenv("JAVA_HOME")+"/lib/security/cacets"),
    "changeit".toCharArray());

KeyStore keyStore = KeyStore.getInstance("pkcs12");
keyStore.load(
    new FileInputStream(System.getenv("JAVA_HOME")+"/lib/security/client.jks"),
    "changeit".toCharArray());

Anahtar deposunu el ile yükleme

Sertifikaları anahtar deposuna el ile yükleyebilirsiniz. SKIP_JAVA_KEYSTORE_LOAD 1 Sertifikaları anahtar deposuna otomatik olarak yüklemek App Service devre dışı bırakmak için değeri olan bir uygulama ayarı oluşturun. Azure portal üzerinden App Service yüklenen tüm genel sertifikalar altında depolanır /var/ssl/certs/ . Özel sertifikalar altında depolanır /var/ssl/private/ .

App Service BIR SSH bağlantısı açıp komutu çalıştırarak Java anahtar aracında etkileşim kurabilir veya hata ayıklayabilirsiniz keytool . Komutların listesi için bkz. anahtar araç belgeleri . KeyStore API 'SI hakkında daha fazla bilgi için resmi belgelerebakın.

3. İzleme anahtarı, bağlantı dizesi ve izleme Aracısı sürümünü Web uygulamasında uygulama ayarları olarak ayarlayın. <instrumentationKey>Ve <connectionString> değerlerini önceki adımdaki değerlerle değiştirin.

   az webapp config appsettings set -n <webapp-name> -g <resource-group> --settings "APPINSIGHTS_INSTRUMENTATIONKEY=<instrumentationKey>" "APPLICATIONINSIGHTS_CONNECTION_STRING=<connectionString>" "ApplicationInsightsAgent_EXTENSION_VERSION=~3" "XDT_MicrosoftApplicationInsights_Mode=default" "XDT_MicrosoftApplicationInsights_Java=1"
   

3. İzleme anahtarı, bağlantı dizesi ve izleme Aracısı sürümünü Web uygulamasında uygulama ayarları olarak ayarlayın. <instrumentationKey>Ve <connectionString> değerlerini önceki adımdaki değerlerle değiştirin.

   az webapp config appsettings set -n <webapp-name> -g <resource-group> --settings "APPINSIGHTS_INSTRUMENTATIONKEY=<instrumentationKey>" "APPLICATIONINSIGHTS_CONNECTION_STRING=<connectionString>" "ApplicationInsightsAgent_EXTENSION_VERSION=~3" "XDT_MicrosoftApplicationInsights_Mode=default"
   

1. NewRelic.com adresinde bir Newrelik hesabı oluşturun

2. Newrelik 'ten Java aracısını indirin, newrelic-java-x.x.x.zip benzer bir dosya adı olacaktır.

3. Lisans anahtarınızı kopyalayın, aracıyı daha sonra yapılandırmak için gerekir.

4. App Service örneğine SSH ekleyin ve /Home/site/Wwwroot/APM adlı yeni bir dizin oluşturun.

5. paketi açılan newrelik Java aracı dosyalarını /home/site/wwwroot/apm altındaki bir dizine Upload. Aracınızın dosyaları /Home/site/Wwwroot/APM/newrelik konumunda olmalıdır.

6. /Home/site/Wwwroot/APM/newrelic/newrelic.exe konumundaki YAML dosyasını değiştirin ve yer tutucu lisans değerini kendi lisans anahtarınızla değiştirin.

7. Azure portal, App Service uygulamanıza gidin ve yeni bir uygulama ayarı oluşturun.

   • Java SE uygulamaları için, değeriyle adlı bir ortam değişkeni oluşturun JAVA_OPTS -javaagent:/home/site/wwwroot/apm/newrelic/newrelic.jar .
   • Tomcat için, değeriyle adlı bir ortam değişkeni oluşturun CATALINA_OPTS -javaagent:/home/site/wwwroot/apm/newrelic/newrelic.jar .

1. NewRelic.com adresinde bir Newrelik hesabı oluşturun

2. Newrelik 'ten Java aracısını indirin, newrelic-java-x.x.x.zip benzer bir dosya adı olacaktır.

3. Lisans anahtarınızı kopyalayın, aracıyı daha sonra yapılandırmak için gerekir.

4. App Service örneğine SSH ekleyin ve /Home/site/Wwwroot/APM adlı yeni bir dizin oluşturun.

5. paketi açılan newrelik Java aracı dosyalarını /home/site/wwwroot/apm altındaki bir dizine Upload. Aracınızın dosyaları /Home/site/Wwwroot/APM/newrelik konumunda olmalıdır.

6. /Home/site/Wwwroot/APM/newrelic/newrelic.exe konumundaki YAML dosyasını değiştirin ve yer tutucu lisans değerini kendi lisans anahtarınızla değiştirin.

7. Azure portal, App Service uygulamanıza gidin ve yeni bir uygulama ayarı oluşturun.

   • Java SE uygulamaları için, değeriyle adlı bir ortam değişkeni oluşturun JAVA_OPTS -javaagent:/home/site/wwwroot/apm/newrelic/newrelic.jar .
   • Tomcat için, değeriyle adlı bir ortam değişkeni oluşturun CATALINA_OPTS -javaagent:/home/site/wwwroot/apm/newrelic/newrelic.jar .

1. AppDynamics.com adresinde bir AppDynamics hesabı oluşturun

2. AppDynamics Web sitesinden Java aracısını indirin, dosya adı AppServerAgent-x.x.x.xxxxx.zip benzerdir.

3. Kudu konsolunu kullanarak /Home/site/Wwwroot/APM adlı yeni bir dizin oluşturun.

4. Java aracı dosyalarını /home/site/wwwroot/apm altındaki bir dizine Upload. Aracınızın dosyaları /Home/site/Wwwroot/APM/AppDynamics konumunda olmalıdır.

5. Azure portal, App Service uygulamanıza gidin ve yeni bir uygulama ayarı oluşturun.

   • Java SE uygulamaları için, JAVA_OPTS -javaagent:/home/site/wwwroot/apm/appdynamics/javaagent.jar -Dappdynamics.agent.applicationName=<app-name> App Service adınız olan değer ile adlı bir ortam değişkeni oluşturun <app-name> .
   • Tomcat uygulamaları için, CATALINA_OPTS App Service adınız olan değer ile adlı bir ortam değişkeni oluşturun -javaagent:/home/site/wwwroot/apm/appdynamics/javaagent.jar -Dappdynamics.agent.applicationName=<app-name> <app-name> .

1. AppDynamics.com adresinde bir AppDynamics hesabı oluşturun

2. AppDynamics Web sitesinden Java aracısını indirin, dosya adı AppServerAgent-x.x.x.xxxxx.zip benzerdir.

3. App Service örneğine SSH ekleyin ve /Home/site/Wwwroot/APM adlı yeni bir dizin oluşturun.

4. Java aracı dosyalarını /home/site/wwwroot/apm altındaki bir dizine Upload. Aracınızın dosyaları /Home/site/Wwwroot/APM/AppDynamics konumunda olmalıdır.

5. Azure portal, App Service uygulamanıza gidin ve yeni bir uygulama ayarı oluşturun.

   • Java SE uygulamaları için, JAVA_OPTS -javaagent:/home/site/wwwroot/apm/appdynamics/javaagent.jar -Dappdynamics.agent.applicationName=<app-name> App Service adınız olan değer ile adlı bir ortam değişkeni oluşturun <app-name> .
   • Tomcat uygulamaları için, CATALINA_OPTS App Service adınız olan değer ile adlı bir ortam değişkeni oluşturun -javaagent:/home/site/wwwroot/apm/appdynamics/javaagent.jar -Dappdynamics.agent.applicationName=<app-name> <app-name> .

Tomcat

Bu yönergeler tüm veritabanı bağlantıları için geçerlidir. Yer tutucuları, seçtiğiniz veritabanının sürücü sınıfı adı ve JAR dosyası ile doldurmanız gerekir. , Ortak veritabanları için sınıf adları ve sürücü indirmeleri içeren bir tablodur.

Veritabanı	Sürücü sınıfı adı	JDBC sürücüsü
PostgreSQL	org.postgresql.Driver	İndir
MySQL	com.mysql.jdbc.Driver	İndir ("platformdan bağımsız" seçeneğini belirleyin)
SQL Server	com.microsoft.sqlserver.jdbc.SQLServerDriver	İndir

Tomcat 'i Java veritabanı bağlantısı (JDBC) veya Java Kalıcılık API 'SI (JPA) kullanacak şekilde yapılandırmak için, önce başlangıçta CATALINA_OPTS Tomcat tarafından okunan ortam değişkenini özelleştirin. Bu değerleri App Service Maven eklentisindekibir uygulama ayarı aracılığıyla ayarlayın:

<appSettings>
    <property>
        <name>CATALINA_OPTS</name>
        <value>"$CATALINA_OPTS -Ddbuser=${DBUSER} -Ddbpassword=${DBPASSWORD} -DconnURL=${CONNURL}"</value>
    </property>
</appSettings>

veya Azure portal içindeki yapılandırma > uygulaması Ayarlar sayfasında ortam değişkenlerini ayarlayın.

Daha sonra, veri kaynağının bir uygulama için mi yoksa Tomcat servlet üzerinde çalışan tüm uygulamalar için mi kullanılabilir olacağını saptayın.

Uygulama düzeyi veri kaynakları

1. Projenizin meta INF/ dizininde bir context.xml dosyası oluşturun. Yoksa meta INF/ dizin oluşturun.

2. context.xml, Context veri kaynağını bir JNDI adresine bağlamak için bir öğe ekleyin. driverClassNameYer tutucusunu, yukarıdaki tablodaki sürücünüzün sınıf adıyla değiştirin.

   <Context>
       <Resource
           name="jdbc/dbconnection"
           type="javax.sql.DataSource"
           url="${dbuser}"
           driverClassName="<insert your driver class name>"
           username="${dbpassword}"
           password="${connURL}"
       />
   </Context>
   

3. Uygulamanızdaki veri kaynağını kullanmak için uygulamanızın web.xml güncelleştirin.

   <resource-env-ref>
       <resource-env-ref-name>jdbc/dbconnection</resource-env-ref-name>
       <resource-env-ref-type>javax.sql.DataSource</resource-env-ref-type>
   </resource-env-ref>
   

Paylaşılan sunucu düzeyi kaynakları

Windows üzerindeki App Service tomcat yüklemeleri App Service planındaki paylaşılan alanda bulunur. Sunucu genelinde yapılandırma için Tomcat yüklemesini doğrudan değiştiremezsiniz. Tomcat yüklemenizde sunucu düzeyinde yapılandırma değişiklikleri yapmak için, Tomcat 'i yerel bir klasöre kopyalamanız gerekir. Bu, Tomcat 'in yapılandırmasını değiştirebilirsiniz.

Uygulama başlatma sırasında özel Tomcat oluşturmayı otomatikleştirin

Bir Web uygulaması başlamadan önce eylemleri gerçekleştirmek için bir başlangıç betiği kullanabilirsiniz. Tomcat 'i özelleştirmeye yönelik başlatma komut dosyasının aşağıdaki adımları tamamlaması gerekir:

1. Tomcat 'in zaten kopyalanıp kopyalanmadığını ve yerel olarak yapılandırılıp yapılandırılmadığını denetleyin. Varsa, başlangıç betiği buradan sona bitebilirler.
2. Tomcat 'i yerel olarak kopyalayın.
3. Gerekli yapılandırma değişikliklerini yapın.
4. Yapılandırmanın başarıyla tamamlandığını belirtin.

Windows siteler için, dizininde veya adında bir dosya oluşturun startup.cmd startup.ps1 wwwroot . Bu işlem, Tomcat sunucusu başlamadan önce otomatik olarak yürütülür.

Aşağıdaki adımları tamamlayan bir PowerShell betiği aşağıda verilmiştir:

    # Check for marker file indicating that config has already been done
    if(Test-Path "$Env:LOCAL_EXPANDED\tomcat\config_done_marker"){
        return 0
    }

    # Delete previous Tomcat directory if it exists
    # In case previous config could not be completed or a new config should be forcefully installed
    if(Test-Path "$Env:LOCAL_EXPANDED\tomcat"){
        Remove-Item "$Env:LOCAL_EXPANDED\tomcat" --recurse
    }

    # Copy Tomcat to local
    # Using the environment variable $AZURE_TOMCAT90_HOME uses the 'default' version of Tomcat
    Copy-Item -Path "$Env:AZURE_TOMCAT90_HOME\*" -Destination "$Env:LOCAL_EXPANDED\tomcat" -Recurse

    # Perform the required customization of Tomcat
    {... customization ...}

    # Mark that the operation was a success
    New-Item -Path "$Env:LOCAL_EXPANDED\tomcat\config_done_marker" -ItemType File

Dönüştürmeler

Tomcat sürümünü özelleştirmenin yaygın kullanım durumu server.xml ,, context.xml ya da web.xml Tomcat yapılandırma dosyalarını değiştirmektir. App Service, platform özellikleri sağlamak için bu dosyaları zaten değiştiriyor. Bu özellikleri kullanmaya devam etmek için, bunlarda değişiklikler yaptığınızda bu dosyaların içeriğinin korunması önemlidir. Bunu gerçekleştirmek için bir XSL dönüşümü (XSLT)kullanmanızı öneririz. Dosyanın özgün içeriğini korurken XML dosyalarında değişiklik yapmak için bir XSL dönüşümü kullanın.

Örnek XSLT dosyası

Bu örnek Transform öğesine yeni bir bağlayıcı düğümü ekler server.xml . Dosyanın özgün içeriğini koruyan kimlik dönüşümünü aklınızda edin.

    <xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
    <xsl:output method="xml" indent="yes"/>

    <!-- Identity transform: this ensures that the original contents of the file are included in the new file -->
    <!-- Ensure that your transform files include this block -->
    <xsl:template match="@* | node()" name="Copy">
      <xsl:copy>
        <xsl:apply-templates select="@* | node()"/>
      </xsl:copy>
    </xsl:template>

    <xsl:template match="@* | node()" mode="insertConnector">
      <xsl:call-template name="Copy" />
    </xsl:template>

    <xsl:template match="comment()[not(../Connector[@scheme = 'https']) and
                                   contains(., '&lt;Connector') and
                                   (contains(., 'scheme=&quot;https&quot;') or
                                    contains(., &quot;scheme='https'&quot;))]">
      <xsl:value-of select="." disable-output-escaping="yes" />
    </xsl:template>

    <xsl:template match="Service[not(Connector[@scheme = 'https'] or
                                     comment()[contains(., '&lt;Connector') and
                                               (contains(., 'scheme=&quot;https&quot;') or
                                                contains(., &quot;scheme='https'&quot;))]
                                    )]
                        ">
      <xsl:copy>
        <xsl:apply-templates select="@* | node()" mode="insertConnector" />
      </xsl:copy>
    </xsl:template>

    <!-- Add the new connector after the last existing Connnector if there is one -->
    <xsl:template match="Connector[last()]" mode="insertConnector">
      <xsl:call-template name="Copy" />

      <xsl:call-template name="AddConnector" />
    </xsl:template>

    <!-- ... or before the first Engine if there is no existing Connector -->
    <xsl:template match="Engine[1][not(preceding-sibling::Connector)]"
                  mode="insertConnector">
      <xsl:call-template name="AddConnector" />

      <xsl:call-template name="Copy" />
    </xsl:template>

    <xsl:template name="AddConnector">
      <!-- Add new line -->
      <xsl:text>&#xa;</xsl:text>
      <!-- This is the new connector -->
      <Connector port="8443" protocol="HTTP/1.1" SSLEnabled="true" 
                 maxThreads="150" scheme="https" secure="true" 
                 keystroreFile="${{user.home}}/.keystore" keystorePass="changeit"
                 clientAuth="false" sslProtocol="TLS" />
    </xsl:template>

    </xsl:stylesheet>

XSL dönüşümü işlevi

PowerShell, XML dosyalarını XSL dönüştürmeleri kullanarak dönüştürmek için yerleşik araçlara sahiptir. Aşağıdaki betik, dönüşümü gerçekleştirmek için ' de kullanabileceğiniz örnek bir işlevdir startup.ps1 :

    function TransformXML{
        param ($xml, $xsl, $output)

        if (-not $xml -or -not $xsl -or -not $output)
        {
            return 0
        }

        Try
        {
            $xslt_settings = New-Object System.Xml.Xsl.XsltSettings;
            $XmlUrlResolver = New-Object System.Xml.XmlUrlResolver;
            $xslt_settings.EnableScript = 1;

            $xslt = New-Object System.Xml.Xsl.XslCompiledTransform;
            $xslt.Load($xsl,$xslt_settings,$XmlUrlResolver);
            $xslt.Transform($xml, $output);

        }

        Catch
        {
            $ErrorMessage = $_.Exception.Message
            $FailedItem = $_.Exception.ItemName
            Write-Host  'Error'$ErrorMessage':'$FailedItem':' $_.Exception;
            return 0
        }
        return 1
    }

Uygulama ayarları

Platformun, Tomcat 'in özel sürümünün yüklü olduğu yeri de bilmeleri gerekir. Uygulamanın ayarında yükleme konumunu ayarlayabilirsiniz CATALINA_BASE .

Bu ayarı değiştirmek için Azure CLı 'yi kullanabilirsiniz:

    az webapp config appsettings set -g $MyResourceGroup -n $MyUniqueApp --settings CATALINA_BASE="%LOCAL_EXPANDED%\tomcat"

Ya da Azure portal ayarı el ile değiştirebilirsiniz:

1. Ayarlar > yapılandırma > uygulaması ayarları' na gidin.
2. Yeni Uygulama Ayarı'nı seçin.
3. Ayarı oluşturmak için bu değerleri kullanın:
   1. Ad: CATALINA_BASE
   2. Değer: "%LOCAL_EXPANDED%\tomcat"

Örnek startup.ps1

Aşağıdaki örnek betik özel bir Tomcat 'i yerel bir klasöre kopyalar, bir XSL dönüşümü gerçekleştirir ve dönüştürmenin başarılı olduğunu gösterir:

    # Locations of xml and xsl files
    $target_xml="$Env:LOCAL_EXPANDED\tomcat\conf\server.xml"
    $target_xsl="$Env:HOME\site\server.xsl"

    # Define the transform function
    # Useful if transforming multiple files
    function TransformXML{
        param ($xml, $xsl, $output)

        if (-not $xml -or -not $xsl -or -not $output)
        {
            return 0
        }

        Try
        {
            $xslt_settings = New-Object System.Xml.Xsl.XsltSettings;
            $XmlUrlResolver = New-Object System.Xml.XmlUrlResolver;
            $xslt_settings.EnableScript = 1;

            $xslt = New-Object System.Xml.Xsl.XslCompiledTransform;
            $xslt.Load($xsl,$xslt_settings,$XmlUrlResolver);
            $xslt.Transform($xml, $output);
        }

        Catch
        {
            $ErrorMessage = $_.Exception.Message
            $FailedItem = $_.Exception.ItemName
            echo  'Error'$ErrorMessage':'$FailedItem':' $_.Exception;
            return 0
        }
        return 1
    }

    $success = TransformXML -xml $target_xml -xsl $target_xsl -output $target_xml

    # Check for marker file indicating that config has already been done
    if(Test-Path "$Env:LOCAL_EXPANDED\tomcat\config_done_marker"){
        return 0
    }

    # Delete previous Tomcat directory if it exists
    # In case previous config could not be completed or a new config should be forcefully installed
    if(Test-Path "$Env:LOCAL_EXPANDED\tomcat"){
        Remove-Item "$Env:LOCAL_EXPANDED\tomcat" --recurse
    }

    md -Path "$Env:LOCAL_EXPANDED\tomcat"

    # Copy Tomcat to local
    # Using the environment variable $AZURE_TOMCAT90_HOME uses the 'default' version of Tomcat
    Copy-Item -Path "$Env:AZURE_TOMCAT90_HOME\*" "$Env:LOCAL_EXPANDED\tomcat" -Recurse

    # Perform the required customization of Tomcat
    $success = TransformXML -xml $target_xml -xsl $target_xsl -output $target_xml

    # Mark that the operation was a success if successful
    if($success){
        New-Item -Path "$Env:LOCAL_EXPANDED\tomcat\config_done_marker" -ItemType File
    }

Yapılandırmayı Sonlandır

Son olarak, sürücü JARs ' ı Tomcat Sınıfyoluna yerleştireceğiz ve App Service yeniden başlatacağız. JDBC sürücü dosyalarının, /Home/Tomcat/lib dizinine yerleştirerek Tomcat ClassLoader için kullanılabilir olduğundan emin olun. (Henüz yoksa, bu dizini oluşturun.) Bu dosyaları App Service örneğine yüklemek için aşağıdaki adımları uygulayın:

1. Cloud Shell, WebApp uzantısını yüklerken:

   az extension add -–name webapp
   

2. App Service için yerel sisteminizden bir SSH tüneli oluşturmak için aşağıdaki CLı komutunu çalıştırın:

   az webapp remote-connection create --resource-group <resource-group-name> --name <app-name> --port <port-on-local-machine>
   

3. sftp istemcinizdeki yerel tünel oluşturma bağlantı noktasına Bağlan ve dosyaları /home/tomcat/lib klasörüne yükleyin.

Alternatif olarak, bir FTP istemcisini kullanarak JDBC sürücüsünü karşıya yükleyebilirsiniz. FTP kimlik bilgilerinizi almak için bu yönergeleriizleyin.

---

Tomcat

Bu yönergeler tüm veritabanı bağlantıları için geçerlidir. Yer tutucuları, seçtiğiniz veritabanının sürücü sınıfı adı ve JAR dosyası ile doldurmanız gerekir. , Ortak veritabanları için sınıf adları ve sürücü indirmeleri içeren bir tablodur.

Veritabanı	Sürücü sınıfı adı	JDBC sürücüsü
PostgreSQL	org.postgresql.Driver	İndir
MySQL	com.mysql.jdbc.Driver	İndir ("platformdan bağımsız" seçeneğini belirleyin)
SQL Server	com.microsoft.sqlserver.jdbc.SQLServerDriver	İndir

Tomcat 'i Java veritabanı bağlantısı (JDBC) veya Java Kalıcılık API 'SI (JPA) kullanacak şekilde yapılandırmak için, önce başlangıçta CATALINA_OPTS Tomcat tarafından okunan ortam değişkenini özelleştirin. Bu değerleri App Service Maven eklentisindekibir uygulama ayarı aracılığıyla ayarlayın:

<appSettings>
    <property>
        <name>CATALINA_OPTS</name>
        <value>"$CATALINA_OPTS -Ddbuser=${DBUSER} -Ddbpassword=${DBPASSWORD} -DconnURL=${CONNURL}"</value>
    </property>
</appSettings>

veya Azure portal içindeki yapılandırma > uygulaması Ayarlar sayfasında ortam değişkenlerini ayarlayın.

Daha sonra, veri kaynağının bir uygulama için mi yoksa Tomcat servlet üzerinde çalışan tüm uygulamalar için mi kullanılabilir olacağını saptayın.

Uygulama düzeyi veri kaynakları

1. Projenizin meta INF/ dizininde bir context.xml dosyası oluşturun. Yoksa meta INF/ dizin oluşturun.

2. context.xml, Context veri kaynağını bir JNDI adresine bağlamak için bir öğe ekleyin. driverClassNameYer tutucusunu, yukarıdaki tablodaki sürücünüzün sınıf adıyla değiştirin.

   <Context>
       <Resource
           name="jdbc/dbconnection"
           type="javax.sql.DataSource"
           url="${dbuser}"
           driverClassName="<insert your driver class name>"
           username="${dbpassword}"
           password="${connURL}"
       />
   </Context>
   

3. Uygulamanızdaki veri kaynağını kullanmak için uygulamanızın web.xml güncelleştirin.

   <resource-env-ref>
       <resource-env-ref-name>jdbc/dbconnection</resource-env-ref-name>
       <resource-env-ref-type>javax.sql.DataSource</resource-env-ref-type>
   </resource-env-ref>
   

Paylaşılan sunucu düzeyi kaynakları

Paylaşılan, sunucu düzeyinde bir veri kaynağı eklemek, Tomcat 'in server.xml düzenlemenizi gerektirir. İlk olarak, bir Başlangıç betiğini karşıya yükleyin ve yolu yapılandırma > Başlangıç komutunda betiğin yolunu ayarlayın. FTPkullanarak başlangıç betiğini karşıya yükleyebilirsiniz.

Başlangıç betiğinizin server.xml dosyasına bir XSL dönüştürmesi yapıp elde edilen XML dosyasının çıktısını almak için kullanılır /usr/local/tomcat/conf/server.xml . Başlangıç betiği APK aracılığıyla libxslt 'yi yüklemelidir. XSL dosyanız ve başlangıç betiğimiz FTP aracılığıyla karşıya yüklenebilir. Aşağıda örnek bir başlangıç betiği verilmiştir.

# Install libxslt. Also copy the transform file to /home/tomcat/conf/
apk add --update libxslt

# Usage: xsltproc --output output.xml style.xsl input.xml
xsltproc --output /home/tomcat/conf/server.xml /home/tomcat/conf/transform.xsl /usr/local/tomcat/conf/server.xml

Örnek bir xsl dosyası aşağıda verilmiştir. Örnek xsl dosyası, Tomcat server.xml yeni bir bağlayıcı düğümü ekler.

<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
  <xsl:output method="xml" indent="yes"/>

  <xsl:template match="@* | node()" name="Copy">
    <xsl:copy>
      <xsl:apply-templates select="@* | node()"/>
    </xsl:copy>
  </xsl:template>

  <xsl:template match="@* | node()" mode="insertConnector">
    <xsl:call-template name="Copy" />
  </xsl:template>

  <xsl:template match="comment()[not(../Connector[@scheme = 'https']) and
                                 contains(., '&lt;Connector') and
                                 (contains(., 'scheme=&quot;https&quot;') or
                                  contains(., &quot;scheme='https'&quot;))]">
    <xsl:value-of select="." disable-output-escaping="yes" />
  </xsl:template>

  <xsl:template match="Service[not(Connector[@scheme = 'https'] or
                                   comment()[contains(., '&lt;Connector') and
                                             (contains(., 'scheme=&quot;https&quot;') or
                                              contains(., &quot;scheme='https'&quot;))]
                                  )]
                      ">
    <xsl:copy>
      <xsl:apply-templates select="@* | node()" mode="insertConnector" />
    </xsl:copy>
  </xsl:template>

  <!-- Add the new connector after the last existing Connnector if there is one -->
  <xsl:template match="Connector[last()]" mode="insertConnector">
    <xsl:call-template name="Copy" />

    <xsl:call-template name="AddConnector" />
  </xsl:template>

  <!-- ... or before the first Engine if there is no existing Connector -->
  <xsl:template match="Engine[1][not(preceding-sibling::Connector)]"
                mode="insertConnector">
    <xsl:call-template name="AddConnector" />

    <xsl:call-template name="Copy" />
  </xsl:template>

  <xsl:template name="AddConnector">
    <!-- Add new line -->
    <xsl:text>&#xa;</xsl:text>
    <!-- This is the new connector -->
    <Connector port="8443" protocol="HTTP/1.1" SSLEnabled="true" 
               maxThreads="150" scheme="https" secure="true" 
               keystroreFile="${{user.home}}/.keystore" keystorePass="changeit"
               clientAuth="false" sslProtocol="TLS" />
  </xsl:template>

</xsl:stylesheet>

Yapılandırmayı Sonlandır

Son olarak, sürücü JARs ' ı Tomcat Sınıfyoluna yerleştirip App Service yeniden başlatın.

1. JDBC sürücü dosyalarının, /Home/Tomcat/lib dizinine yerleştirerek Tomcat ClassLoader için kullanılabilir olduğundan emin olun. (Henüz yoksa, bu dizini oluşturun.) Bu dosyaları App Service örneğine yüklemek için aşağıdaki adımları uygulayın:

   1. Cloud Shell, WebApp uzantısını yüklerken:

   az extension add -–name webapp
   

   2. App Service için yerel sisteminizden bir SSH tüneli oluşturmak için aşağıdaki CLı komutunu çalıştırın:

   az webapp remote-connection create --resource-group <resource-group-name> --name <app-name> --port <port-on-local-machine>
   

   3. sftp istemcinizdeki yerel tünel oluşturma bağlantı noktasına Bağlan ve dosyaları /home/tomcat/lib klasörüne yükleyin.

   Alternatif olarak, bir FTP istemcisini kullanarak JDBC sürücüsünü karşıya yükleyebilirsiniz. FTP kimlik bilgilerinizi almak için bu yönergeleriizleyin.

2. Sunucu düzeyinde bir veri kaynağı oluşturduysanız App Service Linux uygulamasını yeniden başlatın. Tomcat CATALINA_BASE /home/tomcat , güncelleştirilmiş yapılandırmayı sıfırlayacak ve kullanacak şekilde başlatılır.

JBoss EAP

Bir veri kaynağını Jpatron EAP ile kaydederkenüç temel adım vardır: JDBC sürücüsünü karşıya yükleme, JDBC sürücüsünü bir modül olarak ekleme ve modülü kaydetme. App Service, durum bilgisi olmayan bir barındırma hizmetidir, bu nedenle veri kaynağı modülünü eklemek ve kaydettirmek için yapılandırma komutlarının, kapsayıcı başladığı sürece betikleştirilmiş ve uygulanmış olması gerekir.

1. Veritabanınızın JDBC sürücüsünü edinin.

2. JDBC sürücüsü için bir XML Modülü tanım dosyası oluşturun. Aşağıda gösterilen örnek, PostgreSQL için bir modül tanımıdır.

   <?xml version="1.0" ?>
   <module xmlns="urn:jboss:module:1.1" name="org.postgres">
       <resources>
       <!-- ***** IMPORTANT : REPLACE THIS PLACEHOLDER *******-->
       <resource-root path="/home/site/deployments/tools/postgresql-42.2.12.jar" />
       </resources>
       <dependencies>
           <module name="javax.api"/>
           <module name="javax.transaction.api"/>
       </dependencies>
   </module>
   

3. Jpatron CLı komutlarınızı adlı bir dosyaya yerleştirin jboss-cli-commands.cli . Jpatron komutlarının modülü eklemesi ve bunu bir veri kaynağı olarak kaydetmesi gerekir. Aşağıdaki örnekte PostgreSQL için Jpatron CLı komutları gösterilmektedir.

   #!/usr/bin/env bash
   module add --name=org.postgres --resources=/home/site/deployments/tools/postgresql-42.2.12.jar --module-xml=/home/site/deployments/tools/postgres-module.xml
   
   /subsystem=datasources/jdbc-driver=postgres:add(driver-name="postgres",driver-module-name="org.postgres",driver-class-name=org.postgresql.Driver,driver-xa-datasource-class-name=org.postgresql.xa.PGXADataSource)
   
   data-source add --name=postgresDS --driver-name=postgres --jndi-name=java:jboss/datasources/postgresDS --connection-url=${POSTGRES_CONNECTION_URL,env.POSTGRES_CONNECTION_URL:jdbc:postgresql://db:5432/postgres} --user-name=${POSTGRES_SERVER_ADMIN_FULL_NAME,env.POSTGRES_SERVER_ADMIN_FULL_NAME:postgres} --password=${POSTGRES_SERVER_ADMIN_PASSWORD,env.POSTGRES_SERVER_ADMIN_PASSWORD:example} --use-ccm=true --max-pool-size=5 --blocking-timeout-wait-millis=5000 --enabled=true --driver-class=org.postgresql.Driver --exception-sorter-class-name=org.jboss.jca.adapters.jdbc.extensions.postgres.PostgreSQLExceptionSorter --jta=true --use-java-context=true --valid-connection-checker-class-name=org.jboss.jca.adapters.jdbc.extensions.postgres.PostgreSQLValidConnectionChecker
   

4. startup_script.shJpatron CLI komutlarını çağıran bir başlangıç betiği oluşturun. Aşağıdaki örnekte, nasıl çağrılacağını gösterilmektedir jboss-cli-commands.cli . Daha sonra, kapsayıcı başladığında bu betiği çalıştırmak için App Service yapılandırırsınız.

   $JBOSS_HOME/bin/jboss-cli.sh --connect --file=/home/site/deployments/tools/jboss-cli-commands.cli
   

5. Tercihiniz olan bir FTP istemcisini kullanarak JDBC sürücü, jboss-cli-commands.cli , startup_script.sh ve modül tanımınızı adresine /site/deployments/tools/ yükleyin.

6. Kapsayıcı başlatıldığında sitenizi startup_script.sh çalıştıracak şekilde yapılandırma. Komut Azure portal Configuration General 'a > gidin Ayarlar > Komutu'na gidin. Başlangıç komut alanını olarak /home/site/deployments/tools/startup_script.sh ayarlayın. Değişikliklerinizi kaydedin.

Veri kaynaklarının JBoss sunucusuna ekli olduğunu onaylamak için web uygulamanıza SSH ile girin ve $JBOSS_HOME/bin/jboss-cli.sh --connect çalıştırın. JBoss'a bağlandıktan sonra, veri /subsystem=datasources:read-resource kaynaklarının listesini yazdırmak için çalıştırın.

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

JBoss EAP App Service Planları

JBoss EAP yalnızca plan Premium v3 ve Yalıtılmış v2 App Service kullanılabilir. Genel önizleme sırasında farklı bir katmanda JBoss EAP sitesi oluşturan müşterilerin beklenmeyen davranışlardan kaçınmak için Premium veya Yalıtılmış donanım katmanına kadar ölçeğin ölçeğini esndırması gerekir.