Quickstart: Uw eerste toepassing implementeren in Azure Spring Apps
Artikel
Notitie
De Basic-, Standard- en Enterprise-abonnementen worden afgeschaft vanaf medio maart 2025, met een pensioenperiode van 3 jaar. We raden u aan om over te stappen naar Azure Container Apps. Zie de aankondiging over buitengebruikstelling van Azure Spring Apps voor meer informatie.
In dit artikel wordt uitgelegd hoe u een kleine toepassing implementeert die kan worden uitgevoerd in Azure Spring Apps.
De toepassingscode die in deze zelfstudie wordt gebruikt, is een eenvoudige app. Wanneer u dit voorbeeld hebt voltooid, is de toepassing online toegankelijk en kunt u deze beheren via Azure Portal.
Dit artikel bevat de volgende opties voor implementatie in Azure Spring Apps:
De optie Azure Portal is de eenvoudigste en snelste manier om resources te maken en toepassingen met één klik te implementeren. Deze optie is geschikt voor Spring-ontwikkelaars die snel toepassingen willen implementeren in Azure-cloudservices.
De optie Azure Portal + Maven-invoegtoepassing is een conventionelere manier om resources te maken en toepassingen stap voor stap te implementeren. Deze optie is geschikt voor Spring-ontwikkelaars die azure-cloudservices voor het eerst gebruiken.
De Azure Developer CLI-optie is een efficiëntere manier om automatisch resources te maken en toepassingen te implementeren via eenvoudige opdrachten. De Azure Developer CLI maakt gebruik van een sjabloon om de Benodigde Azure-resources in te richten en de toepassingscode te implementeren. Deze optie is geschikt voor Spring-ontwikkelaars die bekend zijn met Azure-cloudservices.
De optie Azure Portal is de eenvoudigste en snelste manier om resources te maken en toepassingen met één klik te implementeren. Deze optie is geschikt voor Spring-ontwikkelaars die snel toepassingen willen implementeren in Azure-cloudservices.
De optie Azure Portal + Maven-invoegtoepassing is een conventionelere manier om resources te maken en toepassingen stap voor stap te implementeren. Deze optie is geschikt voor Spring-ontwikkelaars die azure-cloudservices voor het eerst gebruiken.
De Azure CLI-optie maakt gebruik van een krachtig opdrachtregelprogramma voor het beheren van Azure-resources. Deze optie is geschikt voor Spring-ontwikkelaars die bekend zijn met Azure-cloudservices.
De optie IntelliJ maakt gebruik van een krachtige Java IDE om eenvoudig Azure-resources te beheren. Deze optie is geschikt voor Spring-ontwikkelaars die bekend zijn met Azure-cloudservices en IntelliJ IDEA.
De optie Visual Studio Code maakt gebruik van een lichtgewicht maar krachtige broncode-editor, waarmee u eenvoudig Azure-resources kunt beheren. Deze optie is geschikt voor Spring-ontwikkelaars die bekend zijn met Azure-cloudservices en Visual Studio Code.
Met de knop Implementeren naar Azure in de volgende sectie wordt een Azure Portal-ervaring gestart waarmee een JAR-pakket wordt gedownload van de releasepagina spring-cloud-azure-tools op GitHub. Er zijn geen lokale voorbereidingsstappen nodig.
Gebruik de volgende stappen om het project voor te bereiden:
In de volgende lijst worden de opdrachteninteracties beschreven:
OAuth2-aanmelding: u moet de aanmelding bij Azure autoriseren op basis van het OAuth2-protocol.
Geef een nieuwe omgevingsnaam op: Geef een omgevingsnaam op, die wordt gebruikt als achtervoegsel voor de resourcegroep die is gemaakt om alle Azure-resources op te slaan. Deze naam moet uniek zijn binnen uw Azure-abonnement.
De console voert berichten uit die vergelijkbaar zijn met het volgende voorbeeld:
Initializing a new project (azd init)
(✓) Done: Initialized git repository
(✓) Done: Downloading template code to: <your-local-path>
Enter a new environment name: <your-env-name>
SUCCESS: New project initialized!
You can view the template code in your directory: <your-local-path>
Learn more about running 3rd party code on our DevHub: https://aka.ms/azd-third-party-code-notice
3. De cloudomgeving voorbereiden
In deze sectie wordt beschreven hoe u een Azure Spring Apps-service-exemplaar maakt en de Azure-cloudomgeving voorbereidt.
In deze sectie wordt een knop Implementeren in Azure gebruikt om een implementatie-ervaring te starten in Azure Portal. Deze ervaring maakt gebruik van een ARM-sjabloon om Azure-resources te maken.
3.1. Meld u aan bij het Azure Portal
Ga naar Azure Portal en voer uw referenties in om u aan te melden bij de portal. De standaardweergave is uw service-dashboard.
3.2. Azure-resources maken
Gebruik de volgende stappen om alle Azure-resources te maken waarvoor de app afhankelijk is:
Selecteer de volgende knop Implementeren in Azure om de implementatie-ervaring in Azure Portal te starten:
Vul het formulier in op het tabblad Basisbeginselen . Gebruik de volgende tabel als richtlijn voor het voltooien van het formulier:
Instelling
Voorgestelde waarde
Beschrijving
Abonnement
De naam van uw abonnement.
Het Azure-abonnement dat u wilt gebruiken voor uw server. Als u meerdere abonnementen hebt, kiest u het abonnement waarin u wilt worden gefactureerd voor de resource.
Resourcegroep
myresourcegroup
Een nieuwe resourcegroepnaam of een bestaande naam uit uw abonnement.
Regio
De regio die zich het dichtst bij uw gebruikers bevindt.
De regio wordt gebruikt om de resourcegroep te maken.
Selecteer Controleren en Maken om uw selecties te controleren. Selecteer vervolgens Maken om de app te implementeren in Azure Spring Apps.
Selecteer het pictogram Meldingen (een klok) op de werkbalk om het implementatieproces te bewaken. Nadat de implementatie is voltooid, kunt u Vastmaken aan dashboard selecteren. Hiermee maakt u een tegel voor deze service op uw Azure Portal-dashboard als snelkoppeling naar de overzichtspagina van de service. Selecteer Ga naar de resource om de overzichtspagina van de service te openen.
3.1. Meld u aan bij het Azure Portal
Ga naar Azure Portal en voer uw referenties in om u aan te melden bij de portal. De standaardweergave is uw service-dashboard.
3.2. Een Azure Spring Apps-exemplaar maken
Gebruik de volgende stappen om een Azure Spring Apps-service-exemplaar te maken:
Selecteer Een resource maken in de hoek van Azure Portal.
Selecteer Compute>Azure Spring Apps.
Vul het formulier Basisbeginselen in met de volgende gegevens.
Gebruik de volgende tabel als richtlijn voor het invullen van het formulier. Het aanbevolen plan is Standard consumption & dedicated (preview).
Instelling
Voorgestelde waarde
Beschrijving
Abonnement
De naam van uw abonnement
Het Azure-abonnement dat u wilt gebruiken voor uw server. Als u meerdere abonnementen hebt, kiest u het abonnement waarin u wilt worden gefactureerd voor de resource.
Resourcegroep
myresourcegroup
Een nieuwe resourcegroepnaam of een bestaande naam uit uw abonnement.
Naam
myasa
Een unieke naam die uw Azure Spring Apps-service identificeert. De naam moet tussen de 4 en 32 tekens lang zijn en mag alleen kleine letters, cijfers en afbreekstreepjes bevatten. Het eerste teken van de servicenaam moet een letter zijn en het laatste teken moet een letter of een cijfer zijn.
Plannen
Standaardverbruik en toegewezen (preview)
Het prijsplan bepaalt de resource en de kosten die zijn gekoppeld aan uw exemplaar.
Regio
De regio het dichtst bij uw gebruikers
De locatie die zich het dichtst bij uw gebruikers bevindt.
Container Apps-omgeving
myacaenv
De omgeving is een veilige grens rond een of meer container-apps die met elkaar kunnen communiceren en een virtueel netwerk, logboekregistratie en Dapr-configuratie kunnen delen.
Vul het tabblad Basisbeginselen in met de volgende informatie:
Omgevingsnaam: myacaenv
Abonnement: Verbruik
Zoneredundantie: uitgeschakeld
Selecteer Maken om de Container Apps-omgeving te maken.
Vul het tabblad Basisbeginselen in met de volgende informatie:
Omgevingsnaam: myacaenv
Abonnement: (preview) Verbruiks- en toegewezen workloadprofielen
Zoneredundantie: uitgeschakeld
Selecteer het tabblad Workloadprofielen (preview) en selecteer vervolgens Workloadprofiel toevoegen om een workloadprofiel toe te voegen.
Voeg op de pagina Workloadprofiel toevoegen (preview) de volgende informatie toe:
Naam van workloadprofiel: my-wlp
Grootte van workloadprofiel: Selecteer Dedicated-D4
Bereik voor het automatisch schalen van exemplaren: Selecteer 3 en 5
Selecteer Toevoegen. Met deze selectie gaat u terug naar de pagina Workloadprofiel toevoegen (preview ). Selecteer mijn-wlp en selecteer vervolgens Maken om de Container Apps-omgeving te maken.
Selecteer Controleren en Maken om uw selecties te controleren. Selecteer Maken om het Azure Spring Apps-exemplaar in te richten.
Selecteer het pictogram Meldingen (een klok) op de werkbalk om het implementatieproces te bewaken. Nadat de implementatie is voltooid, kunt u Vastmaken aan dashboard selecteren. Hiermee maakt u een tegel voor deze service op uw Azure Portal-dashboard als snelkoppeling naar de overzichtspagina van de service.
Selecteer Ga naar de resource om naar de overzichtspagina van Azure Spring Apps te gaan.
Gebruik de volgende stappen om de vereiste resources te maken:
Gebruik de volgende opdracht om u met OAuth2 aan te melden bij Azure. Negeer deze stap als u zich al hebt aangemeld.
azd auth login
De console voert berichten uit die vergelijkbaar zijn met het volgende voorbeeld:
Logged in to Azure.
Gebruik de volgende opdracht om de infrastructuur van de sjabloon in te richten in Azure:
azd provision
In de volgende lijst worden de opdrachteninteracties beschreven:
Selecteer een Azure-abonnement dat u wilt gebruiken: gebruik pijlen om te verplaatsen, typ om te filteren en druk vervolgens op Enter.
Selecteer een Azure-locatie die u wilt gebruiken: Gebruik pijlen om te verplaatsen, typ om te filteren en druk op Enter.
De console voert berichten uit die vergelijkbaar zijn met het volgende voorbeeld:
SUCCESS: Your application was provisioned in Azure in xx minutes xx seconds.
You can view the resources created under the resource group rg-<your-environment-name>-<random-string>> in Azure Portal:
https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
Notitie
Dit kan enige tijd duren. U ziet een voortgangsindicator tijdens het inrichten van Azure-resources.
Met de knop Implementeren in Azure in de vorige sectie wordt een Azure-portal-ervaring gestart die toepassingsimplementatie omvat, zodat er niets anders nodig is.
In de volgende lijst worden de opdrachteninteracties beschreven:
OAuth2-aanmelding: u moet de aanmelding bij Azure autoriseren op basis van het OAuth2-protocol.
Abonnement selecteren: selecteer het abonnementslijstnummer van het Azure Spring Apps-exemplaar dat u hebt gemaakt. Dit is standaard het eerste abonnement in de lijst. Als u het standaardnummer gebruikt, drukt u rechtstreeks op Enter .
Gebruik bestaande Azure Spring Apps in Azure: Druk op y om het bestaande Azure Spring Apps-exemplaar te gebruiken.
Selecteer Azure Spring Apps voor implementatie: selecteer het lijstnummer van het Azure Spring Apps-exemplaar dat u hebt gemaakt. Als u het standaardnummer gebruikt, drukt u rechtstreeks op Enter .
Gebruik de bestaande app in Azure Spring Apps <uw exemplaarnaam>: druk op n om een nieuwe app te maken.
Voer de naam van de app (demo) in: Geef een app-naam op. Als u de standaardprojectartefact-id gebruikt, drukt u rechtstreeks op Enter .
Openbare toegang voor deze app beschikbaar maken (boot-for-azure): Druk op y.
Bevestig dat u alle bovenstaande configuraties wilt opslaan: Druk op y. Als u op n drukt, wordt de configuratie niet opgeslagen in de POM-bestanden.
Gebruik de volgende opdracht om de app te implementeren:
./mvnw azure-spring-apps:deploy
In de volgende lijst wordt de interactie met de opdracht beschreven:
OAuth2-aanmelding: u moet de aanmelding bij Azure autoriseren op basis van het OAuth2-protocol.
Nadat de opdracht is uitgevoerd, ziet u in de volgende logboekberichten dat de implementatie is geslaagd:
[INFO] Deployment(default) is successfully created
[INFO] Starting Spring App after deploying artifacts...
[INFO] Deployment Status: Running
[INFO] InstanceName:demo--default-xxxxxxx-xxxxxxxxx-xxxxx Status:Running Reason:null DiscoverStatus:NONE
[INFO] Getting public url of app(demo)...
[INFO] Application url: https://demo.<unique-identifier>.<region-name>.azurecontainerapps.io
Gebruik de volgende stappen om de app te verpakken, de Azure-resources in te richten die nodig zijn voor de webtoepassing en vervolgens te implementeren in Azure Spring Apps:
Gebruik de volgende opdracht om een implementeerbaar exemplaar van uw toepassing te verpakken:
azd package
De console voert berichten uit die vergelijkbaar zijn met het volgende voorbeeld:
SUCCESS: Your application was packaged for Azure in xx seconds.
Gebruik de volgende opdracht om de toepassingscode te implementeren op de zojuist ingerichte resources:
azd deploy
De console voert berichten uit die vergelijkbaar zijn met het volgende voorbeeld:
Deploying services (azd deploy)
(✓) Done: Deploying service demo
- Endpoint: https://demo.xxx.<your-azure-location>.azurecontainerapps.io
SUCCESS: Your application was deployed to Azure in xx minutes xx seconds.
You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
Notitie
U kunt ook azd up de vorige drie opdrachten combineren: azd provision (richt Azure-resources in), azd package (verpakt een implementeerbare kopie van uw toepassing) en azd deploy (implementeert toepassingscode). Zie spring-guides/gs-spring-boot-for-azure voor meer informatie.
Met de knop Implementeren naar Azure in de volgende sectie wordt een Azure Portal-ervaring gestart waarmee een JAR-pakket wordt gedownload van de releasepagina spring-cloud-azure-tools op GitHub. Er zijn geen lokale voorbereidingsstappen nodig.
Gebruik de volgende stappen om het project voor te bereiden:
In de volgende lijst worden de opdrachteninteracties beschreven:
OAuth2-aanmelding: u moet de aanmelding bij Azure autoriseren op basis van het OAuth2-protocol.
Geef een nieuwe omgevingsnaam op: Geef een omgevingsnaam op, die wordt gebruikt als achtervoegsel voor de resourcegroep die is gemaakt om alle Azure-resources op te slaan. Deze naam moet uniek zijn binnen uw Azure-abonnement.
De console voert berichten uit die vergelijkbaar zijn met het volgende voorbeeld:
Initializing a new project (azd init)
(✓) Done: Initialized git repository
(✓) Done: Downloading template code to: <your-local-path>
Enter a new environment name: <your-env-name>
SUCCESS: New project initialized!
You can view the template code in your directory: <your-local-path>
Learn more about running 3rd party code on our DevHub: https://aka.ms/azd-third-party-code-notice
3. De cloudomgeving voorbereiden
In deze sectie wordt beschreven hoe u een Azure Spring Apps-service-exemplaar maakt en de Azure-cloudomgeving voorbereidt.
In deze sectie wordt een knop Implementeren in Azure gebruikt om een implementatie-ervaring te starten in Azure Portal. Deze ervaring maakt gebruik van een ARM-sjabloon om Azure-resources te maken.
3.1. Meld u aan bij het Azure Portal
Ga naar Azure Portal en voer uw referenties in om u aan te melden bij de portal. De standaardweergave is uw service-dashboard.
3.2. Azure-resources maken
Gebruik de volgende stappen om alle Azure-resources te maken waarvoor de app afhankelijk is:
Selecteer de volgende knop Implementeren in Azure om de implementatie-ervaring in Azure Portal te starten:
Vul het formulier in op het tabblad Basisbeginselen . Gebruik de volgende tabel als richtlijn voor het voltooien van het formulier:
Instelling
Voorgestelde waarde
Beschrijving
Abonnement
De naam van uw abonnement.
Het Azure-abonnement dat u wilt gebruiken voor uw server. Als u meerdere abonnementen hebt, kiest u het abonnement waarin u wilt worden gefactureerd voor de resource.
Resourcegroep
myresourcegroup
Een nieuwe resourcegroepnaam of een bestaande naam uit uw abonnement.
Regio
De regio die zich het dichtst bij uw gebruikers bevindt.
De regio wordt gebruikt om de resourcegroep te maken.
Selecteer Controleren en Maken om uw selecties te controleren. Selecteer vervolgens Maken om de app te implementeren in Azure Spring Apps.
Selecteer het pictogram Meldingen (een klok) op de werkbalk om het implementatieproces te bewaken. Nadat de implementatie is voltooid, kunt u Vastmaken aan dashboard selecteren. Hiermee maakt u een tegel voor deze service op uw Azure Portal-dashboard als snelkoppeling naar de overzichtspagina van de service. Selecteer Ga naar de resource om de overzichtspagina van de service te openen.
3.1. Meld u aan bij het Azure Portal
Open uw webbrowser en ga naar Azure Portal. Voer uw referenties in om u aan te melden bij de portal. De standaardweergave is uw service-dashboard.
3.2. Een Azure Spring Apps-exemplaar maken
Gebruik de volgende stappen om een service-exemplaar te maken:
Selecteer Een resource maken in de hoek van Azure Portal.
Selecteer Compute>Azure Spring Apps.
Vul het formulier Basisbeginselen in met de volgende gegevens:
Instelling
Voorgestelde waarde
Beschrijving
Abonnement
De naam van uw abonnement
Het Azure-abonnement dat u wilt gebruiken voor uw server. Als u meerdere abonnementen hebt, kiest u het abonnement waarin u wilt worden gefactureerd voor de resource.
Resourcegroep
myresourcegroup
Een nieuwe resourcegroepnaam of een bestaande naam uit uw abonnement.
Naam
myasa
Een unieke naam die uw Azure Spring Apps-service identificeert. De naam moet tussen de 4 en 32 tekens lang zijn en mag alleen kleine letters, cijfers en afbreekstreepjes bevatten. Het eerste teken van de servicenaam moet een letter zijn en het laatste teken moet een letter of een cijfer zijn.
Plannen
Standaard
Het prijsplan waarmee de resource en kosten worden bepaald die zijn gekoppeld aan uw exemplaar.
Regio
De regio het dichtst bij uw gebruikers
De locatie die zich het dichtst bij uw gebruikers bevindt.
Zoneredundant
Niet geselecteerd
Hiermee wordt aangegeven of u uw Azure Spring Apps-service maakt in een Azure-beschikbaarheidszone. Deze functie wordt momenteel niet ondersteund in alle regio's.
Selecteer Controleren en Maken om uw selecties te controleren. Selecteer Maken om het Azure Spring Apps-exemplaar in te richten.
Selecteer het pictogram Meldingen (een klok) op de werkbalk om het implementatieproces te bewaken. Nadat de implementatie is voltooid, kunt u Vastmaken aan dashboard selecteren. Hiermee maakt u een tegel voor deze service op uw Azure Portal-dashboard als snelkoppeling naar de overzichtspagina van de service.
Selecteer Ga naar de resource om naar de overzichtspagina van Azure Spring Apps te gaan.
Gebruik de volgende stappen om de vereiste resources te maken:
Gebruik de volgende opdracht om u met OAuth2 aan te melden bij Azure. Negeer deze stap als u zich al hebt aangemeld.
azd auth login
De console voert berichten uit die vergelijkbaar zijn met het volgende voorbeeld:
Logged in to Azure.
Gebruik de volgende opdracht om de sjabloon in te stellen met behulp van het Standard-abonnement:
azd env set PLAN standard
Gebruik de volgende opdracht om een implementeerbaar exemplaar van uw toepassing te verpakken, de infrastructuur van de sjabloon in te richten in Azure en de toepassingscode vervolgens te implementeren op die nieuw ingerichte resources:
azd provision
In de volgende lijst worden de opdrachteninteracties beschreven:
Selecteer een Azure-abonnement dat u wilt gebruiken: gebruik pijlen om te verplaatsen, typ om te filteren en druk vervolgens op Enter.
Selecteer een Azure-locatie die u wilt gebruiken: Gebruik pijlen om te verplaatsen, typ om te filteren en druk op Enter.
De console voert berichten uit die vergelijkbaar zijn met de berichten in het volgende voorbeeld:
SUCCESS: Your application was provisioned in Azure in xx minutes xx seconds.
You can view the resources created under the resource group rg-<your-environment-name>-<random-string>> in Azure Portal:
https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
Notitie
Dit kan enige tijd duren. U ziet een voortgangsindicator tijdens het inrichten van Azure-resources.
Met de knop Implementeren in Azure in de vorige sectie wordt een Azure-portal-ervaring gestart die toepassingsimplementatie omvat, zodat er niets anders nodig is.
In de volgende lijst worden de opdrachteninteracties beschreven:
OAuth2-aanmelding: u moet de aanmelding bij Azure autoriseren op basis van het OAuth2-protocol.
Abonnement selecteren: selecteer het abonnementslijstnummer van het Azure Spring Apps-exemplaar dat u hebt gemaakt. Dit is standaard het eerste abonnement in de lijst. Als u het standaardnummer gebruikt, drukt u rechtstreeks op Enter .
Gebruik bestaande Azure Spring Apps in Azure: Druk op y om het bestaande Azure Spring Apps-exemplaar te gebruiken.
Selecteer Azure Spring Apps voor implementatie: selecteer het lijstnummer van het Azure Spring Apps-exemplaar dat u hebt gemaakt. Als u het standaardnummer gebruikt, drukt u rechtstreeks op Enter .
Gebruik de bestaande app in Azure Spring Apps <uw exemplaarnaam>: druk op n om een nieuwe app te maken.
Voer de naam van de app (demo) in: Geef een app-naam op. Als u de standaardprojectartefact-id gebruikt, drukt u rechtstreeks op Enter .
Openbare toegang voor deze app beschikbaar maken (boot-for-azure): Druk op y.
Bevestig dat u alle bovenstaande configuraties wilt opslaan: Druk op y. Als u op n drukt, wordt de configuratie niet opgeslagen in de POM-bestanden.
Gebruik de volgende opdracht om de app te implementeren:
./mvnw azure-spring-apps:deploy
In de volgende lijst wordt de interactie met de opdracht beschreven:
OAuth2-aanmelding: u moet de aanmelding bij Azure autoriseren op basis van het OAuth2-protocol.
Nadat de opdracht is uitgevoerd, ziet u in de volgende logboekberichten dat de implementatie is geslaagd:
[INFO] Deployment(default) is successfully created
[INFO] Starting Spring App after deploying artifacts...
[INFO] Deployment Status: Running
[INFO] InstanceName:demo-default-x-xxxxxxxxxx-xxxxx Status:Running Reason:null DiscoverStatus:UNREGISTERED
[INFO] InstanceName:demo-default-x-xxxxxxxxx-xxxxx Status:Terminating Reason:null DiscoverStatus:UNREGISTERED
[INFO] Getting public url of app(demo)...
[INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-demo.azuremicroservices.io
Gebruik de volgende stappen om de app te verpakken, de Azure-resources in te richten die nodig zijn voor de webtoepassing en vervolgens te implementeren in Azure Spring Apps:
Gebruik de volgende opdracht om een implementeerbaar exemplaar van uw toepassing te verpakken:
azd package
De console voert berichten uit die vergelijkbaar zijn met het volgende voorbeeld:
SUCCESS: Your application was packaged for Azure in xx seconds.
Gebruik de volgende opdracht om de toepassingscode te implementeren op de zojuist ingerichte resources:
azd deploy
De console voert berichten uit die vergelijkbaar zijn met de berichten in het volgende voorbeeld:
Deploying services (azd deploy)
(✓) Done: Deploying service demo
- Endpoint: https://<your-Azure-Spring-Apps-instance-name>-demo.azuremicroservices.io/
SUCCESS: Your application was deployed to Azure in xx minutes xx seconds.
You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
Notitie
U kunt ook azd up de vorige drie opdrachten combineren: azd package (verpakt een implementeerbaar exemplaar van uw toepassing), azd provision (richt Azure-resources in) en azd deploy (implementeert toepassingscode). Zie spring-guides/gs-spring-boot-for-azure voor meer informatie.
Met de knop Implementeren naar Azure in de volgende sectie wordt een Azure Portal-ervaring gestart waarmee een JAR-pakket wordt gedownload van de releasepagina spring-cloud-azure-tools op GitHub. Er zijn geen lokale voorbereidingsstappen nodig.
Gebruik de volgende stappen om het project voor te bereiden:
Maak een webcontroller voor uw webtoepassing door het bestand src/main/java/com/example/demo/HelloController.java toe te voegen met de volgende inhoud:
package com.example.demo;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.bind.annotation.RequestMapping;
@RestController
public class HelloController {
@RequestMapping("/")
public String index() {
return "Hello World";
}
}
Gebruik de volgende Maven-opdracht om het project te bouwen:
./mvnw clean package
Voer het voorbeeldproject lokaal uit met behulp van de volgende opdracht:
In deze sectie wordt een knop Implementeren in Azure gebruikt om een implementatie-ervaring te starten in Azure Portal. Deze ervaring maakt gebruik van een ARM-sjabloon om Azure-resources te maken.
3.1. Meld u aan bij het Azure Portal
Ga naar Azure Portal en voer uw referenties in om u aan te melden bij de portal. De standaardweergave is uw service-dashboard.
3.2. Azure-resources maken
Gebruik de volgende stappen om alle Azure-resources te maken waarvoor de app afhankelijk is:
Selecteer de volgende knop Implementeren in Azure om de implementatie-ervaring in Azure Portal te starten:
Vul het formulier in op het tabblad Basisbeginselen . Gebruik de volgende tabel als richtlijn voor het voltooien van het formulier:
Instelling
Voorgestelde waarde
Beschrijving
Abonnement
De naam van uw abonnement.
Het Azure-abonnement dat u wilt gebruiken voor uw server. Als u meerdere abonnementen hebt, kiest u het abonnement waarin u wilt worden gefactureerd voor de resource.
Resourcegroep
myresourcegroup
Een nieuwe resourcegroepnaam of een bestaande naam uit uw abonnement.
Regio
De regio die zich het dichtst bij uw gebruikers bevindt.
De regio wordt gebruikt om de resourcegroep te maken.
Selecteer Controleren en Maken om uw selecties te controleren. Selecteer vervolgens Maken om de app te implementeren in Azure Spring Apps.
Selecteer het pictogram Meldingen (een klok) op de werkbalk om het implementatieproces te bewaken. Nadat de implementatie is voltooid, kunt u Vastmaken aan dashboard selecteren. Hiermee maakt u een tegel voor deze service op uw Azure Portal-dashboard als snelkoppeling naar de overzichtspagina van de service. Selecteer Ga naar de resource om de overzichtspagina van de service te openen.
3.1. Meld u aan bij het Azure Portal
Ga naar Azure Portal en voer uw referenties in om u aan te melden bij de portal. De standaardweergave is uw service-dashboard.
3.2. Een Azure Spring Apps-exemplaar maken
Gebruik de volgende stappen om het service-exemplaar te maken:
Selecteer Een resource maken in de hoek van Azure Portal.
Selecteer Compute>Azure Spring Apps.
Vul het formulier Basisbeginselen in met de volgende gegevens:
Instelling
Voorgestelde waarde
Beschrijving
Abonnement
De naam van uw abonnement.
Het Azure-abonnement dat u wilt gebruiken voor uw server. Als u meerdere abonnementen hebt, kiest u het abonnement waarin u wilt worden gefactureerd voor de resource.
Resourcegroep
myresourcegroup
Een nieuwe resourcegroepnaam of een bestaande naam uit uw abonnement.
Naam
myasa
Een unieke naam die uw Azure Spring Apps-service identificeert. De naam moet tussen de 4 en 32 tekens lang zijn en mag alleen kleine letters, cijfers en afbreekstreepjes bevatten. Het eerste teken van de servicenaam moet een letter zijn en het laatste teken moet een letter of een cijfer zijn.
Regio
De regio die zich het dichtst bij uw gebruikers bevindt.
De locatie die zich het dichtst bij uw gebruikers bevindt.
Hostingopties en -abonnementen
Enterprise
Het prijsplan waarmee de resource en kosten worden bepaald die zijn gekoppeld aan uw exemplaar.
Zoneredundant
Niet geselecteerd
De optie voor het maken van uw Azure Spring Apps-service in een Azure-beschikbaarheidszone. Deze functie wordt momenteel niet ondersteund in alle regio's.
Software-IP-plan
Betalen per gebruik
Het prijsplan waarmee u per gebruik kunt betalen met Azure Spring Apps.
Voorbeeldproject implementeren
Niet geselecteerd
De optie voor het gebruik van de ingebouwde voorbeeldtoepassing.
Selecteer Controleren en Maken om uw selecties te controleren. Selecteer Vervolgens Maken om het Azure Spring Apps-exemplaar in te richten.
Selecteer het pictogram Meldingen (een klok) op de werkbalk om het implementatieproces te bewaken. Nadat de implementatie is voltooid, kunt u Vastmaken aan dashboard selecteren. Hiermee maakt u een tegel voor deze service op uw Azure Portal-dashboard als snelkoppeling naar de overzichtspagina van de service.
Selecteer Ga naar de resource om naar de overzichtspagina van Azure Spring Apps te gaan.
3.1. Namen opgeven voor elke resource
Maak variabelen voor het opslaan van de resourcenamen met behulp van de volgende opdrachten. Vervang de tijdelijke aanduidingen door uw eigen waarden.
Gebruik de volgende stappen om een nieuwe resourcegroep te maken:
Gebruik de volgende opdracht om u aan te melden bij de Azure CLI:
az login
Gebruik de volgende opdracht om de standaardlocatie in te stellen:
az configure --defaults location=${LOCATION}
Gebruik de volgende opdracht om alle beschikbare abonnementen weer te geven om de abonnements-id te bepalen die u wilt gebruiken:
az account list --output table
Gebruik de volgende opdracht om het standaardabonnement in te stellen:
az account set --subscription <subscription-ID>
Gebruik de volgende opdracht om een resourcegroep te maken:
az group create --resource-group ${RESOURCE_GROUP}
Gebruik de volgende opdracht om de zojuist gemaakte resourcegroep in te stellen als de standaardresourcegroep:
az configure --defaults group=${RESOURCE_GROUP}
3.3. Extensie installeren en naamruimte registreren
Gebruik de volgende opdrachten om de Azure Spring Apps-extensie voor de Azure CLI te installeren en de naamruimte te registreren: Microsoft.SaaS
az extension add --name spring --upgrade
az provider register --namespace Microsoft.SaaS
3.4. Een Azure Spring Apps-exemplaar maken
Gebruik de volgende stappen om het service-exemplaar te maken:
Gebruik de volgende opdracht om de juridische voorwaarden en privacyverklaringen voor het Enterprise-abonnement te accepteren:
Notitie
Deze stap is alleen nodig als uw abonnement nog nooit is gebruikt om een Enterprise-abonnementexemplaren van Azure Spring Apps te maken.
az term accept \
--publisher vmware-inc \
--product azure-spring-cloud-vmware-tanzu-2 \
--plan asa-ent-hr-mtr
Gebruik de volgende opdracht om een Azure Spring Apps-service-exemplaar te maken:
az spring create \
--name ${SERVICE_NAME} \
--sku Enterprise
3.5. Een app maken in uw Azure Spring Apps-exemplaar
Een app is een abstractie van één zakelijke app. Zie App en implementatie in Azure Spring Apps voor meer informatie. Apps worden uitgevoerd in een Azure Spring Apps-service-exemplaar, zoals wordt weergegeven in het volgende diagram.
Gebruik de volgende opdracht om de app te maken in Azure Spring Apps:
az spring app create \
--service ${SERVICE_NAME} \
--name ${APP_NAME} \
--assign-endpoint true
3.1. Meld u aan bij het Azure Portal
Open uw webbrowser en ga naar Azure Portal, voer uw referenties in en meld u aan bij de portal. De standaardweergave is uw service-dashboard.
3.2. Een Azure Spring Apps-exemplaar maken
Gebruik de volgende stappen om het service-exemplaar te maken:
Selecteer Een resource maken in de hoek van Azure Portal.
Selecteer Compute>Azure Spring Apps.
Vul het formulier Basisbeginselen in met de volgende gegevens:
Instelling
Voorgestelde waarde
Beschrijving
Abonnement
De naam van uw abonnement.
Het Azure-abonnement dat u wilt gebruiken voor uw server. Als u meerdere abonnementen hebt, kiest u het abonnement waarin u wilt worden gefactureerd voor de resource.
Resourcegroep
myresourcegroup
Een nieuwe resourcegroepnaam of een bestaande naam uit uw abonnement.
Naam
myasa
Een unieke naam die uw Azure Spring Apps-service identificeert. De naam moet tussen de 4 en 32 tekens lang zijn en mag alleen kleine letters, cijfers en afbreekstreepjes bevatten. Het eerste teken van de servicenaam moet een letter zijn en het laatste teken moet een letter of een cijfer zijn.
Regio
De regio die zich het dichtst bij uw gebruikers bevindt.
De locatie die zich het dichtst bij uw gebruikers bevindt.
Hostingopties en -abonnementen
Enterprise
Het prijsplan waarmee de resource en kosten worden bepaald die zijn gekoppeld aan uw exemplaar.
Zoneredundant
Niet geselecteerd
De optie voor het maken van uw Azure Spring Apps-service in een Azure-beschikbaarheidszone. Deze functie wordt momenteel niet ondersteund in alle regio's.
Software-IP-plan
Betalen per gebruik
Het prijsplan waarmee u per gebruik kunt betalen met Azure Spring Apps.
Voorbeeldproject implementeren
Niet geselecteerd
De optie voor het gebruik van de ingebouwde voorbeeldtoepassing.
Selecteer Controleren en Maken om uw selecties te controleren. Selecteer Vervolgens Maken om het Azure Spring Apps-exemplaar in te richten.
Selecteer het pictogram Meldingen (een klok) op de werkbalk om het implementatieproces te bewaken. Nadat de implementatie is voltooid, kunt u Vastmaken aan dashboard selecteren. Hiermee maakt u een tegel voor deze service op uw Azure Portal-dashboard als snelkoppeling naar de overzichtspagina van de service.
Selecteer Ga naar de resource om naar de overzichtspagina van Azure Spring Apps te gaan.
Met de knop Implementeren in Azure in de vorige sectie wordt een Azure-portal-ervaring gestart die toepassingsimplementatie omvat, zodat er niets anders nodig is.
In de volgende lijst worden de opdrachteninteracties beschreven:
OAuth2-aanmelding: u moet de aanmelding bij Azure autoriseren op basis van het OAuth2-protocol.
Abonnement selecteren: selecteer het abonnementslijstnummer van het Azure Spring Apps-exemplaar dat u hebt gemaakt. Dit is standaard het eerste abonnement in de lijst. Als u het standaardnummer gebruikt, drukt u rechtstreeks op Enter .
Gebruik bestaande Azure Spring Apps in Azure: Druk op y om het bestaande Azure Spring Apps-exemplaar te gebruiken.
Selecteer Azure Spring Apps voor implementatie: selecteer het lijstnummer van het Azure Spring Apps-exemplaar dat u hebt gemaakt. Als u het standaardnummer gebruikt, drukt u rechtstreeks op Enter .
Gebruik de bestaande app in Azure Spring Apps <uw exemplaarnaam>: druk op n om een nieuwe app te maken.
Voer de naam van de app (demo) in: Geef een app-naam op. Als u de standaardprojectartefact-id gebruikt, drukt u rechtstreeks op Enter .
Openbare toegang voor deze app beschikbaar maken (boot-for-azure): Druk op y.
Bevestig dat u alle bovenstaande configuraties wilt opslaan: Druk op y. Als u op n drukt, wordt de configuratie niet opgeslagen in de POM-bestanden.
Gebruik de volgende opdracht om de app te implementeren:
./mvnw azure-spring-apps:deploy
In de volgende lijst wordt de interactie met de opdracht beschreven:
OAuth2-aanmelding: u moet de aanmelding bij Azure autoriseren op basis van het OAuth2-protocol.
Nadat de opdracht is uitgevoerd, ziet u in de volgende logboekberichten dat de implementatie is geslaagd:
[INFO] Deployment(default) is successfully created
[INFO] Starting Spring App after deploying artifacts...
[INFO] Deployment Status: Running
[INFO] InstanceName:demo-default-x-xxxxxxxxxx-xxxxx Status:Running Reason:null DiscoverStatus:N/A
[INFO] Getting public url of app(demo)...
[INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-demo.azuremicroservices.io
Gebruik de volgende opdracht om het .jar-bestand voor de app te implementeren:
az spring app deploy \
--service ${SERVICE_NAME} \
--name ${APP_NAME} \
--artifact-path target/demo-0.0.1-SNAPSHOT.jar
Het implementeren van de toepassing kan enkele minuten duren.
Deze sectie bevat de stappen voor het implementeren van uw toepassing in Azure Spring Apps.
4.1. Het project importeren
Gebruik de volgende stappen om het project te importeren:
Open IntelliJ IDEA en selecteer Openen.
Selecteer de demomap in het dialoogvenster Bestand of Project openen.
4.2. Uw app bouwen en implementeren
Gebruik de volgende stappen om uw app te bouwen en te implementeren:
Als u de Azure-toolkit voor IntelliJ nog niet hebt geïnstalleerd, volgt u de stappen in De Azure-toolkit voor IntelliJ installeren.
Notitie
Azure Toolkit voor IntelliJ biedt vier manieren om u aan te melden bij Azure en de implementatie kan pas worden gestart nadat u zich hebt aangemeld.
Klik met de rechtermuisknop op uw project in het Venster IntelliJ Project en selecteer vervolgens Azure ->Deploy to Azure Spring Apps.
Accepteer de naam voor de app in het veld Naam . De naam verwijst naar de configuratie, niet naar de naam van de app. Meestal hoeft u deze niet te wijzigen.
Selecteer Maven:demo (Java 17) in het tekstvak Artefact.
Controleer in het tekstvak Abonnement of uw abonnement juist is.
Selecteer in het tekstvak Spring Apps het exemplaar van Azure Spring Apps dat u hebt gemaakt.
Selecteer in het tekstvak App het plusteken (+) om een nieuwe app te maken.
Voer in de naam van de app het tekstvak onder Basisbeginselen van de app in en selecteer vervolgens Meer instellingen.
Selecteer de knop Inschakelen naast het openbare eindpunt. De knop verandert in Uitschakelen <om in te schakelen>. Selecteer vervolgens OK.
Selecteer onder Voor starten Maven-doel 'demo:package' uitvoeren en selecteer vervolgens het potloodpictogram om de opdrachtregel te bewerken.
Voer in het tekstvak Opdrachtregel -DskipTests na het pakket in en selecteer VERVOLGENS OK.
Als u de implementatie wilt starten, selecteert u de knop Uitvoeren onderaan het dialoogvenster Implementeren in Azure . De invoegtoepassing voert de Maven-opdracht package -DskipTests uit in de demo app en implementeert het .jar bestand dat door de package opdracht is gegenereerd.
Het implementeren van de toepassing kan enkele minuten duren. U kunt de openbare URL van de toepassing zien in het uitvoerconsolelogboek.
Nadat de implementatie is voltooid, zoekt u de toepassings-URL uit de uitvoer van de implementatie. Voer de volgende stappen uit om te valideren:
Open de toepassings-URL vanaf de pagina Uitvoer van de implementatie. Wanneer u de app opent, krijgt u het antwoord Hello World.
Controleer de details voor elke resource-implementatie, wat handig is voor het onderzoeken van implementatieproblemen.
Nadat de implementatie is voltooid, opent u de toepassing met de URL van de uitvoertoepassing. Gebruik de volgende stappen om de logboeken van de app te controleren om een implementatieprobleem te onderzoeken:
Open de URL van de uitvoertoepassing vanaf de pagina Uitvoer van de implementatie. Wanneer u de app opent, krijgt u het antwoord Hello World.
Selecteer in het navigatiedeelvenster van de overzichtspagina van het Azure Spring Apps-exemplaar logboeken om de logboeken van de app te controleren.
Nadat de implementatie is voltooid, opent u de toepassing met het uitvoereindpunt. Wanneer u de app opent, krijgt u het antwoord Hello World.
Nadat de implementatie is voltooid, gebruikt u de volgende stappen om de toepassings-URL te vinden uit de uitvoer van de implementatie:
Open de toepassings-URL vanaf de pagina Uitvoer van de implementatie. Wanneer u de app opent, krijgt u het antwoord Hello World.
Controleer de details voor elke resource-implementatie, wat handig is voor het onderzoeken van implementatieproblemen.
Nadat de implementatie is voltooid, gebruikt u de volgende stappen om de logboeken van de app te controleren om een implementatieprobleem te onderzoeken:
Open de toepassings-URL vanaf de pagina Uitvoer van de implementatie. Wanneer u de app opent, krijgt u het antwoord Hello World.
Selecteer in het navigatiedeelvenster van de overzichtspagina van het Azure Spring Apps-exemplaar logboeken om de logboeken van de app te controleren.
Nadat de implementatie is voltooid, opent u de toepassing met het uitvoereindpunt. Wanneer u de app opent, krijgt u het antwoord Hello World.
Nadat de implementatie is voltooid, gebruikt u de volgende stappen om de toepassings-URL te vinden uit de uitvoer van de implementatie:
Open de toepassings-URL vanaf de pagina Uitvoer van de implementatie. Wanneer u de app opent, krijgt u het antwoord Hello World.
Controleer de details voor elke resource-implementatie, wat handig is voor het onderzoeken van implementatieproblemen.
Nadat de implementatie is voltooid, gebruikt u de volgende stappen om de app te valideren:
Toegang tot de toepassings-URL. Wanneer u de app opent, krijgt u het antwoord Hello World.
Controleer de consolelogboeken, die handig zijn voor het onderzoeken van implementatieproblemen.
Nadat de implementatie is voltooid, gebruikt u de volgende stappen om de logboeken van de app te controleren om een implementatieprobleem te onderzoeken:
Open de toepassing met de URL van de uitvoertoepassing. Wanneer u de app opent, krijgt u het antwoord Hello World.
Gebruik de volgende opdracht om het logboek van de app te controleren om een implementatieprobleem te onderzoeken:
az spring app logs \
--service ${SERVICE_NAME} \
--name ${APP_NAME}
Gebruik de volgende stappen om uw toepassingslogboeken te streamen:
Open de toepassing met de URL van de uitvoertoepassing. Wanneer u de app opent, krijgt u het antwoord Hello World.
Open het Venster Azure Explorer , vouw het knooppunt Azure uit, vouw het serviceknooppunt Azure Spring Apps uit, vouw het Azure Spring Apps-exemplaar uit dat u hebt gemaakt en selecteer vervolgens het demo-exemplaar van de app die u hebt gemaakt.
Klik met de rechtermuisknop en selecteer Streaminglogboeken starten en selecteer VERVOLGENS OK om realtime toepassingslogboeken weer te geven.
Gebruik de volgende stappen om uw toepassingslogboeken te streamen:
Open de toepassing met de URL van de uitvoertoepassing. Wanneer u de app opent, krijgt u het antwoord Hello World.
Als u van plan bent om verder te gaan met volgende snelstarts en zelfstudies, kunt u deze resources het beste intact laten. Wanneer u de resources niet meer nodig hebt, kunt u overbodige resources opschonen om Azure-kosten te voorkomen.
Gebruik de volgende stappen om de hele resourcegroep te verwijderen, inclusief het zojuist gemaakte service-exemplaar:
Zoek de resourcegroep in Azure Portal. Selecteer resourcegroepen in het navigatiemenu en selecteer vervolgens de naam van uw resourcegroep.
Selecteer Verwijderen op de pagina Resourcegroep. Voer de naam van de resourcegroep in het tekstvak in om het verwijderen te bevestigen en selecteer Vervolgens Verwijderen.
Gebruik de volgende stappen om de hele resourcegroep te verwijderen, inclusief het zojuist gemaakte service-exemplaar:
Zoek de resourcegroep in Azure Portal. Selecteer resourcegroepen in het navigatiemenu en selecteer vervolgens de naam van uw resourcegroep.
Selecteer Verwijderen op de pagina Resourcegroep. Voer de naam van de resourcegroep in het tekstvak in om het verwijderen te bevestigen en selecteer Vervolgens Verwijderen.
Gebruik de volgende opdracht om de resourcegroep te verwijderen met behulp van de Azure CLI:
az group delete --name ${RESOURCE_GROUP}
Gebruik de volgende stappen om de resourcegroep te verwijderen met behulp van IntelliJ:
Ga naar uw Intellij IDEA en zoek de naam van uw resourcegroep.
Klik met de rechtermuisknop op de resourcegroep en selecteer Verwijderen om alle gerelateerde Azure-resources te verwijderen.
Gebruik de volgende stappen om de resourcegroep te verwijderen met behulp van Visual Studio Code:
Ga naar Visual Studio Code, selecteer Groeperen op om Groeperen op resourcegroep in te schakelen en zoek vervolgens de naam van uw resourcegroep.
Klik met de rechtermuisknop op de resourcegroep en selecteer Resourcegroep verwijderen... als u alle gerelateerde Azure-resources wilt verwijderen.
Gebruik de volgende stappen om de hele resourcegroep te verwijderen, inclusief het zojuist gemaakte service-exemplaar:
Zoek de resourcegroep in Azure Portal. Selecteer resourcegroepen in het navigatiemenu en selecteer vervolgens de naam van uw resourcegroep.
Selecteer Verwijderen op de pagina Resourcegroep. Voer de naam van de resourcegroep in het tekstvak in om het verwijderen te bevestigen en selecteer Vervolgens Verwijderen.
Gebruik de volgende stappen om de hele resourcegroep te verwijderen, inclusief het zojuist gemaakte service-exemplaar:
Zoek de resourcegroep in Azure Portal. Selecteer resourcegroepen in het navigatiemenu en selecteer vervolgens de naam van uw resourcegroep.
Selecteer Verwijderen op de pagina Resourcegroep. Voer de naam van de resourcegroep in het tekstvak in om het verwijderen te bevestigen en selecteer Vervolgens Verwijderen.
Gebruik de volgende opdracht om alle Azure-resources te verwijderen die in deze voorbeeldtoepassing worden gebruikt:
azd down
In de volgende lijst wordt de interactie met de opdracht beschreven:
Totaal aantal te verwijderen resources: <uw resourcestotaal>, weet u zeker dat u wilt doorgaan?: Druk op y.
De console voert berichten uit die vergelijkbaar zijn met het volgende voorbeeld:
SUCCESS: Your application was removed from Azure in xx minutes xx seconds.
