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 olarak yönetilen bir hizmette Java web uygulamalarını üç türde çalıştırır:

• Java Standard Edition (SE). Java SE; Spring Boot, Quarkus, Dropwizard gibi ekli bir sunucu içeren bir Java arşiv (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. Bu seçenek Ücretsiz, Premium v3 ve Yalıtılmış v2 içeren bir dizi fiyatlandırma katmanındaki Linux uygulamaları için desteklenir.

Uyarı

App Service'te JBoss EAP artık Kendi Lisansını Getir (KLG) faturalamayı destekliyor. BYOL, mevcut Red Hat aboneliklerine sahip olan müşterilerin bu lisansları doğrudan Azure App Service'teki JBoss EAP dağıtımlarına uygulamalarına olanak tanır. Daha fazla bilgi için bkz. App Service'te JBoss EAP için KLG Desteği.

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 sol bölmesinde Ayarlar>Ortam değişkenleri'ni seçin. Bağlantı dizeleri sekmesinde Ekle'yi seçin. Dize için bir Ad ayarlayın, JDBC bağlantı dizenizi Değer alanına yapıştırın ve Tür değerini Özel olarak ayarlayın. İsteğe bağlı olarak bağlantı dizesini yuva ayarı olarak ayarlayabilirsiniz.

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

2. application.properties dosyanızda, ortam değişkeni adıyla bağlantı dizesine başvurun. Yukarıdaki örnekte şu kodu kullanacaksınız:

   app.datasource.url=${CUSTOMCONNSTR_exampledb}
   

Daha fazla bilgi için bkz. Veri erişimi ve dışlanmış yapılandırmaile ilgili Spring Boot belgeleri.

Tavsiye

Ortam değişkenini WEBSITE_AUTOCONFIGURE_DATABASEtrueolarak ayarlarsanız Linux Tomcat kapsayıcıları, Tomcat sunucusunda 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ı eklemektir. App Service, kapsayıcıda kullanılabilir uygun bir sürücü kullanarak ilgili paylaşılan veritabanını /usr/local/tomcat/conf/context.xmlöğesine otomatik olarak ekler. Bu yaklaşımı kullanan uçtan uca senaryo için bkz. Öğretici: Linux üzerinde ve MySQL ile Azure App Service kullanarak bir 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 değiştirmeniz gerekir. Aşağıdaki tabloda, yaygın veritabanları için sınıf adları ve sürücü indirmeleri sağlanmaktadır.

Veritabanı	Sürücü sınıfı adı	JDBC sürücüsü
PostgreSQL	org.postgresql.Driver	İndirme
MySQL	com.mysql.jdbc.Driver	İndir ( Platformdan Bağımsız'ı seçin.)
SQL Sunucusu	com.microsoft.sqlserver.jdbc.SQLServerDriver	İndirme

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şlangıçta Tomcat tarafından okunan ortam değişkenini özelleştirin CATALINA_OPTS . App Service Maven eklentisinde bir uygulama ayarı kullanarak bu değeri ayarlayın:

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

Alternatif olarak, Azure portalındaki Ayarlar Ortam değişkenleri sayfasının > sekmesinde ortamdeğişkenini de ayarlayabilirsiniz.

Ardından, veri kaynağının bir uygulama için mi yoksa Tomcat servlet'inde çalışan tüm uygulamalar için mi kullanılabilir olacağını 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. Eğer 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. driverClassName yer tutucusunu, bu makalede daha önce gösterilen 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üzeyi kaynaklar

Linux

Tavsiye

Linux Tomcat kapsayıcıları, /home/site/wwwroot'a kopyalanan dosyalar için aşağıdaki kuralı kullanarak XSLT dosyalarını otomatik olarak uygulayabilir: server.xml.xsl veya server.xml.xslt mevcutsa, dosyalar Tomcat'in server.xml öğesine uygulanır. Eğer context.xml.xsl veya context.xml.xslt varsa, dosyalar 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:

• Başlangıç betiğini yükleyin ve Ayarlar>Yapılandırma'da betiğin yolunu ayarlayın. Yığın ayarları sekmesinde Başlangıç komut kutusuna yolu ekleyin. BAŞLANGıÇ betiğini FTP kullanarak karşıya yükleyebilirsiniz.

Başlangıç betiğiniz XSL dönüşümü dosyasına uygular ve ortaya çıkan XML dosyasını /usr/local/tomcat/conf/server.xml olarak 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, aşağıdaki örnek betikteki yorumda belirtildiği gibi. XSL dosyanızı ve başlangıç betiğinizi yüklemek için FTP kullanabilirsiniz.

# 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 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'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'lerini Tomcat sınıf yolu'na yerleştirin ve App Service uygulamanızı yeniden başlatın.

• 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 bir sürücü JAR için komutu ç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, CATALINA_BASE'yi /home/tomcat olarak sıfırlar ve güncellenmiş 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 yapmanın en kolay yolu, uygulama başlangıcında aşağıdaki adımları tamamlamaktır:

1. Tomcat'i yerel bir dizine (%LOCAL_EXPANDED%) kopyalayın ve bu kopyayı olarak CATALINA_BASEkullanın. ( Bu değişkenle ilgili Tomcat belgelerine bakın).
2. XSL dönüşümünü kullanarak paylaşılan veri kaynaklarınızı 'a %LOCAL_EXPANDED%\tomcat\conf\server.xml 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. Dosyada şu yer almalı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, %HOME%\site dizinine configure.ps1 adlı bir yapılandırma betiği ekleyin. Betik şu kodu içerir:

# 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 configuration has already been done
if (Test-Path "$marker_file") {
    return 0
}

# Delete previous Tomcat directory if it exists
# In case previous configuration isn't completed or a new configuration should be forcefully installed
if (Test-Path "$Env:LOCAL_EXPANDED\tomcat") {
    Remove-Item -Path "$Env:LOCAL_EXPANDED\tomcat" -Recurse -Force
}

# Copy Tomcat to local
# When you use the environment variable $AZURE_TOMCAT90_HOME, the 'default' version of Tomcat is used
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 succeeded if it did
if ($success) {
    New-Item -Path "$marker_file" -ItemType File
}

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

1. Özel bir Tomcat kopyası olup olmadığını denetleyin. Varsa, başlangıç betiği durabilir.
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 yaparken bu dosyaların içeriğini korumanız gerekir. Bu içeriği korumak için bir XSL dönüşümü (XSLT) kullanın.

%HOME%_\site dizinine server.xsl 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 transform 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 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'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>

CATALINA_BASE Uygulama ayarını ayarlama

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ında ayarı el ile değiştirebilirsiniz:

1. Ayarlar>Ortam değişkenleri>Uygulama ayarları'na gidin.
2. Add (Ekle) seçeneğini belirleyin.
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 bir sürücü JAR için komutu ç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 paylaşılan veri kaynaklarını 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ı eklemek ve değeriyle WEBSITE_AUTOCONFIGURE_DATABASEuygulama ayarını /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 ilgili paylaşılan veri kaynağını (uygulama ayarı adına ve son ekine _DSgöre) otomatik olarak ekler. Bu yaklaşımı kullanan uçtan uca bir senaryo için, Tutorial: Azure App Service üzerinde Linux ve MySQL ile JBoss web uygulaması oluşturma başlığına bakın.

JBoss EAP'ye veri kaynağı kaydetmenin üç ana 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 yerleştirmeniz ve JBoss kapsayıcısı her başlatıldığında çalıştırmanız gerekir. PostgreSQL, MySQL ve Azure SQL Veritabanı örnekleri şunlardır:

PostgreSQL

Uyarı

App Service'te JBoss EAP, Kendi Lisansınızı Getirin (BYOL) faturalamayı destekler. BYOL, mevcut Red Hat aboneliklerine sahip olan müşterilerin bu lisansları doğrudan Azure App Service'teki JBoss EAP dağıtımlarına uygulamalarına olanak tanır. Daha fazla bilgi için bkz. JBoss EAP için BYOL Desteği.

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ı --resolve-parameter-values bayrağı olmadan ekler, 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 örnekte jboss-cli-commands.cli dosyanızı çağırma gösterilmektedir. 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/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. startup.sh başlangıç dosyası olarak karşıya 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 dosyaları 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>, and <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 yazın ve komutunu çalıştırın $JBOSS_HOME/bin/jboss-cli.sh --connect. JBoss'a bağlandıktan sonra komutunu çalıştırarak /subsystem=datasources:read-resource veri kaynaklarının listesini yazdırın.

jboss-cli-commands.cli dosyasındaki tanım gereği, JNDI adını java:jboss/datasources/postgresDSkullanarak PostgreSQL bağlantısına erişebilirsiniz.

MySQL

Uyarı

App Service'te JBoss EAP, BYOL (Kendi Lisansını Getir) faturalama yöntemini destekler. BYOL, mevcut Red Hat aboneliklerine sahip olan müşterilerin bu lisansları doğrudan Azure App Service'teki JBoss EAP dağıtımlarına uygulamalarına olanak tanır. Daha fazla bilgi için Azure App Service'te JBoss EAP için BYOL Desteği bölümüne bakın.

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ı --resolve-parameter-values bayrağı olmadan ekler, 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 örnekte jboss-cli-commands.cli dosyanızı çağırma gösterilmektedir. 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/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. startup.sh başlangıç dosyası olarak karşıya 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 dosyaları 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 yazın ve komutunu çalıştırın $JBOSS_HOME/bin/jboss-cli.sh --connect. JBoss'a bağlandıktan sonra komutunu çalıştırarak /subsystem=datasources:read-resource veri kaynaklarının listesini yazdırın.

jboss-cli-commands.cli dosyasındaki tanım gereği, JNDI adını java:jboss/datasources/mysqlDSkullanarak MySQL bağlantısına erişebilirsiniz.

SQL Veritabanı

Uyarı

App Service'te JBoss EAP, Kendi Lisansını Kullan (BYOL) faturalamayı destekler. BYOL, mevcut Red Hat aboneliklerine sahip müşterilerin bu lisansları Azure App Service üzerinde JBoss EAP dağıtımlarına doğrudan uygulamasını sağlar. Daha fazla bilgi için JBoss EAP için BYOL Desteği bölümüne bakın.

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 adlı java:jboss/datasources/sqlDSbir Azure SQL veritabanı için 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ı --resolve-parameter-values bayrağı olmadan ekler, 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 örnekte jboss-cli-commands.cli dosyanızı çağırma gösterilmektedir. 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/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. startup.sh'i karşıya 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 dosyaları 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>,  and <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 komutunu çalıştırarak /subsystem=datasources:read-resource veri kaynaklarının listesini yazdırın.

jboss-cli-commands.cli dosyasındaki tanım gereği, JNDI adını java:jboss/datasources/sqlDSkullanarak SQL Veritabanı bağlantısına erişebilirsiniz.

İlgili içerik

• Java geliştiricileri için Azure belgeleri
• App Service Linux Sıkça Sorulan Sorular
• Ortam değişkenleri ve uygulama ayarları referansı