Snabbstart: Skapa en Java-app på Azure App Service
Azure App Service ger en mycket skalbar, självkorrigering av värdtjänsten för webbappar. Den här snabbstarten visar hur du använder Azure CLI med Plugin-programmet för Azure Web App för Maven för att distribuera en .jar-, .war- eller .ear-fil. Använd flikarna för att växla mellan Java SE-, Tomcat- och JBoss EAP-instruktioner.
Om Maven inte är det utvecklingsverktyg du föredrar kan du läsa våra liknande självstudier för Java-utvecklare:
Om du inte har en Azure-prenumeration kan du skapa ett kostnadsfritt Azure-konto innan du börjar.
1 – Använda Azure Cloud Shell
Azure är värd för Azure Cloud Shell, en interaktiv gränssnittsmiljö som du kan använda via webbläsaren. Du kan använda antingen Bash eller PowerShell med Cloud Shell för att arbeta med Azure-tjänster. Du kan använda Cloud Shell förinstallerade kommandon för att köra koden i den här artikeln utan att behöva installera något i din lokala miljö.
Så här startar du Azure Cloud Shell:
Alternativ | Exempel/länk |
---|---|
Välj Prova i det övre högra hörnet i ett kod- eller kommandoblock. Om du väljer Prova kopieras inte koden eller kommandot automatiskt för att Cloud Shell. | ![]() |
Gå till https://shell.azure.com eller Välj knappen Starta Cloud Shell för att öppna Cloud Shell i webbläsaren. | ![]() |
Välj knappen Cloud Shell på menyn längst upp till höger i Azure-portalen. | ![]() |
Så här använder du Azure Cloud Shell:
Starta Cloud Shell.
Välj knappen Kopiera i ett kodblock (eller kommandoblock) för att kopiera koden eller kommandot.
Klistra in koden eller kommandot i den Cloud Shell sessionen genom att välja Ctrl+Skift+V i Windows och Linux, eller genom att välja Cmd+Skift+V på macOS.
Välj Retur för att köra koden eller kommandot.
2 – Skapa en Java-app
Klona exempelprojektet och kolla in källkoden som körs med den här versionen av artikeln.
git clone https://github.com/Azure-Samples/app-service-java-quickstart
Ändra katalogen till det slutförda projektet och skapa från den översta nivån. Sedan cd
till underkatalogen för booty duke.
cd app-service-java-quickstart
git checkout 20230308
mvn clean install
cd booty-duke-app-service
3 – Konfigurera Plugin-programmet Maven
Tips
Maven-plugin-programmet stöder Java 17 och Tomcat 10.0. Mer information om den senaste supporten finns i Java 17 och Tomcat 10.0 finns på Azure App Service.
Distributionsprocessen för att Azure App Service använder dina Azure-autentiseringsuppgifter från Azure CLI automatiskt. Om Azure CLI inte installeras lokalt autentiseras Maven-plugin-programmet med Oauth eller enhetsinloggning. Mer information finns i autentisering med Maven-plugin-program.
Kör maven-kommandot som visas bredvid för att konfigurera distributionen. Det här kommandot hjälper dig att konfigurera App Service operativsystem, Java-version och Tomcat-version.
mvn com.microsoft.azure:azure-webapp-maven-plugin:2.9.0:config
Om du uppmanas att skapa en ny körningskonfiguration väljer du Y.
När du uppmanas med prenumerationsalternativet väljer du rätt
Subscription
genom att ange numret som skrivs ut i början av raden.När du uppmanas att använda alternativet Webbapp väljer du standardalternativet,
<create>
, genom att trycka på Retur.När du uppmanas att använda os-alternativet väljer du Linux genom att trycka på Retur.
När du uppmanas att använda javaVersion väljer du Java 17.
När du uppmanas att använda alternativet Prisnivå väljer du P1v2.
Tryck slutligen på Retur igen för att bekräfta dina val.
Please confirm webapp properties AppName : booty-duke-1678285507374 ResourceGroup : booty-duke-1678285507374-rg Region : centralus PricingTier : P1v2 OS : Linux Java Version: Java 17 Web server stack: Java SE Deploy to slot : false Confirm (Y/N) [Y]: Y [INFO] Saving configuration to pom. [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 01:03 min [INFO] Finished at: 2023-03-08T15:25:47+01:00 [INFO] ------------------------------------------------------------------------
Du kan ändra konfigurationerna för App Service direkt i din pom.xml
. Några vanliga konfigurationer visas nedan:
Egenskap | Krävs | Beskrivning | Version |
---|---|---|---|
<schemaVersion> |
falskt | Ange versionen av konfigurationsschemat. Värden som stöds är: v1 , v2 . |
1.5.2 |
<subscriptionId> |
falskt | Ange prenumerations-ID:t. | 0.1.0+ |
<resourceGroup> |
true | Azure-resursgrupp för din webbapp. | 0.1.0+ |
<appName> |
true | Namnet på din webbapp. | 0.1.0+ |
<region> |
falskt | Anger den region som ska vara värd för webbappen. standardvärdet är centralus. Alla giltiga regioner i avsnittet Regioner som stöds . | 0.1.0+ |
<pricingTier> |
falskt | Prisnivån för din webbapp. Standardvärdet är P1v2 för produktionsarbetsbelastningen, medan B2 är det rekommenderade minimivärdet för Java dev/test. Mer information finns i App Service prissättning | 0.1.0+ |
<runtime> |
falskt | Körningsmiljökonfigurationen. Mer information finns i Konfigurationsinformation. | 0.1.0+ |
<deployment> |
falskt | Distributionskonfigurationen. Mer information finns i Konfigurationsinformation. | 0.1.0+ |
En fullständig lista över konfigurationer finns i referensdokumentationen för plugin-programmet. Alla Azure Maven-plugin-program delar en gemensam uppsättning konfigurationer. Dessa konfigurationer finns i Vanliga konfigurationer. Konfigurationer som är specifika för App Service finns i Azure Web App: Konfigurationsinformation.
Var försiktig med värdena <appName>
för och <resourceGroup>
(helloworld-1590394316693
och helloworld-1590394316693-rg
därmed i demon), de används senare.
4 – Distribuera appen
När all konfiguration är klar i pom-filen kan du distribuera Java-appen till Azure med ett enda kommando.
När distributionen är klar är programmet redo på http://<appName>.azurewebsites.net/
(http://helloworld-1590394316693.azurewebsites.net
i demonstrationen). Öppna URL:en med din lokala webbläsare. Du bör se
Grattis! Du har distribuerat din första Java-app för att App Service.
5 – Rensa resurser
I de föregående stegen skapade du Azure-resurser i en resursgrupp. Om du inte behöver resurserna i framtiden tar du bort resursgruppen från portalen eller genom att köra följande kommando i Cloud Shell:
az group delete --name <your resource group name; for example: helloworld-1558400876966-rg> --yes
Det kan några minuter att köra kommandot.
Azure App Service ger en mycket skalbar, självkorrigering av värdtjänsten för webbappar. Den här snabbstarten visar hur du använder Azure CLI med Plugin-programmet azure web app för Maven för att distribuera en .jar-fil eller .war-fil. Använd flikarna för att växla mellan Java SE- och Tomcat-instruktioner.
Om Maven inte är det utvecklingsverktyg du föredrar kan du läsa våra liknande självstudier för Java-utvecklare:
Om du inte har en Azure-prenumeration kan du skapa ett kostnadsfritt Azure-konto innan du börjar.
1 – Använda Azure Cloud Shell
Azure är värd för Azure Cloud Shell, en interaktiv gränssnittsmiljö som du kan använda via webbläsaren. Du kan använda antingen Bash eller PowerShell med Cloud Shell för att arbeta med Azure-tjänster. Du kan använda Cloud Shell förinstallerade kommandon för att köra koden i den här artikeln utan att behöva installera något i din lokala miljö.
Så här startar du Azure Cloud Shell:
Alternativ | Exempel/länk |
---|---|
Välj Prova i det övre högra hörnet i ett kod- eller kommandoblock. Om du väljer Prova kopieras inte koden eller kommandot automatiskt för att Cloud Shell. | ![]() |
Gå till https://shell.azure.com eller Välj knappen Starta Cloud Shell för att öppna Cloud Shell i webbläsaren. | ![]() |
Välj knappen Cloud Shell på menyn längst upp till höger i Azure-portalen. | ![]() |
Så här använder du Azure Cloud Shell:
Starta Cloud Shell.
Välj knappen Kopiera i ett kodblock (eller kommandoblock) för att kopiera koden eller kommandot.
Klistra in koden eller kommandot i den Cloud Shell sessionen genom att välja Ctrl+Skift+V i Windows och Linux, eller genom att välja Cmd+Skift+V på macOS.
Välj Retur för att köra koden eller kommandot.
2 – Skapa en Java-app
Klona Spring Boot Komma igång-exempelprojektet.
git clone https://github.com/spring-guides/gs-spring-boot
Byt katalog till det slutförda projektet.
cd gs-spring-boot/complete
3 – Konfigurera Plugin-programmet Maven
Tips
Maven-plugin-programmet stöder Java 17 och Tomcat 10.0. Mer information om den senaste supporten finns i Java 17 och Tomcat 10.0 finns på Azure App Service.
I distributionsprocessen till Azure App Service används dina Azure-autentiseringsuppgifter från Azure CLI automatiskt. Om Azure CLI inte installeras lokalt autentiseras Maven-plugin-programmet med Oauth eller enhetsinloggning. Mer information finns i autentisering med Maven-plugin-program.
Kör nedanstående Maven-kommando för att konfigurera distributionen. Det här kommandot hjälper dig att konfigurera App Service operativsystem, Java-version och Tomcat-version.
mvn com.microsoft.azure:azure-webapp-maven-plugin:2.5.0:config
Om du uppmanas med alternativet Prenumeration väljer du rätt
Subscription
genom att ange numret som skrivs ut vid radstarten.När du uppmanas att använda alternativet Webbapp väljer du standardalternativet ,
<create>
genom att trycka på Retur.När du uppmanas att använda os-alternativet väljer du Windows.
När du uppmanas med javaVersion-alternativet väljer du Java 11.
När du uppmanas med alternativet Prisnivå väljer du P1v2.
Tryck slutligen på Retur igen för att bekräfta dina val.
Sammanfattningsutdata ser ut ungefär som kodfragmentet som visas nedan.
Please confirm webapp properties Subscription Id : ********-****-****-****-************ AppName : spring-boot-1599007390755 ResourceGroup : spring-boot-1599007390755-rg Region : centralus PricingTier : P1v2 OS : Windows Java : Java 11 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: 41.118 s [INFO] Finished at: 2020-09-01T17:43:45-07:00 [INFO] ------------------------------------------------------------------------
Du kan ändra konfigurationerna för App Service direkt i .pom.xml
Några vanliga konfigurationer visas nedan:
Egenskap | Krävs | Beskrivning | Version |
---|---|---|---|
<schemaVersion> |
falskt | Ange versionen av konfigurationsschemat. Värden som stöds är: v1 , v2 . |
1.5.2 |
<subscriptionId> |
falskt | Ange prenumerations-ID. | 0.1.0+ |
<resourceGroup> |
true | Azure-resursgrupp för din webbapp. | 0.1.0+ |
<appName> |
true | Namnet på webbappen. | 0.1.0+ |
<region> |
falskt | Anger den region där webbappen ska finnas. standardvärdet är centralus. Alla giltiga regioner i avsnittet Regioner som stöds . | 0.1.0+ |
<pricingTier> |
falskt | Prisnivån för din webbapp. Standardvärdet är P1v2 för produktionsarbetsbelastningen, medan B2 är det rekommenderade minimivärdet för Java dev/test. Mer information finns i App Service prissättning | 0.1.0+ |
<runtime> |
falskt | Körningsmiljökonfigurationen. Mer information finns i Konfigurationsinformation. | 0.1.0+ |
<deployment> |
falskt | Distributionskonfigurationen. Mer information finns i Konfigurationsinformation. | 0.1.0+ |
Var försiktig med värdena <appName>
för och <resourceGroup>
(helloworld-1590394316693
och helloworld-1590394316693-rg
därmed i demot) kommer de att användas senare.
4 – Distribuera appen
Med all konfiguration klar i pom-filen kan du distribuera din Java-app till Azure med ett enda kommando.
När distributionen är klar är programmet klart (http://<appName>.azurewebsites.net/
http://helloworld-1590394316693.azurewebsites.net
i demon). Öppna url:en med din lokala webbläsare. Du bör se
Grattis! Du har distribuerat din första Java-app för att App Service.
5 – Rensa resurser
I de föregående stegen skapade du Azure-resurser i en resursgrupp. Om du inte behöver resurserna i framtiden tar du bort resursgruppen från portalen eller genom att köra följande kommando i Cloud Shell:
az group delete --name <your resource group name; for example: helloworld-1558400876966-rg> --yes
Det kan några minuter att köra kommandot.
Azure App Service ger en mycket skalbar, självkorrigering av webbappens värdtjänst. Den här snabbstartsguiden visar hur du distribuerar en Java SE-app för att Azure App Service i Linux med hjälp av Azure Portal. Om du vill följa en snabbstart som distribuerar till Tomcat eller JBoss EAP väljer du något av Maven-alternativen ovan.
Den här snabbstarten konfigurerar en App Service-app på den kostnadsfria nivån och medför ingen kostnad för din Azure-prenumeration.
Den här snabbstarten visar hur du gör dessa ändringar i webbläsaren utan att behöva installera utvecklingsverktygen på datorn.
Du kan följa stegen här på en Mac-, Windows- eller Linux-dator. Det tar cirka fem minuter att slutföra självstudiekursen när de nödvändiga komponenterna har installerats.
För att slutföra den här snabbstarten behöver du:
- Ett Azure-konto med en aktiv prenumeration. Skapa ett konto utan kostnad.
- Ett GitHub-konto för att förgrena en lagringsplats.
1 – Förgrena exempellagringsplatsen
I webbläsaren navigerar du till lagringsplatsen som innehåller exempelkoden.
I det övre högra hörnet väljer du Förgrening.
På skärmen Skapa en ny förgrening bekräftar du fälten Ägare och Lagringsplatsnamn . Välj Skapa förgrening.
Anteckning
Detta bör ta dig till den nya förgreningen. Din förgrenings-URL ser ut ungefär så här:
https://github.com/YOUR_GITHUB_ACCOUNT_NAME/java-docs-spring-hello-world
2 – Skapa Azure-resurser och konfigurera distribution
Logga in på Azure Portal.
Skriv apptjänster i sökningen. Under Tjänster väljer du App Services.
På sidan App Services väljer du Skapa.
Fyll i sidan Skapa webbapp på följande sätt.
- Resursgrupp: Skapa en resursgrupp med namnet myResourceGroup.
- Namn: Ange ett globalt unikt namn för din webbapp.
- Publicera: Välj Kod.
- Körningsstack: Välj Java 11.
- Java-webbserverstack: Välj Java SE (Embedded Web Server).
- Operativsystem: Välj Linux.
- Region: Välj en Azure-region nära dig.
- App Service Plan: Skapa en App Service-plan med namnet myAppServicePlan.
Om du vill ändra nivån App Service plan väljer du Ändra storlek bredvid Sku och storlek.
I Specifikationsväljaren går du till fliken Produktion och väljer P1V3. Välj knappen Använd längst ned på sidan.
Välj knappen Granska + skapa längst ned på sidan.
När verifieringen har körts väljer du knappen Skapa längst ned på sidan. Då skapas en Azure-resursgrupp, en App Service-plan och en apptjänst.
När Azure-resurserna har skapats väljer du Gå till resurs.
I det vänstra navigeringsfönstret väljer du Distributionscenter.
Under Inställningar väljer du en källa. I den här snabbstarten väljer du GitHub.
I avsnittet under GitHub väljer du följande inställningar:
- Organisation: Välj din organisation.
- Lagringsplats: Välj java-docs-spring-hello-world.
- Gren: Välj huvud.
Välj Spara.
Tips
Den här snabbstarten använder GitHub. Ytterligare kontinuerliga distributionskällor är Bitbucket, Lokal Git, Azure Repos och Extern Git. FTPS är också en distributionsmetod som stöds.
När GitHub-integreringen har sparats väljer duÖversikts-URL>.
Java SE-exempelkoden körs i en Azure App Service Linux-webbapp.
Grattis! Du har distribuerat din första Java-app för att App Service med hjälp av Azure Portal.
3 – Uppdatera förgreningen i GitHub och distribuera ändringarna
Bläddra till din GitHub-förgrening av java-docs-spring-hello-world.
På lagringsplatsen trycker du på
.
för att starta Visual Studio Code i webbläsaren.Anteckning
URL:en ändras från GitHub.com till GitHub.dev. Den här funktionen fungerar bara med lagringsplatser som har filer. Detta fungerar inte på tomma lagringsplatser.
Gå till src/main/java/com/example/demo/DemoApplication.java.
Redigera sayHello-metoden så att den visar "Hello Azure!" i stället för "Hello World!"
@RequestMapping("/") String sayHello() { return "Hello Azure!"; }
I fönstret Källkontroll väljer du knappen Stegändringar för att mellanlagra ändringen.
Ange ett incheckningsmeddelande som
Hello Azure
. Välj sedan Checka in och skicka.När distributionen är klar går du tillbaka till webbläsarfönstret som öppnades när du skulle söka efter appen och klickar på knappen för att uppdatera sidan.
4 – Hantera din nya Azure-app
Gå till Azure Portal för att hantera den webbapp som du skapade. Sök efter och välj App Services.
Välj namnet på din Azure-app.
Webbappens översiktssida visas. Här kan du utföra grundläggande hanteringsuppgifter som Bläddra, Stoppa, Starta om och Ta bort.
Webbappmenyn innehåller olika alternativ för att konfigurera din app.
5 – Rensa resurser
När du är klar med exempelappen kan du ta bort alla resurser för appen från Azure. Det medför inga extra avgifter och din Azure-prenumeration är inte rensad. Om du tar bort resursgruppen tas även alla resurser i resursgruppen bort och det är det snabbaste sättet att ta bort alla Azure-resurser för din app.
På sidan App Service Översikt väljer du den resursgrupp som du skapade tidigare.
På resursgruppssidan väljer du Ta bort resursgrupp. Bekräfta namnet på resursgruppen för att slutföra borttagningen av resurserna.
Azure App Service ger en mycket skalbar, självkorrigering av webbappens värdtjänst. Den här snabbstartsguiden visar hur du distribuerar en Java SE-app för att Azure App Service i Windows med hjälp av Azure Portal. Om du vill följa en snabbstart som distribuerar till Tomcat eller JBoss EAP väljer du något av Maven-alternativen ovan.
Den här snabbstarten konfigurerar en App Service-app på den kostnadsfria nivån och medför ingen kostnad för din Azure-prenumeration.
Den här snabbstarten visar hur du gör dessa ändringar i webbläsaren utan att behöva installera utvecklingsverktygen på datorn.
Du kan följa stegen här på en Mac-, Windows- eller Linux-dator. Det tar cirka fem minuter att slutföra självstudiekursen när de nödvändiga komponenterna har installerats.
För att slutföra den här snabbstarten behöver du:
- Ett Azure-konto med en aktiv prenumeration. Skapa ett konto utan kostnad.
- Ett GitHub-konto för att förgrena en lagringsplats.
1 – Förgrena exempellagringsplatsen
I webbläsaren navigerar du till lagringsplatsen som innehåller exempelkoden.
Välj Förgrening i det övre högra hörnet.
På skärmen Skapa en ny förgrening bekräftar du fälten Ägare och Lagringsplatsnamn . Välj Skapa förgrening.
Anteckning
Detta bör ta dig till den nya förgreningen. Din förgrenings-URL ser ut ungefär så här:
https://github.com/YOUR_GITHUB_ACCOUNT_NAME/java-docs-spring-hello-world
2 – Distribuera till Azure
Logga in på Azure Portal.
Skriv apptjänster i sökningen. Under Tjänster väljer du App Services.
På sidan App Services väljer du Skapa.
Fyll i sidan Skapa webbapp på följande sätt.
- Resursgrupp: Skapa en resursgrupp med namnet myResourceGroup.
- Namn: Ange ett globalt unikt namn för din webbapp.
- Publicera: Välj Kod.
- Körningsstack: Välj Java 11.
- Java-webbserverstack: Välj Java SE (Embedded Web Server).
- Operativsystem: Välj Windows.
- Region: Välj en Azure-region nära dig.
- App Service Plan: Skapa en App Service-plan med namnet myAppServicePlan.
Om du vill ändra App Service plannivå väljer du Ändra storlek bredvid SKU och storlek.
I Specifikationsväljaren går du till fliken Produktion och väljer P1V3. Välj knappen Använd längst ned på sidan.
Välj avsnittet Distribution . Under GitHub Actions inställningar för Kontinuerlig distribution väljer du Aktivera.
I avsnittet under GitHub Actions information väljer du följande inställningar:
- GitHub-konto: Logga in på ditt GitHub-konto.
- Organisation: Välj din organisation.
- Lagringsplats: Välj java-docs-spring-hello-world.
- Gren: Välj main.
Välj knappen Granska + skapa längst ned på sidan.
När verifieringen har körts väljer du knappen Skapa längst ned på sidan. Då skapas en Azure-resursgrupp, en App Service-plan och en App Service.
När resurserna har skapats väljer du Gå till resurs. På sidan skapad App Service väljer du Översikts-URL>.
Java SE-exempelkoden körs i en Azure App Service Linux-webbapp.
Grattis! Du har distribuerat din första Java-app för att App Service med hjälp av Azure Portal.
3 – Uppdatera i GitHub och distribuera om koden
Bläddra till din GitHub-förgrening av java-docs-spring-hello-world.
På lagringsplatsen trycker du på
.
för att starta Visual Studio Code i webbläsaren.Anteckning
URL:en ändras från GitHub.com till GitHub.dev. Den här funktionen fungerar bara med lagringsplatser som har filer. Detta fungerar inte på tomma lagringsplatser.
Gå till src/main/java/com/example/demo/DemoApplication.java.
Redigera metoden sayHello så att den visar "Hello Azure!" i stället för "Hello World!"
@RequestMapping("/") String sayHello() { return "Hello Azure!"; }
I fönstret Källkontroll väljer du knappen Fasändringar för att mellanlagra ändringen.
Ange ett incheckningsmeddelande, till exempel
Hello Azure
. Välj sedan Commit and Push (Genomför och push-överför).När distributionen är klar går du tillbaka till webbläsarfönstret som öppnades när du skulle söka efter appen och klickar på knappen för att uppdatera sidan.
4 – Hantera din nya Azure-app
Gå till Azure Portal för att hantera den webbapp som du skapade. Sök efter och välj App Services.
Välj namnet på din Azure-app.
Webbappens översiktssida visas. Här kan du utföra grundläggande hanteringsuppgifter som Bläddra, Stoppa, Starta om och Ta bort.
Webbappmenyn innehåller olika alternativ för att konfigurera din app.
5 – Rensa resurser
När du är klar med exempelappen kan du ta bort alla resurser för appen från Azure. Det medför inga extra avgifter och din Azure-prenumeration är inte rensad. Om du tar bort resursgruppen tas även alla resurser i resursgruppen bort och är det snabbaste sättet att ta bort alla Azure-resurser för din app.
På sidan App Service Översikt väljer du den resursgrupp som du skapade tidigare.
På resursgruppssidan väljer du Ta bort resursgrupp. Bekräfta namnet på resursgruppen för att slutföra borttagningen av resurserna.