Konfigurace zdrojů dat pro aplikaci Tomcat, JBoss nebo Java SE ve službě Aplikace Azure Service

Tento článek ukazuje, jak nakonfigurovat zdroje dat v aplikaci Java SE, Tomcat nebo JBoss ve službě App Service.

Služba Azure App Service provozuje webové aplikace Java na plně spravovanou službou ve třech verzích.

• Java Standard Edition (SE): Může spustit aplikaci nasazenou jako balíček Java Archive (JAR), který obsahuje vložený server (například Spring Boot, Quarkus, Dropwizard nebo aplikaci s vloženým serverem Tomcat nebo Jetty).
• Tomcat: Integrovaný server Tomcat může spustit aplikaci nasazenou jako balíček archivu webových aplikací (WAR).
• JBoss Enterprise Application Platform (EAP): Integrovaný server JBoss EAP může spustit aplikaci nasazenou jako balíček WAR nebo enterprise archive (EAR). Podporováno pro aplikace pro Linux v sadě cenových úrovní, které zahrnují Free, Premium v3 a Isolated v2.gti.

Poznámka:

JBoss EAP ve službě App Service teď podporuje fakturaci byOL (Bring Your Own License), což zákazníkům se stávajícími předplatnými Red Hat umožňuje použít tyto licence přímo na nasazení EAP JBoss ve službě Azure App Service. Další informace.

Konfigurace zdroje dat

Pokud se chcete připojit ke zdrojům dat v aplikacích Spring Boot, doporučujeme vytvořit připojovací řetězce a vložit je do souboru application.properties .

1. V části Konfigurace na stránce služby App Service nastavte název řetězce, vložte připojovací řetězec JDBC do pole hodnoty a nastavte typ na Vlastní. Volitelně můžete tento připojovací řetězec nastavit jako slotové nastavení.

   Tento připojovací řetězec je pro naši aplikaci přístupný jako proměnná prostředí s názvem CUSTOMCONNSTR_<your-string-name>. Například CUSTOMCONNSTR_exampledb.

2. V souboru application.properties odkazujte na tento připojovací řetězec pomocí názvu proměnné prostředí. V našem příkladu bychom použili následující kód:

   app.datasource.url=${CUSTOMCONNSTR_exampledb}
   

Další informace najdete v dokumentaci Spring Bootu k přístupu k datům a externalizovaným konfiguracím.

Návod

Kontejnery Tomcat pro Linux mohou automaticky konfigurovat sdílené zdroje dat pro vás na serveru Tomcat nastavením proměnné WEBSITE_AUTOCONFIGURE_DATABASE prostředí na true. Jediné, co je potřeba udělat, je přidat nastavení aplikace, které obsahuje platný připojovací řetězec JDBC k databázi Oracle, SQL Server, PostgreSQL nebo MySQL (včetně přihlašovacích údajů pro připojení) a App Service automaticky přidá odpovídající sdílenou databázi do /usr/local/tomcat/conf/context.xmlpomocí příslušného ovladače dostupného v kontejneru. Kompletní scénář, který používá tento přístup, najdete v tématu Kurz: Vytvoření webové aplikace Tomcat se službou Azure App Service v Linuxu a MySQL.

Tyto pokyny platí pro všechna připojení k databázi. Zástupné symboly musíte vyplnit názvem třídy ovladače zvolené databáze a souborem JAR. Poskytuje se tabulka s názvy tříd a stahováním ovladačů pro běžné databáze.

Databáze	Název třídy ovladače	Ovladač JDBC
PostgreSQL	org.postgresql.Driver	Stáhnout
MySQL	com.mysql.jdbc.Driver	Stáhnout (vybrat nezávislou platformu)
SQL Server	com.microsoft.sqlserver.jdbc.SQLServerDriver	Stáhnout

Pokud chcete nakonfigurovat Tomcat tak, aby používala připojení k databázi Java (JDBC) nebo rozhraní JPA (Java Persistence API), nejprve při spuštění přizpůsobte CATALINA_OPTS proměnnou prostředí, která je načtena tomcatem. Nastavte tyto hodnoty prostřednictvím nastavení aplikace v modulu plug-in App Service Maven:

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

Nebo nastavte proměnné prostředí na stránce Konfigurace>Nastavení aplikace v portálu Azure.

Dále určete, jestli má být zdroj dat dostupný pro jednu aplikaci nebo pro všechny aplikace spuštěné na servletu Tomcat.

Zdroje dat na úrovni aplikace

Konfigurace zdroje dat na úrovni aplikace:

1. V adresáři META-INF/ projektu vytvořte soubor context.xml. Pokud neexistuje, vytvořte adresář META-INF/ .

2. V context.xmlpřidejte Context prvek pro propojení zdroje dat s adresou JNDI. Nahraďte zástupný symbol driverClassName názvem třídy vašeho ovladače z výše uvedené tabulky.

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

3. Aktualizujte v aplikaci položku web.xml k použití zdroje dat ve vaší aplikaci.

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

Sdílené prostředky na úrovni serveru

Linux

Návod

Kontejnery Tomcat pro Linux mohou automaticky použít soubory XSLT pomocí následující konvence pro soubory zkopírované do /home/site/wwwroot: Pokud jsou server.xml.xsl nebo server.xml.xslt k dispozici, budou použity na Tomcatův server.xml. Pokud jsou přítomny context.xml.xsl nebo context.xml.xslt, budou aplikovány na Tomcat's context.xml.

Přidání sdíleného zdroje dat na úrovni serveru vyžaduje, abyste upravili soubor Tomcat.server.xml Vzhledem k tomu, že změny souborů mimo /home adresář jsou dočasné, je třeba změny konfiguračních souborů Tomcat použít programově, a to následujícím způsobem:

1. Nahrajte spouštěcí skript a nastavte cestu ke skriptu v>konfiguračním spouštěcím příkazu. Spouštěcí skript můžete nahrát pomocí ftp.

Spouštěcí skript provede transformaci XSL do server.xml souboru a výstup výsledného souboru XML do /usr/local/tomcat/conf/server.xml. Spouštěcí skript by se měl nainstalovat libxslt nebo xlstproc v závislosti na distribuci verze Tomcat vaší webové aplikace. Váš soubor XSL a spouštěcí skript se dají nahrát přes FTP. Níže je uveden příklad spouštěcího skriptu.

# 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

Následující příklad souboru XSL přidá nový uzel konektoru do tomcat server.xml.

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

Dokončení konfigurace

Nakonec umístěte soubor JAR ovladačů do classpathu Tomcat a restartujte App Service.

1. Ujistěte se, že soubory ovladačů JDBC jsou k dispozici pro zavaděč tříd Tomcat jejich umístěním do adresáře /home/site/lib . V Cloud Shellu spusťte az webapp deploy --type=lib pro každý soubor JAR ovladače:

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

Pokud jste vytvořili zdroj dat na úrovni serveru, restartujte aplikaci App Service Pro Linux. Tomcat resetuje CATALINA_BASE na /home/tomcat a používá aktualizovanou konfiguraci.

Windows

Instalaci Tomcat nelze přímo upravit pro konfiguraci na úrovni serveru, protože umístění instalace je jen pro čtení. Pokud chcete provést změny konfigurace na úrovni serveru v instalaci Windows Tomcat, nejjednodušší způsob, jak spustit aplikaci, je provést následující kroky:

1. Zkopírujte Tomcat do místního adresáře (%LOCAL_EXPANDED%) a použijte ho jako CATALINA_BASE (viz dokumentace k této proměnné Tomcat).
2. Přidejte své sdílené datové zdroje do %LOCAL_EXPANDED%\tomcat\conf\server.xml pomocí XSL transformace.

Přidání spouštěcího souboru

Vytvořte soubor s názvem startup.cmd v %HOME%\site\wwwroot adresáři. Tento soubor se spustí automaticky před spuštěním serveru Tomcat. Soubor by měl mít následující obsah:

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

Přidání konfiguračního skriptu PowerShellu

Dále do adresáře přidejte konfigurační skript configure.ps1%HOME%\site s následujícím kódem:

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

Tento PowerShell provede následující kroky:

1. Zkontrolujte, jestli už existuje vlastní kopie Tomcat. Pokud ano, spouštěcí skript může skončit tady.
2. Místně zkopírujte Tomcat.
3. Přidejte sdílené zdroje dat do vlastní konfigurace Tomcat pomocí transformace XSL.
4. Indikuje, že konfigurace byla úspěšně dokončena.

Přidání transformačního souboru XSL

Běžným případem použití pro přizpůsobení integrované instalace Tomcat je úprava konfiguračních server.xmlsouborů , context.xmlnebo web.xml Tomcat. Služba App Service už tyto soubory upravuje tak, aby poskytovaly funkce platformy. Pokud chcete tyto funkce dál používat, je důležité při provádění změn zachovat obsah těchto souborů. K tomu použijte transformaci XSL (XSLT).

Do adresáře %HOME%_\site přidejte transformační soubor XSL s názvem configure.ps1. K přidání nového uzlu konektoru do server.xml můžete použít následující kód transformace XSL. Transformace identity na začátku zachovává původní obsah konfiguračního souboru.

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

Nastavení CATALINA_BASE aplikace

Platforma také potřebuje vědět, kde je nainstalovaná vaše vlastní verze Tomcat. Umístění instalace můžete nastavit v CATALINA_BASE nastavení aplikace.

Toto nastavení můžete změnit pomocí Azure CLI:

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

Nebo můžete nastavení na webu Azure Portal změnit ručně:

1. Přejděte na Nastavení>konfigurační>aplikace.
2. Vyberte Nové nastavení aplikace.
3. K vytvoření nastavení použijte tyto hodnoty:
   1. Název: CATALINA_BASE
   2. Hodnota: "%LOCAL_EXPANDED%\tomcat"

Dokončení konfigurace

Nakonec umístíte JAR soubory ovladačů do classpath Tomcatu a restartujete App Service. Ujistěte se, že soubory ovladačů JDBC jsou k dispozici pro zavaděč tříd Tomcat jejich umístěním do adresáře /home/site/lib . V Cloud Shellu spusťte az webapp deploy --type=lib pro každý soubor JAR ovladače:

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

Návod

Kontejnery JBoss pro Linux můžou ve výchozím nastavení automaticky konfigurovat sdílené zdroje dat na serveru JBoss. Jediné, co je potřeba udělat, je přidat nastavení aplikace, které obsahuje platný připojovací řetězec JDBC k databázi Oracle, SQL Server, PostgreSQL nebo MySQL (včetně přihlašovacích údajů připojení) a přidat nastavení aplikace / prostředí proměnnou WEBSITE_AUTOCONFIGURE_DATABASE s hodnotou true. Podporují se také připojení JDBC vytvořená pomocí konektoru Service Connector. App Service automaticky přidá odpovídající sdílený zdroj dat (na základě názvu nastavení aplikace a přípony _DS) pomocí příslušného ovladače dostupného v kontejneru. Kompletní scénář, který používá tento přístup, najdete v tématu Kurz: Vytvoření webové aplikace JBoss se službou Azure App Service v Linuxu a MySQL.

Při registraci zdroje dat v JBoss EAP existují tři základní kroky:

1. Nahrajte ovladač JDBC.
2. Přidejte ovladač JDBC jako modul.
3. Přidejte zdroj dat pomocí modulu.

App Service je bezstavová hostitelská služba, takže tyto kroky musíte umístit do spouštěcího skriptu a spustit ji při každém spuštění kontejneru JBoss. Příklady použití PostgreSQL, MySQL a SQL Database:

PostgreSQL

Poznámka:

JBoss EAP ve službě App Service teď podporuje fakturaci byOL (Bring Your Own License), což zákazníkům se stávajícími předplatnými Red Hat umožňuje použít tyto licence přímo na nasazení EAP JBoss ve službě Azure App Service. Další informace.

1. Příkazy rozhraní příkazového řádku JBoss umístěte do souboru s názvem jboss-cli-commands.cli. Příkazy JBoss musí přidat modul a zaregistrovat ho jako zdroj dat. Následující příklad ukazuje příkazy rozhraní příkazového řádku JBoss pro vytvoření zdroje dat PostgreSQL s názvem java:jboss/datasources/postgresDSJNDI .

   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
   

   Všimněte si, že module add příkaz používá tři proměnné prostředí (DB_HOSTDB_USERNAMEa DB_PASSWORD), které musíte přidat do app Service jako nastavení aplikace. Skript je přidá bez příznaku --resolve-parameter-values, aby JBoss neuložil jejich hodnoty v prostém textu.

2. Vytvořte spouštěcí skript startup.sh, který volá příkazy rozhraní příkazového řádku JBoss. Následující příklad ukazuje, jak volat jboss-cli-commands.cli. Později nakonfigurujete službu App Service tak, aby při spuštění kontejneru spustila tento skript.

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

3. Pomocí možnosti nasazení podle vašeho výběru nahrajte ovladač JDBC, jboss-cli-commands.cli a startup.sh do cest zadaných v příslušných skriptech. Zejména nahrajte startup.sh jako spouštěcí soubor. Příklad:

   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
   

   Další informace najdete v tématu Nasazení souborů do služby App Service.

   Azure Maven plugin

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

   Kanály Azure

   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
   

Pokud chcete ověřit, že se zdroj dat přidal na server JBoss, připojte se přes SSH do webové aplikace a spusťte $JBOSS_HOME/bin/jboss-cli.sh --connect. Po připojení k JBoss spusťte /subsystem=datasources:read-resource příkaz pro tisk seznamu zdrojů dat.

Jak bylo dříve definováno v jboss-cli-commands.cli, můžete přistupovat k připojení PostgreSQL pomocí názvu JNDIjava:jboss/datasources/postgresDS.

MySQL

Poznámka:

JBoss EAP ve službě App Service teď podporuje fakturaci byOL (Bring Your Own License), což zákazníkům se stávajícími předplatnými Red Hat umožňuje použít tyto licence přímo na nasazení EAP JBoss ve službě Azure App Service. Další informace.

1. Příkazy rozhraní příkazového řádku JBoss umístěte do souboru s názvem jboss-cli-commands.cli. Příkazy JBoss musí přidat modul a zaregistrovat ho jako zdroj dat. Následující příklad ukazuje příkazy rozhraní příkazového řádku JBoss pro vytvoření zdroje dat MySQL s názvem java:jboss/datasources/mysqlDSJNDI .

   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
   

   Všimněte si, že module add příkaz používá tři proměnné prostředí (DB_HOSTDB_USERNAMEa DB_PASSWORD), které musíte přidat do app Service jako nastavení aplikace. Skript je přidá bez příznaku --resolve-parameter-values, aby JBoss neuložil jejich hodnoty v prostém textu.

2. Vytvořte spouštěcí skript startup.sh, který volá příkazy rozhraní příkazového řádku JBoss. Následující příklad ukazuje, jak volat jboss-cli-commands.cli. Později nakonfigurujete službu App Service tak, aby při spuštění kontejneru spustila tento skript.

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

3. Pomocí možnosti nasazení podle vašeho výběru nahrajte ovladač JDBC, jboss-cli-commands.cli a startup.sh do cest zadaných v příslušných skriptech. Zejména nahrajte startup.sh jako spouštěcí soubor. Příklad:

   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
   

   Další informace najdete v tématu Nasazení souborů do služby App Service.

   Azure Maven plugin

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

   Kanály Azure

   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
   

Pokud chcete ověřit, že se zdroj dat přidal na server JBoss, připojte se přes SSH do webové aplikace a spusťte $JBOSS_HOME/bin/jboss-cli.sh --connect. Po připojení k JBoss spusťte /subsystem=datasources:read-resource příkaz pro tisk seznamu zdrojů dat.

Jak bylo dříve definováno v jboss-cli-commands.cli, můžete přistupovat k připojení MySQL pomocí názvu JNDI java:jboss/datasources/mysqlDS.

SQL Database

Poznámka:

JBoss EAP ve službě App Service teď podporuje fakturaci byOL (Bring Your Own License), což zákazníkům se stávajícími předplatnými Red Hat umožňuje použít tyto licence přímo na nasazení EAP JBoss ve službě Azure App Service. Další informace.

1. Příkazy rozhraní příkazového řádku JBoss umístěte do souboru s názvem jboss-cli-commands.cli. Příkazy JBoss musí přidat modul a zaregistrovat ho jako zdroj dat. Následující příklad ukazuje příkazy rozhraní příkazového řádku JBoss pro vytvoření zdroje dat pro Azure SQL Database s názvem java:jboss/datasources/sqlDSJNDI .

   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
   

   Všimněte si, že module add příkaz používá tři proměnné prostředí (DB_HOSTDB_USERNAMEa DB_PASSWORD), které musíte přidat do app Service jako nastavení aplikace. Skript je přidá bez příznaku --resolve-parameter-values, aby JBoss neuložil jejich hodnoty v prostém textu.

2. Vytvořte spouštěcí skript startup.sh, který volá příkazy rozhraní příkazového řádku JBoss. Následující příklad ukazuje, jak volat jboss-cli-commands.cli. Později nakonfigurujete službu App Service tak, aby při spuštění kontejneru spustila tento skript.

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

3. Pomocí možnosti nasazení podle vašeho výběru nahrajte ovladač JDBC, jboss-cli-commands.cli a startup.sh do cest zadaných v příslušných skriptech. Zejména nahrajte startup.sh jako spouštěcí soubor. Příklad:

   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
   

   Další informace najdete v tématu Nasazení souborů do služby App Service.

   Azure Maven plugin

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

   Kanály Azure

   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
   

Pokud chcete ověřit, že se zdroj dat přidal na server JBoss, připojte se přes SSH do webové aplikace a spusťte $JBOSS_HOME/bin/jboss-cli.sh --connect. Po připojení k JBoss spusťte /subsystem=datasources:read-resource příkaz pro tisk seznamu zdrojů dat.

Jak bylo dříve definováno v jboss-cli-commands.cli, můžete přistupovat k připojení ke službě SQL Database pomocí názvu JNDI java:jboss/datasources/sqlDS.

Související obsah

Navštivte centrum Azure pro vývojáře v Javě, kde najdete rychlé starty, kurzy a referenční dokumentaci k Azure a Javě.

• Nejčastější dotazy k App Service Linuxu
• Referenční informace k proměnným prostředí a nastavením aplikace