Sdílet prostřednictvím


Rychlý start: Vytvoření aplikace v Javě ve službě Aplikace Azure Service

Azure App Service poskytuje vysoce škálovatelnou službu pro hostování webových aplikací s automatickými opravami. V tomto rychlém startu použijete modul plug-in Maven pro Azure App Service Web Apps k nasazení webové aplikace Java na server Tomcat s Linuxem ve službě Azure App Service.

Pokud maven není vaším upřednostňovaným vývojářskými nástroji, podívejte se na podobné články pro vývojáře v Javě:

Požadavky

  • Pokud nemáte účet Azure, vytvořte si bezplatný účet před tím, než začnete.

  • Spuštění příkazů v tomto rychlém startu pomocí Azure Cloud Shellu, interaktivního prostředí, které můžete použít v prohlížeči pro práci se službami Azure. Použití Cloud Shellu:

    1. Vyberte následující tlačítko Spustit Cloud Shell nebo přejděte na https://shell.azure.com pro otevření Cloud Shell v prohlížeči.

    2. V případě potřeby se přihlaste k Azure a ujistěte se, že jste v prostředí Bash služby Cloud Shell.

    3. Vyberte Kopírovat v bloku kódu, vložte ho do Cloud Shellu a spusťte ho.

Vytvoření aplikace v Javě

Spuštěním následujícího příkazu Maven v Cloud Shellu vytvořte novou aplikaci s názvem helloworld:

mvn archetype:generate "-DgroupId=example.demo" "-DartifactId=helloworld" "-DarchetypeArtifactId=maven-archetype-webapp" "-DarchetypeVersion=1.4" "-Dversion=1.0-SNAPSHOT"

Potom změňte pracovní adresář na složku projektu spuštěním cd helloworldpříkazu .

Konfigurace modulu plug-in Maven

Proces nasazení služby App Service používá vaše přihlašovací údaje Azure z Cloud Shellu automaticky. Modul plug-in Maven se ověřuje pomocí OAuth nebo přihlášení zařízení. Další informace najdete v tématu Ověřování.

Spuštěním následujícího příkazu Mavenu nakonfigurujte nasazení nastavením operačního systému služby App Service, verze Javy a verze Tomcat.

mvn com.microsoft.azure:azure-webapp-maven-plugin:2.14.1:config
  1. V části Vytvořit novou konfiguraci spuštění zadejte Y a stiskněte Enter.
  2. Definovat hodnotu pro OS zadejte 2 pro Linux a stiskněte Enter.
  3. Jako hodnotu Define pro javaVersion zadejte 1 pro Javu 21 a stiskněte Enter.
  4. Jako hodnotu Define pro webContainer zadejte 1 pro Tomcat 10.1 a stiskněte Enter.
  5. Jako definovanou hodnotu pro pricingTier zadejte 3 pro P1V2 a poté stiskněte Enter.
  6. Potvrďte tak, že zadáte Y a pak stisknete Enter.

Výstup by měl vypadat podobně jako následující kód:

Please confirm webapp properties
AppName : helloworld-1745408005556
ResourceGroup : helloworld-1745408005556-rg
Region : centralus
PricingTier : P1V2
OS : Linux
Java Version: Java 21
Web server stack: Tomcat 10.1
Deploy to slot : false
Confirm (Y/N) [Y]: 
[INFO] Saving configuration to pom.
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  01:36 min
[INFO] Finished at: 2025-04-23T11:34:44Z
[INFO] ------------------------------------------------------------------------

Po potvrzení vašich voleb plugin přidá příslušný prvek a požadovaná nastavení do souboru pom.xml ve vašem projektu, což nakonfiguruje spuštění webové aplikace ve službě App Service.

Relevantní část souboru pom.xml by měla vypadat podobně jako v následujícím příkladu.

<build>
    <plugins>
        <plugin>
            <groupId>com.microsoft.azure</groupId>
            <artifactId>>azure-webapp-maven-plugin</artifactId>
            <version>x.xx.x</version>
            <configuration>
                <schemaVersion>v2</schemaVersion>
                <resourceGroup>helloworld-1745408005556-rg</resourceGroup>
                <appName>helloworld-1745408005556</appName>
            ...
            </configuration>
        </plugin>
    </plugins>
</build>

Hodnoty pro <appName> a <resourceGroup>, helloworld-1745408005556 a helloworld-1745408005556-rg pro ukázkovou aplikaci, se použijí později.

Konfigurace služby App Service můžete upravit přímo v souborupom.xml .

Nasazení aplikace

S veškerou konfigurací připravenou v souboru pom.xml můžete nasadit aplikaci v Javě do Azure pomocí následujícího jediného příkazu.

mvn package azure-webapp:deploy

Jakmile vyberete ze seznamu dostupných předplatných, Maven se nasadí do Služby Azure App Service. Po dokončení nasazení je vaše aplikace připravená.

Pro tuto ukázku je adresa URL http://helloworld-1745408005556.azurewebsites.net. Když otevřete adresu URL v místním webovém prohlížeči, měla by se zobrazit následující aplikace:

Snímek obrazovky webové aplikace Maven Hello World spuštěné ve službě Aplikace Azure Service

Blahopřejeme! Nasadili jste aplikaci v Javě do služby App Service.

Vyčistěte zdroje

Prostředky pro tento kurz jste vytvořili ve skupině prostředků Azure. Pokud už je nepotřebujete, můžete odstranit skupinu prostředků a všechny její prostředky spuštěním následujícího příkazu Azure CLI v Cloud Shellu.

az group delete --name helloworld-1745408005556-rg --yes

Spuštění příkazu může chvíli trvat.

Azure App Service poskytuje vysoce škálovatelnou službu pro hostování webových aplikací s automatickými opravami. V tomto rychlém startu pomocí modulu plug-in Maven pro Azure App Service Web Apps nasadíte webovou aplikaci Java s vloženým serverem Spring Boot, Quarkus nebo Tomcat do služby App Service. Další informace najdete v tématu azure-webapp-maven-plugin.

Pokud maven není vaším upřednostňovaným vývojářskými nástroji, podívejte se na podobné články pro vývojáře v Javě:

Požadavky

  • Pokud nemáte účet Azure, vytvořte si bezplatný účet před tím, než začnete.

  • Spuštění příkazů v tomto rychlém startu pomocí Azure Cloud Shellu, interaktivního prostředí, které můžete použít v prohlížeči pro práci se službami Azure. Použití Cloud Shellu:

    1. Vyberte následující tlačítko Spustit Cloud Shell nebo přejděte na https://shell.azure.com pro otevření Cloud Shell v prohlížeči.

    2. V případě potřeby se přihlaste k Azure a ujistěte se, že jste v prostředí Bash služby Cloud Shell.

    3. Vyberte Kopírovat v bloku kódu, vložte ho do Cloud Shellu a spusťte ho.

Získání ukázkové aplikace

Zvolte příslušnou kartu a podle pokynů získejte ukázkovou webovou aplikaci Spring Boot, Quarkus nebo Embedded Tomcat.

Stáhněte a extrahujte výchozí šablonu webové aplikace Spring Boot nebo ji naklonujte spuštěním následujícího příkazu. Spuštěním příkazu spring boot new my-webapp také naklonujete webovou aplikaci.

git clone https://github.com/rd-1-2022/rest-service my-webapp

Potom změňte pracovní adresář na složku projektu spuštěním cd my-webapppříkazu .

Konfigurace modulu plug-in Maven

Proces nasazení služby App Service používá vaše přihlašovací údaje Azure z Cloud Shellu automaticky. Modul plug-in Maven se ověřuje pomocí OAuth nebo přihlášení zařízení. Další informace najdete v tématu Ověřování.

Spuštěním následujícího příkazu Mavenu nakonfigurujte nasazení nastavením operačního systému služby App Service a verze Javy.

mvn com.microsoft.azure:azure-webapp-maven-plugin:2.14.1:config
  1. V části Vytvořit novou konfiguraci spuštění zadejte Y a stiskněte Enter.
  2. Definovat hodnotu pro OS zadejte 2 pro Linux a stiskněte Enter.
  3. Jako hodnotu Define pro javaVersion zadejte 1 pro Javu 21 a stiskněte Enter.
  4. Zadejte hodnotu pro pricingTier ve výši 3 pro P1v2 a stiskněte Enter.
  5. Potvrďte tak, že zadáte Y a pak stisknete Enter.

Výstup by měl vypadat podobně jako následující kód:

Please confirm webapp properties
AppName : <generated-app-name>
ResourceGroup : <generated-app-name>-rg
Region : centralus
PricingTier : P1v2
OS : Linux
Java Version: Java 21
Web server stack: Java SE
Deploy to slot : false
Confirm (Y/N) [Y]: 
[INFO] Saving configuration to pom.
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  47.533 s
[INFO] Finished at: 2025-04-23T12:20:08Z
[INFO] ------------------------------------------------------------------------

Po potvrzení vašich voleb plugin přidá příslušný prvek a požadovaná nastavení do souboru pom.xml ve vašem projektu, což nakonfiguruje spuštění webové aplikace ve službě App Service.

Relevantní část souboru pom.xml by měla vypadat podobně jako v následujícím příkladu.

<build>
    <plugins>
        <plugin>
            <groupId>com.microsoft.azure</groupId>
            <artifactId>>azure-webapp-maven-plugin</artifactId>
            <version>x.xx.x</version>
            <configuration>
                <schemaVersion>v2</schemaVersion>
                <resourceGroup>generated-app-name-rg</resourceGroup>
                <appName>generated-app-name</appName>
            ...
            </configuration>
        </plugin>
    </plugins>
</build>

Hodnoty pro <appName> a <resourceGroup> jsou použity později.

Konfigurace služby App Service můžete upravit přímo v souborupom.xml .

Nasazení aplikace

Se všemi konfiguracemi připravenými v souborupom.xml můžete aplikaci v Javě nasadit do Azure.

  1. Pomocí následujícího příkazu sestavte soubor JAR.

     mvn clean package
    

    Návod

    Spring Boot vytvoří dva soubory JAR, mvn package, ale azure-webapp-maven-plugin vybere správný soubor JAR pro automatické nasazení.

  2. Nasaďte aplikaci do Azure pomocí následujícího příkazu:

    mvn azure-webapp:deploy
    

    Jakmile vyberete ze seznamu dostupných předplatných, Maven se nasadí do Služby Azure App Service. Po dokončení nasazení je vaše aplikace připravená a zobrazí se následující výstup:

    [INFO] Successfully deployed the artifact to <URL>
    [INFO] ------------------------------------------------------------------------
    [INFO] BUILD SUCCESS
    [INFO] ------------------------------------------------------------------------
    [INFO] Total time:  02:20 min
    [INFO] Finished at: 2023-07-26T12:47:50Z
    [INFO] ------------------------------------------------------------------------
    
  3. Otevřete výchozí doménu aplikace ze stránky Přehled v portálu Azure a připojte /greeting k adrese URL. Měla by se zobrazit následující aplikace:

    Snímek obrazovky webové aplikace Spring Boot Hello World spuštěné ve službě Aplikace Azure Service

Blahopřejeme! Nasadili jste aplikaci v Javě do služby App Service.

Vyčistěte zdroje

Prostředky pro tento kurz jste vytvořili ve skupině prostředků Azure. Pokud už je nepotřebujete, můžete odstranit skupinu prostředků a všechny její prostředky spuštěním následujícího příkazu Azure CLI v Cloud Shellu.

az group delete --name <resource group name>  --yes

Například spusťte az group delete --name quarkus-hello-azure-1690375364238-rg --yespříkaz . Spuštění tohoto příkazu může chvíli trvat.

Azure App Service poskytuje vysoce škálovatelnou službu pro hostování webových aplikací s automatickými opravami. V tomto rychlém startu použijete modul plug-in Maven pro Azure App Service Web Apps k nasazení webové aplikace Java na server JBoss EAP s Linuxem ve službě Azure App Service.

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.

Pokud maven není vaším upřednostňovaným vývojářskými nástroji, podívejte se na podobné články pro vývojáře v Javě:

Požadavky

  • Pokud nemáte účet Azure, vytvořte si bezplatný účet před tím, než začnete.

  • Spuštění příkazů v tomto rychlém startu pomocí Azure Cloud Shellu, interaktivního prostředí, které můžete použít v prohlížeči pro práci se službami Azure. Použití Cloud Shellu:

    1. Vyberte následující tlačítko Spustit Cloud Shell nebo přejděte na https://shell.azure.com pro otevření Cloud Shell v prohlížeči.

    2. V případě potřeby se přihlaste k Azure a ujistěte se, že jste v prostředí Bash služby Cloud Shell.

    3. Vyberte Kopírovat v bloku kódu, vložte ho do Cloud Shellu a spusťte ho.

Vytvoření aplikace v Javě

  1. Naklonujte ukázkovou aplikaci Pet Store.

    git clone https://github.com/Azure-Samples/app-service-java-quickstart
    
  2. Změňte adresář na dokončený petstore-ee7 projekt a sestavte ho.

    cd app-service-java-quickstart
    git checkout 20230308
    cd petstore-ee7
    mvn clean install
    

    Pokud se zobrazí zpráva o tom, že je v odpojeném stavu HEAD, můžete ji ignorovat. V tomto rychlém startu neprovádíte žádné potvrzení Gitu, takže je vhodné odpojit stav HEAD.

    Návod

    Ukázka petstore-ee7 vyžaduje Javu 11 nebo novější. Ukázkový booty-duke-app-service projekt vyžaduje Javu 17. Pokud je nainstalovaná verze Javy menší než 17, spusťte sestavení z adresáře petstore-ee7 místo z nejvyšší úrovně adresářové struktury.

Konfigurace modulu plug-in Maven

Proces nasazení služby App Service používá vaše přihlašovací údaje Azure z Cloud Shellu automaticky. Modul plug-in Maven se ověřuje pomocí OAuth nebo přihlášení zařízení. Další informace najdete v tématu Ověřování.

Spuštěním následujícího příkazu Mavenu nakonfigurujte nasazení nastavením operačního systému služby App Service, verze Javy a verze Jbosseap.

mvn com.microsoft.azure:azure-webapp-maven-plugin:2.14.1:config
  1. V části Vytvořit novou konfiguraci spuštění zadejte Y a stiskněte Enter.
  2. Definovat hodnotu pro OS zadejte 2 pro Linux a stiskněte Enter.
  3. Jako hodnotu Define pro javaVersion zadejte 2 pro Javu 17 a stiskněte Enter. Pokud vyberete Javu 21, možnost Jbosseap se později nezobrazí.
  4. Jako hodnotu Define pro webContainer zadejte 4 pro Jbosseap 7 a stiskněte Enter.
  5. Definujte hodnotu pro pricingTier, zadejte 1 pro P1v3 a stiskněte Enter.
  6. Potvrďte tak, že zadáte Y a pak stisknete Enter.

Výstup by měl vypadat podobně jako následující kód:

Please confirm webapp properties
AppName : petstoreee7-1745409173307
ResourceGroup : petstoreee7-1745409173307-rg
Region : centralus
PricingTier : P1v3
OS : Linux
Java Version: Java 17
Web server stack: Jbosseap 4
Deploy to slot : false
Confirm (Y/N) [Y]: 
[INFO] Saving configuration to pom.
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  01:36 min
[INFO] Finished at: 2025-04-23T11:54:22Z
[INFO] ------------------------------------------------------------------------

Po potvrzení vašich voleb plugin přidá příslušný prvek a požadovaná nastavení do souboru pom.xml ve vašem projektu, což nakonfiguruje spuštění webové aplikace ve službě App Service.

Relevantní část souboru pom.xml by měla vypadat podobně jako v následujícím příkladu.

<build>
    <plugins>
        <plugin>
            <groupId>com.microsoft.azure</groupId>
            <artifactId>>azure-webapp-maven-plugin</artifactId>
            <version>x.xx.x</version>
            <configuration>
                <schemaVersion>v2</schemaVersion>
                <resourceGroup>petstoreee7-1745409173307-rg</resourceGroup>
                <appName>petstoreee7-1745409173307</appName>
            ...
            </configuration>
        </plugin>
    </plugins>
</build>

Hodnoty pro <appName> a <resourceGroup>, petstoreee7-1745409173307 a petstoreee7-1745409173307-rg v ukázkové aplikaci se použijí později.

Konfigurace služby App Service můžete upravit přímo v souborupom.xml .

Nasazení aplikace

Se všemi konfiguracemi připravenými v souborupom.xml můžete aplikaci v Javě nasadit do Azure pomocí následujícího jediného příkazu.

# Disable testing, as it requires Wildfly to be installed locally.
mvn package azure-webapp:deploy -DskipTests

Jakmile vyberete ze seznamu dostupných předplatných, Maven se nasadí do Služby Azure App Service. Po dokončení nasazení je vaše aplikace připravená.

Pro tato ukázková aplikace je adresa URL http://petstoreee7-1745409173307.azurewebsites.net. Když otevřete adresu URL v místním webovém prohlížeči, měla by se zobrazit následující aplikace:

Snímek obrazovky webové aplikace Maven Hello World spuštěné ve službě Aplikace Azure Service

Blahopřejeme! Nasadili jste aplikaci v Javě do služby App Service.

Vyčistěte zdroje

Prostředky pro tento kurz jste vytvořili ve skupině prostředků Azure. Pokud už je nepotřebujete, můžete odstranit skupinu prostředků a všechny její prostředky spuštěním následujícího příkazu Azure CLI v Cloud Shellu.

az group delete --name petstoreee7-1745409173307-rg  --yes

Spuštění příkazu může chvíli trvat.