Dela via


Flytta Azure Event Grid-systemämnen till en annan region

Den här artikeln beskriver den rekommenderade metoden, riktlinjerna och metoderna för att flytta Event Grid-systemämnen till en annan region.

Det finns olika orsaker till varför du kanske vill flytta dina befintliga Azure-resurser från en region till en annan. Du kanske vill:

  • Dra nytta av en ny Azure-region.
  • Distribuera endast funktioner eller tjänster som är tillgängliga i specifika regioner.
  • Uppfylla interna policy- och styrningskrav.
  • Justera med företagsfusioner och förvärv
  • Uppfylla kapacitetsplaneringskraven.

Här är de övergripande stegen som beskrivs i den här artikeln:

  • Exportera resursgruppen som innehåller Azure Storage-kontot och dess associerade systemavsnitt till en Resource Manager-mall. Du kan också exportera en mall endast för systemavsnittet. Om du går den här vägen bör du komma ihåg att flytta Azure-händelsekällan (i det här exemplet ett Azure Storage-konto) till den andra regionen innan du flyttar systemämnet. I den exporterade mallen för systemavsnittet uppdaterar du sedan det externa ID:t för lagringskontot i målregionen.
  • Ändra mallen för att lägga till egenskapen så att den endpointUrl pekar på en webhook som prenumererar på systemämnet. När systemämnet exporteras exporteras även dess prenumeration (i det här fallet en webhook) till mallen, men egenskapen endpointUrl ingår inte. Därför måste du uppdatera den så att den pekar på slutpunkten som prenumererar på ämnet. Uppdatera också värdet för location egenskapen till den nya platsen eller regionen. För andra typer av händelsehanterare behöver du bara uppdatera platsen.
  • Använd mallen för att distribuera resurser till målregionen. Du anger namn för lagringskontot och systemavsnittet som ska skapas i målregionen.
  • Verifiera distributionen. Kontrollera att webhooken anropas när du laddar upp en fil till bloblagringen i målregionen.
  • För att slutföra flytten tar du bort resurser (händelsekälla och systemämne) från källregionen.

Förutsättningar

Förbereda

Kom igång genom att exportera en Resource Manager-mall för resursgruppen som innehåller systemhändelsekällan (Azure Storage-kontot) och dess associerade systemämne.

  1. Logga in på Azure-portalen.

  2. Välj Resursgrupper på den vänstra menyn. Välj sedan den resursgrupp som innehåller händelsekällan som systemämnet skapades för. I följande exempel är det Azure Storage-kontot . Resursgruppen innehåller lagringskontot och dess associerade systemämne.

    Skärmbild av resursgruppssidan.

  3. På den vänstra menyn väljer du Exportera mall under Inställningar och sedan Ladda ned i verktygsfältet.

    Skärmbild av lagringskonto – sidan Exportera mall.

  4. Leta upp den .zip fil som du laddade ned från portalen och packa upp filen till valfri mapp. Den här zip-filen innehåller JSON-filer för mallar och parametrar.

  5. Öppna template.json i valfri redigerare.

  6. URL:en för Webhook exporteras inte till mallen. Så gör du följande:

    1. Sök efter WebHook i mallfilen.

    2. I avsnittet Egenskaper lägger du till ett kommatecken (,) i slutet av den sista raden. I det här exemplet är "preferredBatchSizeInKilobytes": 64det .

    3. endpointUrl Lägg till egenskapen med värdet inställt på din Webhook-URL enligt följande exempel.

      "destination": {
          "properties": {
              "maxEventsPerBatch": 1,
              "preferredBatchSizeInKilobytes": 64,
              "endpointUrl": "https://mysite.azurewebsites.net/api/updates"
          },
          "endpointType": "WebHook"
      }
      

      Kommentar

      För andra typer av händelsehanterare exporteras alla egenskaper till mallen. Du behöver bara uppdatera location egenskapen till målregionen som du ser i nästa steg.

  7. Uppdatera location för lagringskontoresursen till målregionen eller platsen. Information om hur du hämtar platskoder finns i Azure-platser. Koden för en region är regionnamnet utan blanksteg, till westusexempel West US lika med .

    "type": "Microsoft.Storage/storageAccounts",
    "apiVersion": "2019-06-01",
    "name": "[parameters('storageAccounts_spegridstorage080420_name')]",
    "location": "westus",
    
  8. Upprepa steget för att uppdatera location systemämnesresursen i mallen.

    "type": "Microsoft.EventGrid/systemTopics",
    "apiVersion": "2020-04-01-preview",
    "name": "[parameters('systemTopics_spegridsystopic080420_name')]",
    "location": "westus",
    
  9. Spara mallen.

Omdistribuera

Distribuera mallen för att skapa ett lagringskonto och ett systemämne för lagringskontot i målregionen.

  1. I Azure-portalen väljer du Skapa en resurs.
  2. I Sök på Marketplace skriver du malldistribution och trycker sedan på RETUR.
  3. Välj Malldistribution.
  4. Välj Skapa.
  5. Välj alternativet för att skapa din egen mall i redigeringsprogrammet.
  6. Välj Läs in fil och följ sedan anvisningarna för att läsa in den template.json fil som du laddade ned i det sista avsnittet.
  7. Spara mallen genom att välja Spara .
  8. Följ dessa steg på sidan Anpassad distribution .
    1. Välj en Azure-prenumeration.

    2. Välj en befintlig resursgrupp i målregionen eller skapa en.

    3. För Region väljer du målregionen. Om du har valt en befintlig resursgrupp är den här inställningen skrivskyddad.

    4. Som systemämnesnamn anger du ett namn för systemavsnittet som ska associeras med lagringskontot.

    5. Ange ett namn för lagringskontot som ska skapas i målregionen för lagringskontots namn.

      Skärmbild av sidan för att distribuera Resource Manager-mall.

    6. Välj Granska + skapa längst ned på sidan.

    7. På sidan Granska + skapa granskar du inställningarna och väljer Skapa.

Verifiera

  1. När distributionen har slutförts väljer du Resursgrupp för Goto.
  2. På sidan Resursgrupp kontrollerar du att händelsekällan (i det här exemplet Azure Storage-konto) och systemavsnittet skapas.
  3. Ladda upp en fil till en container i Azure Blob Storage och kontrollera att webhooken har tagit emot händelsen. Mer information finns i Skicka en händelse till slutpunkten.

Ta bort eller rensa

För att slutföra flytten tar du bort resursgruppen som innehåller lagringskontot och dess associerade systemämne i källregionen.

Om du vill börja om tar du bort resursgruppen i målregionen och upprepar stegen i avsnitten Förbered och återskapa i den här artikeln.

Så här tar du bort en resursgrupp (källa eller mål) med hjälp av Azure-portalen:

  1. I sökfönstret överst i Azure-portalen skriver du Resursgrupper och väljer Resursgrupper i sökresultat.

  2. Välj den resursgrupp som ska tas bort och välj Ta bort i verktygsfältet.

    Skärmbild av ta bort resursgrupp.

  3. På bekräftelsesidan anger du namnet på resursgruppen och väljer Ta bort.