Migrera en Azure Spring Apps Basic- eller Standard-planinstans till Enterprise-planen

Kommentar

Azure Spring Apps är det nya namnet på Azure Spring Cloud-tjänsten. Även om tjänsten har ett nytt namn ser du det gamla namnet på vissa platser ett tag medan vi arbetar med att uppdatera tillgångar som skärmbilder, videor och diagram.

Den här artikeln gäller för: ✔️ Basic/Standard ✔️ Enterprise

Den här artikeln visar hur du migrerar ett befintligt program i Basic- eller Standard-planen till Enterprise-planen. När du migrerar från Basic- eller Standard-planen till Enterprise-planen ersätter VMware Tanzu-komponenterna komponenterna för programvara med öppen källkod (OSS) Spring Cloud för att ge mer funktionsstöd.

I den här artikeln används exempelappar för husdjurskliniken som exempel på hur du migrerar.

Förutsättningar

• En Azure-prenumeration. Om du inte har någon prenumeration skapar du ett kostnadsfritt konto innan du börjar.
• Azure CLI version 2.45.0 eller senare.
• Azure Spring Apps Enterprise-plantillägget. Använd följande kommando för att ta bort tidigare versioner och installera det senaste Enterprise-plantillägget. Om du tidigare har installerat spring-cloud tillägget avinstallerar du det för att undvika konfigurations- och versionsmatchningar.

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

• Git.

Etablera en tjänstinstans

I Azure Spring Apps Enterprise-planen ersätter VMware Tanzu-komponenterna OSS Spring Cloud-komponenterna för att ge mer funktionsstöd. Tanzu-komponenter aktiveras på begäran enligt dina behov. Du måste aktivera de komponenter du behöver innan du skapar Azure Spring Apps-tjänstinstansen.

Kommentar

Om du vill använda Tanzu-komponenter måste du aktivera dem när du etablerar din Azure Spring Apps-tjänstinstans. Du kan inte aktivera dem efter etableringen just nu.

Använd följande steg för att etablera en Azure Spring Apps-tjänstinstans:

Azure-portalen

1. Öppna Azure Portal.

2. Sök efter Azure Spring Apps i den översta sökrutan.

3. Välj Azure Spring Apps i resultatet och välj sedan Skapa.

4. På sidan Skapa Azure Spring Apps anger du din prenumeration, resursgrupp och namn för instansen.

5. För Planera i tjänstinformation väljer du Ändra.

   

6. På sidan Välj din plan väljer du raden Företag i tabellen och väljer sedan Välj.

   

7. På sidan Skapa Azure Spring Apps väljer du Villkor för att godkänna de juridiska villkoren och sekretesspolicyerna för Enterprise-abonnemangserbjudandet på Azure Marketplace.

8. Välj Nästa: VMware Tanzu-inställningar.

9. På inställningsfliken VMWare Tanzu bläddrar du igenom listan för att granska Tanzu-komponenterna. Alla komponenter är aktiverade som standard.

   

   Kommentar

   Fundera noga över vilka Tanzu-komponenter du vill använda eller aktivera under etableringsfasen. När du har etablerat Azure Spring Apps-instansen kan du inte aktivera eller inaktivera Tanzu-komponenter.

10. Välj fliken Application Insights och välj sedan Aktivera Application Insights. Granska följande inställningar:

    • Aktivera Application Insights bör väljas .
    • Välj en befintlig Application Insights-instans eller skapa en ny Application Insights-instans.
    • Ange en samplingsfrekvens i intervallet 0–100 eller använd standardvärdet 10.

    Du kan också aktivera Application Insights när du har etablerat Azure Spring Apps-instansen. Mer information om priser för Application Insights finns i avsnittet Application Insights-fakturering i kostnadsberäkningar och alternativ för Azure Monitor-loggar.

    Kommentar

    Du betalar för användningen av Application Insights när du är integrerad med Azure Spring Apps.

11. Välj Granska och skapa och vänta tills verifieringen har slutförts och välj sedan Skapa för att börja etablera tjänstinstansen.

Det tar cirka 5 minuter att slutföra resursetablering.

Azure CLI

1. Använd följande kommando för att uppdatera Azure CLI med Azure Spring Apps-tillägget:

   az extension add --upgrade --name spring
   

2. Använd följande kommandon för att logga in på Azure CLI och välja din aktiva prenumeration:

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

3. Använd följande kommando för att acceptera juridiska villkor och sekretesspolicyer för Enterprise-planen. Det här steget krävs bara första gången du skapar en Azure Spring Apps-instans i Enterprise-planen.

   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. Skapa ett namn för din Azure Spring Apps-tjänstinstans. Namnet måste vara mellan 4 och 32 tecken långt och får bara innehålla gemener, siffror och bindestreck. Det första tecknet i tjänstnamnet måste vara en bokstav och det sista tecknet måste vara antingen en bokstav eller ett tal.

5. Använd följande kommando för att skapa en resursgrupp och en Azure Spring Apps-tjänstinstans:

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

   Mer information om resursgrupper finns i Vad är Azure Resource Manager?.

Skapa och konfigurera appar

Stegen för att skapa appar är desamma som Standard-planen.

1. Använd följande kommando för att ange Azure CLI-standardvärden. Se till att ersätta platshållarna med dina egna värden.

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

2. Använd följande kommandon för att skapa de två kärnprogrammen för PetClinic api-gateway och 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
   

Använda Application Configuration Service för extern konfiguration

För externaliserad konfiguration i ett distribuerat system är hanterad Spring Cloud Config Server (OSS) endast tillgänglig i Basic- och Standard-abonnemangen. I Enterprise-planen tillhandahåller Programkonfigurationstjänsten för Tanzu liknande funktioner för dina appar. I följande tabell beskrivs vissa skillnader i användning mellan OSS-konfigurationsservern och programkonfigurationstjänsten.

Komponent	Supportavtal	Aktiverat	Binda till app	Profile
Spring Cloud Config Server	Basic/Standard	Alltid aktiverat.	Automatiskt bunden	Konfigurerad i appens källkod.
Programkonfigurationstjänst för Tanzu	Stora företag	Aktivera på begäran.	Manuell bindning	Tillhandahålls som config-file-pattern i en Azure Spring Apps-distribution.

Till skillnad från klient-server-läget i OSS-konfigurationsservern hanterar Application Configuration Service konfigurationen med hjälp av Kubernetes-native ConfigMap, som fylls i från egenskaper som definierats i Serverdelens Git-lagringsplatser. Programkonfigurationstjänsten kan inte få den aktiva profilen konfigurerad i appens källkod för att matcha rätt konfiguration, så den explicita konfigurationen config-file-pattern bör anges på distributionsnivå för Azure Spring Apps.

Konfigurera programkonfigurationstjänsten för Tanzu

Följ de här stegen för att använda Application Configuration Service för Tanzu som en centraliserad konfigurationstjänst.

Azure-portalen

1. I din Azure Spring Apps Enterprise-instans väljer du Programkonfigurationstjänst i navigeringsfönstret. Visa körningstillståndet och resurserna som allokerats till Programkonfigurationstjänsten för Tanzu.

   

2. Välj Inställningar och fyll i formuläret i lagringsplatser för att lägga till en ny post med följande information:

   • Namn: default
   • Mönster: api-gateway,customers-service
   • URI: https://github.com/Azure-Samples/spring-petclinic-microservices-config
   • Etikett: master

   

3. Välj Verifiera för att verifiera åtkomsten till mål-URI:n.

4. När valideringen har slutförts väljer du Använd för att uppdatera konfigurationsinställningarna.

Azure CLI

Använd följande kommando för att ange standardlagringsplatsen:

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

Binda program till Programkonfigurationstjänst för Tanzu

När du använder Application Configuration Service för Tanzu med en Git-serverdel måste du binda appen till Application Configuration Service för Tanzu. När du har bindt appen måste du konfigurera vilket mönster som används av appen. Använd följande steg för att binda och konfigurera mönstret för appen.

Azure-portalen

Använd följande steg för att binda appar till Application Configuration Service för VMware Tanzu.

1. I din Azure Spring Apps Enterprise-instans väljer du Programkonfigurationstjänst i navigeringsfönstret.

2. Välj Appbindning och välj sedan Bind app.

   

3. Välj en app i den nedrullningsbara menyn och välj sedan Använd för att binda programmet till Programkonfigurationstjänsten för Tanzu.

Azure CLI

Använd följande kommandon för att binda appar till Application Configuration Service för VMware Tanzu och VMware Tanzu Service Registry:

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

Mer information finns i Använda programkonfigurationstjänsten för Tanzu.

Använda Service Registry för Tanzu

Service Registry är en av de egenutvecklade VMware Tanzu-komponenterna. Det ger dina appar en implementering av Service Discovery-mönstret, ett av de viktigaste begreppen i en mikrotjänstbaserad arkitektur. I Enterprise-planen tillhandahåller Service Registry for Tanzu tjänstregister och identifierar stöd för dina appar. Managed Spring Cloud Eureka är endast tillgängligt i Basic- och Standard-planen och är inte tillgängligt i Enterprise-planen.

Komponent	Standardplan	Enterprise-plan
Tjänstregister	OSS eureka Automatisk bindning (alltid inmatning) Alltid etablerad	Service Registry för Tanzu Behöver manuell bindning till appen Aktivera på begäran

Binda ett program till Tanzu Service Registry

Följ dessa steg om du vill binda appar till Application Configuration Service för VMware Tanzu.

Azure-portalen

1. I din Azure Spring Apps Enterprise-instans väljer du Service Registry.

2. Välj Appbindning. För närvarande visas bundna appar under Appnamn.

3. Välj Bind app.

4. Välj en app i den nedrullningsbara menyn och välj sedan Använd för att binda programmet till Tanzu Service Registry.

   

Azure CLI

Använd följande kommandon för att binda appar till Application Configuration Service för VMware Tanzu och VMware Tanzu Service Registry:

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

Kommentar

När du ändrar bindnings-/avbindningsstatusen måste du starta om eller distribuera om appen för att ändringen ska börja gälla.

Mer information finns i Använda Tanzu Service Registry.

Skapa och distribuera program

I Enterprise-planen används Tanzu Build Service för att skapa appar. Den innehåller fler funktioner som flerspråkiga appar att distribuera från artefakter som källkod och zip-filer.

Om du vill använda Tanzu Build Service måste du ange en resurs som bygguppgiften och byggverktyget ska använda. Du kan också ange parametern --build-env för att ange byggmiljöer.

Om appen binder till Application Configuration Service för Tanzu måste du ange ett extra argument —config-file-pattern.

Mer information finns i Använda Tanzu Build Service.

Skapa program lokalt

Använd följande steg för att skapa lokalt:

1. Använd följande kommandon för att klona exempelapplagringsplatsen i ditt Azure-konto, ändra katalogen och skapa projektet:

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

   Det kan ta flera minuter att kompilera projektet. När du är klar har du enskilda JAR-filer för varje tjänst i respektive mapp.

2. Använd följande kommandon för att distribuera JAR-filerna som skapades i föregående steg:

   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. Använd följande kommando för att köra frågor mot programstatusen efter distributionen:

   az spring app list --output table
   

   Det här kommandot genererar utdata som liknar följande exempel:

   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
   

Använda Application Insights

Azure Spring Apps Enterprise-planen använder buildpack-bindningar för att integrera Application Insights med typen ApplicationInsights i stället för In-Process Agent. Mer information finns i Konfigurera APM-integrering och CA-certifikat.

I följande tabell visas de APM-leverantörer som är tillgängliga för abonnemangen.

Standardplan	Enterprise-plan
Application Insight Ny relik Dynatrace AppDynamics	Application Insight Ny relik Dynatrace AppDynamics ElasticAPM

Azure-portalen

Om du vill kontrollera eller uppdatera de aktuella inställningarna i Application Insights använder du följande steg:

1. I din Azure Spring Apps Enterprise-instans väljer du Application Insights.

2. Aktivera eller inaktivera Application Insights genom att välja Redigera bindning eller Avbindningsbindning.

   

3. Välj Redigera bindning. Redigera bindningsinställningarna och välj sedan Spara.

   

Azure CLI

Följande kommandon visar hur du kontrollerar eller uppdaterar de aktuella inställningarna i Application Insights.

Använd följande kommando för att skapa en Application Insights buildpack-bindning:

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>

Använd följande kommando för att lista alla buildpack-bindningar och hitta Application Insights-bindningar för typen 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>

Använd följande kommando för att ersätta en Application Insights buildpack-bindning:

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>

Använd följande kommando för att hämta en Application Insights buildpack-bindning:

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

Använd följande kommando för att ta bort en Application Insights buildpack-bindning:

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

Mer information finns i Använda Application Insights Java In-Process Agent i Azure Spring Apps.

Nästa steg

• Azure Spring Apps
• Använda API-portalen för VMware Tanzu
• Använda Spring Cloud Gateway