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

  • Artykuł

Uwaga

Azure Spring Apps to nowa nazwa usługi Azure Spring Cloud. Mimo że usługa ma nową nazwę, stara nazwa będzie widoczna w niektórych miejscach przez pewien czas, ponieważ pracujemy nad aktualizowaniem zasobów, takich jak zrzuty ekranu, filmy wideo i diagramy.

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 zestawów Git, JDK, Maven i interfejsu wiersza polecenia platformy Azure. 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

Aprowizuj wystąpienie usługi przy użyciu interfejsu wiersza polecenia platformy Azure

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 zawierającą usługę w usłudze 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 aprowizować wystąpienie 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>

Wdrożenie wystąpienia usługi potrwa 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.

Wdrażanie wstępnie utworzonego pliku 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 pliku MANIFEST.MFtarget (w przypadku wdrożeń maven) lub build/libs (w przypadku 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 okienko 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.