Spring Boot-toepassingen implementeren vanuit Azure CLI

Artikel
04/23/2024

Notitie

Azure Spring Apps is de nieuwe naam voor de Azure Spring Cloud-service. Hoewel de service een nieuwe naam heeft, ziet u de oude naam op sommige plaatsen terwijl we werken aan het bijwerken van assets, zoals schermopnamen, video's en diagrammen.

Dit artikel is van toepassing op: ✔️ Java ❌ C#

Dit artikel is van toepassing op: ✔️ Basic/Standard ❌± Enterprise

Met Azure Spring Apps kunt u Spring Boot-toepassingen in Azure inschakelen.

U kunt toepassingen rechtstreeks vanuit Java-broncode of vanuit een vooraf gebouwde JAR starten. In dit artikel worden de implementatieprocedures beschreven.

Vereisten

Voordat u begint, moet u ervoor zorgen dat uw Azure-abonnement over de vereiste afhankelijkheden beschikt:

Tip

Azure Cloud Shell is een gratis interactieve shell waarmee u de stappen in dit artikel kunt uitvoeren. Deze bevat vooraf geïnstalleerde algemene Azure-hulpprogramma's, met inbegrip van de nieuwste versies van Git, JDK, Maven en de Azure CLI. Als u bent aangemeld bij uw Azure-abonnement, start u uw Azure Cloud Shell vanuit shell.azure.com. Meer informatie over Azure Cloud Shell vindt u door onze documentatie te lezen

De Azure CLI-extensie installeren

Installeer de Azure Spring Apps-extensie voor de Azure CLI met de volgende opdracht

az extension add --name spring

Een service-exemplaar inrichten met behulp van de Azure CLI

Meld u aan bij de Azure CLI en kies uw actieve abonnement.

az login
az account list -o table
az account set --subscription <subscription-id>

Maak een resourcegroep die uw service in Azure Spring Apps bevat. Hier vindt u meer informatie over Azure-resourcegroepen.

az group create --location eastus --name <resource-group-name>

Voer de volgende opdrachten uit om een exemplaar van Azure Spring Apps in te richten. Bereid een naam voor uw service in Azure Spring Apps voor. 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.

az spring create --resource-group <resource-group-name> --name <resource-name>

De implementatie van het service-exemplaar duurt ongeveer vijf minuten.

Stel de standaardnaam van de resourcegroep en de naam van het Azure Spring Apps-exemplaar in met behulp van de volgende opdrachten:

az config set defaults.group=<service-group-name>
az config set defaults.spring=<service-instance-name>

De toepassing maken in Azure Spring Apps

Met de volgende opdracht maakt u een toepassing in Azure Spring Apps in uw abonnement. Hiermee maakt u een lege service waarnaar u uw toepassing kunt uploaden.

az spring app create --name <app-name>

Uw Spring Boot-toepassing implementeren

U kunt uw toepassing implementeren vanuit een vooraf gebouwde JAR of vanuit een Gradle- of Maven-opslagplaats. Hieronder vindt u de instructies voor beide gevallen.

Een vooraf gebouwde JAR implementeren

Als u wilt implementeren vanuit een JAR die op uw lokale computer is gebouwd, moet u ervoor zorgen dat uw build een fat-JARproduceert.

De fat-JAR implementeren in een actieve implementatie

az spring app deploy --name <app-name> --artifact-path <path-to-fat-JAR>

De fat-JAR implementeren in een specifieke implementatie

az spring app deployment create --app <app-name> \
    --name <deployment-name> \
    --artifact-path <path-to-fat-JAR>

Implementeren vanuit broncode

Azure Spring Apps maakt gebruik van kpack om uw project te bouwen. U kunt Azure CLI gebruiken om uw broncode te uploaden, uw project te bouwen met kpack en het te implementeren in de doeltoepassing.

Waarschuwing

Het project moet slechts één JAR-bestand produceren met een main-class-vermelding in de MANIFEST.MF in target (voor Maven-implementaties) of build/libs (voor Gradle-implementaties). Meerdere JAR-bestanden met main-class-vermeldingen zullen ervoor zorgen dat de implementatie mislukt.

Voor Maven-/Gradle-projecten met één module:

cd <path-to-maven-or-gradle-source-root>
az spring app deploy --name <app-name> --source-path

Voor Maven-/Gradle-projecten met meerdere modules herhaalt u voor elke module:

cd <path-to-maven-or-gradle-source-root>
az spring app deploy --name <app-name> --source-path \
    --target-module <relative-path-to-module>

Implementatielogboeken weergeven

Bekijk de kpack-buildlogboeken met behulp van de volgende opdracht:

az spring app show-deploy-log --name <app-name>

Notitie

In de kpack-logboeken wordt alleen de meest recente implementatie weergegeven als die implementatie is gebouwd op basis van de bron met behulp van kpack.

Een openbaar eindpunt toewijzen aan een toepassing

Open het deelvenster Apps om apps voor uw service-exemplaar weer te geven.
Selecteer een toepassing om de overzichtspagina ervan weer te geven.
Selecteer Eindpunt toewijzen om een openbaar eindpunt toe te wijzen aan de toepassing. Dit proces kan enkele minuten in beslag nemen.
Kopieer de URL van de overzichtspagina en plak deze in uw browser om de actieve toepassing weer te geven.

Volgende stappen

Quickstart: Azure Spring Apps bewaken met logboeken, metrische gegevens en tracering

Er zijn meer voorbeelden beschikbaar op GitHub: Azure Spring Apps-voorbeelden.

Share via