Udostępnij przez


Jak wdrożyć aplikacje Spring Boot z poziomu interfejsu wiersza polecenia platformy Azure

Uwaga

Plany Basic, Standardi Enterprise weszły w okres wycofywania 17 marca 2025 r. Aby uzyskać więcej informacji, zobacz ogłoszenie o wycofaniu usługi Azure Spring Apps.

Ten artykuł dotyczy:✅ Java ❎ C#

Ten artykuł dotyczy:✅ Podstawowa/Standardowa ❎️ Enterprise

Usługa Azure Spring Apps umożliwia korzystanie z aplikacji Spring Boot na platformie Azure.

Aplikacje można uruchamiać bezpośrednio z kodu źródłowego Java lub ze wstępnie utworzonego pliku JAR. W tym artykule opisano procedury wdrażania.

Wymagania wstępne

Przed rozpoczęciem upewnij się, że subskrypcja platformy Azure ma wymagane zależności:

  1. Zainstaluj oprogramowanie Git
  2. Instalowanie zestawu JDK 8
  3. Instalowanie programu Maven w wersji 3.0 lub nowszej
  4. Zainstalowanie interfejsu wiersza polecenia platformy Azure
  5. Tworzenie konta w celu uzyskania subskrypcji platformy Azure

Napiwek

Usługa Azure Cloud Shell to bezpłatna interaktywna powłoka, której możesz używać do wykonywania kroków opisanych w tym artykule. Wstępnie zainstalowane narzędzia platformy Azure, w tym najnowsze wersje Git, JDK, Maven i Azure CLI. Jeśli logujesz się do subskrypcji platformy Azure, uruchom usługę Azure Cloud Shell z shell.azure.com. Aby dowiedzieć się więcej na temat usługi Azure Cloud Shell, przeczytaj naszą dokumentację

Instalowanie rozszerzenia interfejsu wiersza polecenia platformy Azure

Zainstaluj rozszerzenie Azure Spring Apps dla interfejsu wiersza polecenia platformy Azure za pomocą następującego polecenia

az extension add --name spring

Skonfiguruj wystąpienie usługi za pomocą Azure CLI

Zaloguj się do interfejsu wiersza polecenia platformy Azure i wybierz aktywną subskrypcję.

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

Utwórz grupę zasobów, aby pomieścić swoją usługę w Azure Spring Apps. Możesz dowiedzieć się więcej o grupach zasobów platformy Azure.

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

Uruchom następujące polecenia, aby przygotować instancję usługi Azure Spring Apps. Przygotuj nazwę usługi w usłudze Azure Spring Apps. Nazwa musi zawierać od 4 do 32 znaków i może zawierać tylko małe litery, cyfry i łączniki. Pierwszy znak nazwy usługi musi być literą, a ostatni znak musi być literą lub cyfrą.

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

Zainstalowanie instancji usługi zajmie około pięciu minut.

Ustaw domyślną nazwę grupy zasobów i nazwę wystąpienia usługi Azure Spring Apps przy użyciu następujących poleceń:

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

Tworzenie aplikacji w usłudze Azure Spring Apps

Następujące polecenie tworzy aplikację w usłudze Azure Spring Apps w ramach subskrypcji. Spowoduje to utworzenie pustej usługi, do której można przekazać aplikację.

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

Wdrażanie aplikacji Spring Boot

Aplikację można wdrożyć ze wstępnie utworzonego pliku JAR lub z repozytorium Gradle lub Maven. Znajdź instrukcje dla każdego przypadku poniżej.

Wdróż wstępnie utworzony plik JAR

Aby wdrożyć plik JAR oparty na komputerze lokalnym, upewnij się, że kompilacja generuje plik FAT-JAR.

Aby wdrożyć plik FAT-JAR w aktywnym wdrożeniu

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

Aby wdrożyć plik FAT-JAR w określonym wdrożeniu

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

Wdrażanie z kodu źródłowego

Usługa Azure Spring Apps używa pakietu kpack do kompilowania projektu. Za pomocą interfejsu wiersza polecenia platformy Azure możesz przekazać kod źródłowy, skompilować projekt przy użyciu pakietu kpack i wdrożyć go w aplikacji docelowej.

Ostrzeżenie

Projekt musi utworzyć tylko jeden plik JAR z wpisem main-class w MANIFEST.MF w target (dla wdrożeń Maven) lub build/libs (dla wdrożeń narzędzia Gradle). Wiele plików JAR z wpisami main-class spowoduje niepowodzenie wdrożenia.

W przypadku projektów Programu Maven/Gradle z jednym modułem:

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

W przypadku projektów Maven/Gradle z wieloma modułami powtórz dla każdego modułu:

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

Pokaż dzienniki wdrażania

Przejrzyj dzienniki kompilacji kpack przy użyciu następującego polecenia:

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

Uwaga

Dzienniki kpack będą pokazywać tylko najnowsze wdrożenie, jeśli to wdrożenie zostało skompilowane ze źródła przy użyciu pakietu kpack.

Przypisywanie publicznego punktu końcowego do aplikacji

  1. Otwórz panel Aplikacje aby wyświetlić aplikacje dla wystąpienia usługi.
  2. Wybierz aplikację, aby wyświetlić jej stronę Przegląd .
  3. Wybierz pozycję Przypisz punkt końcowy, aby przypisać publiczny punkt końcowy do aplikacji. Proces może potrwać kilka minut.
  4. Skopiuj adres URL ze strony Przegląd i wklej go w przeglądarce, aby wyświetlić uruchomioną aplikację.

Następne kroki

Szybki start: monitorowanie usługi Azure Spring Apps przy użyciu dzienników, metryk i śledzenia

Więcej przykładów jest dostępnych w witrynie GitHub: Przykłady usługi Azure Spring Apps.