Konfigurieren von Datenquellen für eine Tomcat-, JBoss- oder Java SE-App in Azure App Service

In diesem Artikel wird erläutert, wie Datenquellen in einer Java SE-, Tomcat- oder JBoss-App in App Service konfiguriert werden.

Azure App Service führt Java-Webanwendungen in drei Typen in einem vollständig verwalteten Dienst aus:

Java Standard Edition (SE). Java SE kann eine App ausführen, die als Java-Archivpaket (JAR) bereitgestellt wird, das einen eingebetteten Server enthält, z. B. Spring Boot, Aspxus, Dropwizard oder eine App mit einem eingebetteten Tomcat- oder Jetty-Server.
Tomcat. Der integrierte Tomcat-Server kann eine App ausführen, die als War-Paket (Web Application Archive) bereitgestellt wird.
JBoss Enterprise Application Platform (EAP): Der integrierte JBoss EAP-Server kann eine App ausführen, die als WAR- oder Enterprise-Archivpaket (EAR) bereitgestellt wird. Diese Option wird für Linux-Apps in einer Reihe von Preisstufen unterstützt, die free, Premium v3 und Isolated v2 enthalten.

Hinweis

JBoss EAP on App Service unterstützt jetzt die Bring Your Own License (BYOL)-Abrechnung. BYOL ermöglicht Kunden, die über vorhandene Red Hat-Abonnements verfügen, diese Lizenzen direkt auf ihre JBoss EAP-Bereitstellungen in Azure App Service anzuwenden. Weitere Informationen finden Sie unter BYOL-Support für JBoss EAP für App Service.

Konfigurieren der Datenquelle

Für das Verbinden mit Datenquellen in Spring Boot-Anwendungen wird empfohlen, Verbindungszeichenfolgen zu erstellen und in Ihre Datei application.properties einzufügen.

Wählen Sie im linken Bereich der Seite "App Service" Einstellungen>Umgebungsvariablen aus. Wählen Sie auf der Registerkarte "Verbindungszeichenfolgen" die Option "Hinzufügen" aus. Legen Sie einen Namen für die Zeichenfolge fest, fügen Sie Ihre JDBC-Verbindungszeichenfolge in das Feld Wert ein, und legen Sie den Typ auf Benutzerdefiniert fest. Optional können Sie die Verbindungszeichenfolge als Steckplatzeinstellung festlegen.

Die Verbindungszeichenfolge steht Ihrer Anwendung als Umgebungsvariable mit dem Namen CUSTOMCONNSTR_<your-string-name> zur Verfügung. Beispiel: CUSTOMCONNSTR_exampledb.
Verweisen Sie in der Datei "application.properties " auf die Verbindungszeichenfolge mit dem Namen der Umgebungsvariablen. Im vorherigen Beispiel würden Sie diesen Code verwenden:
```
app.datasource.url=${CUSTOMCONNSTR_exampledb}
```

Weitere Informationen finden Sie in der Spring Boot-Dokumentation zu Datenzugriff und externer Konfiguration.

Tipp

Linux Tomcat-Container können freigegebene Datenquellen automatisch auf dem Tomcat-Server konfigurieren, wenn Sie die Umgebungsvariable WEBSITE_AUTOCONFIGURE_DATABASE auf truefestlegen. Das Einzige, was Sie tun müssen, ist eine App-Einstellung hinzuzufügen, die eine gültige JDBC-Verbindungszeichenfolge zu einer Oracle-, SQL Server-, PostgreSQL- oder MySQL-Datenbank enthält (einschließlich der Verbindungsanmeldeinformationen). Der App-Dienst fügt automatisch die entsprechende freigegebene Datenbank zu /usr/local/tomcat/conf/context.xmlhinzu, wobei ein entsprechender Treiber verwendet wird, der im Container verfügbar ist. Ein End-to-End-Szenario, das diesen Ansatz verwendet, finden Sie im Lernprogramm: Erstellen einer Tomcat-Web-App mit Azure App Service unter Linux und MySQL.

Diese Anweisungen gelten für alle Datenbankverbindungen. Sie müssen Platzhalter durch den Treiberklassennamen und die JAR-Datei der ausgewählten Datenbank ersetzen. Die folgende Tabelle enthält Klassennamen und Treiberdownloads für allgemeine Datenbanken.

Datenbank	Treiberklassenname	JDBC-Treiber
PostgreSQL	`org.postgresql.Driver`	Herunterladen
MySQL	`com.mysql.jdbc.Driver`	Herunterladen ( Plattformunabhängig auswählen.)
SQL Server	`com.microsoft.sqlserver.jdbc.SQLServerDriver`	Herunterladen

Zum Konfigurieren von Tomcat für die Verwendung von Java Database Connectivity (JDBC) oder der Java Persistence API (JPA) passen Sie zuerst die Umgebungsvariable an, die von Tomcat zum Starten gelesen wird CATALINA_OPTS. Legen Sie diesen Wert mithilfe einer App-Einstellung im App Service Maven-Plug-In fest:

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

Oder legen Sie die Umgebungsvariable auf der Registerkarte "App-Einstellungen" der Seite "Umgebungsvariablen> im Azure-Portal fest.

Ermitteln Sie als Nächstes, ob die Datenquelle für eine Anwendung oder für alle Anwendungen verfügbar sein soll, die auf dem Tomcat-Servlet ausgeführt werden.

Datenquellen auf Anwendungsebene

So konfigurieren Sie eine Datenquelle auf Anwendungsebene:

Erstellen Sie eine context.xml-Datei im Verzeichnis META-INF/ Ihres Projekts. Erstellen Sie das Verzeichnis META-INF/, falls es noch nicht vorhanden ist.
Fügen Sie in context.xml ein Element vom Typ Context hinzu, um die Datenquelle mit einer JNDI-Adresse zu verknüpfen. Ersetzen Sie den driverClassName-Platzhalter durch den Klassennamen Ihres Treibers aus der Tabelle, die weiter oben in diesem Artikel angezeigt wird.
```
<Context>
    <Resource
        name="jdbc/dbconnection"
        type="javax.sql.DataSource"
        url="${connURL}"
        driverClassName="<insert your driver class name>"
        username="${dbuser}"
        password="${dbpassword}"
    />
</Context>
```

Aktualisieren Sie die Datei web.xml Ihrer Anwendung, sodass die Datenquelle in Ihrer Anwendung verwendet wird.

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

Gemeinsam verwendete Ressourcen auf Serverebene

Linux
Windows

Tipp

Linux Tomcat-Container können XSLT-Dateien automatisch anwenden, indem die folgende Konvention für Dateien verwendet wird, die in /home/site/wwwroot kopiert werden: Wenn server.xml.xsl oder server.xml.xslt vorhanden ist, werden die Dateien auf Tomcats server.xml angewendet. Wenn context.xml.xsl oder context.xml.xslt vorhanden ist, werden die Dateien auf Tomcats context.xml angewendet.

Zum Hinzufügen einer freigegebenen Datenquelle auf Serverebene müssen Sie die Tomcat-Konfiguration server.xml bearbeiten. Da Dateiänderungen außerhalb des /home Verzeichnisses kurzlebig sind, müssen Änderungen an den Konfigurationsdateien von Tomcat programmgesteuert angewendet werden:

Laden Sie ein Startskript hoch, und legen Sie den Pfad zum Skript in der Einstellungskonfiguration> fest. Fügen Sie auf der Registerkarte "Stapeleinstellungen " den Pfad im Befehlsfeld "Start" hinzu . Sie können das Startskript mithilfe von FTP hochladen.

Ihr Startskript erstellt eine XSL-Transformation in die server.xml Datei und gibt die resultierende XML-Datei in /usr/local/tomcat/conf/server.xml. Das Startskript sollte libxslt oder xlstproc installieren, abhängig von der Distribution der Version von Tomcat Ihrer Webanwendung, wie im Kommentar des folgenden Beispielskripts angegeben. Sie können FTP verwenden, um Ihre XSL-Datei und das Startskript hochzuladen.

# 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

Die folgende XSL-Beispieldatei fügt der Datei „server.xml“ von Tomcat einen neuen Connectorknoten hinzu.

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

Abschließen der Konfiguration

Platzieren Sie schließlich die Treiber-JARs im Tomcat-Klassenpfad, und starten Sie Ihre App Service-App neu.

Stellen Sie sicher, dass die JDBC-Treiberdateien für das Tomcat-Klassenladeprogramm verfügbar sind, indem Sie sie im Verzeichnis /home/site/lib ablegen. Führen Sie in Cloud Shell für jede Treiber-JAR-Datei az webapp deploy --type=lib aus:

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

Wenn Sie eine Datenquelle auf Serverebene erstellt haben, starten Sie die App Service-Linux-Anwendung neu. Tomcat setzt CATALINA_BASE auf /home/tomcat zurück und verwendet die aktualisierte Konfiguration.

Sie können eine Tomcat-Installation nicht direkt für die serverweite Konfiguration ändern, weil der Speicherort der Installation schreibgeschützt ist. Am einfachsten können Sie Konfigurationsänderungen auf Serverebene an Ihrer Windows Tomcat-Installation vornehmen, indem Sie die folgenden Schritte beim Starten der App ausführen:

Kopieren Sie Tomcat in ein lokales Verzeichnis (%LOCAL_EXPANDED%), und verwenden Sie diese Kopie als CATALINA_BASE. (Weitere Informationen finden Sie in der Dokumentation zu Tomcat für diese Variable).
Fügen Sie Ihre freigegebenen Datenquellen zu %LOCAL_EXPANDED%\tomcat\conf\server.xml mithilfe der XSL-Transformation hinzu.

Hinzufügen einer Startdatei

Erstellen Sie eine Datei namens startup.cmd im Verzeichnis %HOME%\site\wwwroot. Diese Datei wird automatisch ausgeführt, bevor der Tomcat-Server gestartet wird. Die Datei sollte folgendes enthalten:

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

Hinzufügen des PowerShell-Konfigurationsskripts

Fügen Sie als Nächstes ein Konfigurationsskript namens configure.ps1 in das %HOME%\site-Verzeichnis hinzu. Das Skript enthält diesen Code:

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

Diese PowerShell führt die folgenden Schritte aus:

Überprüfen Sie, ob eine benutzerdefinierte Tomcat-Kopie vorhanden ist. Falls vorhanden, kann das Startskript beendet werden.
Kopieren Sie Tomcat lokal.
Fügen Sie der Konfiguration des benutzerdefinierten Tomcat mithilfe der XSL-Transformation freigegebene Datenquellen hinzu.
Gibt an, dass die Konfiguration erfolgreich abgeschlossen wurde.

Hinzufügen der XSL-Transformationsdatei

Ein häufiger Anwendungsfall zum Anpassen der integrierten Tomcat-Installation ist das Ändern der Konfigurationsdateien server.xml, context.xml oder web.xml für Tomcat. App Service ändert diese Dateien bereits, um Plattformfunktionen zur Verfügung zu stellen. Um diese Features weiterhin verwenden zu können, müssen Sie den Inhalt dieser Dateien beibehalten, wenn Sie Änderungen daran vornehmen. Um diesen Inhalt beizubehalten, verwenden Sie eine XSL-Transformation (XSLT).

Fügen Sie dem %HOME%verzeichnis "_\site" eine XSL-Transformationsdatei namens "server.xsl" hinzu. Sie können den folgenden XSL-Transformationscode verwenden, um server.xml einen neuen Connectorknoten hinzuzufügen. Die Identitätstransformation am Anfang behält den ursprünglichen Inhalt der Konfigurationsdatei bei.

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

Festlegen der `CATALINA_BASE` App-Einstellung

Der Plattform muss auch bekannt sein, wo Ihre benutzerdefinierte Version von Tomcat installiert ist. Sie können den Speicherort der Installation in der CATALINA_BASE App-Einstellung festlegen.

Sie können die Azure CLI (Azure-Befehlszeilenschnittstelle) nutzen, um diese Einstellung zu ändern:

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

Alternativ können Sie die Einstellung im Azure-Portal manuell ändern:

Wechseln Sie zu Einstellungen>für Umgebungsvariablen>App-Einstellungen.
Klicken Sie auf Hinzufügen.
Verwenden Sie folgende Werte, um die Einstellung zu erstellen:
1. Name: CATALINA_BASE
2. Wert: "%LOCAL_EXPANDED%\tomcat"

Abschließen der Konfiguration

Platzieren Sie abschließend die JAR-Dateien des Treibers im Tomcat-Klassenpfad, und starten Sie Ihre App Service-Instanz neu. Stellen Sie sicher, dass die JDBC-Treiberdateien für das Tomcat-Klassenladeprogramm verfügbar sind, indem Sie sie im Verzeichnis /home/site/lib ablegen. Führen Sie in Cloud Shell für jede Treiber-JAR-Datei az webapp deploy --type=lib aus:

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

Tipp

Standardmäßig können Linux-JBoss-Container freigegebene Datenquellen automatisch auf dem JBoss-Server konfigurieren. Das einzige, was Sie tun müssen, ist das Hinzufügen einer App-Einstellung, die eine gültige SHAPE-Verbindungszeichenfolge zu einer Oracle-, SQL Server-, PostgreSQL- oder MySQL-Datenbank (einschließlich der Verbindungsanmeldeinformationen) enthält, und die App-Einstellungs-/Umgebungsvariable WEBSITE_AUTOCONFIGURE_DATABASE mit dem Wert truehinzufügen. JDBC-Verbindungen, die mit dem Service-Connector erstellt wurden, werden ebenfalls unterstützt. Der App-Dienst fügt automatisch die entsprechende freigegebene Datenquelle (basierend auf dem Namen der App-Einstellung und dem Suffix _DS) mithilfe eines geeigneten Treibers hinzu, der im Container verfügbar ist. Ein End-to-End-Szenario, das diesen Ansatz verwendet, finden Sie im Lernprogramm: Erstellen einer JBoss-Web-App mit Azure App Service unter Linux und MySQL.

Es gibt drei Hauptschritte zum Registrieren einer Datenquelle bei JBoss EAP:

Hochladen des JDBC-Treibers
Hinzufügen des JDBC-Treibers als Modul
Hinzufügen einer Datenquelle mit dem Modul

App Service ist ein zustandsloser Hostingdienst, daher müssen Sie diese Schritte in ein Startskript einfügen und jedes Mal ausführen, wenn der JBoss-Container gestartet wird. Hier sind Beispiele für PostgreSQL, MySQL und Azure SQL-Datenbank:

Hinweis

JBoss EAP on App Service unterstützt die Bring Your Own License (BYOL)-Abrechnung. BYOL ermöglicht Kunden, die über vorhandene Red Hat-Abonnements verfügen, diese Lizenzen direkt auf ihre JBoss EAP-Bereitstellungen in Azure App Service anzuwenden. Weitere Informationen finden Sie unter BYOL-Support für JBoss EAP.

Fügen Sie Ihre JBoss-CLI-Befehle in eine Datei mit dem Namen jboss-cli-commands.cli ein. Die JBoss-Befehle müssen das Modul hinzufügen und es als Datenquelle registrieren. Das folgende Beispiel zeigt die JBoss-CLI-Befehle zum Erstellen einer PostgreSQL-Datenquelle mit dem JNDI-Namen java:jboss/datasources/postgresDS.
```
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
```
Beachten Sie, dass der Befehl module add drei Umgebungsvariablen verwendet (DB_HOST, DB_USERNAMEund DB_PASSWORD), die Sie in App Service als App-Einstellungen hinzufügen müssen. Das Skript fügt sie ohne das --resolve-parameter-values-Flag hinzu, sodass JBoss ihre Werte nicht als Klartext speichert.
Erstellen Sie ein Startskript namens startup.sh, das die JBoss-CLI-Befehle aufruft. Das folgende Beispiel zeigt, wie Sie Die jboss-cli-commands.cli-Datei aufrufen. Später konfigurieren Sie App Service so, dass dieses Skript ausgeführt wird, wenn der Container gestartet wird.
```
$JBOSS_HOME/bin/jboss-cli.sh --connect --file=/home/site/scripts/jboss-cli-commands.cli
```

Laden Sie mit einer Bereitstellungsoption Ihrer Wahl den JDBC-Treiber (jboss-cli-commands.cli) und startup.shstartup.sh in die in den jeweiligen Skripts angegebenen Pfade hoch. Laden Sie startup.sh als Startdatei hoch. Zum Beispiel:

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

Weitere Informationen finden Sie unter Dateien im App Service bereitstellen.

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

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

Um zu bestätigen, dass die Datenquelle dem JBoss-Server hinzugefügt wurde, SSHen Sie in Ihre Web-App und geben Sie den Befehl $JBOSS_HOME/bin/jboss-cli.sh --connect ein. Nachdem Sie mit JBoss verbunden sind, führen Sie die Ausführung /subsystem=datasources:read-resource aus, um eine Liste der Datenquellen zu drucken.

Gemäß der Definition in jboss-cli-commands.cli können Sie mithilfe des JNDI-Namens java:jboss/datasources/postgresDSauf die PostgreSQL-Verbindung zugreifen.

Hinweis

Fügen Sie Ihre JBoss-CLI-Befehle in eine Datei mit dem Namen jboss-cli-commands.cli ein. Die JBoss-Befehle müssen das Modul hinzufügen und es als Datenquelle registrieren. Das folgende Beispiel zeigt die JBoss-CLI-Befehle zum Erstellen einer MySQL-Datenquelle mit dem JNDI-Namen java:jboss/datasources/mysqlDS.

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

Beachten Sie, dass der Befehl module add drei Umgebungsvariablen verwendet (DB_HOST, DB_USERNAMEund DB_PASSWORD), die Sie in App Service als App-Einstellungen hinzufügen müssen. Das Skript fügt sie ohne das --resolve-parameter-values-Flag hinzu, sodass JBoss ihre Werte nicht als Klartext speichert.

Erstellen Sie ein Startskript namens startup.sh, das die JBoss-CLI-Befehle aufruft. Das folgende Beispiel zeigt, wie Sie Die jboss-cli-commands.cli-Datei aufrufen. Später konfigurieren Sie App Service so, dass dieses Skript ausgeführt wird, wenn der Container gestartet wird.
```
$JBOSS_HOME/bin/jboss-cli.sh --connect --file=/home/site/scripts/jboss-cli-commands.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

Weitere Informationen finden Sie unter Dateien im App Service bereitstellen.

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

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

Um zu bestätigen, dass die Datenquelle dem JBoss-Server hinzugefügt ist, ssh auf Ihre Web-App und führen Sie $JBOSS_HOME/bin/jboss-cli.sh --connect aus. Nachdem Sie mit JBoss verbunden sind, führen Sie die Ausführung /subsystem=datasources:read-resource aus, um eine Liste der Datenquellen zu drucken.

Gemäß der Definition in jboss-cli-commands.cli können Sie mithilfe des JNDI-Namens java:jboss/datasources/mysqlDSauf die MySQL-Verbindung zugreifen.

Hinweis

JBoss EAP on App Service unterstützt die Bring Your Own License (BYOL)-Abrechnung. BYOL ermöglicht Es Kunden mit vorhandenen Red Hat-Abonnements, diese Lizenzen direkt auf ihre JBoss EAP-Bereitstellungen in Azure App Service anzuwenden. Weitere Informationen finden Sie unter BYOL-Support für JBoss EAP.

Fügen Sie Ihre JBoss-CLI-Befehle in eine Datei mit dem Namen jboss-cli-commands.cli ein. Die JBoss-Befehle müssen das Modul hinzufügen und es als Datenquelle registrieren. Das folgende Beispiel zeigt die JBoss CLI-Befehle zum Erstellen einer Datenquelle für eine Azure SQL-Datenbank mit dem JNDI-Namen java:jboss/datasources/sqlDS.

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

Erstellen Sie ein Startskript namens startup.sh, das die JBoss-CLI-Befehle aufruft. Das folgende Beispiel zeigt, wie Sie Die jboss-cli-commands.cli-Datei aufrufen. Später konfigurieren Sie App Service so, dass dieses Skript ausgeführt wird, wenn der Container gestartet wird.
```
$JBOSS_HOME/bin/jboss-cli.sh --connect --file=/home/site/scripts/jboss-cli-commands.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

Weitere Informationen finden Sie unter Dateien im App Service bereitstellen.

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

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

Um sich zu vergewissern, dass die Datenquelle dem JBoss-Server hinzugefügt wurde, stellen Sie eine SSH-Verbindung mit Ihrer Web-App her, und führen Sie $JBOSS_HOME/bin/jboss-cli.sh --connect aus. Nachdem Sie mit JBoss verbunden sind, führen Sie die Ausführung /subsystem=datasources:read-resource aus, um eine Liste der Datenquellen zu drucken.

Gemäß der Definition in jboss-cli-commands.cli können Sie mithilfe des JNDI-Namens java:jboss/datasources/sqlDS auf die SQL-Datenbankverbindung zugreifen.

Feedback

War diese Seite hilfreich?

Last updated on 2026-04-24

Konfigurieren von Datenquellen für eine Tomcat-, JBoss- oder Java SE-App in Azure App Service

Konfigurieren der Datenquelle

Datenquellen auf Anwendungsebene

Gemeinsam verwendete Ressourcen auf Serverebene

Abschließen der Konfiguration

Verwandte Inhalte

Feedback

Zusätzliche Ressourcen