Migrowanie wystąpienia planu Azure Spring Apps w warstwie Podstawowa lub Standardowa do planu Enterprise

Uwaga

Plany Podstawowa, Standardowa i Enterprise zostaną wycofane od połowy marca 2025 r. z 3-letnim okresem emerytalnym. Zalecamy przejście do usługi Azure Container Apps. Aby uzyskać więcej informacji, zobacz ogłoszenie o wycofaniu usługi Azure Spring Apps.

Zużycie standardowe i dedykowany plan zostaną wycofane od 30 września 2024 r. z całkowitym zamknięciem po sześciu miesiącach. Zalecamy przejście do usługi Azure Container Apps. Aby uzyskać więcej informacji, zobacz Migrowanie użycia usługi Azure Spring Apps w warstwie Standardowa i dedykowanego planu do usługi Azure Container Apps.

Ten artykuł dotyczy:✅ Podstawowa/Standardowa ✅ Enterprise

W tym artykule pokazano, jak przeprowadzić migrację istniejącej aplikacji w planie Podstawowa lub Standardowa do planu Enterprise. W przypadku migracji z planu podstawowego lub standardowego do planu Enterprise składniki VMware Tanzu zastępują składniki oprogramowania open source (OSS) Spring Cloud, aby zapewnić większą obsługę funkcji.

W tym artykule użyto przykładowych aplikacji Pet Clinic jako przykładowych sposobów migracji.

Wymagania wstępne

• Subskrypcja platformy Azure. Jeśli nie masz subskrypcji, przed rozpoczęciem utwórz bezpłatne konto .
• Interfejs wiersza polecenia platformy Azure w wersji 2.45.0 lub nowszej.
• Rozszerzenie planu Usługi Azure Spring Apps Enterprise. Użyj następującego polecenia, aby usunąć poprzednie wersje i zainstalować najnowsze rozszerzenie planu Enterprise. Jeśli wcześniej zainstalowano spring-cloud rozszerzenie, odinstaluj je, aby uniknąć niezgodności konfiguracji i wersji.

  az extension add --upgrade --name spring
  az extension remove --name spring-cloud
  

• Git.

Aprowizuj wystąpienie usługi

W planie Usługi Azure Spring Apps Enterprise składniki VMware Tanzu zastępują składniki systemu operacyjnego Spring Cloud, aby zapewnić większą obsługę funkcji. Składniki Tanzu są włączone na żądanie zgodnie z potrzebami. Przed utworzeniem wystąpienia usługi Azure Spring Apps należy włączyć potrzebne składniki.

Uwaga

Aby używać składników Tanzu, należy je włączyć podczas aprowizowania wystąpienia usługi Azure Spring Apps. Nie można ich włączyć po aprowizacji w tej chwili.

Aby aprowizować wystąpienie usługi Azure Spring Apps, wykonaj następujące kroki:

Witryna Azure Portal

1. Otwórz portal Azure Portal.

2. W górnym polu wyszukiwania wyszukaj pozycję Azure Spring Apps.

3. Wybierz pozycję Azure Spring Apps z wyników, a następnie wybierz pozycję Utwórz.

4. Na stronie Tworzenie usługi Azure Spring Apps ustaw subskrypcję, grupę zasobów i nazwę dla wystąpienia.

5. W obszarze Planowanie w obszarze Szczegóły usługi wybierz pozycję Zmień.

   

6. Na stronie Wybieranie planu wybierz wiersz Enterprise w tabeli, a następnie wybierz pozycję Wybierz.

   

7. Po powrocie na stronę Tworzenie usługi Azure Spring Apps wybierz pozycję Warunki , aby wyrazić zgodę na postanowienia prawne i oświadczenia o ochronie prywatności oferty planu Enterprise w witrynie Azure Marketplace.

8. Wybierz pozycję Dalej: ustawienia programu VMware Tanzu.

9. Na karcie Ustawienia tanzu vmWare przewiń listę, aby przejrzeć składniki Tanzu. Wszystkie składniki są domyślnie włączone.

   

   Uwaga

   Dokładnie zastanów się, które składniki Tanzu mają być używane lub włączane w fazie aprowizacji. Po aprowizacji wystąpienia usługi Azure Spring Apps nie można włączać ani wyłączać składników Tanzu.

10. Wybierz kartę Application Insights , a następnie wybierz pozycję Włącz usługę Application Insights. Przejrzyj następujące ustawienia:

    • Należy wybrać opcję Włącz usługę Application Insights .
    • Wybierz istniejące wystąpienie usługi Application Insights lub utwórz nowe wystąpienie usługi Application Insights.
    • Wprowadź częstotliwość próbkowania w zakresie od 0 do 100 lub użyj wartości domyślnej 10.

    Możesz również włączyć usługę Application Insights po aprowizacji wystąpienia usługi Azure Spring Apps. Aby uzyskać więcej informacji na temat cennika usługi Application Insights, zobacz sekcję Rozliczenia usługi Application Insights w temacie Obliczenia i opcje dotyczące kosztów dzienników usługi Azure Monitor.

    Uwaga

    Po zintegrowaniu z usługą Azure Spring Apps płacisz za użycie usługi Application Insights.

11. Wybierz pozycję Przejrzyj i utwórz i poczekaj na zakończenie walidacji, a następnie wybierz pozycję Utwórz , aby rozpocząć aprowizowanie wystąpienia usługi.

Aprowizacja zasobów trwa około 5 minut.

Interfejs wiersza polecenia platformy Azure

1. Użyj następującego polecenia, aby zaktualizować interfejs wiersza polecenia platformy Azure za pomocą rozszerzenia Azure Spring Apps:

   az extension add --upgrade --name spring
   

2. Użyj następujących poleceń, aby zalogować się do interfejsu wiersza polecenia platformy Azure i wybrać aktywną subskrypcję:

   az login
   az account list --output table
   az account set --subscription <subscription-ID>
   

3. Użyj następującego polecenia, aby zaakceptować warunki prawne i oświadczenia o ochronie prywatności dla planu Enterprise. Ten krok jest wymagany tylko przy pierwszym utworzeniu wystąpienia usługi Azure Spring Apps w planie Enterprise.

   az provider register --namespace Microsoft.SaaS
   az term accept --publisher vmware-inc --product azure-spring-cloud-vmware-tanzu-2 --plan asa-ent-hr-mtr
   

4. Utwórz nazwę wystąpienia usługi Azure Spring Apps. Nazwa musi mieć długość 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ą.

5. Użyj następującego polecenia, aby utworzyć grupę zasobów i wystąpienie usługi Azure Spring Apps:

   az spring create \
       --resource-group <resource-group-name> \
       --name <Azure-Spring-Apps-service-instance-name> \
       --sku enterprise
   

   Aby uzyskać więcej informacji na temat grup zasobów, zobacz Co to jest usługa Azure Resource Manager?.

Tworzenie i konfigurowanie aplikacji

Kroki tworzenia aplikacji są takie same jak w przypadku planu w warstwie Standardowa.

1. Użyj następującego polecenia, aby ustawić wartości domyślne interfejsu wiersza polecenia platformy Azure. Pamiętaj, aby zastąpić symbole zastępcze własnymi wartościami.

   az config set defaults.group=<resource-group-name>
   az config set defaults.spring=<Azure-Spring-Apps-service-instance-name>
   

2. Użyj następujących poleceń, aby utworzyć dwie podstawowe aplikacje dla petClinic api-gateway i customers-service:

   az spring app create --name api-gateway --instance-count 1 --memory 2Gi --assign-endpoint
   az spring app create --name customers-service --instance-count 1 --memory 2Gi
   

Używanie usługi konfiguracji aplikacji na potrzeby konfiguracji zewnętrznej

W przypadku konfiguracji zewnętrznej w systemie rozproszonym zarządzany serwer Spring Cloud Config Server (OSS) jest dostępny tylko w planach Podstawowa i Standardowa. W planie dla przedsiębiorstw usługa konfiguracji aplikacji tanzu udostępnia podobne funkcje dla aplikacji. W poniższej tabeli opisano pewne różnice w użyciu między serwerem konfiguracji systemu operacyjnego i usługą konfiguracji aplikacji.

Składnik	Plany pomocy technicznej	Włączona	Wiązanie z aplikacją	Profil
Spring Cloud Config Server	Podstawowa/Standardowa	Zawsze włączone.	Automatyczne wiązanie	Skonfigurowany w kodzie źródłowym aplikacji.
Usługa konfiguracji aplikacji dla tanzu	Przedsiębiorstwa	Włącz na żądanie.	Powiązanie ręczne	Podane jako config-file-pattern we wdrożeniu usługi Azure Spring Apps.

W przeciwieństwie do trybu klient-serwer na serwerze konfiguracji systemu operacyjnego usługa konfiguracji aplikacji zarządza konfiguracją przy użyciu natywnego ConfigMaprozwiązania Kubernetes, który jest wypełniany z właściwości zdefiniowanych w repozytoriach Git zaplecza. Usługa konfiguracji aplikacji nie może pobrać aktywnego profilu skonfigurowanego w kodzie źródłowym aplikacji w celu dopasowania do odpowiedniej konfiguracji, dlatego jawna konfiguracja config-file-pattern powinna być określona na poziomie wdrożenia usługi Azure Spring Apps.

Konfigurowanie usługi konfiguracji aplikacji dla programu Tanzu

Wykonaj następujące kroki, aby użyć usługi Konfiguracji aplikacji dla tanzu jako scentralizowanej usługi konfiguracji.

Witryna Azure Portal

1. W wystąpieniu usługi Azure Spring Apps Enterprise wybierz pozycję Usługa konfiguracji aplikacji w okienku nawigacji. Wyświetl stan działania i zasoby przydzielone do usługi konfiguracji aplikacji dla programu Tanzu.

   

2. Wybierz pozycję Ustawienia i wypełnij formularz w obszarze Repozytoria , aby dodać nowy wpis z następującymi informacjami:

   • Nazwa: default
   • Wzorców: api-gateway,customers-service
   • URI: https://github.com/Azure-Samples/spring-petclinic-microservices-config
   • Etykieta: master

   

3. Wybierz pozycję Weryfikuj , aby zweryfikować dostęp do docelowego identyfikatora URI.

4. Po pomyślnym zakończeniu walidacji wybierz pozycję Zastosuj , aby zaktualizować ustawienia konfiguracji.

Interfejs wiersza polecenia platformy Azure

Użyj następującego polecenia, aby ustawić domyślne repozytorium:

az spring application-configuration-service git repo add \
    --name default \
    --patterns api-gateway,customers-service \
    --uri https://github.com/Azure-Samples/spring-petclinic-microservices-config.git \
    --label master

Wiązanie aplikacji z usługą konfiguracji aplikacji dla tanzu

W przypadku korzystania z usługi Application Configuration Service for Tanzu z zapleczem Usługi Git należy powiązać aplikację z usługą Konfiguracji aplikacji dla programu Tanzu. Po powiązaniu aplikacji należy skonfigurować wzorzec używany przez aplikację. Wykonaj poniższe kroki, aby powiązać i skonfigurować wzorzec dla aplikacji.

Witryna Azure Portal

Wykonaj poniższe kroki, aby powiązać aplikacje z usługą Application Configuration Service for VMware Tanzu.

1. W wystąpieniu usługi Azure Spring Apps Enterprise wybierz pozycję Usługa konfiguracji aplikacji w okienku nawigacji.

2. Wybierz pozycję Powiązanie aplikacji, a następnie wybierz pozycję Powiązaj aplikację.

   

3. Wybierz aplikację z menu rozwijanego, a następnie wybierz pozycję Zastosuj , aby powiązać aplikację z usługą konfiguracji aplikacji dla tanzu.

Interfejs wiersza polecenia platformy Azure

Użyj następujących poleceń, aby powiązać aplikacje z usługą Application Configuration Service for VMware Tanzu i VMware Tanzu Service Registry:

az spring application-configuration-service bind --app api-gateway
az spring application-configuration-service bind --app customers-service

Aby uzyskać więcej informacji, zobacz Use Application Configuration Service for Tanzu (Używanie usługi konfiguracji aplikacji dla tanzu).

Korzystanie z rejestru usługi Tanzu

Rejestr usług jest jednym z zastrzeżonych składników VMware Tanzu. Udostępnia ona aplikacjom implementację wzorca odnajdywania usług, jedną z kluczowych koncepcji architektury opartej na mikrousługach. W planie przedsiębiorstwa rejestr usług tanzu udostępnia rejestr usług i odnajduje obsługę aplikacji. Zarządzana usługa Spring Cloud Eureka jest dostępna tylko w planie Podstawowa i Standardowa i nie jest dostępna w planie Enterprise.

Składnik	Plan w warstwie Standardowa	Plan przedsiębiorstwa
Rejestr usług	System operacyjny Eureka Automatyczne wiązanie (zawsze iniekcja) Zawsze aprowizowana	Rejestr usług tanzu Wymaga ręcznego powiązania z aplikacją Włącz na żądanie

Wiązanie aplikacji z rejestrem usługi Tanzu

Aby powiązać aplikacje z usługą Application Configuration Service dla programu VMware Tanzu, wykonaj następujące kroki.

Witryna Azure Portal

1. W wystąpieniu usługi Azure Spring Apps Enterprise wybierz pozycję Rejestr usług.

2. Wybierz pozycję Powiązanie aplikacji. Obecnie powiązane aplikacje są wyświetlane w obszarze Nazwa aplikacji.

3. Wybierz pozycję Powiąż aplikację.

4. Wybierz aplikację z menu rozwijanego, a następnie wybierz pozycję Zastosuj , aby powiązać aplikację z rejestrem usługi Tanzu.

   

Interfejs wiersza polecenia platformy Azure

Użyj następujących poleceń, aby powiązać aplikacje z usługą Application Configuration Service for VMware Tanzu i VMware Tanzu Service Registry:

az spring service-registry bind --app api-gateway
az spring service-registry bind --app customers-service

Uwaga

Po zmianie stanu powiązania/odłączenia należy ponownie uruchomić lub ponownie wdrożyć aplikację, aby zmiany zaczęły obowiązywać.

Aby uzyskać więcej informacji, zobacz Use Tanzu Service Registry (Korzystanie z rejestru usługi Tanzu).

Kompilowanie i wdrażanie aplikacji

W planie Enterprise usługa Tanzu Build Service służy do tworzenia aplikacji. Udostępnia ona więcej funkcji, takich jak aplikacje wielolotowe do wdrażania z artefaktów, takich jak kod źródłowy i pliki zip.

Aby użyć usługi Tanzu Build Service, należy określić zasób dla zadania kompilacji i konstruktora do użycia. Można również określić parametr, --build-env aby ustawić środowiska kompilacji.

Jeśli aplikacja jest powiązana z usługą Konfiguracji aplikacji dla usługi Tanzu, musisz określić dodatkowy argument —config-file-pattern.

Aby uzyskać więcej informacji, zobacz Use Tanzu Build Service (Korzystanie z usługi Tanzu Build Service).

Lokalne tworzenie aplikacji

Wykonaj następujące kroki, aby skompilować lokalnie:

1. Użyj następujących poleceń, aby sklonować przykładowe repozytorium aplikacji na koncie platformy Azure, zmienić katalog i skompilować projekt:

   git clone -b enterprise https://github.com/azure-samples/spring-petclinic-microservices
   cd spring-petclinic-microservices
   mvn clean package -DskipTests
   

   Kompilowanie projektu może potrwać kilka minut. Po zakończeniu będziesz mieć pojedyncze pliki JAR dla każdej usługi w odpowiednim folderze.

2. Użyj następujących poleceń, aby wdrożyć pliki JAR utworzone w poprzednim kroku:

   az spring app deploy \
       --name api-gateway \
       --artifact-path spring-petclinic-api-gateway/target/spring-petclinic-api-gateway-2.3.6.jar \
       --config-file-patterns api-gateway
   az spring app deploy \
       --name customers-service \
       --artifact-path spring-petclinic-customers-service/target/spring-petclinic-customers-service-2.3.6.jar \
       --config-file-patterns customers-service
   

3. Użyj następującego polecenia, aby wysłać zapytanie o stan aplikacji po wdrożeniu:

   az spring app list --output table
   

   To polecenie generuje dane wyjściowe podobne do następującego przykładu:

   Name                  Location    ResourceGroup       Public Url                                                 Production Deployment    Provisioning State    CPU    Memory    Running Instance    Registered Instance    Persistent Storage    Bind Service Registry    Bind Application Configuration Service
   --------------------  ----------  ---------------  ---------------------------------------------------------  -----------------------  --------------------  -----  --------  ------------------  ---------------------  --------------------  -----------------------  ----------------------------------------
   api-gateway           eastus      <resource group>   https://<service_name>-api-gateway.asc-test.net                    default                  Succeeded             1      2Gi       1/1                1/1                    -                     True                     True
   customers-service     eastus      <resource group>                                                                      default                  Succeeded             1      2Gi       1/1                1/1                    -                     True                     True
   

Korzystanie z usługi Application Insights

Plan usługi Azure Spring Apps Enterprise używa powiązań pakietu buildpack w celu zintegrowania usługi Application Insights z typem ApplicationInsights zamiast agenta przetwarzania. Aby uzyskać więcej informacji, zobacz How to configure APM integration and CA certificates (Jak skonfigurować integrację aPM i certyfikaty urzędu certyfikacji).

W poniższej tabeli wymieniono dostawców APM dostępnych planów.

Plan w warstwie Standardowa	Plan przedsiębiorstwa
Usługa Application Insights Nowa relikwia Dynatrace AppDynamics	Usługa Application Insights Nowa relikwia Dynatrace AppDynamics ElasticAPM

Witryna Azure Portal

Aby sprawdzić lub zaktualizować bieżące ustawienia w usłudze Application Insights, wykonaj następujące kroki:

1. W wystąpieniu usługi Azure Spring Apps Enterprise wybierz pozycję Application Insights.

2. Włącz lub wyłącz usługę Application Insights, wybierając pozycję Edytuj powiązanie lub Usuń powiązanie.

   

3. Wybierz pozycję Edytuj powiązanie. Edytuj ustawienia powiązania, a następnie wybierz pozycję Zapisz.

   

Interfejs wiersza polecenia platformy Azure

Poniższe polecenia pokazują, jak sprawdzić lub zaktualizować bieżące ustawienia w usłudze Application Insights.

Użyj następującego polecenia, aby utworzyć powiązanie pakietu buildpack usługi Application Insights:

az spring build-service builder buildpack-binding create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <your-binding-name> \
    --builder-name <your-builder-name> \
    --type ApplicationInsights \
    --properties sampling-percentage=<your-sampling-percentage> \
                 connection-string=<your-connection-string>

Użyj następującego polecenia, aby wyświetlić listę wszystkich powiązań pakietu buildpack i znaleźć powiązania usługi Application Insights dla typu ApplicationInsights:

az spring build-service builder buildpack-binding list \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --builder-name <your-builder-name>

Użyj następującego polecenia, aby zastąpić powiązanie pakietu buildpack usługi Application Insights:

az spring build-service builder buildpack-binding set \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <your-binding-name> \
    --builder-name <your-builder-name> \
    --type ApplicationInsights \
    --properties sampling-percentage=<your-sampling-percentage> \
                 connection-string=<your-connection-string>

Użyj następującego polecenia, aby uzyskać powiązanie pakietu buildpack usługi Application Insights:

az spring build-service builder buildpack-binding show \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <your-binding-name> \
    --builder-name <your-builder-name> \

Użyj następującego polecenia, aby usunąć powiązanie pakietu buildpack usługi Application Insights:

az spring build-service builder buildpack-binding delete \
    --resource-group <your-resource-group-name> \
    --service <your-service-instance-name> \
    --name <your-binding-name> \
    --builder-name <your-builder-name> \

Aby uzyskać więcej informacji, zobacz Używanie agenta przetwarzania Java usługi Application Insights w usłudze Azure Spring Apps.

Następne kroki

• Azure Spring Apps
• Korzystanie z portalu interfejsu API dla programu VMware Tanzu
• Korzystanie z usługi Spring Cloud Gateway