Azure App Service'te Tomcat, JBoss veya Java SE uygulaması için veri kaynaklarını yapılandırma

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

Azure App Service, tam yönetilen bir hizmet üzerinde Java web uygulamalarını üç farklı şekilde çalıştırır.

• Java Standard Edition (SE): Eklenmiş bir sunucu (Spring Boot, Quarkus, Dropwizard gibi) içeren bir Java Arşivi (JAR) paketi olarak dağıtılan bir uygulamayı ya da katıştırılmış Tomcat veya Jetty sunucusuna sahip bir uygulamayı çalıştırabilir.
• Tomcat: Yerleşik Tomcat sunucusu, web uygulaması arşiv (WAR) paketi olarak dağıtılan bir uygulamayı çalıştırabilir.
• JBoss Kurumsal Uygulama Platformu (EAP): Yerleşik JBoss EAP sunucusu, WAR veya kurumsal arşiv (EAR) paketi olarak dağıtılan bir uygulamayı çalıştırabilir. Ücretsiz, Premium v3 ve Yalıtılmış v2.gti içeren bir dizi fiyatlandırma katmanında Linux uygulamaları için desteklenir

Uyarı

App Service'te JBoss EAP artık "Kendi Lisansını Getir" (KLG) faturalamasını destekliyor. Bu, mevcut Red Hat aboneliklerine sahip müşterilerin bu lisansları Doğrudan Azure App Service'te JBoss EAP dağıtımlarına uygulamasına olanak sağlıyor. Daha fazla bilgi edinin.

Veri kaynağını yapılandırma

Spring Boot uygulamalarındaki veri kaynaklarına bağlanmak için bağlantı dizeleri 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ı dizenizi değer alanına yapıştırın ve türü "Özel" olarak ayarlayın. İsteğe bağlı olarak bu bağlantı dizesini yuva ayarı olarak ayarlayabilirsiniz.

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

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

   app.datasource.url=${CUSTOMCONNSTR_exampledb}
   

Daha fazla bilgi için veri erişimi ve dışsal yapılandırmalarlailgili Spring Boot belgelerine bakın.

Tavsiye

Linux Tomcat kapsayıcıları, ortam değişkenini WEBSITE_AUTOCONFIGURE_DATABASEtrueolarak ayarlayarak Tomcat sunucusunda paylaşılan veri kaynaklarını sizin için otomatik olarak yapılandırabilir. Yapmanız gereken tek şey, 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 bulunan uygun bir sürücüyü kullanarak ilgili paylaşılan veritabanını otomatik olarak /usr/local/tomcat/conf/context.xmlekler. Bu yaklaşımı kullanan uçtan uca bir senaryo için bkz: Öğretici: Linux ve MySQL üzerinde Azure App Service ile Tomcat web uygulaması oluşturma.

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, ortak 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	İndirme
MySQL	com.mysql.jdbc.Driver	İndir ("Platform Independent"ı seçin)
SQL Sunucusu	com.microsoft.sqlserver.jdbc.SQLServerDriver	İndirme

Tomcat'i Java Database Connectivity (JDBC) veya Java Persistence API (JPA) kullanacak şekilde yapılandırmak için önce başlangıçta Tomcat tarafından okunan ortam değişkenini CATALINA_OPTS özelleştirin. Bu değerleri App Service Maven eklentisindeki bir 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>

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

Ardından, veri kaynağının tek bir uygulama tarafından mı yoksa Tomcat servlet üzerinde çalışan tüm uygulamalar için mi kullanılabilir olması gerektiğini belirleyin.

Uygulama düzeyi veri kaynakları

Uygulama düzeyinde veri kaynağını yapılandırmak için:

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

2. context.xmlbölümünde, veri kaynağını bir JNDI adresine bağlamak için bir Context öğe ekleyin. Yer tutucuyu driverClassName yukarıdaki tabloda yer alan 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üzeyi kaynaklar

Linux

Tavsiye

Linux Tomcat kapsayıcıları, /home/site/wwwroot'e kopyalanan dosyalar için aşağıdaki yöntemi kullanarak XSLT dosyalarını otomatik olarak uygulayabilir: server.xml.xsl veya server.xml.xslt varsa, bunlar Tomcat'in server.xml öğesine uygulanır. context.xml.xsl veya context.xml.xslt mevcutsa, Tomcat'in context.xml öğesine uygulanır.

Paylaşılan, sunucu düzeyinde bir veri kaynağı eklemek için Tomcat'in server.xmlöğesini düzenlemeniz gerekir. Dizin dışındaki /home dosya değişiklikleri kısa ömürlü olduğundan, Tomcat'in yapılandırma dosyalarındaki değişikliklerin programlı olarak uygulanması gerekir:

1. Bir başlangıç komut dosyası yükleyin ve Yapılandırma>Başlangıç Komutu'nda komut dosyasının yolunu ayarlayın. Başlangıç komut dosyasını FTP kullanarak yükleyebilirsiniz.

Başlangıç betiğiniz XSL dönüşümü dosyasına uygular ve sonuçta elde edilen XML dosyasını içine verir. Başlangıç betiği, web uygulamanızın Tomcat sürümünün dağıtımına bağlı olarak libxslt veya xlstproc 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ıç komut dosyası verilmiştir.

# Install the libxslt package on Alpine-based images:
apk add --update libxslt

# Install the xsltproc package on Debian or Ubuntu-based images:
apt install xsltproc

# Also copy the transform file to /home/tomcat/conf/
# 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.xmlyeni 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 Connector 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ırın

Son olarak, sürücü JAR'larını Tomcat sınıf yoluna 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 ç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, güncelleştirilmiş yapılandırmaya CATALINA_BASE sıfırlanır /home/tomcat ve bu yapılandırmayı kullanır.

Windows

Yükleme konumu salt okunur olduğundan, sunucu genelinde yapılandırma için bir 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 kopyalayın (%LOCAL_EXPANDED%) ve bunu farklı şekilde CATALINA_BASE kullanın ( bu değişkenle ilgili Tomcat belgelerine bakın).
2. Paylaşılan veri kaynaklarınızı XSL dönüşümünü %LOCAL_EXPANDED%\tomcat\conf\server.xml kullanarak ekleyin.

Başlangıç dosyası ekleme

dizininde startup.cmd adlı %HOME%\site\wwwroot bir dosya oluşturun. Bu dosya, Tomcat sunucusu başlamadan ö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 > %HOME%\site\configure.log

PowerShell yapılandırma betiğini ekleme

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

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

# 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
        Write-Error 'Error'$ErrorMessage':'$FailedItem':' $_.Exception;
        return 0
    }
    return 1
}

# Start here

# Check for marker file indicating that config has already been done
if (Test-Path "$marker_file") {
    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 -Path "$Env:LOCAL_EXPANDED\tomcat" -Recurse -Force
}

# 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 $source_xml -xsl $target_xsl -output $target_xml

# Mark that the operation was a success if successful
if ($success) {
    New-Item -Path "$marker_file" -ItemType File
}

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

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

XSL dönüşüm dosyası ekle

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

%HOME%_\site dizinine configure.ps1 adlı bir XSL dönüşüm 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 Connector 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ı belirleme CATALINA_BASE

Platformun ayrıca Tomcat'in özel sürümünün nerede yüklü olduğunu da bilmesi gerekir. Kurulumun konumunu uygulama ayarından 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"

Alternatif olarak, Azure portal ayarı el ile değiştirebilirsiniz:

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

Yapılandırmayı sonlandırın

Son olarak, sürücü JAR'larını Tomcat sınıf yoluna 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 ç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

Tavsiye

Varsayılan olarak, Linux JBoss kapsayıcıları, JBoss sunucusunda sizin için paylaşılan veri kaynaklarını 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ı eklemek ve değeriyle WEBSITE_AUTOCONFIGURE_DATABASEUygulama Ayarı / Ortam değişkenini true eklemektir. Hizmet Bağlayıcısı ile oluşturulan JDBC Bağlantıları da desteklenir. App Service, kapsayıcıda kullanılabilir uygun bir sürücü kullanarak, Uygulama Ayarı adının sonuna eklenen sonek temelinde ilgili paylaşılan veri kaynağını otomatik olarak ekler. Bu yaklaşımı kullanan uçtan uca bir senaryo için bkz: Öğretici: Linux ve MySQL üzerinde Azure App Service ile JBoss web uygulaması oluşturma.

JBoss EAP ile bir veri kaynağını kaydederken üç temel adım vardır:

1. JDBC sürücüsünü yükleyin.
2. JDBC sürücüsünü bir modül olarak ekleyin.
3. Modülle bir veri kaynağı ekleyin.

App Service durum bilgisi olmayan bir barındırma hizmetidir, bu nedenle bu adımları bir başlangıç betiğine koymanız ve JBoss kapsayıcısı her başlatıldığında çalıştırmanız gerekir. PostgreSQL, MySQL ve SQL Veritabanı'nı örnek olarak kullanma:

PostgreSQL

Uyarı

App Service'te JBoss EAP artık "Kendi Lisansını Getir" (KLG) faturalamasını destekliyor. Bu, mevcut Red Hat aboneliklerine sahip müşterilerin bu lisansları Doğrudan Azure App Service'te JBoss EAP dağıtımlarına uygulamasına olanak sağlıyor. Daha fazla bilgi edinin.

1. JBoss CLI komutlarınızı jboss-cli-commands.cli adlı bir dosyaya yerleştirin. JBoss komutlarının modülü eklemesi ve veri kaynağı olarak kaydetmesi gerekir. Aşağıdaki örnek, JNDI adıyla java:jboss/datasources/postgresDSbir PostgreSQL veri kaynağı oluşturmak için JBoss CLI komutlarını gösterir.

   module add --name=org.postgresql --resources=/home/site/libs/postgresql-42.7.4.jar
   /subsystem=datasources/jdbc-driver=postgresql:add(driver-name="postgresql",driver-module-name="org.postgresql",driver-class-name="org.postgresql.Driver",driver-xa-datasource-class-name="org.postgresql.xa.PGXADataSource")
   data-source add --name=postgresql --driver-name="postgresql" --jndi-name="java:jboss/datasources/postgresDS" --connection-url="jdbc:postgresql://\${env.DB_HOST}:5432/postgres" --user-name="\${env.DB_USERNAME}" --password="\${env.DB_PASSWORD}" --enabled=true --use-java-context=true
   

   Komutun, App Service'e module add uygulama ayarları olarak eklemeniz gereken üç ortam değişkeni (DB_HOST, DB_USERNAME, ve DB_PASSWORD) kullandığını unutmayın. Komut dosyası bunları bayrak olmadan ekler, --resolve-parameter-values böylece JBoss değerlerini düz metin olarak kaydetmez.

2. JBoss CLI komutlarını çağıran bir başlangıç betiği (startup.sh) oluşturun. Aşağıdaki örnek, .jboss-cli-commands.cli Daha sonra, kapsayıcı başlatıldığında App Service'i bu betiği çalıştıracak şekilde yapılandıracaksınız.

   $JBOSS_HOME/bin/jboss-cli.sh --connect --file=/home/site/scripts/jboss_cli_commands.cli
   

3. Tercih ettiğiniz bir dağıtım seçeneğini kullanarak, JDBC sürücünüzü, jboss-cli-commands.cli ve startup.sh ilgili betiklerde belirtilen yollara yükleyin. Özellikle, startup.sh bir başlangıç dosyası olarak yükleyin. Örneğin:

   Azure CLI

   export RESOURCE_GROUP_NAME=<resource-group-name>
   export APP_NAME=<app-name>
   
   # The lib type uploads to /home/site/libs by default.
   az webapp deploy --resource-group $RESOURCE_GROUP_NAME --name $APP_NAME --src-path postgresql-42.7.4.jar --target-path postgresql-42.7.4.jar --type lib
   az webapp deploy --resource-group $RESOURCE_GROUP_NAME --name $APP_NAME --src-path jboss_cli_commands.cli --target-path /home/site/scripts/jboss_cli_commands.cli --type static
   # The startup type uploads to /home/site/scripts/startup.sh by default.
   az webapp deploy --resource-group $RESOURCE_GROUP_NAME --name $APP_NAME --src-path startup.sh --type startup
   

   Daha fazla bilgi için bkz . App Service'e dosya dağıtma.

   Azure Maven Eklentisi

   <deployment>
       <resources>
           <resource>
               <!-- The lib type uploads to /home/site/libs by default. -->
               <type>lib</type>
               <directory>${project.build.directory}/${project.artifactId}/META-INF/lib</directory> <!-- Assume driver is part of POM dependencies. -->
               <includes>
                   <include>postgresql-42.7.4.jar</include>
               </includes>
           </resource>
           <resource>
               <!-- The script type uploads to /home/site/scripts by default. -->
               <type>script</type>
               <directory>${project.scriptSourceDirectory}</directory> <!-- Assume script is in src/main/scripts. -->
               <includes>
                   <include>jboss_cli_commands.cli</include>
               </includes>
           </resource>
           <resource>
               <!-- The startup type uploads to /home/site/scripts by default. -->
               <type>startup</type>
               <directory>${project.scriptSourceDirectory}</directory> <!-- Assume script is in src/main/scripts. -->
               <includes>
                   <include>startup.sh</include>
               </includes>
           </resource>
           ...
       </resources>
   </deployment>
   

   Azure Pipelines

   variables: # Set <subscription-id>, <resource-group-name>, <app-name> for your environment
   - name: SUBSCRIPTION_ID
     value: <subscription-id>
   - name: RESOURCE_GROUP_NAME
     value: <resource-group-name>
   - name: APP_NAME
     value: <app-name>
   
   steps: 
   - task: AzureCLI@2
     displayName: Azure CLI
     inputs:
       azureSubscription: $(SUBSCRIPTION_ID)
       scriptType: bash
       scriptLocation: inlineScript
       inlineScript: |
         # The lib type uploads to /home/site/libs by default.
         az webapp deploy --resource-group $(RESOURCE_GROUP_NAME) --name $(APP_NAME) --src-path postgresql-42.7.4.jar --target-path postgresql-42.7.4.jar --type lib
         az webapp deploy --resource-group $(RESOURCE_GROUP_NAME) --name $(APP_NAME) --src-path jboss_cli_commands.cli --target-path /home/site/scripts/jboss_cli_commands.cli --type static
         # The startup type uploads to /home/site/scripts/startup.sh by default.
         az webapp deploy --resource-group $(RESOURCE_GROUP_NAME) --name $(APP_NAME) --src-path startup.sh --type startup
   

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

Daha önce jboss-cli-commands.cli tarafından tanımlandığı gibi, JNDI adını java:jboss/datasources/postgresDSkullanarak PostgreSQL bağlantısına erişebilirsiniz.

MySQL

Uyarı

App Service'te JBoss EAP artık "Kendi Lisansını Getir" (KLG) faturalamasını destekliyor. Bu, mevcut Red Hat aboneliklerine sahip müşterilerin bu lisansları Doğrudan Azure App Service'te JBoss EAP dağıtımlarına uygulamasına olanak sağlıyor. Daha fazla bilgi edinin.

1. JBoss CLI komutlarınızı jboss-cli-commands.cli adlı bir dosyaya yerleştirin. JBoss komutlarının modülü eklemesi ve veri kaynağı olarak kaydetmesi gerekir. Aşağıdaki örnek, JNDI adıyla java:jboss/datasources/mysqlDSbir MySQL veri kaynağı oluşturmak için JBoss CLI komutlarını gösterir.

   module add --name=com.mysql.mysql-connector-j --resources=/home/site/libs/mysql-connector-j-9.1.0.jar
   /subsystem=datasources/jdbc-driver=mysql:add(driver-name="mysql",driver-module-name="com.mysql.mysql-connector-j",driver-class-name="com.mysql.cj.jdbc.Driver",driver-xa-datasource-class-name="com.mysql.cj.jdbc.MysqlXADataSource")
   data-source add --name=mysql --driver-name="mysql" --jndi-name="java:jboss/datasources/mysqlDS" --connection-url="jdbc:mysql://\${env.DB_HOST}:5432/mysql?serverTimezone=UTC" --user-name="\${env.DB_USERNAME}" --password="\${env.DB_PASSWORD}" --enabled=true --use-java-context=true
   

   Komutun, App Service'e module add uygulama ayarları olarak eklemeniz gereken üç ortam değişkeni (DB_HOST, DB_USERNAME, ve DB_PASSWORD) kullandığını unutmayın. Komut dosyası bunları bayrak olmadan ekler, --resolve-parameter-values böylece JBoss değerlerini düz metin olarak kaydetmez.

2. JBoss CLI komutlarını çağıran bir başlangıç betiği (startup.sh) oluşturun. Aşağıdaki örnek, .jboss-cli-commands.cli Daha sonra, kapsayıcı başlatıldığında App Service'i bu betiği çalıştıracak şekilde yapılandıracaksınız.

   $JBOSS_HOME/bin/jboss-cli.sh --connect --file=/home/site/scripts/jboss_cli_commands.cli
   

3. Tercih ettiğiniz bir dağıtım seçeneğini kullanarak, JDBC sürücünüzü, jboss-cli-commands.cli ve startup.sh ilgili betiklerde belirtilen yollara yükleyin. Özellikle, startup.sh bir başlangıç dosyası olarak yükleyin. Örneğin:

   Azure CLI

   export RESOURCE_GROUP_NAME=<resource-group-name>
   export APP_NAME=<app-name>
   
   # The lib type uploads to /home/site/libs by default.
   az webapp deploy --resource-group $RESOURCE_GROUP_NAME --name $APP_NAME --src-path mysql-connector-j-9.1.0.jar --target-path mysql-connector-j-9.1.0.jar --type lib
   az webapp deploy --resource-group $RESOURCE_GROUP_NAME --name $APP_NAME --src-path jboss_cli_commands.cli --target-path /home/site/scripts/jboss_cli_commands.cli --type static
   # The startup type uploads to /home/site/scripts/startup.sh by default.
   az webapp deploy --resource-group $RESOURCE_GROUP_NAME --name $APP_NAME --src-path startup.sh --type startup
   

   Daha fazla bilgi için bkz . App Service'e dosya dağıtma.

   Azure Maven Eklentisi

   <deployment>
       <resources>
           <resource>
               <!-- The lib type uploads to /home/site/libs by default. -->
               <type>lib</type>
               <directory>${project.build.directory}/${project.artifactId}/META-INF/lib</directory> <!-- Assume driver is part of POM dependencies. -->
               <includes>
                   <include>mysql-connector-j-9.1.0.jar</include>
               </includes>
           </resource>
           <resource>
               <!-- The script type uploads to /home/site/scripts by default. -->
               <type>script</type>
               <directory>${project.scriptSourceDirectory}</directory> <!-- Assume script is in src/main/scripts. -->
               <includes>
                   <include>jboss_cli_commands.cli</include>
               </includes>
           </resource>
           <resource>
               <!-- The startup type uploads to /home/site/scripts/startup.sh by default -->
               <type>startup</type>
               <directory>${project.scriptSourceDirectory}</directory> <!-- Assume script is in src/main/scripts. -->
               <includes>
                   <include>startup.sh</include>
               </includes>
           </resource>
           ...
       </resources>
   </deployment>
   

   Azure Pipelines

   variables: # Set <subscription-id>, <resource-group-name>, <app-name> for your environment
   - name: SUBSCRIPTION_ID
     value: <subscription-id>
   - name: RESOURCE_GROUP_NAME
     value: <resource-group-name>
   - name: APP_NAME
     value: <app-name>
   
   steps: 
   - task: AzureCLI@2
     displayName: Azure CLI
     inputs:
       azureSubscription: $(SUBSCRIPTION_ID)
       scriptType: bash
       scriptLocation: inlineScript
       inlineScript: |
         # The lib type uploads to /home/site/libs by default.
         az webapp deploy --resource-group $(RESOURCE_GROUP_NAME) --name $(APP_NAME) --src-path mysql-connector-j-9.1.0.jar --target-path mysql-connector-j-9.1.0.jar --type lib
         az webapp deploy --resource-group $(RESOURCE_GROUP_NAME) --name $(APP_NAME) --src-path jboss_cli_commands.cli --target-path /home/site/scripts/jboss_cli_commands.cli --type static
         # The startup type uploads to /home/site/scripts/startup.sh by default.
         az webapp deploy --resource-group $(RESOURCE_GROUP_NAME) --name $(APP_NAME) --src-path startup.sh --type startup
   

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

Daha önce jboss-cli-commands.cli tarafından tanımlandığı gibi, JNDI adını java:jboss/datasources/mysqlDSkullanarak MySQL bağlantısına erişebilirsiniz.

SQL Veritabanı

Uyarı

App Service'te JBoss EAP artık "Kendi Lisansını Getir" (KLG) faturalamasını destekliyor. Bu, mevcut Red Hat aboneliklerine sahip müşterilerin bu lisansları Doğrudan Azure App Service'te JBoss EAP dağıtımlarına uygulamasına olanak sağlıyor. Daha fazla bilgi edinin.

1. JBoss CLI komutlarınızı jboss-cli-commands.cli adlı bir dosyaya yerleştirin. JBoss komutlarının modülü eklemesi ve veri kaynağı olarak kaydetmesi gerekir. Aşağıdaki örnekte, JNDI adıyla java:jboss/datasources/sqlDSAzure SQL Veritabanı için bir veri kaynağı oluşturmaya yönelik JBoss CLI komutları gösterilmektedir.

   module add --name=sqlserver --resources=/home/site/libs/mssql-jdbc-11.2.3.jre17.jar
   /subsystem=datasources/jdbc-driver=sqlserver:add(driver-name="sqlserver",driver-module-name="sqlserver",driver-class-name="com.microsoft.sqlserver.jdbc.SQLServerDriver",driver-xa-datasource-class-name="com.microsoft.sqlserver.jdbc.SQLServerXADataSource")
   data-source add --name=sqlDS --jndi-name=java:jboss/datasources/sqlDS --driver-name=sqlserver --connection-url="jdbc:sqlserver://\${env.DB_HOST}:1433;databaseName=master" --user-name="\${env.DB_USERNAME}" --password="\${env.DB_PASSWORD}" --validate-on-match=true --background-validation=false --valid-connection-checker-class-name=org.jboss.jca.adapters.jdbc.extensions.mssql.MSSQLValidConnectionChecker --exception-sorter-class-name=org.jboss.jca.adapters.jdbc.extensions.mssql.MSSQLExceptionSorter
   

   Komutun, App Service'e module add uygulama ayarları olarak eklemeniz gereken üç ortam değişkeni (DB_HOST, DB_USERNAME, ve DB_PASSWORD) kullandığını unutmayın. Komut dosyası bunları bayrak olmadan ekler, --resolve-parameter-values böylece JBoss değerlerini düz metin olarak kaydetmez.

2. JBoss CLI komutlarını çağıran bir başlangıç betiği (startup.sh) oluşturun. Aşağıdaki örnek, .jboss-cli-commands.cli Daha sonra, kapsayıcı başlatıldığında App Service'i bu betiği çalıştıracak şekilde yapılandıracaksınız.

   $JBOSS_HOME/bin/jboss-cli.sh --connect --file=/home/site/scripts/jboss_cli_commands.cli
   

3. Tercih ettiğiniz bir dağıtım seçeneğini kullanarak, JDBC sürücünüzü, jboss-cli-commands.cli ve startup.sh ilgili betiklerde belirtilen yollara yükleyin. Özellikle, startup.sh bir başlangıç dosyası olarak yükleyin. Örneğin:

   Azure CLI

   export RESOURCE_GROUP_NAME=<resource-group-name>
   export APP_NAME=<app-name>
   
   # The lib type uploads to /home/site/libs by default.
   az webapp deploy --resource-group $RESOURCE_GROUP_NAME --name $APP_NAME --src-path mssql-jdbc-11.2.3.jre17.jar --target-path mssql-jdbc-11.2.3.jre17.jar --type lib
   az webapp deploy --resource-group $RESOURCE_GROUP_NAME --name $APP_NAME --src-path jboss_cli_commands.cli --target-path /home/site/scripts/jboss_cli_commands.cli --type static
   # The startup type uploads to /home/site/scripts/startup.sh by default.
   az webapp deploy --resource-group $RESOURCE_GROUP_NAME --name $APP_NAME --src-path startup.sh --type startup
   

   Daha fazla bilgi için bkz . App Service'e dosya dağıtma.

   Azure Maven Eklentisi

   <deployment>
       <resources>
           <resource>
               <!-- The lib type uploads to /home/site/libs by default. -->
               <type>lib</type>
               <directory>${project.build.directory}/${project.artifactId}/META-INF/lib</directory> <!-- Assume driver is part of POM dependencies. -->
               <includes>
                   <include>mssql-jdbc-11.2.3.jre17.jar</include>
               </includes>
           </resource>
           <resource>
               <!-- The script type uploads to /home/site/scripts by default. -->
               <type>script</type>
               <directory>${project.scriptSourceDirectory}</directory> <!-- Assume script is in src/main/scripts. -->
               <includes>
                   <include>jboss_cli_commands.cli</include>
               </includes>
           </resource>
           <resource>
               <!-- The startup type uploads to /home/site/scripts/startup.sh by default -->
               <type>startup</type>
               <directory>${project.scriptSourceDirectory}</directory> <!-- Assume script is in src/main/scripts. -->
               <includes>
                   <include>startup.sh</include>
               </includes>
           </resource>
           ...
       </resources>
   </deployment>
   

   Azure Pipelines

   variables: # Set <subscription-id>, <resource-group-name>, <app-name> for your environment
   - name: SUBSCRIPTION_ID
     value: <subscription-id>
   - name: RESOURCE_GROUP_NAME
     value: <resource-group-name>
   - name: APP_NAME
     value: <app-name>
   
   steps: 
   - task: AzureCLI@2
     displayName: Azure CLI
     inputs:
       azureSubscription: $(SUBSCRIPTION_ID)
       scriptType: bash
       scriptLocation: inlineScript
       inlineScript: |
         # The lib type uploads to /home/site/libs by default.
         az webapp deploy --resource-group $(RESOURCE_GROUP_NAME) --name $(APP_NAME) --src-path mssql-jdbc-11.2.3.jre17.jar --target-path mssql-jdbc-11.2.3.jre17.jar --type lib
         az webapp deploy --resource-group $(RESOURCE_GROUP_NAME) --name $(APP_NAME) --src-path jboss_cli_commands.cli --target-path /home/site/scripts/jboss_cli_commands.cli --type static
         # The startup type uploads to /home/site/scripts/startup.sh by default.
         az webapp deploy --resource-group $(RESOURCE_GROUP_NAME) --name $(APP_NAME) --src-path startup.sh --type startup
   

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

Daha önce jboss-cli-commands.cli tarafından tanımlandığı gibi, JNDI adını java:jboss/datasources/sqlDSkullanarak SQL Veritabanı bağlantısına erişebilirsiniz.

İlgili içerik

Java Geliştiricileri için Azure merkezini ziyaret ederek Azure hızlı başlangıçlarını, eğitimlerini ve Java referans belgelerini bulabilirsiniz.

• App Service Linux Sıkça Sorulan Sorular
• Ortam değişkenleri ve uygulama ayarları referansı