Dela via


Migrera befintliga Azure Service Bus-standardnamnrymder till premiumnivå

Tidigare erbjöd Azure Service Bus endast namnområden på standardnivån. Namnområden är installationer för flera klientorganisationer som är optimerade för miljöer med lågt dataflöde och utvecklare. Premiumnivån erbjuder dedikerade resurser per namnområde för förutsägbar svarstid och ökat dataflöde till ett fast pris. Premiumnivån är optimerad för miljöer med högt dataflöde och produktionsmiljöer som kräver ytterligare företagsfunktioner.

Den här artikeln beskriver hur du migrerar befintliga standardnivånamnområden till premiumnivån.

Varning

Migreringen är avsedd för att Service Bus-standardnamnområden ska uppgraderas till premiumnivån. Migreringsverktyget stöder inte nedgradering. Under migreringen från standarden till premiumnivån skapas en DNS-pekare som kan användas för att komma åt Standard Service Bus. Observera att under migreringen skapas ett alternateName som representerar pekaren till DNS-namnområdet för den gamla servicebussen och åtgärden kan inte ångras. Alla typer av tester bör utföras i en testmiljö.

Några av punkterna att notera:

  • Den här migreringen är avsedd att ske på plats, vilket innebär att befintliga avsändar- och mottagarprogram inte kräver några ändringar i kod eller konfiguration. Den befintliga niska veze pekar automatiskt på det nya premiumnamnområdet.
  • Om du använder ett befintligt premiumnamn bör premiumnamnområdet inte ha några entiteter i det för att migreringen ska lyckas och bör inte ha partitionering aktiverat.
  • Alla entiteter i standardnamnområdet kopieras till premiumnamnområdet under migreringsprocessen.
  • Migrering stöder 1 000 entiteter per meddelandeenhet på premiumnivån. Om du vill identifiera hur många meddelandeenheter du behöver börjar du med antalet entiteter som du har i ditt aktuella standardnamnområde.
  • Du kan inte direkt migrera från basic-nivån till premiumnivån, men du kan göra det indirekt genom att migrera från basic till standard först och sedan från standardnivån till Premium i nästa steg.
  • Inställningarna för rollbaserad åtkomstkontroll (RBAC) migreras inte, så du måste lägga till dem manuellt efter migreringen.

Migreringssteg

Vissa villkor är associerade med migreringsprocessen. Bekanta dig med följande steg för att minska risken för fel. De här stegen beskriver migreringsprocessen och den stegvisa informationen visas i de avsnitt som följer.

  1. Skapa ett nytt premiumnamnområde. Du slutför de kommande tre stegen med hjälp av följande CLI- eller Azure-portalinstruktioner i den här artikeln.
  2. Koppla standard- och premiumnamnrymderna till varandra.
  3. Synkronisera (kopiera över) entiteter från standarden till premium-namnområdet.
  4. Genomför migreringen.
  5. Töm entiteter i standardnamnområdet med namnområdets namn efter migreringen.
  6. Ta bort standardnamnområdet.

Viktigt!

När migreringen har genomförts får du åtkomst till det gamla standardnamnområdet och tömmer köerna och prenumerationerna. När meddelandena har tömts kan de skickas till det nya premiumnamnområdet som ska bearbetas av mottagarprogrammen. När köerna och prenumerationerna har tömts rekommenderar vi att du tar bort det gamla standardnamnområdet.

Migrera med hjälp av Azure CLI eller PowerShell

Följ dessa steg för att migrera service bus-standardnamnområdet till Premium med hjälp av Azure CLI- eller PowerShell-verktyget.

  1. Skapa ett nytt Service Bus Premium-namnområde. Du kan referera till Azure Resource Manager-mallarna eller använda Azure-portalen. Se till att välja premium för parametern serviceBusSku .

  2. Ange följande miljövariabler för att förenkla migreringskommandona. Du kan hämta Azure Resource Manager-ID:t för premiumnamnområdet genom att navigera till namnområdet i Azure-portalen och kopiera den del av URL:en som ser ut som följande exempel: /subscriptions/00000000-0000-0000-0000-00000000000000/resourceGroups/contosoresourcegroup/providers/Microsoft.ServiceBus/namespaces/contosopremiumnamespace.

    resourceGroup = <resource group for the standard namespace>
    standardNamespace = <standard namespace to migrate>
    premiumNamespaceArmId = <Azure Resource Manager ID of the premium namespace to migrate to>
    postMigrationDnsName = <post migration DNS name entry to access the standard namespace>
    

    Viktigt!

    Alias/namn efter migrering (post_migration_dns_name) används för att komma åt det gamla standardnamnområdet efter migreringen. Använd det här alternativet om du vill tömma köerna och prenumerationerna och sedan ta bort namnområdet.

  3. Koppla ihop standard- och premiumnamnrymderna och starta synkroniseringen med hjälp av följande kommando:

    az servicebus migration start --resource-group $resourceGroup --name $standardNamespace --target-namespace $premiumNamespaceArmId --post-migration-name $postMigrationDnsName
    
  4. Kontrollera statusen för migreringen med hjälp av följande kommando:

    az servicebus migration show --resource-group $resourceGroup --name $standardNamespace
    

    Migreringen anses vara slutförd när du ser följande värden:

    • MigrationState = "Aktiv"
    • pendingReplicationsOperationsCount = 0
    • provisioningState = "Lyckades"

    Det här kommandot visar även migreringskonfigurationen. Kontrollera att värdena har angetts korrekt. Kontrollera även premiumnamnområdet i portalen för att se till att alla köer och ämnen har skapats och att de matchar det som fanns i standardnamnområdet.

  5. Genomför migreringen genom att köra följande fullständiga kommando:

    az servicebus migration complete --resource-group $resourceGroup --name $standardNamespace
    

Migrera med hjälp av Azure-portalen

Migrering med hjälp av Azure-portalen har samma logiska flöde som migrering med hjälp av kommandona. Följ de här stegen för att migrera med hjälp av Azure-portalen.

  1. På navigeringsmenyn i det vänstra fönstret väljer du Migrera till premium. Välj knappen Kom igång för att fortsätta till nästa sida. Bild som visar sidan Migrera till premium.

  2. Du ser följande sida för installationsnamnområden .

    Bild som visar sidan Namnområden för installation.

  3. Följ något av följande steg på sidan Installationsnamnområden :

    1. Om du väljer Skapa ett nytt premiumnamnområde:
      1. På sidan Skapa namnområde anger du ett namn för namnområdet och väljer Granska + skapa.

      2. På sidan Granska + skapa väljer du Skapa.

        Bild som visar sidan Skapa namnområde.

    2. Om du väljer Välj ett befintligt tomt premiumnamnområde:
      1. Välj den Azure-prenumeration och resursgrupp som har namnområdet.

      2. Välj sedan premiumnamnområdet.

      3. Klicka sedan på Välj.

        Bild som visar valet av ett befintligt premiumnamnområde.

  4. Ange ett eftermigreringsnamn och välj sedan Nästa. Du använder det här namnet för att komma åt standardnamnområdet när migreringen är klar.

    Bild som visar namnet efter migreringen för standardnamnområdet.

  5. Välj Starta synkronisering för att synkronisera entiteter mellan standard- och premiumnamnrymderna.

    Bild som visar knappen Starta synkronisering.

  6. Välj Ja i dialogrutan för att bekräfta och starta synkroniseringen. Vänta tills synkroniseringen är klar. Välj sedan Nästa.

    Viktigt!

    Om du av någon anledning behöver avbryta migreringen läser du avbrutet flöde i avsnittet Vanliga frågor och svar i det här dokumentet.

  7. Välj Slutför migrering på sidan Växla .

    Bild som visar sidan **Växla** i migreringsguiden.

  8. Välj Ja för att bekräfta växlingen av standardnamnområdet till premium. När växeln är klar pekar DNS-namnet på standardnamnområdet på ditt premiumnamnområde. Det går inte att ångra den här åtgärden. Sidan Lyckades visas när migreringen är klar.

    Bild som visar sidan Lyckades.

Varningar

Vissa av funktionerna som tillhandahålls av Azure Service Bus Standard-nivån stöds inte av Azure Service Bus Premium-nivån. Dessa är avsiktliga eftersom premiumnivån erbjuder dedikerade resurser för förutsägbart dataflöde och svarstid.

Här är en översikt över funktioner som inte stöds av Premium och deras åtgärder.

Expressenheter

Expressentiteter som inte checkar in några meddelandedata till lagring stöds inte på Premium-nivån . Dedikerade resurser gav betydande dataflödesförbättringar samtidigt som data sparas, vilket förväntas av alla meddelandesystem för företag.

Under migreringen skapas någon av dina expressentiteter i standardnamnområdet på Premium-namnområdet som en icke-expressentitet.

Om du använder Azure Resource Manager-mallar kontrollerar du att du tar bort flaggan "enableExpress" från distributionskonfigurationen så att dina automatiserade arbetsflöden körs utan fel.

RBAC-inställningar

Inställningarna för rollbaserad åtkomstkontroll (RBAC) i namnområdet migreras inte till premiumnamnområdet. Du måste lägga till dem manuellt efter migreringen.

Vanliga frågor och svar

Vad händer när migreringen utförs?

När migreringen har checkats in pekar niska veze som pekade på standardnamnområdet på premiumnamnområdet.

Avsändar- och mottagarprogrammen kopplar från standardnamnområdet och återansluter automatiskt till premiumnamnområdet.

Om du använder Azure Resource Manager-ID:t för konfiguration i stället för en niska veze (t.ex. som mål för en Event Grid-prenumeration) måste du uppdatera Azure Resource Manager-ID:t till premiumnamnområdet.

Vad gör jag när standardmigreringen till Premium har slutförts?

Standardmigreringen till Premium säkerställer att entitetsmetadata som ämnen, prenumerationer och filter kopieras från standardnamnområdet till premiumnamnområdet. Meddelandedata som har checkats in i standardnamnområdet kopieras inte från standardnamnområdet till premiumnamnområdet.

Standardnamnområdet kan ha vissa meddelanden som har skickats och checkats in medan migreringen pågick. Töm meddelandena manuellt från standardnamnområdet och skicka dem manuellt till premiumnamnområdet. Om du vill tömma meddelandena manuellt använder du en konsolapp eller ett skript som tömmer standardnamnområdesentiteterna med hjälp av dns-namnet efter migreringen som du angav i migreringskommandona. Skicka dessa meddelanden till premiumnamnområdet så att de kan bearbetas av mottagarna.

När meddelandena har tömts tar du bort standardnamnområdet.

Viktigt!

När meddelandena från standardnamnområdet har tömts tar du bort standardnamnområdet. Detta är viktigt eftersom niska veze som ursprungligen refererade till standardnamnområdet nu refererar till premiumnamnområdet. Du behöver inte standardnamnområdet längre. Om du tar bort standardnamnområdet som du migrerade kan du minska förvirringen senare.

Hur mycket stilleståndstid förväntar jag mig?

Migreringsprocessen är avsedd att minska den förväntade stilleståndstiden för programmen. Stilleståndstiden minskas med hjälp av niska veze som avsändar- och mottagarprogrammen använder för att peka på det nya premiumnamnområdet.

Den stilleståndstid som programmet upplever är begränsad till den tid det tar att uppdatera DNS-posten så att den pekar på premiumnamnområdet. Stilleståndstiden är cirka 5 minuter.

Måste jag göra några konfigurationsändringar när jag gör migreringen?

Nej, det behövs inga kod- eller konfigurationsändringar för migreringen. DNS-namnet på standardnamnområdet pekar på ditt premiumnamnområde. Den niska veze som avsändare och mottagarprogram använder för att komma åt standardnamnområdet mappas automatiskt för att fungera som ett alias för premiumnamnområdet.

Hur avbryter jag migreringen?

Migreringen kan avbrytas antingen med hjälp Abort av kommandot eller med hjälp av Azure-portalen.

Azure CLI

az servicebus migration abort --resource-group $resourceGroup --name $standardNamespace

Azure Portal

Välj Avbrytsidan Synkronisera entiteter .

Bild som visar sidan Avbryt.

När den är klar visas följande sida:

Bild som visar sidan Avbryt slutförd.

Vad händer när jag avbryter migreringen?

När migreringsprocessen avbryts avbryts processen med att kopiera entiteterna (ämnen, prenumerationer och filter) från standarden till premiumnamnområdet och bryter parkopplingen.

Niska veze uppdateras inte för att peka på premiumnamnområdet. Dina befintliga program fortsätter att fungera som de gjorde innan du startade migreringen.

Den tar dock inte bort entiteterna i premiumnamnområdet eller tar bort premiumnamnområdet. Ta bort entiteterna manuellt om du har valt att inte gå vidare med migreringen.

Viktigt!

Om du bestämmer dig för att avbryta migreringen tar du bort det premiumnamnområde som du har etablerat för migreringen så att du inte debiteras för resurserna.

Jag vill inte behöva tömma meddelandena. Vad ska jag göra?

Det kan finnas meddelanden som skickas av avsändarprogrammen och skickas till lagringen på standardnamnområdet medan migreringen sker och precis innan migreringen genomförs.

Under migreringen kopieras inte de faktiska meddelandedata/nyttolasten från standarden till premiumnamnområdet. Meddelandena måste tömmas manuellt och sedan skickas till premiumnamnområdet.

Men om du kan migrera under ett planerat underhåll/hushållningsfönster och du inte vill tömma och skicka meddelanden manuellt följer du dessa steg:

  1. Stoppa avsändarprogrammen. Mottagarprogrammen bearbetar de meddelanden som för närvarande finns i standardnamnområdet och tömmer kön.

  2. När köerna och prenumerationerna i standardnamnområdet är tomma följer du proceduren som beskrivs tidigare för att köra migreringen från standarden till premiumnamnområdet.

  3. När migreringen är klar kan du starta om avsändarprogrammen.

  4. Avsändare och mottagare ansluter nu automatiskt till premiumnamnområdet.

    Kommentar

    Du behöver inte stoppa mottagarprogrammen för migreringen.

    När migreringen är klar kopplas mottagarprogrammen från standardnamnområdet och ansluts automatiskt till premiumnamnområdet.

Nästa steg