Rilocare gli argomenti di sistema di Griglia di eventi di Azure in un'altra area

Questo articolo illustra l'approccio consigliato, le linee guida e le procedure per rilocare gli argomenti di sistema di Griglia di eventi in un'altra area.

Esistono diversi motivi per cui è possibile spostare le risorse di Azure esistenti da un'area a un'altra. È possibile:

• Sfruttare i vantaggi di una nuova area di Azure.
• Distribuire funzionalità o servizi disponibili solo in aree specifiche.
• Soddisfare i requisiti di governance e criteri interni.
• Allinearsi alle fusioni e alle acquisizioni aziendali
• Soddisfare i requisiti di pianificazione della capacità.

Di seguito sono riportate le procedure generali descritte in questo articolo:

• Esportare il gruppo di risorse che contiene l'account di archiviazione di Azure e l'argomento di sistema associato in un modello di Resource Manager. È anche possibile esportare un modello solo per l'argomento di sistema. Se si sceglie questo percorso, ricordarsi di spostare l'origine evento di Azure (in questo esempio un account di Archiviazione di Azure) nell'altra area prima di spostare l'argomento di sistema. Quindi, nel modello esportato per l'argomento di sistema aggiornare l'ID esterno per l'account di archiviazione nell'area di destinazione.
• Modificare il modello per aggiungere la proprietà endpointUrl in modo che punti a un webhook che esegue la sottoscrizione all'argomento di sistema. Quando l'argomento di sistema viene esportato, viene esportata nel modello anche la relativa sottoscrizione (in questo caso un webhook), ma la proprietà endpointUrl non è inclusa. È quindi necessario aggiornarlo in modo che punti all'endpoint che esegue la sottoscrizione all'argomento. Aggiornare anche il valore della proprietà location alla nuova posizione o area. Per altri tipi di gestori eventi, è necessario aggiornare solo il percorso.
• Usare il modello per implementare le risorse nell'area di destinazione. Verranno specificati i nomi per l'account di archiviazione e l'argomento di sistema da creare nell'area di destinazione.
• Verificare la distribuzione. Verificare che il webhook venga richiamato quando si carica un file nell'archivio BLOB nell'area di destinazione.
• Per completare lo spostamento, eliminare le risorse (origine evento e argomento di sistema) dall'area di origine.

Prerequisiti

• Completare Avvio rapido: Instradare gli eventi dell'archivio BLOB all'endpoint Web con il portale di Azure nell'area di origine. Questo passaggio è facoltativo. Eseguire questa procedura per testare i passaggi in questo articolo. Mantenere l'account di archiviazione in un gruppo di risorse separato dal servizio app e dal piano di servizio app.
• Assicurarsi che il servizio Griglia di eventi sia disponibile nell'area di destinazione. Vedere Prodotti disponibili in base all'area.

Preparazione

Per iniziare, esportare un modello di Resource Manager per il gruppo di risorse che contiene l'origine evento di sistema (account di archiviazione di Azure) e l'argomento di sistema associato.

1. Accedere al portale di Azure.

2. Selezionare Gruppi di risorse nel menu a sinistra. Selezionare quindi il gruppo di risorse che contiene l'origine evento per cui è stato creato l'argomento di sistema. Nell'esempio seguente si tratta dell'account di archiviazione di Azure. Il gruppo di risorse contiene l'account di archiviazione e l'argomento di sistema associato.

   

3. Nel menu a sinistra selezionare Esporta il modello in Impostazioni, quindi selezionare Scarica nella barra degli strumenti.

   

4. Individuare il file con estensione zip scaricato dal portale e decomprimerlo in una cartella di propria scelta. Questo file ZIP contiene file JSON di modelli e parametri.

5. Aprire template.json in un editor di propria scelta.

6. L'URL per il webhook non viene esportato nel modello. Quindi, seguire questa procedura:

   1. Nel file modello cercare WebHook.

   2. Nella sezione Proprietà aggiungere una virgola (,) alla fine dell'ultima riga. In questo esempio è "preferredBatchSizeInKilobytes": 64.

   3. Aggiungere la proprietà endpointUrl con il valore impostato sull'URL del webhook, come illustrato nell'esempio seguente.

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

      Nota

      Per altri tipi di gestori eventi, tutte le proprietà vengono esportate nel modello. È sufficiente aggiornare la proprietà location all'area di destinazione, come illustrato nel passaggio successivo.

7. Aggiornare location per la risorsa dell'account di archiviazione nella posizione o nell'area di destinazione. Per ottenere i codici di posizione, vedere Località di Azure. Il codice per un'area è il nome dell'area senza spazi, ad esempio West US corrisponde a westus.

   "type": "Microsoft.Storage/storageAccounts",
   "apiVersion": "2019-06-01",
   "name": "[parameters('storageAccounts_spegridstorage080420_name')]",
   "location": "westus",
   

8. Ripetere il passaggio per aggiornare location per la risorsa dell'argomento di sistema nel modello.

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

9. Scegliere Salva per salvare il modello.

Ripetere la distribuzione

Implementare il modello per creare un account di archiviazione e un argomento di sistema per l'account di archiviazione nell'area di destinazione.

1. Nel portale di Azure selezionare Crea una risorsa.
2. In Cerca nel Marketplace digitare distribuzione modelli e quindi premere INVIO.
3. Selezionare Distribuzione modello.
4. Seleziona Crea.
5. Selezionare Creare un modello personalizzato nell'editor.
6. Selezionare Carica file e quindi seguire le istruzioni per caricare il file template.json scaricato nell'ultima sezione.
7. Selezionare Salva per salvare il modello.
8. Nella pagina Distribuzione personalizzata seguire questa procedura.

   1. Selezionare una sottoscrizione di Azure.

   2. Selezionare un gruppo di risorse esistente nell'area di destinazione o crearne uno.

   3. Per Area, selezionare l'area di destinazione. Se è stato selezionato un gruppo di risorse esistente, questa impostazione è di sola lettura.

   4. Per il nome dell'argomento di sistema, immettere un nome che verrà associato all'account di archiviazione.

   5. Per il nome dell'account di archiviazione, immettere un nome dal creare nell'area di destinazione.

      

   6. Selezionare Rivedi e crea nella parte inferiore della pagina.

   7. Nella pagina Rivedi e crea controllare le impostazioni e selezionare Crea.

Verificare

1. Al termine della distribuzione selezionare Vai al gruppo di risorse.
2. Nella pagina Gruppo di risorse verificare che l'origine evento (in questo esempio, l'account di archiviazione di Azure) e l'argomento di sistema siano stati creati.
3. Caricare un file in un contenitore nell'archivio BLOB di Azure e verificare che il webhook abbia ricevuto l'evento. Per altre informazioni, vedere Inviare un evento all'endpoint.

Eliminare o pulire

Per completare lo spostamento, eliminare il gruppo di risorse che contiene l'account di archiviazione e l'argomento di sistema associato in un modello di Resource Manager.

Per ricominciare, eliminare il gruppo di risorse nell'area di destinazione e ripetere i passaggi nelle sezioni Preparare e Ricreare di questo articolo.

Per eliminare un gruppo di risorse (origine o destinazione) usando il portale di Azure:

1. Nella finestra di ricerca nella parte superiore del portale di Azure digitare Gruppo di risorse e selezionare Gruppi di risorse dai risultati della ricerca.

2. Selezionare il gruppo di risorse da eliminare e selezionare Elimina sulla barra degli strumenti.

   

3. Nella pagina di conferma immettere il nome del gruppo di risorse, quindi selezionare Elimina.

Contenuto correlato

• Rilocare gli argomenti personalizzati nelle diverse aree.
• Rilocare i domini nelle diverse aree.
• Spostare le risorse in un altro gruppo di risorse o un'altra sottoscrizione.