Een Azure Spring Apps Basic- of Standard-planexemplaren migreren naar het Enterprise-abonnement

Notitie

De Basic-, Standard- en Enterprise-abonnementen worden afgeschaft vanaf medio maart 2025, met een pensioenperiode van 3 jaar. We raden u aan om over te stappen naar Azure Container Apps. Zie de aankondiging over buitengebruikstelling van Azure Spring Apps voor meer informatie.

Het standaardverbruik en het speciale abonnement worden vanaf 30 september 2024 afgeschaft, met een volledige afsluiting na zes maanden. We raden u aan om over te stappen naar Azure Container Apps. Zie Azure Spring Apps Standard-verbruik en toegewezen abonnement migreren naar Azure Container Apps voor meer informatie.

Dit artikel is van toepassing op: ✔️ Basic/Standard ✔️ Enterprise

In dit artikel leest u hoe u een bestaande toepassing in het Basic- of Standard-abonnement migreert naar het Enterprise-abonnement. Wanneer u migreert van het Basic- of Standard-plan naar het Enterprise-abonnement, vervangen VMware Tanzu-onderdelen de opensource-software (OSS) Spring Cloud-onderdelen om meer functieondersteuning te bieden.

In dit artikel worden de voorbeeld-apps van Pet Clinic gebruikt als voorbeelden van hoe u migreert.

Vereisten

• Een Azure-abonnement. Als u geen abonnement hebt, maakt u een gratis account voordat u begint.
• Azure CLI versie 2.45.0 of hoger.
• De Azure Spring Apps Enterprise-abonnementsextensie. Gebruik de volgende opdracht om eerdere versies te verwijderen en de nieuwste Enterprise-abonnementsextensie te installeren. Als u de extensie eerder hebt geïnstalleerd, verwijdert u deze spring-cloud om te voorkomen dat de configuratie en versie niet overeenkomen.

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

• Git.

Een service-exemplaar inrichten

In het Azure Spring Apps Enterprise-plan vervangen VMware Tanzu-onderdelen de OSS Spring Cloud-onderdelen om meer functieondersteuning te bieden. Tanzu-onderdelen zijn op aanvraag ingeschakeld op basis van uw behoeften. U moet de benodigde onderdelen inschakelen voordat u het Azure Spring Apps-service-exemplaar maakt.

Notitie

Als u Tanzu Components wilt gebruiken, moet u deze inschakelen wanneer u uw Azure Spring Apps-service-exemplaar inricht. U kunt ze op dit moment niet inschakelen na het inrichten.

Gebruik de volgende stappen om een Azure Spring Apps-service-exemplaar in te richten:

Azure-portal

1. Open de Azure Portal.

2. Zoek in het bovenste zoekvak naar Azure Spring Apps.

3. Selecteer Azure Spring Apps in de resultaten en selecteer vervolgens Maken.

4. Stel op de pagina Azure Spring Apps maken uw abonnement, resourcegroep en naam voor het exemplaar in.

5. Selecteer Wijzigen voor Plan in ServiceDetails.

   

6. Selecteer op de pagina Uw abonnement kiezen de rij Onderneming in de tabel en selecteer vervolgens Selecteren.

   

7. Selecteer op de pagina Azure Spring Apps maken de voorwaarden om akkoord te gaan met de juridische voorwaarden en privacyverklaringen van de Enterprise-abonnementsaanbieding in Azure Marketplace.

8. Selecteer Volgende: VMware Tanzu-instellingen.

9. Blader op het tabblad VMWare Tanzu-instellingen door de lijst om de Tanzu-onderdelen te bekijken. Alle onderdelen zijn standaard ingeschakeld.

   

   Notitie

   Overweeg zorgvuldig welke Tanzu-onderdelen u wilt gebruiken of inschakelen tijdens de inrichtingsfase. Na het inrichten van het Azure Spring Apps-exemplaar kunt u Tanzu-onderdelen niet in- of uitschakelen.

10. Selecteer het tabblad Application Insights en selecteer Vervolgens Application Insights inschakelen. Controleer de volgende instellingen:

    • Application Insights inschakelen moet zijn geselecteerd.
    • Kies een bestaand Application Insights-exemplaar of maak een nieuw Application Insights-exemplaar.
    • Voer een steekproeffrequentie in het bereik van 0-100 in of gebruik de standaardwaarde 10.

    U kunt Application Insights ook inschakelen nadat u het Azure Spring Apps-exemplaar hebt ingericht. Zie de sectie Application Insights-facturering van Azure Monitor-kostenberekeningen en -opties voor meer informatie over de prijzen van Application Insights.

    Notitie

    U betaalt voor het gebruik van Application Insights wanneer deze is geïntegreerd met Azure Spring Apps.

11. Selecteer Controleren en maken en wachten tot de validatie is voltooid en selecteer vervolgens Maken om het service-exemplaar in te richten.

Het duurt ongeveer 5 minuten om het inrichten van resources te voltooien.

Azure-CLI

1. Gebruik de volgende opdracht om Azure CLI bij te werken met de Azure Spring Apps-extensie:

   az extension add --upgrade --name spring
   

2. Gebruik de volgende opdrachten om u aan te melden bij de Azure CLI en uw actieve abonnement te kiezen:

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

3. Gebruik de volgende opdracht om de juridische voorwaarden en privacyverklaringen voor het Enterprise-abonnement te accepteren. Deze stap is alleen vereist wanneer u voor het eerst een Azure Spring Apps-exemplaar in het Enterprise-abonnement maakt.

   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. Maak een naam voor uw Azure Spring Apps-service-exemplaar. De naam moet tussen 4 en 32 tekens lang zijn en mag alleen kleine letters, cijfers en afbreekstreepjes bevatten. Het eerste teken van de servicenaam moet een letter zijn en het laatste teken moet een letter of een cijfer zijn.

5. Gebruik de volgende opdracht om een resourcegroep en een Azure Spring Apps-service-exemplaar te maken:

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

   Zie Wat is Azure Resource Manager? voor meer informatie over resourcegroepen.

Apps maken en configureren

De stappen voor het maken van apps zijn hetzelfde als het Standard-abonnement.

1. Gebruik de volgende opdracht om de standaardinstellingen van Azure CLI in te stellen. Vervang de tijdelijke aanduidingen door uw eigen waarden.

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

2. Gebruik de volgende opdrachten om de twee kerntoepassingen voor PetClinic api-gateway te maken en 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
   

Toepassingsconfiguratieservice gebruiken voor externe configuratie

Voor externe configuratie in een gedistribueerd systeem is beheerde Spring Cloud Config Server (OSS) alleen beschikbaar in de Basic- en Standard-abonnementen. In het Enterprise-plan biedt Application Configuration Service voor Tanzu vergelijkbare functies voor uw apps. In de volgende tabel worden enkele verschillen in gebruik tussen de OSS-configuratieserver en application configuration-service beschreven.

Onderdeel	Ondersteuningsplannen	Ingeschakeld	Binden aan app	Profiel
Spring Cloud-configuratieserver	Basic/Standard	Altijd ingeschakeld.	Automatisch gebonden	Geconfigureerd in de broncode van de app.
Toepassingsconfiguratieservice voor Tanzu	Enterprise	Schakel op aanvraag in.	Handmatige binding	Geleverd als config-file-pattern in een Azure Spring Apps-implementatie.

In tegenstelling tot de client-servermodus in de OSS-configuratieserver beheert Application Configuration Service de configuratie met behulp van de Kubernetes-systeemeigen ConfigMap, die wordt gevuld met eigenschappen die zijn gedefinieerd in git-opslagplaatsen in de back-end. Application Configuration Service kan het actieve profiel dat is geconfigureerd in de broncode van de app, niet ophalen zodat deze overeenkomt met de juiste configuratie. Daarom moet de expliciete configuratie config-file-pattern worden opgegeven op het implementatieniveau van Azure Spring Apps.

Toepassingsconfiguratieservice configureren voor Tanzu

Volg deze stappen om Application Configuration Service voor Tanzu te gebruiken als een gecentraliseerde configuratieservice.

Azure-portal

1. Selecteer in uw Azure Spring Apps Enterprise-exemplaar de toepassingsconfiguratieservice in het navigatiedeelvenster. Bekijk de actieve status en resources die zijn toegewezen aan Application Configuration Service voor Tanzu.

   

2. Selecteer Instellingen en vul het formulier in Opslagplaatsen in om een nieuwe vermelding toe te voegen met de volgende informatie:

   • Naam: default
   • Patronen: api-gateway,customers-service
   • URI: https://github.com/Azure-Samples/spring-petclinic-microservices-config
   • Etiket: master

   

3. Selecteer Valideren om de toegang tot de doel-URI te valideren.

4. Nadat de validatie is voltooid, selecteert u Toepassen om de configuratie-instellingen bij te werken.

Azure-CLI

Gebruik de volgende opdracht om de standaardopslagplaats in te stellen:

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

Toepassingen binden aan Application Configuration Service voor Tanzu

Wanneer u Application Configuration Service voor Tanzu gebruikt met een Git-back-end, moet u de app verbinden met Application Configuration Service voor Tanzu. Nadat u de app hebt gekoppeld, moet u configureren welk patroon door de app wordt gebruikt. Gebruik de volgende stappen om het patroon voor de app te binden en te configureren.

Azure-portal

Gebruik de volgende stappen om apps te binden aan Application Configuration Service voor VMware Tanzu.

1. Selecteer in uw Azure Spring Apps Enterprise-exemplaar de toepassingsconfiguratieservice in het navigatiedeelvenster.

2. Selecteer App-binding en selecteer vervolgens Bind-app.

   

3. Selecteer een app in de vervolgkeuzelijst en selecteer Vervolgens Toepassen om de toepassing te binden aan Application Configuration Service voor Tanzu.

Azure-CLI

Gebruik de volgende opdrachten om apps te binden aan Application Configuration Service voor VMware Tanzu en VMware Tanzu Service Registry:

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

Zie Application Configuration Service voor Tanzu gebruiken voor meer informatie.

Serviceregister voor Tanzu gebruiken

Service Registry is een van de eigen VMware Tanzu-onderdelen. Het biedt uw apps een implementatie van het Service Discovery-patroon, een van de belangrijkste concepten van een microservicearchitectuur. In het Enterprise-plan biedt serviceregister voor Tanzu serviceregister en detecteert u ondersteuning voor uw apps. Managed Spring Cloud Eureka is alleen beschikbaar in het Basic- en Standard-abonnement en is niet beschikbaar in het Enterprise-abonnement.

Onderdeel	Standard-abonnement	Enterprise-abonnement
Serviceregister	OSS eureka Automatisch gebonden (altijd injectie) Altijd ingericht	Serviceregister voor Tanzu Handmatige binding met app nodig Op aanvraag inschakelen

Een toepassing binden aan tanzu-serviceregister

Volg deze stappen om apps te binden aan Application Configuration Service voor VMware Tanzu.

Azure-portal

1. Selecteer serviceregister in uw Azure Spring Apps Enterprise-exemplaar.

2. Selecteer App-binding. Momenteel gebonden apps worden weergegeven onder app-naam.

3. Selecteer Bind-app.

4. Selecteer een app in de vervolgkeuzelijst en selecteer vervolgens Toepassen om de toepassing te binden aan Tanzu Service Registry.

   

Azure-CLI

Gebruik de volgende opdrachten om apps te binden aan Application Configuration Service voor VMware Tanzu en VMware Tanzu Service Registry:

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

Notitie

Wanneer u de bindings-/niet-gekoppelde status wijzigt, moet u de app opnieuw starten of opnieuw implementeren om de wijziging door te voeren.

Zie Tanzu Service Registry gebruiken voor meer informatie.

Toepassingen bouwen en implementeren

In het Enterprise-plan wordt Tanzu Build Service gebruikt om apps te bouwen. Het biedt meer functies zoals polyglot-apps om te implementeren vanuit artefacten, zoals broncode en zip-bestanden.

Als u Tanzu Build Service wilt gebruiken, moet u een resource opgeven die moet worden gebruikt voor het bouwen van taken en opbouwfuncties. U kunt ook de --build-env parameter opgeven om buildomgevingen in te stellen.

Als de app bindt met Application Configuration Service voor Tanzu, moet u een extra argument —config-file-patternopgeven.

Zie Tanzu Build Service gebruiken voor meer informatie.

Toepassingen lokaal bouwen

Gebruik de volgende stappen om lokaal te bouwen:

1. Gebruik de volgende opdrachten om de opslagplaats van de voorbeeld-app in uw Azure-account te klonen, de map te wijzigen en het project te bouwen:

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

   Het compileren van het project kan enkele minuten duren. Als u klaar bent, hebt u afzonderlijke JAR-bestanden voor elke service in de desbetreffende map.

2. Gebruik de volgende opdrachten om de JAR-bestanden te implementeren die in de vorige stap zijn gebouwd:

   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. Gebruik de volgende opdracht om een query uit te voeren op de toepassingsstatus na de implementatie:

   az spring app list --output table
   

   Met deze opdracht wordt uitvoer geproduceerd die vergelijkbaar is met het volgende voorbeeld:

   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
   

Application Insights gebruiken

Het Azure Spring Apps Enterprise-plan maakt gebruik van buildpack-bindingen om Application Insights te integreren met het type ApplicationInsights in plaats van In-Process Agent. Zie APM-integratie en CA-certificaten configureren voor meer informatie.

De volgende tabel bevat de APM-providers die de abonnementen beschikbaar hebben.

Standard-abonnement	Enterprise-abonnement
Inzicht in toepassingen New Relic Dynatrace AppDynamics	Inzicht in toepassingen New Relic Dynatrace AppDynamics ElasticAPM

Azure-portal

Gebruik de volgende stappen om de huidige instellingen in Application Insights te controleren of bij te werken:

1. Selecteer Application Insights in uw Azure Spring Apps Enterprise-exemplaar.

2. Schakel Application Insights in of uit door Binding bewerken of Binding ongedaan maken te selecteren.

   

3. Selecteer Binding bewerken. Bewerk de bindingsinstellingen en selecteer Opslaan.

   

Azure-CLI

De volgende opdrachten laten zien hoe u de huidige instellingen in Application Insights controleert of bijwerkt.

Gebruik de volgende opdracht om een Application Insights buildpack-binding te maken:

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>

Gebruik de volgende opdracht om alle buildpack-bindingen weer te geven en Zoek Application Insights-bindingen voor het type 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>

Gebruik de volgende opdracht om een Application Insights buildpack-binding te vervangen:

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>

Gebruik de volgende opdracht om een Application Insights buildpack-binding op te halen:

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> \

Gebruik de volgende opdracht om een Application Insights buildpack-binding te verwijderen:

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> \

Zie Application Insights Java In-Process Agent gebruiken in Azure Spring Apps voor meer informatie.

Volgende stappen

• Azure Spring Apps
• API-portal gebruiken voor VMware Tanzu
• Spring Cloud Gateway gebruiken