Oefening: een web-app implementeren in Azure App Service

Voltooid

In deze les implementeert u uw Java Tomcat-web-app in Azure App Service.

Maven-invoegtoepassing voor Azure App Service

Microsoft biedt de Maven-invoegtoepassing voor Azure App Service, zodat Java-ontwikkelaars eenvoudiger toepassingen kunnen implementeren in Azure. Met deze invoegtoepassing kunt u uw toepassing eenvoudig configureren en implementeren in Azure. Gebruik de stappen in de volgende secties om de invoegtoepassing te configureren, uw broncode te compileren en uw app te implementeren.

De Maven-invoegtoepassing voor Azure App Service configureren

Voer de volgende stappen uit om de Maven-invoegtoepassing voor Azure App Service te configureren:

  1. Begin de configuratie met behulp van de volgende opdracht:

    mvn com.microsoft.azure:azure-webapp-maven-plugin:2.10.0:config
    
  2. Nadat u de opdracht hebt gebruikt, worden er enkele vragen weergegeven bij de prompt, zodat u verschillende opties kunt configureren. Configureer de opties en waarden op basis van de informatie in de volgende tabel:

    Artikel Invoerwaarde
    Abonnement Kies uw Azure-abonnement.
    Waarde definiëren voor het besturingssysteem Linux
    Waarde definiëren voor prijscategorie B1
    Waarde definiëren voor Java-versie Java 21
    Waarde definiëren voor runtimestack TOMCAT 10.0
    Bevestigen (Y/N) Ja

    Nadat u de opties hebt geconfigureerd, is de volgende uitvoer gebruikelijk:

    mvn com.microsoft.azure:azure-webapp-maven-plugin:2.10.0:config
    [INFO] Scanning for projects...
    [INFO]
    [INFO] -------------------< com.example:simple-tomcat-app >--------------------
    [INFO] Building simple-tomcat-app 1.0-SNAPSHOT
    [INFO]   from pom.xml
    [INFO] --------------------------------[ war ]---------------------------------
    [INFO]
    [INFO] --- azure-webapp:2.10.0:config (default-cli) @ simple-tomcat-app ---
    Downloading from central: https://repo.maven.apache.org/maven2/net/minidev/json-smart/maven-metadata.xml
    Downloading from ossrh: https://oss.sonatype.org/content/repositories/snapshots/net/minidev/json-smart/maven-metadata.xml
    Downloading from shibboleth-repo: https://build.shibboleth.net/nexus/content/repositories/releases/net/minidev/json-smart/maven-metadata.xml
    Downloaded from central: https://repo.maven.apache.org/maven2/net/minidev/json-smart/maven-metadata.xml (1.3 kB at 6.3 kB/s)
    Please choose which part to config [Application]:
    * 1: Application
      2: Runtime
      3: DeploymentSlot
    Enter your choice: 1
    Define value for appName [simple-tomcat-app]: tomcatmavendemo
    Define value for resourceGroup [tomcatmavendemo-rg]: MyResourceGroup
    Define value for region [{azure.region}]: centralus
    Define value for pricingTier [B1]:
    *  1: B1
       2: B2
       3: B3
       4: D1
       5: EP1
       6: EP2
       7: EP3
       8: F1
       9: P1v2
      10: P1v3
      11: P2v2
      12: P2v3
      13: P3v2
      14: P3v3
      15: S1
      16: S2
      17: S3
      18: Y1
    Enter your choice: 1
    Please confirm webapp properties
    AppName : tomcatmavendemo
    ResourceGroup : MyResourceGroup
    Region : centralus
    PricingTier : B1
    OS : Linux
    Java Version: 21
    Web server stack: Tomcat 10.1
    Deploy to slot : false
    Confirm (Y/N) [Y]: Y
    [INFO] Saving configuration to pom.
    [INFO] ------------------------------------------------------------------------
    [INFO] BUILD SUCCESS
    [INFO] ------------------------------------------------------------------------
    [INFO] Total time:  01:49 min
    [INFO] Finished at: 2024-11-07T09:54:55-08:00
    [INFO] ------------------------------------------------------------------------
    
  3. Het bestandpom.xml bevat nu een nieuwe sectie in de <plugins> sectie. Als u de naam van de resourcegroep, instantienaam of implementatielocatie wilt wijzigen, wijzigt u de waarden in de <resourceGroup>, <appName>of <region> elementen. In het volgende voorbeeld ziet u een typisch pom.xml bestand:

          <!-- Azure Web App Maven Plugin -->
    <plugin>
        <groupId>com.microsoft.azure</groupId>
        <artifactId>azure-webapp-maven-plugin</artifactId>
        <version>2.10.0</version>
        <configuration>
            <resourceGroup>MyResourceGroup</resourceGroup>
            <appName>tomcatmavendemo</appName>
            <region>centralus</region>
            <pricingTier>B1</pricingTier>
            <runtime>
                <os>linux</os>
                <javaVersion>21</javaVersion>
                <webContainer>Tomcat 10.1</webContainer>
            </runtime>
            <deployment>
                <resources>
                    <resource>
                        <directory>${project.build.directory}</directory>
                        <includes>
                            <include>*.war</include>
                        </includes>
                    </resource>
                </resources>
            </deployment>
        </configuration>
    </plugin>
    

Compileren en implementeren in Azure App Service

Nu u klaar bent met het configureren van de instellingen voor implementatie in Azure App Service, gebruikt u de volgende stappen om uw broncode te compileren en uw app te implementeren in Azure App Services:

  1. Compileer de broncode opnieuw met behulp van de volgende opdracht:

    mvn clean package
    
  2. Nadat de broncode is gecompileerd, gebruikt u de volgende opdracht om uw toepassing te implementeren:

    mvn azure-webapp:deploy
    

Wanneer de implementatie is voltooid, is de volgende uitvoer gebruikelijk:

[INFO] Successfully deployed the artifact to https://tomcatmavendemo.azurewebsites.net
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  06:55 min
[INFO] Finished at: 2024-11-07T10:05:19-08:00
[INFO] ------------------------------------------------------------------------

Zoals u ziet, biedt die uitvoer de openbare URL van de geïmplementeerde toepassing: Successfully deployed the artifact to https://tomcatmavendemo.azurewebsites.net.

Wanneer u naar de toepassing navigeert, ziet deze er ongeveer als volgt uit:

Schermopname van de geïmplementeerde web-app in een browser.

De logboekstroom bevestigen

Gebruik de volgende opdracht om toegang te krijgen tot de logboekstream:

az webapp log tail \
    --resource-group <your-resource-group> \
    --name <your-app-name>

De volgende uitvoer is gebruikelijk:

2024-11-07T18:14:37  Welcome, you are now connected to log-streaming service.
Starting Log Tail -n 10 of existing logs ----
/appsvctmp/volatile/logs/runtime/container.log
2024-11-07T18:06:05.3874260Z  java.base/java.lang.Thread.run(Thread.java:1583)
2024-11-07T18:06:05.5635356Z Nov 07, 2024 6:06:05 PM org.apache.coyote.AbstractProtocol stop
2024-11-07T18:06:05.5636042Z INFO: Stopping ProtocolHandler ["http-nio-127.0.0.1-80"]
2024-11-07T18:06:05.6020767Z Nov 07, 2024 6:06:05 PM org.apache.coyote.AbstractProtocol stop
2024-11-07T18:06:05.6021438Z INFO: Stopping ProtocolHandler ["http-nio-169.254.129.3-80"]
2024-11-07T18:06:05.6423756Z Nov 07, 2024 6:06:05 PM org.apache.coyote.AbstractProtocol destroy
2024-11-07T18:06:05.6424403Z INFO: Destroying ProtocolHandler ["http-nio-127.0.0.1-80"]
2024-11-07T18:06:05.6893602Z Nov 07, 2024 6:06:05 PM org.apache.coyote.AbstractProtocol destroy
2024-11-07T18:06:05.6894311Z INFO: Destroying ProtocolHandler ["http-nio-169.254.129.3-80"]
2024-11-07T18:06:05.7849816Z Done processing signal SIGTERM. Exiting now!
Ending Log Tail of existing logs ---
Starting Live Log Stream ---

Samenvatting van oefening

In deze les hebt u geleerd hoe u een Tomcat-web-app maakt met behulp van Maven. U hebt ook geleerd hoe u een servlet maakt en hoe het werkt. Vervolgens hebt u uw web-app lokaal geïmplementeerd met behulp van Tomcat. Ten slotte hebt u Azure App Service gedeployed zodat iedereen ter wereld er toegang toe heeft.