Quickstart: Uw eerste webtoepassing 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 deze quickstart ziet u hoe u een Spring Boot-webtoepassing implementeert in Azure Spring Apps. Het voorbeeldproject is een eenvoudige ToDo-toepassing om taken toe te voegen, te markeren wanneer ze zijn voltooid en ze vervolgens te verwijderen. In de volgende schermopname ziet u de toepassing:
Deze toepassing is een typische webtoepassing met drie lagen met de volgende lagen:
In het volgende diagram ziet u de architectuur van het systeem:
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 biedt 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.
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 biedt 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.
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 van ASA-Samples-Web-Application op GitHub. Er zijn geen lokale voorbereidingsstappen nodig.
Hoewel u Azure Portal in latere stappen gebruikt, moet u de Bash-opdrachtregel gebruiken om het project lokaal voor te bereiden. Gebruik de volgende stappen om de app lokaal te klonen en uit te voeren:
Gebruik de volgende opdracht om het voorbeeldproject te klonen vanuit GitHub:
Gebruik de volgende opdracht om het voorbeeldproject te bouwen met Maven:
cd ASA-Samples-Web-Application
./mvnw clean package
Gebruik de volgende opdracht om de voorbeeldtoepassing uit te voeren:
java -jar web/target/simple-todo-web.jar
Ga naar http://localhost:8080 in uw browser om toegang te krijgen tot de toepassing.
3. De cloudomgeving voorbereiden
De belangrijkste resources die nodig zijn om dit voorbeeld uit te voeren, zijn een Azure Spring Apps-exemplaar en een Azure Database for PostgreSQL-exemplaar. Deze sectie bevat de stappen voor het maken van deze resources.
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.
Postgre SQL-beheerderswachtwoord
N.v.t.
Het wachtwoord voor de PostgreSQL-serverbeheerder.
Postgre SQL-gebruikerswachtwoord
N.v.t.
Het wachtwoord voor de Gebruiker van de PostgreSQL-toepassing, die in de toepassing wordt gebruikt.
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, 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.
Plannen
Enterprise
Het prijsplan waarmee de resource en kosten worden bepaald die zijn gekoppeld aan uw exemplaar.
Regio
De regio die zich het dichtst bij uw gebruikers bevindt.
De locatie die zich het dichtst bij uw gebruikers bevindt.
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
Betalen per gebruik met Azure Spring Apps.
Voorwaarde
Selected
Het selectievakje overeenkomst dat is gekoppeld aan de Marketplace-aanbieding. U moet dit selectievakje inschakelen.
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.3. Het PostgreSQL-exemplaar voorbereiden
Gebruik de volgende stappen om een Azure Database for PostgreSQL-server te maken:
Selecteer in Azure Portal Een resource maken.
Selecteer Databases>Azure Database for PostgreSQL Flexible Server.
Vul het tabblad Basisbeginselen in met de volgende informatie:
Servernaam: my-demo-pgsql
Regio: VS - oost
PostgreSQL-versie: 14
Workloadtype: Ontwikkeling
Hoge beschikbaarheid inschakelen: niet geselecteerd
Verificatiemethode: alleen PostgreSQL-verificatie
Gebruikersnaam van beheerder: myadmin
Wachtwoord en wachtwoord bevestigen: voer een wachtwoord in.
Configureer het tabblad Netwerken met behulp van de volgende informatie:
Openbare toegang vanuit elke Azure-service binnen Azure tot deze server toestaan: geselecteerd
Selecteer Beoordelen en maken om uw selecties te controleren en selecteer Vervolgens Maken om de server in te richten. Deze bewerking kan enkele minuten duren.
Ga in het Azure Portal naar uw PostgreSQL-server.
Selecteer Databases in het navigatiemenu om een database te maken, bijvoorbeeld Todo.
3.4. App-exemplaar verbinden met PostgreSQL-exemplaar
Gebruik de volgende stappen om verbinding te maken met uw service-exemplaren:
Ga naar uw Azure Spring Apps-exemplaar in Azure Portal.
Open Apps in het navigatiedeelvenster en selecteer Vervolgens App maken.
Op de pagina App maken gebruikt u simple-todo-web voor de naam van de app en laat u alle andere velden met hun standaardwaarden staan.
Selecteer Maken om het maken van de app te voltooien en selecteer vervolgens de app om de details weer te geven.
Selecteer Serviceconnector in het navigatiedeelvenster en selecteer Vervolgens Maken om een nieuwe serviceverbinding te maken.
Vul het tabblad Basisbeginselen in met de volgende informatie:
Servicetype: flexibele DB for PostgreSQL-server
Verbindingsnaam: gevuld met een automatisch gegenereerde naam die u kunt wijzigen.
Abonnement: selecteer uw abonnement.
Flexibele PostgreSQL-server: my-demo-pgsql
PostgreSQL-database: selecteer de database die u hebt gemaakt.
Clienttype: SpringBoot
Configureer het tabblad Volgende: Verificatie met de volgende informatie:
Selecteer het verificatietype dat u wilt gebruiken tussen uw rekenservice en doelservice.: Selecteer verbindingsreeks.
Doorgaan met...: Databasereferenties selecteren
Gebruikersnaam: myadmin
Wachtwoord: voer uw wachtwoord in.
Selecteer Volgende: Netwerken. Gebruik de standaardoptie Firewallregels configureren om toegang tot de doelservice in te schakelen.
Selecteer Volgende: Controleren en Maken om uw selecties te controleren en selecteer vervolgens Maken om de verbinding te maken.
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.
0.0.0.0 Als u opgeeft, hebt u openbare toegang vanaf alle resources die in Azure zijn geïmplementeerd om toegang te krijgen tot uw server.
3.5. App-exemplaar verbinden met PostgreSQL-exemplaar
Nadat het toepassingsexemplaren en het PostgreSQL-exemplaar zijn gemaakt, heeft het toepassingsexemplaren geen rechtstreeks toegang tot het PostgreSQL-exemplaar. Gebruik de volgende stappen om de app in staat te stellen verbinding te maken met het PostgreSQL-exemplaar.
Gebruik de volgende opdracht om de fully qualified domain name van het PostgreSQL-exemplaar op te halen:
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:
Selecteer onderliggende modules die u wilt configureren: Selecteer de module die u wilt configureren en voer vervolgens het nummer van de SimpleTodo-webmodule in.
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 aantal Azure Spring Apps-exemplaren dat u hebt gemaakt. Als u het standaardnummer gebruikt, drukt u rechtstreeks op Enter .
Openbare toegang voor deze app beschikbaar maken: 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 Status: Running
[INFO] InstanceName:simple-todo-web-default-15-xxxxxxxxx-xxxxx Status:Running Reason:null DiscoverStatus:N/A
[INFO] Getting public url of app(simple-todo-web)...
[INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-simple-todo-web.azuremicroservices.io
De URL van de uitvoertoepassing is het eindpunt voor toegang tot de todo toepassing.
Nu de cloudomgeving is voorbereid, is de toepassing klaar om te implementeren. Gebruik de volgende opdracht om de app te implementeren:
az spring app deploy \
--service ${AZURE_SPRING_APPS_NAME} \
--name ${APP_NAME} \
--artifact-path web/target/simple-todo-web.jar
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 van ASA-Samples-Web-Application op GitHub. Er zijn geen lokale voorbereidingsstappen nodig.
Hoewel u Azure Portal in latere stappen gebruikt, moet u de Bash-opdrachtregel gebruiken om het project lokaal voor te bereiden. Gebruik de volgende stappen om de app lokaal te klonen en uit te voeren:
Gebruik de volgende opdracht om het voorbeeldproject te klonen vanuit GitHub:
In de volgende lijst wordt de interactie met de opdracht beschreven:
Voer een nieuwe omgevingsnaam in: 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
De belangrijkste resources die nodig zijn om dit voorbeeld uit te voeren, zijn een Azure Spring Apps-exemplaar en een Azure Database for PostgreSQL-exemplaar. Deze sectie bevat de stappen voor het maken van deze resources.
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.
PostgreSQL-beheerderswachtwoord
N.v.t.
Het wachtwoord voor de PostgreSQL-serverbeheerder.
PostgreSQL-gebruikerswachtwoord
N.v.t.
Het wachtwoord voor de Gebruiker van de PostgreSQL-toepassing, die in de toepassing wordt gebruikt.
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.
Gebruik de volgende stappen om een Azure Spring Apps-exemplaar en een Azure Database for PostgreSQL-exemplaar te maken:
3.1. Meld u aan bij het Azure Portal
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 een service-exemplaar te maken:
Selecteer Een resource maken in de hoek van de portal.
Selecteer Compute>Azure Spring Apps.
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.
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 die zich het dichtst bij uw gebruikers bevindt.
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.
(Optioneel) Vul het tabblad Basisinformatie in met de volgende informatie om een Container Apps-omgeving te maken:
Omgevingsnaam: myacaenv
Abonnement: Verbruik
Zoneredundantie: uitgeschakeld
Selecteer Vervolgens Maken om de Container Apps-omgeving te maken.
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 de overzichtspagina van de service te openen.
3.3. Het PostgreSQL-exemplaar voorbereiden
Gebruik de volgende stappen om een Azure Database for PostgreSQL-server te maken:
Selecteer in Azure Portal Een resource maken.
Selecteer Databases>Azure Database for PostgreSQL Flexible Server.
Vul het tabblad Basisbeginselen in met de volgende informatie:
Servernaam: my-demo-pgsql
Regio: VS - oost
PostgreSQL-versie: 14
Workloadtype: Ontwikkeling
Hoge beschikbaarheid inschakelen: niet geselecteerd
Verificatiemethode: alleen PostgreSQL-verificatie
Gebruikersnaam van beheerder: myadmin
Wachtwoord en wachtwoord bevestigen: voer een wachtwoord in.
Configureer het tabblad Netwerken met behulp van de volgende informatie:
Openbare toegang vanuit elke Azure-service binnen Azure tot deze server toestaan: geselecteerd
Selecteer Beoordelen en maken om uw selecties te controleren en selecteer Vervolgens Maken om de server in te richten. Deze bewerking kan enkele minuten duren.
Ga in het Azure Portal naar uw PostgreSQL-server.
Selecteer Databases in het navigatiemenu om een database te maken, bijvoorbeeld Todo.
3.4. App-exemplaar verbinden met PostgreSQL-exemplaar
Gebruik de volgende stappen om verbinding te maken met uw service-exemplaren:
Ga naar uw Azure Spring Apps-exemplaar in Azure Portal.
Open Apps in het navigatiedeelvenster en selecteer Vervolgens App maken.
Op de pagina App maken gebruikt u simple-todo-web voor de naam van de app en selecteert u De voorbeeld-app Snel starten gebruiken om de app te maken.
Selecteer Maken om het maken van de app te voltooien en selecteer vervolgens de app om de details ervan weer te geven.
Selecteer Configuratie in het navigatiedeelvenster en configureer vervolgens de volgende eigenschappen op het tabblad Omgevingsvariabelen :
SPRING_DATASOURCE_PASSWORD: voer uw wachtwoord in.
Selecteer Opslaan om de verbindingseigenschappen op te slaan.
Gebruik de volgende stappen om een Azure Spring Apps-exemplaar en een Azure Database for PostgreSQL-exemplaar 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 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> in Azure Portal:
https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
Notitie
Het voltooien van deze opdracht 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:
Selecteer onderliggende modules die u wilt configureren: Selecteer de module die u wilt configureren en voer vervolgens het nummer van de SimpleTodo-webmodule in.
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 aantal Azure Spring Apps-exemplaren dat u hebt gemaakt. Als u het standaardnummer gebruikt, drukt u rechtstreeks op Enter .
Openbare toegang voor deze app beschikbaar maken: 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] Start updating app(simple-todo-web)...
[INFO] App(simple-todo-web) is successfully updated.
[INFO] Starting Spring App after deploying artifacts...
[INFO] Deployment Status: Running
[INFO] InstanceName:simple-todo-web--default-xxxxxxx-xxxxxxxxx-xxxxx Status:Running Reason:null DiscoverStatus:NONE
[INFO] Getting public url of app(simple-todo-web)...
[INFO] Application url: https://simple-todo-web.<unique-identifier>.<region-name>.azurecontainerapps.io
De URL van de uitvoertoepassing is het eindpunt voor toegang tot de todo toepassing.
U kunt de app nu implementeren in Azure Spring Apps. 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 simple-todo-web
- Endpoint: https://simple-todo-web.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
Het uitvoereindpunt is het eindpunt voor toegang tot de todo toepassing.
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 Azure-Samples/ASA-Samples-Web-Application 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 van ASA-Samples-Web-Application op GitHub. Er zijn geen lokale voorbereidingsstappen nodig.
Hoewel u Azure Portal in latere stappen gebruikt, moet u de Bash-opdrachtregel gebruiken om het project lokaal voor te bereiden. Gebruik de volgende stappen om de app lokaal te klonen en uit te voeren:
Gebruik de volgende opdracht om het voorbeeldproject te klonen vanuit GitHub:
In de volgende lijst wordt de interactie met de opdracht beschreven:
Voer een nieuwe omgevingsnaam in: 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>
Please 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
De belangrijkste resources die nodig zijn om dit voorbeeld uit te voeren, zijn een Azure Spring Apps-exemplaar en een Azure Database for PostgreSQL-exemplaar. Deze sectie bevat de stappen voor het maken van deze resources.
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.
Postgre SQL-beheerderswachtwoord
N.v.t.
Het wachtwoord voor de PostgreSQL-serverbeheerder.
Postgre SQL-gebruikerswachtwoord
N.v.t.
Het wachtwoord voor de Gebruiker van de PostgreSQL-toepassing, die in de toepassing wordt gebruikt.
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.
Gebruik de volgende stappen om een Azure Spring Apps-exemplaar en een Azure Database for PostgreSQL-exemplaar 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. Een Azure Spring Apps-exemplaar maken
Gebruik de volgende stappen om een service-exemplaar te maken:
Selecteer Een resource maken in de hoek van de portal.
Selecteer Compute>Azure Spring Apps.
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.
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
Basic
Het prijsplan bepaalt de resource en de kosten die zijn gekoppeld aan uw exemplaar.
Regio
De regio die zich het dichtst bij uw gebruikers bevindt.
De locatie die zich het dichtst bij uw gebruikers bevindt.
Zoneredundant
Niet geselecteerd
Of u nu uw Azure Spring Apps-service in een Azure-beschikbaarheidszone wilt maken. Deze functie wordt momenteel alleen ondersteund in sommige regio's.
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 de overzichtspagina van de service te openen.
3.3. Het PostgreSQL-exemplaar voorbereiden
Gebruik de volgende stappen om een Azure Database for PostgreSQL-server te maken:
Selecteer in Azure Portal Een resource maken.
Selecteer Databases>Azure Database for PostgreSQL Flexible Server.
Vul het tabblad Basisbeginselen in met de volgende informatie:
Servernaam: my-demo-pgsql
Regio: VS - oost
PostgreSQL-versie: 14
Workloadtype: Ontwikkeling
Hoge beschikbaarheid inschakelen: niet geselecteerd
Verificatiemethode: alleen PostgreSQL-verificatie
Gebruikersnaam van beheerder: myadmin
Wachtwoord en wachtwoord bevestigen: voer een wachtwoord in.
Configureer het tabblad Netwerken met behulp van de volgende informatie:
Openbare toegang vanuit elke Azure-service binnen Azure tot deze server toestaan: geselecteerd
Selecteer Beoordelen en maken om uw selecties te controleren en selecteer Vervolgens Maken om de server in te richten. Deze bewerking kan enkele minuten duren.
Ga in het Azure Portal naar uw PostgreSQL-server.
Selecteer Databases in het navigatiemenu om een database te maken, bijvoorbeeld Todo.
3.4. App-exemplaar verbinden met PostgreSQL-exemplaar
Gebruik de volgende stappen om verbinding te maken met uw service-exemplaren:
Ga naar uw Azure Spring Apps-exemplaar in Azure Portal.
Open in het navigatiedeelvenster het deelvenster Apps en selecteer App maken.
Gebruik op de pagina App maken voor de naam van de app simple-todo-web en voor het runtimeplatform de optie Java 17.
Selecteer Maken om het maken van de app te voltooien en selecteer de app om details weer te geven.
Selecteer Serviceconnector in het navigatiedeelvenster en selecteer Vervolgens Maken om een nieuwe serviceverbinding te maken.
Vul het tabblad Basisbeginselen in met de volgende informatie:
Servicetype: flexibele DB for PostgreSQL-server
Verbindingsnaam: gevuld met een automatisch gegenereerde naam die u kunt wijzigen.
Abonnement: selecteer uw abonnement.
Flexibele PostgreSQL-server: my-demo-pgsql
PostgreSQL-database: selecteer de database die u hebt gemaakt.
Clienttype: SpringBoot
Configureer het tabblad Volgende: Verificatie met de volgende informatie:
Selecteer het verificatietype dat u wilt gebruiken tussen uw rekenservice en doelservice.: Selecteer verbindingsreeks.
Doorgaan met...: Selecteer databasereferenties.
Gebruikersnaam: myadmin
Wachtwoord: voer uw wachtwoord in.
Selecteer Volgende: Netwerken. Gebruik de standaardoptie Firewallregels configureren om toegang tot de doelservice in te schakelen.
Selecteer Volgende: Controleren en Maken om uw selecties te controleren en selecteer vervolgens Maken om de verbinding te maken.
Gebruik de volgende stappen om een Azure Spring Apps-exemplaar en een Azure Database for PostgreSQL-exemplaar te maken:
Gebruik de volgende opdracht om u aan te melden bij Azure met OAuth2. Negeer deze stap als u al bent 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 het standaardplan :
azd env set PLAN standard
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 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> in Azure Portal:
https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
Notitie
Het voltooien van deze opdracht 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.
U kunt de app nu implementeren in Azure Spring Apps.
In de volgende lijst worden de opdrachteninteracties beschreven:
Selecteer onderliggende modules die u wilt configureren: Selecteer de module die u wilt configureren en voer vervolgens het nummer van de SimpleTodo-webmodule in.
OAuth2-aanmelding: autoriseren van de aanmelding bij Azure 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 .
Selecteer Azure Spring Apps: selecteer het nummer van het Azure Spring Apps-exemplaar dat u hebt gemaakt. Als u het standaardnummer gebruikt, drukt u rechtstreeks op Enter .
Openbare toegang voor deze app beschikbaar maken?: Druk op y.
Bevestig dat u alle bovenstaande configuraties (Y/n) 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:simple-todo-web-default-x-xxxxxxxxxx-xxxxx Status:Running Reason:null DiscoverStatus:UNREGISTERED
[INFO] InstanceName:simple-todo-web-default-x-xxxxxxxxx-xxxxx Status:Terminating Reason:null DiscoverStatus:UNREGISTERED
[INFO] Getting public url of app(simple-todo-web)...
[INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-simple-todo-web.azuremicroservices.io
De URL van de uitvoertoepassing is het eindpunt voor toegang tot de todo toepassing.
U kunt de app nu implementeren in Azure Spring Apps. 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 simple-todo-web
- Endpoint: https://<your-Azure-Spring-Apps-instance-name>-simple-todo-web.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
Het uitvoereindpunt is het eindpunt voor toegang tot de todo toepassing.
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 Azure-Samples/ASA-Samples-Web-Application voor meer informatie.
5. De web-app valideren
Nu hebt u toegang tot de geïmplementeerde app om te zien of deze werkt.
Nadat de implementatie is voltooid, kunt u de toepassings-URL vinden in de uitvoer van de implementatie:
Open de toepassing met de URL van de uitvoertoepassing. De pagina moet worden weergegeven zoals u in localhost hebt gezien.
Controleer de details voor elke resource-implementatie, wat handig is voor het onderzoeken van implementatieproblemen.
Open de toepassing met de URL van de uitvoertoepassing. De pagina moet worden weergegeven zoals u in localhost hebt gezien.
Voer de volgende stappen uit om te valideren:
Nadat de implementatie is voltooid, hebt u toegang tot de app met deze URL: https://${AZURE_SPRING_APPS_NAME}-${APP_NAME}.azuremicroservices.io/. De pagina moet worden weergegeven zoals u in localhost hebt gezien.
Gebruik de volgende opdracht om het logboek van de app te controleren om een implementatieprobleem te onderzoeken:
az spring app logs \
--service ${AZURE_SPRING_APPS_NAME} \
--name ${APP_NAME}
Nadat de implementatie is voltooid, zoekt u de toepassings-URL uit de uitvoer van de implementatie:
Toegang tot de toepassings-URL. De pagina moet worden weergegeven zoals u in localhost hebt gezien.
Controleer de details voor elke resource-implementatie, wat handig is voor het onderzoeken van implementatieproblemen.
Open de toepassing met de URL van de uitvoertoepassing. De pagina moet worden weergegeven zoals u in localhost hebt gezien.
Open de toepassing met het uitvoereindpunt. De pagina moet worden weergegeven zoals u in localhost hebt gezien.
6. Resources opschonen
Verwijder de resources die u in dit artikel hebt gemaakt wanneer u ze niet meer nodig hebt. U kunt de Azure-resourcegroep verwijderen, met alle resources uit de resourcegroep.
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: <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.
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 hele resourcegroep te verwijderen, inclusief de zojuist gemaakte service:
