Szybki start: wdrażanie pierwszej aplikacji w usłudze Azure Spring Apps

Artykuł
09/03/2023

Uwaga

Pierwsze 50 godzin procesorów wirtualnych i 100 GB pamięci jest wolne każdego miesiąca. Aby uzyskać więcej informacji, zobacz Price Reduction — Azure Spring Apps robi więcej, kosztuje mniej! w blogu Aplikacje na platformie Azure.

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.

W tym artykule wyjaśniono, jak wdrożyć małą aplikację do uruchamiania w usłudze Azure Spring Apps.

Kod aplikacji używany w tym samouczku jest prostą aplikacją. Po ukończeniu tego przykładu aplikacja jest dostępna w trybie online i można nią zarządzać za pośrednictwem Azure Portal.

W tym artykule opisano następujące dwie opcje wdrażania w usłudze Azure Spring Apps:

Azure Portal to bardziej konwencjonalny sposób tworzenia zasobów i wdrażania aplikacji krok po kroku. Jest ona odpowiednia dla deweloperów platformy Spring, którzy po raz pierwszy korzystają z usług w chmurze platformy Azure.
Azure Developer CLI to bardziej wydajny sposób automatycznego tworzenia zasobów i wdrażania aplikacji za pomocą prostych poleceń. Obejmuje ona kod aplikacji i infrastrukturę jako pliki kodu potrzebne do aprowizacji zasobów platformy Azure. Jest ona odpowiednia dla deweloperów platformy Spring, którzy znają usługi w chmurze platformy Azure.

Subskrypcja platformy Azure. Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto platformy Azure.
Git.
Java Development Kit (JDK), wersja 17.

Subskrypcja platformy Azure. Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto platformy Azure.
Jeśli wdrażasz wystąpienie planu Usługi Azure Spring Apps Enterprise po raz pierwszy w subskrypcji docelowej, zobacz sekcję Wymagania planu Enterprise w Azure Marketplace.
Git.
Java Development Kit (JDK), wersja 17.
Interfejs wiersza polecenia platformy Azure w wersji 2.45.0 lub nowszej.

2. Przygotowanie projektu Spring

Witryna Azure Portal
Azure Developer CLI

Aby przygotować projekt, wykonaj następujące czynności:

Użyj następującego polecenia, aby sklonować przykładowy projekt Spring Boot dla platformy Azure z usługi GitHub.
```
git clone https://github.com/spring-guides/gs-spring-boot-for-azure.git
```
Użyj następującego polecenia, aby przejść do folderu projektu:
```
cd gs-spring-boot-for-azure/complete
```
Użyj następującego polecenia narzędzia Maven , aby skompilować projekt:
```
./mvnw clean package
```
Uruchom przykładowy projekt lokalnie, używając następującego polecenia:
```
./mvnw spring-boot:run
```

Aby zainicjować aplikację z szablonów Azure Developer CLI, wykonaj następujące kroki:

Otwórz okno terminalu, utwórz nowy folder, a następnie przejdź do niego.

Użyj następującego polecenia, aby zainicjować projekt:

azd init --template spring-guides/gs-spring-boot-for-azure

Poniższa lista zawiera opis interakcji poleceń:

Wprowadź nową nazwę środowiska: podaj nazwę środowiska, która jest używana jako sufiks dla grupy zasobów utworzonej do przechowywania wszystkich zasobów platformy Azure. Ta nazwa powinna być unikatowa w ramach subskrypcji platformy Azure.

Konsola generuje komunikaty podobne do następującego przykładu:

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. Przygotowanie środowiska chmury

Głównym zasobem, który należy uruchomić w tym przykładzie, jest wystąpienie usługi Azure Spring Apps. Aby utworzyć ten zasób, wykonaj następujące czynności.

Witryna Azure Portal
Azure Developer CLI

Otwórz przeglądarkę internetową i przejdź do Azure Portal. Wprowadź swoje poświadczenia, aby zalogować się do portalu. Widok domyślny to pulpit nawigacyjny usług.

3.2. Tworzenie wystąpienia usługi Azure Spring Apps

Aby utworzyć wystąpienie usługi Azure Spring Apps, wykonaj następujące czynności:

Wybierz pozycję Utwórz zasób w rogu Azure Portal.
Wybierz pozycję Compute>Azure Spring Apps.

Wypełnij formularz Podstawowe , korzystając z poniższych informacji.

Poniższa tabela zawiera wskazówki dotyczące wypełniania formularza. Zalecany plan to Standard consumption & dedicated (preview).

Ustawienie	Sugerowana wartość	Opis
Subskrypcja	Nazwa subskrypcji użytkownika	Subskrypcja platformy Azure, która ma być używana dla serwera. Jeśli masz wiele subskrypcji, wybierz subskrypcję, w której chcesz naliczać opłaty za zasób.
Grupa zasobów	myresourcegroup	Nowa nazwa grupy zasobów lub istniejąca nazwa z subskrypcji.
Nazwa	myasa	Unikatowa nazwa identyfikująca usługę 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ą.
Planowanie	& Użycie standardowe dedykowane (wersja zapoznawcza)	Plan cenowy określa zasób i koszt skojarzony z wystąpieniem.
Region (Region)	Region najbliżej Twoich użytkowników	Lokalizacja znajdująca się najbliżej użytkowników.
Środowisko usługi Container Apps	myacaenv	Środowisko to bezpieczna granica wokół co najmniej jednej aplikacji kontenera, która może komunikować się ze sobą i udostępniać sieć wirtualną, rejestrowanie i konfigurację języka Dapr.

(Opcjonalnie) Utwórz środowisko usługi Container Apps.
- Obciążenie zużyciem
- Dedykowane obciążenie
1. Wypełnij kartę Podstawy następującymi informacjami:
  - Nazwa środowiska: myacaenv
  - Plan: Zużycie
  - Nadmiarowość strefy: wyłączone
2. Wybierz pozycję Utwórz , aby utworzyć środowisko usługi Container Apps.
1. Wypełnij kartę Podstawy następującymi informacjami:
  - Nazwa środowiska: myacaenv
  - Plan: (wersja zapoznawcza) Użycie i profile dedykowanego obciążenia
  - Nadmiarowość strefy: wyłączone
2. Wybierz kartę Profile obciążeń (wersja zapoznawcza), a następnie wybierz pozycję Dodaj profil obciążenia , aby dodać profil obciążenia.
3. Na stronie Dodawanie profilu obciążenia (wersja zapoznawcza) dodaj następujące informacje:
  - Nazwa profilu obciążenia: my-wlp
  - Rozmiar profilu obciążenia: wybierz pozycję Dedicated-D4
  - Zakres liczby wystąpień skalowania automatycznego: wybierz 3 i 5
4. Wybierz pozycję Dodaj. Ten wybór spowoduje powrót do strony Dodawanie profilu obciążenia (wersja zapoznawcza). Wybierz pozycję my-wlp, a następnie wybierz pozycję Utwórz , aby utworzyć środowisko usługi Container Apps.
Wybierz pozycję Przejrzyj i utwórz , aby przejrzeć wybrane opcje. Wybierz pozycję Utwórz , aby aprowizować wystąpienie usługi Azure Spring Apps.
Na pasku narzędzi wybierz ikonę Powiadomienia (dzwonek), aby monitorować proces wdrażania. Po zakończeniu wdrażania możesz wybrać pozycję Przypnij do pulpitu nawigacyjnego, co spowoduje utworzenie kafelka dla tej usługi na pulpicie nawigacyjnym Azure Portal jako skrótu do strony Przegląd usługi.
Wybierz pozycję Przejdź do zasobu , aby przejść do strony Przegląd usługi Azure Spring Apps .

Użyj następującego polecenia, aby zalogować się do platformy Azure przy użyciu protokołu OAuth2. Zignoruj ten krok, jeśli już się zalogowano.
```
azd auth login
```
Konsola generuje komunikaty podobne do następującego przykładu:
```
Logged in to Azure.
```
Użyj następującego polecenia, aby aprowizować infrastrukturę szablonu na platformie Azure:
```
azd provision
```
Poniższa lista zawiera opis interakcji poleceń:
- Wybierz subskrypcję platformy Azure, która ma być używana: użyj strzałek do przeniesienia, wpisz , aby filtrować, a następnie naciśnij klawisz Enter.
- Wybierz lokalizację platformy Azure do użycia: użyj strzałek do przeniesienia, wpisz, aby filtrować, a następnie naciśnij klawisz Enter.
Konsola generuje komunikaty podobne do następującego przykładu:
```
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>-<random-string>> in Azure Portal:
https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/<your-resource-group>/overview
```
Uwaga

Może to potrwać trochę czasu. Zobaczysz wskaźnik postępu, gdy aprowizuje zasoby platformy Azure.

4. Wdrażanie aplikacji w usłudze Azure Spring Apps

Ta sekcja zawiera kroki wdrażania aplikacji w usłudze Azure Spring Apps.

Witryna Azure Portal
Azure Developer CLI

Wykonaj następujące kroki, aby wdrożyć za pomocą wtyczki Maven dla usługi Azure Spring Apps:

Przejdź do kompletnego katalogu, a następnie uruchom następujące polecenie, aby skonfigurować aplikację w usłudze Azure Spring Apps:
```
./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.18.0:config
```
Poniższa lista zawiera opis interakcji poleceń:
- Logowanie OAuth2: musisz autoryzować logowanie do platformy Azure na podstawie protokołu OAuth2.
- Wybierz subskrypcję: wybierz numer listy subskrypcji utworzonego wystąpienia usługi Azure Spring Apps, który domyślnie jest domyślnie pierwszą subskrypcją na liście. Jeśli używasz numeru domyślnego, naciśnij klawisz Enter bezpośrednio.
- Wybierz pozycję Azure Spring Apps do wdrożenia: wybierz numer listy utworzonego wystąpienia usługi Azure Spring Apps. Jeśli używasz numeru domyślnego, naciśnij klawisz Enter bezpośrednio.
- Wprowadź nazwę aplikacji: podaj nazwę aplikacji. Jeśli używasz domyślnego identyfikatora artefaktu projektu, naciśnij klawisz Enter bezpośrednio.
- Uwidocznij publiczny dostęp dla tej aplikacji (boot-for-azure)?: Naciśnij klawisz y.
- Potwierdź zapisanie wszystkich powyższych konfiguracji (Y/n): Naciśnij klawisz y. Jeśli naciśniesz n, konfiguracja nie zostanie zapisana w plikach POM.

Użyj następującego polecenia, aby wdrożyć aplikację:

./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.18.0:deploy

Na poniższej liście opisano interakcję z poleceniem:

Logowanie OAuth2: musisz autoryzować logowanie do platformy Azure na podstawie protokołu OAuth2.

Po wykonaniu polecenia można zobaczyć z następujących komunikatów dziennika, że wdrożenie zakończyło się pomyślnie:

[INFO] Deployment(default) is successfully updated.
[INFO] Deployment Status: Running
[INFO]   InstanceName:demo-default-x-xxxxxxxxxx-xxxxx  Status:Running Reason:null       DiscoverStatus:UNREGISTERED
[INFO] Getting public url of app(demo)...
[INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-demo.azuremicroservices.io

Wykonaj następujące kroki, aby spakować aplikację, aprowizować zasoby platformy Azure wymagane przez aplikację internetową, a następnie wdrożyć je w usłudze Azure Spring Apps:

Użyj następującego polecenia, aby spakować kopię aplikacji z możliwością wdrożenia:
```
azd package
```
Konsola generuje komunikaty podobne do następującego przykładu:
```
SUCCESS: Your application was packaged for Azure in xx seconds.
```

Użyj następującego polecenia, aby wdrożyć kod aplikacji w nowo aprowidowanych zasobach:

azd deploy

Konsola generuje komunikaty podobne do następującego przykładu:

Deploying services (azd deploy)

(✓) Done: Deploying service demo
- Endpoint: https://demo.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

Uwaga

Możesz również użyć azd up polecenia , aby połączyć poprzednie trzy polecenia: azd provision (aprowizuje zasoby platformy Azure), azd package (pakuje wdrażaną kopię aplikacji) i azd deploy (wdraża kod aplikacji). Aby uzyskać więcej informacji, zobacz spring-guides/gs-spring-boot-for-azure.

2. Przygotowanie projektu Spring

Witryna Azure Portal
Azure Developer CLI

Aby przygotować projekt, wykonaj następujące czynności:

Użyj następującego polecenia, aby sklonować przykładowy projekt Spring Boot dla platformy Azure z usługi GitHub.
```
git clone https://github.com/spring-guides/gs-spring-boot-for-azure.git
```
Użyj następującego polecenia, aby przejść do folderu projektu:
```
cd gs-spring-boot-for-azure/complete
```
Użyj następującego polecenia narzędzia Maven , aby skompilować projekt:
```
./mvnw clean package
```
Uruchom przykładowy projekt lokalnie, używając następującego polecenia:
```
./mvnw spring-boot:run
```

Wykonaj następujące kroki, aby zainicjować aplikację z szablonów Azure Developer CLI.

Otwórz okno terminalu, utwórz nowy folder i przejdź do niego.

Użyj następującego polecenia, aby zainicjować projekt:

azd init --template spring-guides/gs-spring-boot-for-azure

Poniższa lista zawiera opis interakcji poleceń:

Wprowadź nową nazwę środowiska: podaj nazwę środowiska, która jest używana jako sufiks dla grupy zasobów utworzonej do przechowywania wszystkich zasobów platformy Azure. Ta nazwa powinna być unikatowa w ramach subskrypcji platformy Azure.

Konsola generuje komunikaty podobne do następującego przykładu:

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. Przygotowanie środowiska chmury

Głównym zasobem, który należy uruchomić w tym przykładzie, jest wystąpienie usługi Azure Spring Apps. Aby utworzyć ten zasób, wykonaj następujące czynności.

Witryna Azure Portal
Azure Developer CLI

Otwórz przeglądarkę internetową i przejdź do Azure Portal. Wprowadź swoje poświadczenia, aby zalogować się do portalu. Widok domyślny to pulpit nawigacyjny usług.

3.2. Tworzenie wystąpienia usługi Azure Spring Apps

Aby utworzyć wystąpienie usługi, wykonaj następujące czynności:

Wybierz pozycję Utwórz zasób w rogu Azure Portal.
Wybierz pozycję Compute>Azure Spring Apps.

Wypełnij formularz Podstawowe , korzystając z następujących informacji:

Ustawienie	Sugerowana wartość	Opis
Subskrypcja	Nazwa subskrypcji użytkownika	Subskrypcja platformy Azure, która ma być używana dla serwera. Jeśli masz wiele subskrypcji, wybierz subskrypcję, w której chcesz naliczać opłaty za zasób.
Grupa zasobów	myresourcegroup	Nowa nazwa grupy zasobów lub istniejąca nazwa z subskrypcji.
Nazwa	myasa	Unikatowa nazwa identyfikująca usługę 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ą.
Planowanie	Standardowa	Plan cenowy określający zasób i koszt skojarzony z wystąpieniem.
Region (Region)	Region najbliżej Twoich użytkowników	Lokalizacja znajdująca się najbliżej użytkowników.
Strefowo nadmiarowy	Niezaznaczone	Wskazuje, czy chcesz utworzyć usługę Azure Spring Apps w strefie dostępności platformy Azure. Ta funkcja nie jest obecnie obsługiwana we wszystkich regionach.

Wybierz pozycję Przejrzyj i utwórz , aby przejrzeć wybrane opcje. Wybierz pozycję Utwórz , aby aprowizować wystąpienie usługi Azure Spring Apps.
Na pasku narzędzi wybierz ikonę Powiadomienia (dzwonek), aby monitorować proces wdrażania. Po zakończeniu wdrażania możesz wybrać pozycję Przypnij do pulpitu nawigacyjnego, co spowoduje utworzenie kafelka dla tej usługi na pulpicie nawigacyjnym Azure Portal jako skrótu do strony Przegląd usługi.
Wybierz pozycję Przejdź do zasobu , aby przejść do strony Przegląd usługi Azure Spring Apps .

Użyj następującego polecenia, aby zalogować się do platformy Azure przy użyciu protokołu OAuth2. Zignoruj ten krok, jeśli już się zalogowano.
```
azd auth login
```
Konsola generuje komunikaty podobne do następującego przykładu:
```
Logged in to Azure.
```
Użyj następującego polecenia, aby ustawić szablon przy użyciu planu standardowego:
```
azd env set PLAN standard
```
Użyj następującego polecenia, aby spakować wdrażalną kopię aplikacji, aprowizować infrastrukturę szablonu na platformie Azure i wdrożyć kod aplikacji w nowo aprowidowanych zasobach:
```
azd provision
```
Poniższa lista zawiera opis interakcji poleceń:
- Wybierz subskrypcję platformy Azure, która ma być używana: użyj strzałek do przeniesienia, wpisz , aby filtrować, a następnie naciśnij klawisz Enter.
- Wybierz lokalizację platformy Azure do użycia: użyj strzałek do przeniesienia, wpisz, aby filtrować, a następnie naciśnij klawisz Enter.
Konsola generuje komunikaty podobne do tych w poniższym przykładzie:
```
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>-<random-string>> in Azure Portal:
https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/<your-resource-group>/overview
```
Uwaga

Może to potrwać trochę czasu. Zobaczysz wskaźnik postępu, gdy aprowizuje zasoby platformy Azure.

4. Wdrażanie aplikacji w usłudze Azure Spring Apps

Ta sekcja zawiera kroki wdrażania aplikacji w usłudze Azure Spring Apps.

Witryna Azure Portal
Azure Developer CLI

Wykonaj następujące kroki, aby wdrożyć za pomocą wtyczki Maven dla usługi Azure Spring Apps:

Przejdź do kompletnego katalogu, a następnie uruchom następujące polecenie, aby skonfigurować aplikację w usłudze Azure Spring Apps:
```
./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.18.0:config
```
Poniższa lista zawiera opis interakcji poleceń:
- Logowanie OAuth2: musisz autoryzować logowanie do platformy Azure na podstawie protokołu OAuth2.
- Wybierz subskrypcję: wybierz numer listy subskrypcji utworzonego wystąpienia usługi Azure Spring Apps, który domyślnie jest domyślnie pierwszą subskrypcją na liście. Jeśli używasz numeru domyślnego, naciśnij klawisz Enter bezpośrednio.
- Wybierz pozycję Azure Spring Apps do wdrożenia: wybierz numer listy utworzonego wystąpienia usługi Azure Spring Apps. Jeśli używasz numeru domyślnego, naciśnij klawisz Enter bezpośrednio.
- Wprowadź nazwę aplikacji: podaj nazwę aplikacji. Jeśli używasz domyślnego identyfikatora artefaktu projektu, naciśnij klawisz Enter bezpośrednio.
- Uwidocznij publiczny dostęp dla tej aplikacji (boot-for-azure)?: Naciśnij klawisz y.
- Potwierdź zapisanie wszystkich powyższych konfiguracji (Y/n): Naciśnij klawisz y. Jeśli naciśniesz n, konfiguracja nie zostanie zapisana w plikach POM.

Użyj następującego polecenia, aby wdrożyć aplikację:

./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.18.0:deploy

Poniższa lista zawiera opis interakcji poleceń:

Logowanie OAuth2: musisz autoryzować logowanie do platformy Azure na podstawie protokołu OAuth2.

Po wykonaniu polecenia można zobaczyć z następujących komunikatów dziennika, że wdrożenie zakończyło się pomyślnie:

[INFO] Deployment(default) is successfully updated.
[INFO] Deployment Status: Running
[INFO]   InstanceName:demo-default-x-xxxxxxxxxx-xxxxx  Status:Running Reason:null       DiscoverStatus:UNREGISTERED
[INFO] Getting public url of app(demo)...
[INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-demo.azuremicroservices.io

Wykonaj następujące kroki, aby spakować aplikację, aprowizować zasoby platformy Azure wymagane przez aplikację internetową, a następnie wdrożyć je w usłudze Azure Spring Apps:

Użyj następującego polecenia, aby spakować kopię aplikacji z możliwością wdrożenia:
```
azd package
```
Konsola generuje komunikaty podobne do następującego przykładu:
```
SUCCESS: Your application was packaged for Azure in xx seconds.
```

Użyj następującego polecenia, aby wdrożyć kod aplikacji w nowo aprowidowanych zasobach:

azd deploy

Konsola generuje komunikaty podobne do tych w poniższym przykładzie:

Deploying services (azd deploy)

(✓) Done: Deploying service demo
- Endpoint: https://<your-Azure-Spring-Apps-instance-name>-demo.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

Uwaga

Możesz również użyć azd up polecenia , aby połączyć poprzednie trzy polecenia: azd package (pakuje wdrażaną kopię aplikacji), azd provision (aprowizuje zasoby platformy Azure) i azd deploy (wdraża kod aplikacji). Aby uzyskać więcej informacji, zobacz spring-guides/gs-spring-boot-for-azure.

2. Przygotowanie projektu Spring

Aby przygotować projekt, wykonaj następujące czynności:

Użyj następującego polecenia, aby sklonować przykładowy projekt Spring Boot dla platformy Azure z usługi GitHub.
```
git clone https://github.com/spring-guides/gs-spring-boot-for-azure.git
```
Użyj następującego polecenia, aby przejść do folderu projektu:
```
cd gs-spring-boot-for-azure/complete
```
Użyj następującego polecenia narzędzia Maven , aby skompilować projekt:
```
./mvnw clean package
```
Uruchom przykładowy projekt lokalnie, używając następującego polecenia:
```
./mvnw spring-boot:run
```

Aby utworzyć projekt, wykonaj następujące czynności:

Użyj następującego polecenia, aby wygenerować przykładowy projekt z start.spring.io zalecanymi zależnościami dla usługi Azure Spring Apps:

curl https://start.spring.io/starter.tgz -d dependencies=web -d baseDir=demo -d bootVersion=3.0.0 -d javaVersion=17 -d type=maven-project -d groupId=com.example -d artifactId=demo -d name=demo -d packageName=com.example.demo -d packaging=jar | tar -xzvf -

Utwórz kontroler sieci Web dla aplikacji internetowej, dodając plik src/main/java/com/example/demo/HelloController.java z następującą zawartością:

package com.example.demo;

import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.bind.annotation.RequestMapping;

@RestController
public class HelloController {

    @RequestMapping("/")
    public String index() {
        return "Hello World";
     }
}

Użyj następującego polecenia narzędzia Maven , aby skompilować projekt:
```
./mvnw clean package
```
Uruchom przykładowy projekt lokalnie, używając następującego polecenia:
```
./mvnw spring-boot:run
```

3. Przygotowanie środowiska chmury

Wykonaj poniższe kroki, aby utworzyć wystąpienie usługi Azure Spring Apps.

3.1. Podaj nazwy dla każdego zasobu

Utwórz zmienne do przechowywania nazw zasobów przy użyciu następujących poleceń. Pamiętaj, aby zastąpić symbole zastępcze własnymi wartościami.

export LOCATION="<region>"
export RESOURCE_GROUP="<resource-group-name>"
export SERVICE_NAME="<Azure-Spring-Apps-instance-name>"
export APP_NAME="demo"

3.2. Tworzenie nowej grupy zasobów

Aby utworzyć nową grupę zasobów, wykonaj następujące kroki:

Użyj następującego polecenia, aby zalogować się do interfejsu wiersza polecenia platformy Azure:
```
az login
```
Użyj następującego polecenia, aby ustawić lokalizację domyślną:
```
az configure --defaults location=${LOCATION}
```
Użyj następującego polecenia, aby wyświetlić listę wszystkich dostępnych subskrypcji, aby określić identyfikator subskrypcji do użycia:
```
az account list --output table
```
Użyj następującego polecenia, aby ustawić domyślną subskrypcję:
```
az account set --subscription <subscription-ID>
```
Użyj następującego polecenia, aby utworzyć grupę zasobów:
```
az group create --resource-group ${RESOURCE_GROUP}
```
Użyj następującego polecenia, aby ustawić nowo utworzoną grupę zasobów jako domyślną grupę zasobów:
```
az configure --defaults group=${RESOURCE_GROUP}
```

3.3. Instalowanie rozszerzenia i rejestrowanie przestrzeni nazw

Użyj następujących poleceń, aby zainstalować rozszerzenie Usługi Azure Spring Apps dla interfejsu wiersza polecenia platformy Azure i zarejestrować przestrzeń nazw: : Microsoft.SaaS

az extension add --name spring --upgrade
az provider register --namespace Microsoft.SaaS

3.4. Tworzenie wystąpienia usługi Azure Spring Apps

Aby utworzyć wystąpienie usługi, wykonaj następujące czynności:

Użyj następującego polecenia, aby zaakceptować warunki prawne i oświadczenia o ochronie prywatności dla planu Enterprise:

Uwaga

Ten krok jest niezbędny tylko wtedy, gdy twoja subskrypcja nigdy nie została użyta do utworzenia wystąpienia planu Enterprise usługi Azure Spring Apps.
```
az term accept \
    --publisher vmware-inc \
    --product azure-spring-cloud-vmware-tanzu-2 \
    --plan asa-ent-hr-mtr
```
Użyj następującego polecenia, aby utworzyć wystąpienie usługi Azure Spring Apps:
```
az spring create \
    --name ${SERVICE_NAME} \
    --sku Enterprise
```

3.5. Tworzenie aplikacji w wystąpieniu usługi Azure Spring Apps

Aplikacja to abstrakcja jednej aplikacji biznesowej. Aby uzyskać więcej informacji, zobacz App and deployment in Azure Spring Apps (Aplikacja i wdrażanie w usłudze Azure Spring Apps). Aplikacje są uruchamiane w wystąpieniu usługi Azure Spring Apps, jak pokazano na poniższym diagramie.

Diagram przedstawiający relację między aplikacjami a wystąpieniem usługi Azure Spring Apps.

Użyj następującego polecenia, aby utworzyć aplikację w usłudze Azure Spring Apps:

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

Otwórz przeglądarkę internetową i przejdź do Azure Portal. Wprowadź swoje poświadczenia, aby zalogować się do portalu. Widok domyślny to pulpit nawigacyjny usług.

3.2. Tworzenie wystąpienia usługi Azure Spring Apps

Aby utworzyć wystąpienie usługi, wykonaj następujące czynności:

Wybierz pozycję Utwórz zasób w rogu Azure Portal.
Wybierz pozycję Compute>Azure Spring Apps.

Wypełnij formularz Podstawowe , korzystając z następujących informacji:

Ustawienie	Sugerowana wartość	Opis
Subskrypcja	Nazwa subskrypcji użytkownika	Subskrypcja platformy Azure, która ma być używana dla serwera. Jeśli masz wiele subskrypcji, wybierz subskrypcję, w której chcesz naliczać opłaty za zasób.
Grupa zasobów	myresourcegroup	Nowa nazwa grupy zasobów lub istniejąca nazwa z subskrypcji.
Nazwa	myasa	Unikatowa nazwa identyfikująca usługę 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ą.
Planowanie	Przedsiębiorstwo	Plan cenowy określający zasób i koszt skojarzony z wystąpieniem.
Region (Region)	Region najbliżej Twoich użytkowników	Lokalizacja znajdująca się najbliżej użytkowników.
Strefowo nadmiarowy	Niezaznaczone	Wskazuje, czy chcesz utworzyć usługę Azure Spring Apps w strefie dostępności platformy Azure. Ta funkcja nie jest obecnie obsługiwana we wszystkich regionach.
Plan adresów IP oprogramowania	Pay-as-you-go	Płatność zgodnie z rzeczywistym użyciem za pomocą usługi Azure Spring Apps.
Terminologia	Wybrane	Musisz zaznaczyć pole wyboru umowy skojarzone z ofertą witryny Marketplace.

Wybierz pozycję Przejrzyj i utwórz , aby przejrzeć wybrane opcje. Wybierz pozycję Utwórz , aby aprowizować wystąpienie usługi Azure Spring Apps.
Na pasku narzędzi wybierz ikonę Powiadomienia (dzwonek), aby monitorować proces wdrażania. Po zakończeniu wdrażania możesz wybrać pozycję Przypnij do pulpitu nawigacyjnego, co spowoduje utworzenie kafelka dla tej usługi na pulpicie nawigacyjnym Azure Portal jako skrótu do strony Przegląd usługi.
Wybierz pozycję Przejdź do zasobu , aby przejść do strony Przegląd usługi Azure Spring Apps .

4. Wdrażanie aplikacji w usłudze Azure Spring Apps

Ta sekcja zawiera kroki wdrażania aplikacji w usłudze Azure Spring Apps.

Użyj następującego polecenia, aby wdrożyć plik jar dla aplikacji:

az spring app deploy \
    --service ${SERVICE_NAME} \
    --name ${APP_NAME} \
    --artifact-path target/demo-0.0.1-SNAPSHOT.jar

Wdrażanie aplikacji może potrwać kilka minut.

4.1. Importowanie projektu

Aby zaimportować projekt, wykonaj następujące kroki:

Otwórz środowisko IntelliJ IDEA, a następnie wybierz pozycję Otwórz.
W oknie dialogowym Otwieranie pliku lub projektu wybierz folder demonstracyjny .

4.2. Kompilowanie i wdrażanie aplikacji

Aby skompilować i wdrożyć aplikację, wykonaj następujące kroki:

Jeśli jeszcze nie zainstalowano zestawu narzędzi Azure Toolkit for IntelliJ, wykonaj kroki opisane w temacie Instalowanie zestawu narzędzi Azure Toolkit for IntelliJ.

Uwaga

Zestaw narzędzi Azure Toolkit for IntelliJ udostępnia cztery sposoby logowania się na platformę Azure, a wdrożenie może rozpocząć się tylko po zalogowaniu.
Kliknij prawym przyciskiem myszy projekt w oknie Projekt IntelliJ, a następnie wybierz pozycję Azure ->Deploy to Azure Spring Apps (Wdróż w usłudze Azure Spring Apps).
Zaakceptuj nazwę aplikacji w polu Nazwa . Nazwa odnosi się do konfiguracji, a nie nazwy aplikacji. Zwykle nie trzeba go zmieniać.
W polu tekstowym Artefakt wybierz pozycję Maven:demo(Java 17).
W polu tekstowym Subskrypcja sprawdź, czy twoja subskrypcja jest poprawna.
W polu tekstowym Spring Apps wybierz utworzone wystąpienie usługi Azure Spring Apps.
W polu tekstowym Aplikacja wybierz znak plus (+), aby utworzyć nową aplikację.
W polu tekstowym Nazwa aplikacji w obszarze Podstawy aplikacji wprowadź pokaz, a następnie wybierz pozycję Więcej ustawień.
Wybierz przycisk Włącz obok pozycji Publiczny punkt końcowy. Przycisk zmieni się na Wyłącz <, aby być włączony>. Następnie wybierz przycisk OK.
W obszarze Przed uruchomieniem wybierz pozycję Uruchom cel Maven "demo:package", a następnie wybierz ikonę ołówka, aby edytować wiersz polecenia.
W polu tekstowym Wiersz polecenia wprowadź ciąg -DskipTests po pakiecie, a następnie wybierz przycisk OK.
Aby rozpocząć wdrażanie, wybierz przycisk Uruchom w dolnej części okna dialogowego Wdrażanie na platformie Azure . Wtyczka uruchamia polecenie package -DskipTests Maven w demo aplikacji i wdraża plik jar wygenerowany przez package polecenie .

Wdrażanie aplikacji może potrwać kilka minut. Publiczny adres URL aplikacji można wyświetlić w dzienniku konsoli wyjściowej.

5. Weryfikowanie aplikacji

Po wdrożeniu możesz uzyskać dostęp do aplikacji pod adresem https://<your-Azure-Spring-Apps-instance-name>-demo.azuremicroservices.io. Po otwarciu aplikacji otrzymasz odpowiedź Hello World.

W okienku nawigacji na stronie przeglądu wystąpienia usługi Azure Spring Apps wybierz pozycję Dzienniki , aby sprawdzić dzienniki aplikacji.

Użyj następującego polecenia, aby sprawdzić dziennik aplikacji w celu zbadania dowolnego problemu z wdrożeniem:

az spring app logs \
    --service ${SERVICE_NAME} \
    --name ${APP_NAME}

6. Czyszczenie zasobów

Pamiętaj, aby usunąć zasoby utworzone w tym artykule, gdy nie są już potrzebne. Aby usunąć zasoby, wystarczy usunąć grupę zasobów zawierającą je. Grupę zasobów można usunąć przy użyciu Azure Portal. Alternatywnie aby usunąć grupę zasobów przy użyciu interfejsu wiersza polecenia platformy Azure, użyj następującego polecenia:

az group delete --name ${RESOURCE_GROUP}

Możesz usunąć grupę zasobów platformy Azure zawierającą wszystkie zasoby w tej grupie.

Witryna Azure Portal
Azure Developer CLI

Wykonaj następujące kroki, aby usunąć całą grupę zasobów, w tym nowo utworzoną usługę:

Znajdź grupę zasobów w witrynie Azure Portal. W menu nawigacji wybierz pozycję Grupy zasobów. Następnie wybierz nazwę grupy zasobów — na przykład myresourcegroup.
Na stronie grupy zasobów wybierz pozycję Usuń. Wprowadź nazwę grupy zasobów w polu tekstowym, aby potwierdzić usunięcie — na przykład myresourcegroup — a następnie wybierz pozycję Usuń.

Użyj następującego polecenia, aby usunąć wszystkie zasoby platformy Azure używane w tej przykładowej aplikacji:

azd down

Poniższa lista zawiera opis interakcji poleceń:

Łączna liczba zasobów do usunięcia: <suma> zasobów, czy na pewno chcesz kontynuować?: Naciśnij klawisz y.

Konsola generuje komunikaty podobne do następującego przykładu:

SUCCESS: Your application was removed from Azure in xx minutes xx seconds.

7. Następne kroki

Dziennik aplikacji ustrukturyzowanych dla usługi Azure Spring Apps

Mapuj istniejącą domenę niestandardową na usługę Azure Spring Apps

Używanie ciągłej integracji/ciągłego wdrażania usługi Azure Spring Apps z usługą GitHub Actions

Automatyzowanie wdrożeń aplikacji w usłudze Azure Spring Apps

Używanie tożsamości zarządzanych dla aplikacji w usłudze Azure Spring Apps

Tworzenie połączenia usługi w usłudze Azure Spring Apps przy użyciu interfejsu wiersza polecenia platformy Azure

Wprowadzenie do aplikacji przykładowej

Wprowadzenie do przykładowej aplikacji ze sklepu Fitness Store

Aby uzyskać więcej informacji, zobacz następujące artykuły:

Szybki start: wdrażanie pierwszej aplikacji w usłudze Azure Spring Apps

1. Wymagania wstępne

2. Przygotowanie projektu Spring

3. Przygotowanie środowiska chmury

3.2. Tworzenie wystąpienia usługi Azure Spring Apps

4. Wdrażanie aplikacji w usłudze Azure Spring Apps

2. Przygotowanie projektu Spring

3. Przygotowanie środowiska chmury

3.2. Tworzenie wystąpienia usługi Azure Spring Apps

4. Wdrażanie aplikacji w usłudze Azure Spring Apps

2. Przygotowanie projektu Spring

3. Przygotowanie środowiska chmury

3.1. Podaj nazwy dla każdego zasobu

3.2. Tworzenie nowej grupy zasobów

3.3. Instalowanie rozszerzenia i rejestrowanie przestrzeni nazw

3.4. Tworzenie wystąpienia usługi Azure Spring Apps

3.5. Tworzenie aplikacji w wystąpieniu usługi Azure Spring Apps

3.2. Tworzenie wystąpienia usługi Azure Spring Apps

4. Wdrażanie aplikacji w usłudze Azure Spring Apps

4.1. Importowanie projektu

4.2. Kompilowanie i wdrażanie aplikacji

5. Weryfikowanie aplikacji

6. Czyszczenie zasobów

7. Następne kroki

Dodatkowe zasoby

Dodatkowe zasoby

Szybki start: wdrażanie pierwszej aplikacji w usłudze Azure Spring Apps

1. Wymagania wstępne

2. Przygotowanie projektu Spring

3. Przygotowanie środowiska chmury

3.1. Logowanie się do witryny Azure Portal

3.2. Tworzenie wystąpienia usługi Azure Spring Apps

4. Wdrażanie aplikacji w usłudze Azure Spring Apps

2. Przygotowanie projektu Spring

3. Przygotowanie środowiska chmury

3.1. Logowanie się do witryny Azure Portal

3.2. Tworzenie wystąpienia usługi Azure Spring Apps

4. Wdrażanie aplikacji w usłudze Azure Spring Apps

2. Przygotowanie projektu Spring

3. Przygotowanie środowiska chmury

3.1. Podaj nazwy dla każdego zasobu

3.2. Tworzenie nowej grupy zasobów

3.3. Instalowanie rozszerzenia i rejestrowanie przestrzeni nazw

3.4. Tworzenie wystąpienia usługi Azure Spring Apps

3.5. Tworzenie aplikacji w wystąpieniu usługi Azure Spring Apps

4. Wdrażanie aplikacji w usłudze Azure Spring Apps

5. Weryfikowanie aplikacji

6. Czyszczenie zasobów

7. Następne kroki

Dodatkowe zasoby

Dodatkowe zasoby