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

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.

Plan dotyczący zużycia standardowego oraz dedykowany plan zostały wycofane 30 września 2024 r., z całkowitym zamknięciem do końca marca 2025 r. 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.

Przygotuj instancję usługi

W planie Azure Spring Apps Enterprise składniki VMware Tanzu zastępują składniki open source Spring Cloud, aby zapewnić większe wsparcie dla 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:

Portal Azure

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 skonfigurowaniu wystąpienia usługi Azure Spring Apps nie można włączyć ani wyłączyć 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 utworzeniu wystąpienia usługi Azure Spring Apps. Aby uzyskać więcej informacji na temat cen usługi Application Insights, zobacz sekcję Fakturowanie usługi Application Insights w temacie Obliczenia kosztów i opcje dla 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 Przejrzyj i utwórz i poczekaj na zakończenie walidacji, a następnie wybierz Utwórz, aby rozpocząć udostępnianie wystąpienia usługi.

Aprowizacja zasobów trwa około 5 minut.

Azure CLI

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 instancji 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ę dla 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 planie Standard.

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 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 Application Configuration Service dla Tanzu

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

Portal Azure

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 Usługę konfiguracji aplikacji w okienku nawigacji.

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

   

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

Azure CLI

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 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 Enterprise Rejestr Usług Tanzu zapewnia rejestr usług i obsługę dla odnajdywania usł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 Standardowy	Plan przedsiębiorstwa
Rejestr usług	System operacyjny Eureka Automatyczne wiązanie (zawsze iniekcja) Zawsze aprowizowana	Rejestr Usług dla 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.

Portal Azure

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

2. Wybierz 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.

   

Azure CLI

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 Korzystanie z rejestru usług 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 wielojęzyczne do wdrażania z artefaktów 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 wiąże się z Usługą Konfiguracji Aplikacji dla Tanzu, musisz podać dodatkowy argument —config-file-pattern.

Aby uzyskać więcej informacji, zobacz Korzyści z użytkowania usługi Tanzu Build Service.

Lokalne tworzenie aplikacji

Wykonaj następujące kroki, aby zbudować 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 Azure Spring Apps Enterprise używa powiązań buildpack do zintegrowania usługi Application Insights z typem ApplicationInsights, zamiast Agenta In-Process. Aby uzyskać więcej informacji, zobacz Jak skonfigurować integrację APM i certyfikaty urzędów certyfikacji.

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

Plan standardowy	Plan przedsiębiorstwa
Usługa Application Insights Nowa relikwia Dynatrace AppDynamics	Usługa Application Insights Nowa relikwia Dynatrace AppDynamics ElasticAPM

Portal Azure

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.

   

Azure CLI

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 buildpack dla 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 buildpacku aplikacji 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