Quickstart: Uw eerste webtoepassing implementeren in Azure Spring Apps

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.

Het standaardverbruik en het speciale abonnement worden vanaf 30 september 2024 afgeschaft, met een volledige afsluiting na zes maanden. We raden u aan om over te stappen naar Azure Container Apps. Zie Azure Spring Apps Standard-verbruik en toegewezen abonnement migreren naar Azure Container 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:

• Een front-end gebonden React-toepassing .
• Een back-end Spring-webtoepassing die gebruikmaakt van Spring Data JPA voor toegang tot een relationele database.
• Een relationele database. Voor localhost gebruikt de toepassing H2 Database Engine. Voor Azure Spring Apps maakt de toepassing gebruik van Azure Database for PostgreSQL. Zie de documentatie van Flexible Server voor meer informatie over Azure Database for PostgreSQL.

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.

1. Vereisten

Azure-portal

• Een Azure-abonnement. Als u geen abonnement hebt, maakt u een gratis account voordat u begint.

Azure Portal + Maven-invoegtoepassing

• Een Azure-abonnement. Als u geen abonnement hebt, maakt u een gratis account voordat u begint.
• Git.
• Java Development Kit (JDK), versie 17.

Azure Developer CLI

• Een Azure-abonnement. Als u geen abonnement hebt, maakt u een gratis account voordat u begint.
• Git.
• Java Development Kit (JDK), versie 17.
• Azure Developer CLI (AZD), versie 1.2.0 of hoger.

Azure-portal

• Een Azure-abonnement. Als u geen abonnement hebt, maakt u een gratis account voordat u begint.

Azure Portal + Maven-invoegtoepassing

• Een Azure-abonnement. Als u geen abonnement hebt, maakt u een gratis account voordat u begint.
• Git.
• Java Development Kit (JDK), versie 17.

Azure-CLI

• Een Azure-abonnement. Als u geen abonnement hebt, maakt u een gratis account voordat u begint.
• Git.
• Java Development Kit (JDK), versie 17.
• Azure CLI versie 2.45.0 of hoger. Gebruik de volgende opdracht om de Azure Spring Apps-extensie te installeren: az extension add --name spring
• Als u voor het eerst een Azure Spring Apps Enterprise-planexemplaren implementeert in het doelabonnement, raadpleegt u de sectie Vereisten van het Enterprise-plan in Azure Marketplace.

2. Het Spring-project voorbereiden

Azure-portal

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.

Azure Portal + Maven-invoegtoepassing

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:

1. Gebruik de volgende opdracht om het voorbeeldproject te klonen vanuit GitHub:

   git clone https://github.com/Azure-Samples/ASA-Samples-Web-Application.git
   

2. Gebruik de volgende opdracht om het voorbeeldproject te bouwen met Maven:

   cd ASA-Samples-Web-Application
   ./mvnw clean package
   

3. Gebruik de volgende opdracht om de voorbeeldtoepassing uit te voeren:

   java -jar web/target/simple-todo-web.jar
   

4. Ga naar http://localhost:8080 in uw browser om toegang te krijgen tot de toepassing.

Azure-CLI

Gebruik de volgende stappen om de app lokaal te klonen en uit te voeren:

1. Gebruik de volgende opdracht om het voorbeeldproject te klonen vanuit GitHub:

   git clone https://github.com/Azure-Samples/ASA-Samples-Web-Application.git
   

2. Gebruik de volgende opdracht om het voorbeeldproject te bouwen met Maven:

   cd ASA-Samples-Web-Application
   ./mvnw clean package
   

3. Gebruik de volgende opdracht om de voorbeeldtoepassing uit te voeren:

   java -jar web/target/simple-todo-web.jar
   

4. 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.

Azure-portal

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:

1. Selecteer de volgende knop Implementeren in Azure om de implementatie-ervaring in Azure Portal te starten:

   

2. 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.

   

3. Selecteer Controleren en Maken om uw selecties te controleren. Selecteer vervolgens Maken om de app te implementeren in Azure Spring Apps.

4. 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.

   

Azure Portal + Maven-invoegtoepassing

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:

1. Selecteer Een resource maken in de hoek van Azure Portal.

2. Selecteer Compute>Azure Spring Apps.

   

3. 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.

   

4. Selecteer Controleren en Maken om uw selecties te controleren. Selecteer Vervolgens Maken om het Azure Spring Apps-exemplaar in te richten.

5. 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.

   

6. 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:

1. Selecteer in Azure Portal Een resource maken.

2. Selecteer Databases>Azure Database for PostgreSQL Flexible Server.

   

3. 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.

4. Configureer het tabblad Netwerken met behulp van de volgende informatie:

   • Connectiviteitsmethode: Openbare toegang (toegestane IP-adressen)
   • Openbare toegang vanuit elke Azure-service binnen Azure tot deze server toestaan: geselecteerd

   

5. 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.

6. Ga naar uw PostgreSQL-server in Azure Portal.

7. 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:

1. Ga naar uw Azure Spring Apps-exemplaar in Azure Portal.

2. Open Apps in het navigatiedeelvenster en selecteer Vervolgens App maken.

3. 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.

4. Selecteer Maken om het maken van de app te voltooien en selecteer vervolgens de app om de details weer te geven.

5. Selecteer Serviceconnector in het navigatiedeelvenster en selecteer Vervolgens Maken om een nieuwe serviceverbinding te maken.

   

6. 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

   

7. 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.

   

8. Selecteer Volgende: Netwerken. Gebruik de standaardoptie Firewallregels configureren om toegang tot de doelservice in te schakelen.

9. Selecteer Volgende: Controleren en Maken om uw selecties te controleren en selecteer vervolgens Maken om de verbinding te maken.

Azure-CLI

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.

export RESOURCE_GROUP=<resource-group-name>
export LOCATION=<location>
export POSTGRESQL_SERVER=<server-name>
export POSTGRESQL_DB=<database-name>
export POSTGRESQL_ADMIN_USERNAME=<admin-username>
export POSTGRESQL_ADMIN_PASSWORD=<admin-password>
export AZURE_SPRING_APPS_NAME=<Azure-Spring-Apps-service-instance-name>
export APP_NAME=<web-app-name>

3.2. Een nieuwe resourcegroep maken

Gebruik de volgende stappen om een nieuwe resourcegroep te maken.

1. Gebruik de volgende opdracht om u aan te melden bij de Azure CLI.

   az login
   

2. Gebruik de volgende opdracht om de standaardlocatie in te stellen.

   az configure --defaults location=${LOCATION}
   

3. Gebruik de volgende opdracht om alle beschikbare abonnementen weer te geven om de abonnements-id te bepalen die moet worden gebruikt.

   az account list --output table
   

4. Gebruik de volgende opdracht om het standaardabonnement in te stellen:

   az account set --subscription <subscription-ID>
   

5. Gebruik de volgende opdracht om een resourcegroep te maken.

   az group create --resource-group ${RESOURCE_GROUP}
   

6. Gebruik de volgende opdracht om de zojuist gemaakte resourcegroep in te stellen als de standaardresourcegroep.

   az configure --defaults group=${RESOURCE_GROUP}
   

3.3. Een Azure Spring Apps-exemplaar maken

Azure Spring Apps wordt gebruikt voor het hosten van de Spring-web-app. Maak een Azure Spring Apps-exemplaar en een toepassing erin.

1. Gebruik de volgende opdracht om een Azure Spring Apps-service-exemplaar te maken.

   az spring create --name ${AZURE_SPRING_APPS_NAME} --sku enterprise
   

2. Gebruik de volgende opdracht om een toepassing te maken in het Azure Spring Apps-exemplaar.

   az spring app create \
       --service ${AZURE_SPRING_APPS_NAME} \
       --name ${APP_NAME} \
       --assign-endpoint true
   

3.4. Het PostgreSQL-exemplaar voorbereiden

De Spring-web-app maakt gebruik van H2 voor de database in localhost en Azure Database for PostgreSQL voor de database in Azure.

Gebruik de volgende opdracht om een PostgreSQL-exemplaar te maken:

az postgres flexible-server create \
    --name ${POSTGRESQL_SERVER} \
    --database-name ${POSTGRESQL_DB} \
    --admin-user ${POSTGRESQL_ADMIN_USERNAME} \
    --admin-password ${POSTGRESQL_ADMIN_PASSWORD} \
    --public-access 0.0.0.0

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.

1. Gebruik de volgende opdracht om de fully qualified domain name van het PostgreSQL-exemplaar op te halen:

   export PSQL_FQDN=$(az postgres flexible-server show \
       --name ${POSTGRESQL_SERVER} \
       --query fullyQualifiedDomainName \
       --output tsv)
   

2. Gebruik de volgende opdracht om de spring.datasource. eigenschappen voor de app op te geven via omgevingsvariabelen:

   az spring app update \
       --service ${AZURE_SPRING_APPS_NAME} \
       --name ${APP_NAME} \
       --env SPRING_DATASOURCE_URL="jdbc:postgresql://${PSQL_FQDN}:5432/${POSTGRESQL_DB}?sslmode=require" \
             SPRING_DATASOURCE_USERNAME="${POSTGRESQL_ADMIN_USERNAME}" \
             SPRING_DATASOURCE_PASSWORD="${POSTGRESQL_ADMIN_PASSWORD}"
   

4. De app implementeren in Azure Spring Apps

Azure-portal

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.

Azure Portal + Maven-invoegtoepassing

Gebruik de volgende stappen om te implementeren met behulp van de Maven-invoegtoepassing voor Azure Spring Apps:

1. Navigeer naar de volledige map en voer vervolgens de volgende opdracht uit om de app te configureren in Azure Spring Apps:

   ./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.19.0:config
   

   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.

2. 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.

Azure-CLI

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

2. Het Spring-project voorbereiden

Azure-portal

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.

Azure Portal + Maven-invoegtoepassing

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:

1. Gebruik de volgende opdracht om het voorbeeldproject te klonen vanuit GitHub:

   git clone https://github.com/Azure-Samples/ASA-Samples-Web-Application.git
   

2. Gebruik de volgende opdracht om het voorbeeldproject te bouwen met Maven:

   cd ASA-Samples-Web-Application
   ./mvnw clean package
   

3. Gebruik de volgende opdracht om de voorbeeldtoepassing uit te voeren:

   java -jar web/target/simple-todo-web.jar
   

4. Ga naar http://localhost:8080 in uw browser om toegang te krijgen tot de toepassing.

Azure Developer CLI

Gebruik de volgende stappen om de webtoepassing te initialiseren vanuit de Azure Developer CLI-sjablonen:

1. Open een terminal, maak een lege map en wijzig de map erin.

2. Gebruik de volgende opdracht om het project te initialiseren:

   azd init --template https://github.com/Azure-Samples/ASA-Samples-Web-Application
   

   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.

Azure-portal

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:

1. Selecteer de volgende knop Implementeren in Azure om de implementatie-ervaring in Azure Portal te starten:

   

2. 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.

   

3. Selecteer Controleren en Maken om uw selecties te controleren. Selecteer vervolgens Maken om de app te implementeren in Azure Spring Apps.

4. 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.

   

Azure Portal + Maven-invoegtoepassing

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:

1. Selecteer Een resource maken in de hoek van de portal.

2. Selecteer Compute>Azure Spring Apps.

   

3. 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.

   

4. (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.

5. Selecteer Controleren en Maken om uw selecties te controleren. Selecteer Vervolgens Maken om het Azure Spring Apps-exemplaar in te richten.

6. 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:

1. Selecteer in Azure Portal Een resource maken.

2. Selecteer Databases>Azure Database for PostgreSQL Flexible Server.

   

3. 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.

4. Configureer het tabblad Netwerken met behulp van de volgende informatie:

   • Connectiviteitsmethode: Openbare toegang (toegestane IP-adressen)
   • Openbare toegang vanuit elke Azure-service binnen Azure tot deze server toestaan: geselecteerd

   

5. 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.

6. Ga naar uw PostgreSQL-server in Azure Portal.

7. 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:

1. Ga naar uw Azure Spring Apps-exemplaar in Azure Portal.

2. Open Apps in het navigatiedeelvenster en selecteer Vervolgens App maken.

3. 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.

   

4. Selecteer Maken om het maken van de app te voltooien en selecteer vervolgens de app om de details ervan weer te geven.

5. Selecteer Configuratie in het navigatiedeelvenster en configureer vervolgens de volgende eigenschappen op het tabblad Omgevingsvariabelen :

   • SPRING_DATASOURCE_URL: jdbc:postgresql://my-demo-pgsql.postgres.database.azure.com:5432/todo?sslmode=require
   • SPRING_DATASOURCE_USERNAME: myadmin
   • SPRING_DATASOURCE_PASSWORD: voer uw wachtwoord in.

   

6. Selecteer Opslaan om de verbindingseigenschappen op te slaan.

Azure Developer CLI

Gebruik de volgende stappen om een Azure Spring Apps-exemplaar en een Azure Database for PostgreSQL-exemplaar te maken:

1. 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.
   

2. 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.

4. De app implementeren in Azure Spring Apps

Azure-portal

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.

Azure Portal + Maven-invoegtoepassing

Gebruik de volgende stappen om te implementeren met behulp van de Maven-invoegtoepassing voor Azure Spring Apps:

1. Navigeer naar de volledige map en voer vervolgens de volgende opdracht uit om de app te configureren in Azure Spring Apps:

   ./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.19.0:config
   

   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.

2. 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.

Azure Developer CLI

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:

1. 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.
   

2. 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.

2. Het Spring-project voorbereiden

Azure-portal

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.

Azure Portal + Maven-invoegtoepassing

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:

1. Gebruik de volgende opdracht om het voorbeeldproject te klonen vanuit GitHub:

   git clone https://github.com/Azure-Samples/ASA-Samples-Web-Application.git
   

2. Gebruik de volgende opdracht om het voorbeeldproject te bouwen met Maven:

   cd ASA-Samples-Web-Application
   ./mvnw clean package
   

3. Gebruik de volgende opdracht om de voorbeeldtoepassing uit te voeren:

   java -jar web/target/simple-todo-web.jar
   

4. Ga naar http://localhost:8080 in uw browser om toegang te krijgen tot de toepassing.

Azure Developer CLI

Gebruik de volgende stappen om de webtoepassing te initialiseren vanuit de Azure Developer CLI-sjablonen:

1. Open een terminal, maak een lege map en wijzig de map erin.

2. Gebruik de volgende opdracht om het project te initialiseren:

   azd init --template https://github.com/Azure-Samples/ASA-Samples-Web-Application
   

   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.

Azure-portal

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:

1. Selecteer de volgende knop Implementeren in Azure om de implementatie-ervaring in Azure Portal te starten:

   

2. 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.

   

3. Selecteer Controleren en Maken om uw selecties te controleren. Selecteer Vervolgens Maken om de app te implementeren in Azure Spring Apps.

4. 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.

   

Azure Portal + Maven-invoegtoepassing

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:

1. Selecteer Een resource maken in de hoek van de portal.

2. Selecteer Compute>Azure Spring Apps.

   

3. 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.

   

4. Selecteer Controleren en Maken om uw selecties te controleren. Selecteer Vervolgens Maken om het Azure Spring Apps-exemplaar in te richten.

5. 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:

1. Selecteer in Azure Portal Een resource maken.

2. Selecteer Databases>Azure Database for PostgreSQL Flexible Server.

   

3. 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.

4. Configureer het tabblad Netwerken met behulp van de volgende informatie:

   • Connectiviteitsmethode: Openbare toegang (toegestane IP-adressen)
   • Openbare toegang vanuit elke Azure-service binnen Azure tot deze server toestaan: geselecteerd

   

5. 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.

6. Ga naar uw PostgreSQL-server in Azure Portal.

7. 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:

1. Ga naar uw Azure Spring Apps-exemplaar in Azure Portal.

2. Open in het navigatiedeelvenster het deelvenster Apps en selecteer App maken.

3. Gebruik op de pagina App maken voor de naam van de app simple-todo-web en voor het runtimeplatform de optie Java 17.

   

4. Selecteer Maken om het maken van de app te voltooien en selecteer de app om details weer te geven.

5. Selecteer Serviceconnector in het navigatiedeelvenster en selecteer Vervolgens Maken om een nieuwe serviceverbinding te maken.

   

6. 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

   

7. 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.

   

8. Selecteer Volgende: Netwerken. Gebruik de standaardoptie Firewallregels configureren om toegang tot de doelservice in te schakelen.

9. Selecteer Volgende: Controleren en Maken om uw selecties te controleren en selecteer vervolgens Maken om de verbinding te maken.

Azure Developer CLI

Gebruik de volgende stappen om een Azure Spring Apps-exemplaar en een Azure Database for PostgreSQL-exemplaar te maken:

1. 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.
   

2. Gebruik de volgende opdracht om de sjabloon in te stellen met het standaardplan :

   azd env set PLAN standard
   

3. 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.

4. De app implementeren in Azure Spring Apps

Azure-portal

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.

Azure Portal + Maven-invoegtoepassing

U kunt de app nu implementeren in Azure Spring Apps.

Gebruik de volgende stappen om te implementeren met de Maven-invoegtoepassing voor Azure Spring Apps:

1. Navigeer naar de voorbeeldprojectmap en voer de volgende opdracht uit om de app te configureren in Azure Spring Apps:

   ./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.19.0:config
   

   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.

2. 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.

Azure Developer CLI

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:

1. 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.
   

2. 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.

Azure-portal

Voer de volgende stappen uit om te valideren:

1. Nadat de implementatie is voltooid, kunt u de toepassings-URL vinden in de uitvoer van de implementatie:

   

2. Open de toepassing met de URL van de uitvoertoepassing. De pagina moet worden weergegeven zoals u in localhost hebt gezien.

3. Controleer de details voor elke resource-implementatie, wat handig is voor het onderzoeken van implementatieproblemen.

Azure Portal + Maven-invoegtoepassing

Open de toepassing met de URL van de uitvoertoepassing. De pagina moet worden weergegeven zoals u in localhost hebt gezien.

Azure-CLI

Voer de volgende stappen uit om te valideren:

1. 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.

2. 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}
   

Azure-portal

Voer de volgende stappen uit om te valideren:

1. Nadat de implementatie is voltooid, kunt u de toepassings-URL vinden in de uitvoer van de implementatie:

   

2. Toegang tot de toepassings-URL. De pagina moet worden weergegeven zoals u in localhost hebt gezien.

3. Controleer de details voor elke resource-implementatie, wat handig is voor het onderzoeken van implementatieproblemen.

Azure Portal + Maven-invoegtoepassing

Open de toepassing met de URL van de uitvoertoepassing. De pagina moet worden weergegeven zoals u in localhost hebt gezien.

Azure Developer CLI

Open de toepassing met het uitvoereindpunt. De pagina moet worden weergegeven zoals u in localhost hebt gezien.

Azure-portal

Voer de volgende stappen uit om te valideren:

1. Nadat de implementatie is voltooid, zoekt u de toepassings-URL uit de uitvoer van de implementatie:

   

2. Toegang tot de toepassings-URL. De pagina moet worden weergegeven zoals u in localhost hebt gezien.

3. Controleer de details voor elke resource-implementatie, wat handig is voor het onderzoeken van implementatieproblemen.

Azure Portal + Maven-invoegtoepassing

Open de toepassing met de URL van de uitvoertoepassing. De pagina moet worden weergegeven zoals u in localhost hebt gezien.

Azure Developer CLI

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.

Azure-portal

Gebruik de volgende stappen om de hele resourcegroep te verwijderen, inclusief het zojuist gemaakte service-exemplaar:

1. Zoek de resourcegroep in Azure Portal. Selecteer resourcegroepen in het navigatiemenu en selecteer vervolgens de naam van uw resourcegroep.

2. 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.

Azure Portal + Maven-invoegtoepassing

Gebruik de volgende stappen om de hele resourcegroep te verwijderen, inclusief het zojuist gemaakte service-exemplaar:

1. Zoek de resourcegroep in Azure Portal. Selecteer resourcegroepen in het navigatiemenu en selecteer vervolgens de naam van uw resourcegroep.

2. 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.

Azure Developer CLI

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.

Azure-portal

Gebruik de volgende stappen om de hele resourcegroep te verwijderen, inclusief het zojuist gemaakte service-exemplaar:

1. Zoek de resourcegroep in Azure Portal. Selecteer resourcegroepen in het navigatiemenu en selecteer vervolgens de naam van uw resourcegroep.

2. 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.

Azure Portal + Maven-invoegtoepassing

Gebruik de volgende stappen om de hele resourcegroep te verwijderen, inclusief het zojuist gemaakte service-exemplaar:

1. Zoek de resourcegroep in Azure Portal. Selecteer resourcegroepen in het navigatiemenu en selecteer vervolgens de naam van uw resourcegroep.

2. 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.

Azure-CLI

Gebruik de volgende opdracht om de hele resourcegroep te verwijderen, inclusief de zojuist gemaakte service:

az group delete --name ${RESOURCE_GROUP}

7. Volgende stappen

Gestructureerd toepassingslogboek voor Azure Spring Apps

Een bestaand aangepast domein toewijzen aan Azure Spring Apps

Azure Spring Apps CI/CD instellen met GitHub Actions

Toepassingsimplementaties automatiseren in Azure Spring Apps

Beheerde identiteiten gebruiken voor toepassingen in Azure Spring Apps

Quickstart: Een serviceverbinding maken in Azure Spring Apps met de Azure CLI

Inleiding tot de voorbeeld-app

Inleiding tot de Fitness Store-voorbeeld-app

Raadpleeg voor meer informatie de volgende artikelen:

• Voorbeelden van Azure Spring Apps.
• Azure voor Spring-ontwikkelaars
• Documentatie voor Spring Cloud Azure