Azure Uygulaması Hizmetinde Tomcat, JBoss veya Java SE uygulaması için veri kaynaklarını yapılandırma

Bu makalede App Service'te Java SE, Tomcat veya JBoss uygulamasında veri kaynaklarının nasıl yapılandırılacakları gösterilmektedir.

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.

Not

Spring uygulamaları için Azure Spring Apps kullanmanızı öneririz. Ancak, Azure Uygulaması Hizmetini hedef olarak kullanmaya devam edebilirsiniz. Öneri için bkz . Java İş Yükü Hedef Kılavuzu .

Veri kaynağını yapılandırma

Spring Boot uygulamalarında veri kaynaklarına bağlanmak için bağlantı dizesi oluşturmanızı ve bunları application.properties dosyanıza eklemenizi öneririz.

1. App Service sayfasının "Yapılandırma" bölümünde dize için bir ad ayarlayın, JDBC bağlantı dizesi değer alanına yapıştırın ve türü "Özel" olarak ayarlayın. İsteğe bağlı olarak bu bağlantı dizesi yuva ayarı olarak ayarlayabilirsiniz.

   Bu bağlantı dizesi adlı bir ortam değişkeni CUSTOMCONNSTR_<your-string-name>olarak uygulamamız tarafından erişilebilir. Örneğin, CUSTOMCONNSTR_exampledb.

2. application.properties dosyanızda bu bağlantı dizesi ortam değişkeni adıyla başvurun. Örneğimizde aşağıdaki kodu kullanırız:

   app.datasource.url=${CUSTOMCONNSTR_exampledb}
   

Daha fazla bilgi için veri erişimi ve dışlaştırılmış yapılandırmalarla ilgili Spring Boot belgelerine bakın.

İpucu

Varsayılan olarak, Linux Tomcat kapsayıcıları Tomcat sunucusunda paylaşılan veri kaynaklarını sizin için otomatik olarak yapılandırabilir. Tek yapmanız gereken Oracle, SQL Server, PostgreSQL veya MySQL veritabanına (bağlantı kimlik bilgileri dahil) geçerli bir JDBC bağlantı dizesi içeren bir uygulama ayarı eklemektir ve App Service kapsayıcıda kullanılabilir uygun bir sürücü kullanarak cooresponding paylaşılan veritabanını sizin için otomatik olarak /usr/local/tomcat/conf/context.xml ekler. Bu yaklaşımı kullanan uçtan uca senaryo için bkz. Öğretici: Linux ve MySQL üzerinde Azure Uygulaması Hizmeti ile Tomcat web uygulaması derleme.

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ıyla doldurmanız gerekir. Sağlanan, yaygın veritabanları için sınıf adlarını ve sürücü indirmelerini içeren bir tablodur.

Veritabanı	Sürücü Sınıfı Adı	JDBC Sürücüsü
PostgreSQL	org.postgresql.Driver	Karşıdan Yükle
MySQL	com.mysql.jdbc.Driver	İndir ("Platformdan Bağımsız" seçeneğini belirleyin)
SQL Server	com.microsoft.sqlserver.jdbc.SQLServerDriver	Karşıdan Yükle

Tomcat'i Java Veritabanı Bağlantısı (JDBC) veya Java Kalıcılık API'sini (JPA) kullanacak şekilde yapılandırmak için, ilk olarak başlatma sırasında Tomcat tarafından okunan ortam değişkenini özelleştirin CATALINA_OPTS . App Service Maven eklentisindeki bir uygulama ayarı aracılığıyla bu değerleri ayarlayın:

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

Alternatif olarak, Azure portalının Yapılandırma>Uygulaması Ayarları sayfasında ortam değişkenlerini de ayarlayabilirsiniz.

Ardından, veri kaynağının bir uygulamada mı yoksa Tomcat servlet'inde çalışan tüm uygulamalarda mı kullanılabilir olması gerektiğini belirleyin.

Uygulama düzeyinde veri kaynakları

1. Projenizin META-INF/ dizininde bir context.xml dosyası oluşturun. Yoksa META-INF/ dizini oluşturun.

2. context.xml'da, veri kaynağını bir Context JNDI adresine bağlamak için bir öğe ekleyin. Yer tutucuyu driverClassName , yukarıdaki tablodan sürücünüzün sınıf adıyla değiştirin.

   <Context>
       <Resource
           name="jdbc/dbconnection"
           type="javax.sql.DataSource"
           url="${connURL}"
           driverClassName="<insert your driver class name>"
           username="${dbuser}"
           password="${dbpassword}"
       />
   </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üzeyindeki kaynaklar

Linux

Paylaşılan, sunucu düzeyinde bir veri kaynağı eklemek için Tomcat'in server.xml düzenlemeniz gerekir. Bunu yapmak için en güvenilir yol aşağıdaki gibidir:

1. Başlangıç betiğini karşıya yükleyin ve Yapılandırma>Başlangıç Komutu'nda betiğin yolunu ayarlayın. BAŞLANGıÇ betiğini FTP kullanarak karşıya yükleyebilirsiniz.

Başlangıç betiğiniz, server.xml dosyasına bir xsl dönüşümü yapar ve sonuçta elde edilen xml dosyasını olarak /usr/local/tomcat/conf/server.xmlverir. Başlangıç betiği, apk aracılığıyla libxslt yüklemelidir. xsl dosyanız ve başlangıç betiğiniz 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

Aşağıdaki ö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's 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's 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" 
               keystoreFile="${{user.home}}/.keystore" keystorePass="changeit"
               clientAuth="false" sslProtocol="TLS" />
  </xsl:template>

</xsl:stylesheet>

Yapılandırmayı sonlandırma

Son olarak sürücü JAR'lerini Tomcat sınıf yolu'na yerleştirin ve App Service'inizi yeniden başlatın.

1. JDBC sürücü dosyalarını /home/site/lib dizinine yerleştirerek Tomcat sınıf yükleyicisi tarafından kullanılabilir olduğundan emin olun. Cloud Shell'de her sürücü JAR'ı için komutunu çalıştırınaz webapp deploy --type=lib:

az webapp deploy --resource-group <group-name> --name <app-name> --src-path <jar-name>.jar --type=lib --path <jar-name>.jar

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

Windows

Yükleme konumu salt okunur olduğundan sunucu genelinde yapılandırma için Tomcat yüklemesini doğrudan değiştiremezsiniz. Windows Tomcat yüklemenizde sunucu düzeyinde yapılandırma değişiklikleri yapmak için en basit yol, uygulama başlangıcında aşağıdakileri yapmaktır:

1. Tomcat'i yerel bir dizine (%LOCAL_EXPANDED%) kopyalayın ve bunu olarak CATALINA_BASE kullanın (bu değişkenle ilgili Tomcat belgelerine bakın).
2. Paylaşılan veri kaynaklarınızı %LOCAL_EXPANDED%\tomcat\conf\server.xml XSL dönüşümünü kullanmaya ekleyin.

Başlangıç dosyası ekleme

directory adlı startup.cmd %HOME%\site\wwwroot bir dosya oluşturun. Bu dosya Tomcat sunucusu başlatılmadan önce otomatik olarak çalışır. Dosya aşağıdaki içeriğe sahip olmalıdır:

C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe -File  %HOME%\site\configure.ps1

PowerShell yapılandırma betiğini ekleme

Ardından, configure.ps1 adlı yapılandırma betiğini aşağıdaki kodla %HOME%_\site dizinine ekleyin:

# 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
}

# Start here

# 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 isn't 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
New-Item "$Env:LOCAL_EXPANDED\tomcat" -ItemType Directory
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
}

Bu PowerShell aşağıdaki adımları tamamlar:

1. Özel bir Tomcat kopyasının zaten var olup olmadığını denetleyin. Varsa, başlangıç betiği burada sona erebilir.
2. Tomcat'i yerel olarak kopyalayın.
3. XSL dönüşümünü kullanarak özel Tomcat yapılandırmasına paylaşılan veri kaynakları ekleyin.
4. Yapılandırmanın başarıyla tamamlandığını belirtin.

XSL dönüştürme dosyası ekleme

Yerleşik Tomcat yüklemesini özelleştirmek için yaygın bir kullanım örneği, , context.xmlveya web.xml Tomcat yapılandırma dosyalarını değiştirmektirserver.xml. App Service, platform özellikleri sağlamak için bu dosyaları zaten değiştirir. Bu özellikleri kullanmaya devam etmek için, bu dosyalarda değişiklik yaptığınızda bu dosyaların içeriğini korumak önemlidir. Bunu yapmak için bir XSL dönüşümü (XSLT) kullanın.

%HOME%_\site dizinine configure.ps1 adlı bir XSL dönüştürme dosyası ekleyin. öğesine yeni bir bağlayıcı düğümü server.xmleklemek için aşağıdaki XSL dönüştürme kodunu kullanabilirsiniz. Başlangıçtaki kimlik dönüşümü , yapılandırma dosyasının özgün içeriğini korur.

<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's 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's 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" 
                 keystoreFile="${{user.home}}/.keystore" keystorePass="changeit"
                 clientAuth="false" sslProtocol="TLS" />
    </xsl:template>

</xsl:stylesheet>

Uygulama ayarını ayarlama CATALINA_BASE

Platformun ayrıca Özel Tomcat sürümünüzün nerede yüklendiğini bilmesi gerekir. Yüklemenin konumunu uygulama ayarında CATALINA_BASE ayarlayabilirsiniz.

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

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

İsterseniz Azure portalında ayarı el ile de 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 şu değerleri kullanın:
   1. Ad: CATALINA_BASE
   2. Değer: "%LOCAL_EXPANDED%\tomcat"

Yapılandırmayı sonlandırma

Son olarak, sürücü JAR'lerini Tomcat sınıf yolu'na yerleştirir ve App Service'inizi yeniden başlatırsınız. JDBC sürücü dosyalarını /home/site/lib dizinine yerleştirerek Tomcat sınıf yükleyicisi tarafından kullanılabilir olduğundan emin olun. Cloud Shell'de her sürücü JAR'ı için komutunu çalıştırınaz webapp deploy --type=lib:

az webapp deploy --resource-group <group-name> --name <app-name> --src-path <jar-name>.jar --type=lib --target-path <jar-name>.jar

Bir veri kaynağını JBoss EAP'ye kaydederken üç temel adım vardır: JDBC sürücüsünü karşıya yükleme, JDBC sürücüsünü 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ü ekleme ve kaydetmeye yönelik yapılandırma komutlarının betiklenmesi ve kapsayıcı başlatılırken uygulanması gerekir.

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

2. JDBC sürücüsü için bir XML modülü tanım dosyası oluşturun. Aşağıdaki örnekte PostgreSQL için bir modül tanımı gösterilmektedir.

   <?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. JBoss CLI komutlarınızı adlı jboss-cli-commands.clibir dosyaya yerleştirin. JBoss komutlarının modülü eklemesi ve veri kaynağı olarak kaydetmesi gerekir. Aşağıdaki örnekte PostgreSQL için JBoss CLI 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. JBoss CLI komutlarını çağıran bir başlangıç betiği startup_script.sh oluşturun. Aşağıdaki örnekte, öğesinin nasıl çağrılacakları gösterilmektedir jboss-cli-commands.cli. Daha sonra App Service'i kapsayıcı başlatıldığında bu betiği çalıştıracak şekilde yapılandıracaksınız.

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

5. Seçtiğiniz bir FTP istemcisini kullanarak JDBC sürücünüzü, jboss-cli-commands.cli, startup_script.shve modül tanımınızı öğesine /site/deployments/tools/yükleyin.

6. Kapsayıcı başlatıldığında sitenizi çalışacak startup_script.sh şekilde yapılandırın. Azure portalında Yapılandırma>Genel Ayarları>Başlangıç Komutu'na gidin. Başlangıç komut alanını olarak /home/site/deployments/tools/startup_script.shayarlayın. Değişikliklerinizi kaydedin.

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

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