Realocar tópicos do sistema da Grade de Eventos do Azure para outra região

Este artigo aborda a abordagem, as diretrizes e as práticas recomendadas para realocar domínios da Grade de Eventos para outra região.

Há vários motivos pelos quais talvez você queira mover seus recursos existentes do Azure de uma região para outra. Talvez você queira:

• Aproveitar uma nova região do Azure.
• Implantar recursos ou serviços disponíveis apenas em regiões específicas.
• Atender aos requisitos internos de política e governança.
• Alinhar-se com fusões e aquisições da empresa
• Atender aos requisitos de planejamento de capacidade.

A seguir são apresentadas as etapas de alto nível descritas neste artigo:

• Exporte o grupo de recursos que contém a conta de Armazenamento do Azure e o tópico do sistema associado a um modelo do Resource Manager. Também é possível exportar um modelo somente para o tópico do sistema. Para fazer isso, lembre-se de mover a origem de evento do Azure (neste exemplo, uma conta de Armazenamento do Azure) para a outra região antes de mover o tópico do sistema. Em seguida, no modelo exportado para o tópico do sistema, atualize a ID externa da conta de armazenamento na região de destino.
• Modifique o modelo para adicionar a propriedade endpointUrl a fim de apontar para um webhook que assina o tópico do sistema. Quando o tópico do sistema é exportado, sua assinatura (neste caso, um webhook) também é exportada para o modelo, mas a propriedade endpointUrl não é incluída. Portanto, é necessário atualizá-la para apontar para o ponto de extremidade que assina o tópico. Além disso, atualize o valor da propriedade location para o novo local ou região. Para outros tipos de manipuladores de eventos, só é necessário atualizar o local.
• Use o modelo para implantar os recursos na região de destino. Você especificará nomes para a conta de armazenamento e o tópico do sistema a serem criados na região de destino.
• verificar a implantação. Verifique se o webhook é invocado ao carregar um arquivo no armazenamento de blobs da região de destino.
• Para concluir a movimentação, exclua os recursos (origem de evento e tópico do sistema) da região de origem.

Pré-requisitos

• Realize os procedimentos de Início rápido: rotear eventos do armazenamento de blobs para o ponto de extremidade da Web com o portal do Azure na região de origem. Esta etapa é opcional. Faça isso para testar as etapas neste artigo. Mantenha a conta de armazenamento em um grupo de recursos separado do serviço de aplicativo e do plano do serviço de aplicativo.
• Verifique se o serviço da Grade de Eventos do Azure está disponível na região de destino. Consulte Produtos disponíveis por região.

Preparar

Para começar, exporte um modelo do Resource Manager para o grupo de recursos que contém a origem de evento do sistema (conta de Armazenamento do Azure) e o tópico do sistema associado.

1. Entre no portal do Azure.

2. Selecione Grupos de recursos no menu esquerdo. Em seguida, selecione o grupo de recursos que contém a origem de evento para a qual o tópico do sistema foi criado. No exemplo a seguir, é a conta de Armazenamento do Azure. O grupo de recursos contém a conta de armazenamento e o tópico do sistema associado.

   

3. No menu à esquerda, selecione Exportar modelo em Configurações e, em seguida, selecione Baixar na barra de ferramentas.

   

4. Localize o arquivo .zipque você baixou do portal e descompacte-o na pasta desejada. Esse arquivo zip contém arquivos JSON de parâmetros e modelos.

5. Abra o modelo.json em um editor à sua escolha.

6. A URL do webhook não é exportada para o modelo. Execute as etapas a seguir:

   1. No arquivo de modelo, pesquise WebHook.

   2. Na seção Propriedades, adicione um caractere de vírgula (,) no final da última linha. Neste exemplo, é "preferredBatchSizeInKilobytes": 64.

   3. Adicione a propriedade endpointUrl com o valor definido para a URL do Webhook, conforme mostrado no exemplo a seguir.

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

      Observação

      Para outros tipos de manipuladores de eventos, todas as propriedades são exportadas para o modelo. Você só precisa atualizar a propriedade location para a região de destino, conforme mostrado na próxima etapa.

7. Atualize location com relação ao recurso da conta de armazenamento para a região ou o local de destino. Para obter códigos de locais, confira os locais do Azure. O código de uma região é o nome da região sem espaços, por exemplo, West US é igual a westus.

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

8. Repita a etapa para atualizar location para o recurso do tópico do sistema no modelo.

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

9. Salve o modelo.

Reimplantar

Implante o modelo para criar uma conta de armazenamento e um tópico do sistema para ela na região de destino.

1. No portal do Azure, selecione Criar um recurso.
2. Em Pesquisar no Marketplace, digite implantação de modelo e pressione ENTER.
3. Selecione Implantação de modelo.
4. Selecione Criar.
5. Selecione Criar seu próprio modelo no editor.
6. Selecione Carregar arquivo e em seguida siga as instruções para carregar o arquivo de modelo.json baixado na última seção.
7. Selecione Salvar para salvar o modelo.
8. Na página Implantação personalizada, siga estas etapas:

   1. Selecione uma assinatura do Azure.

   2. Selecione umgrupo de recursosexistente na região-alvo ou crie um novo.

   3. Para aRegião,selecione a região-alvo. Se você selecionou um grupo de recursos existente, esta configuração é somente leitura.

   4. Em Nome do tópico do sistema, insira um nome para o tópico do sistema que será associado à conta de armazenamento.

   5. Em Nome da conta de armazenamento, insira um nome para a conta de armazenamento que será criada na região de destino.

      

   6. Selecione Revisar + criar na parte inferior da página.

   7. Na páginaRevisar + criar,revise as configurações e selecioneCriar.

Verificar

1. Após a conclusão da implantação, selecioneAcessar grupo de recursos.
2. Na página Grupo de recursos, verifique se a origem de evento (neste exemplo, a conta de Armazenamento do Azure) e o tópico do sistema foram criados.
3. Carregue um arquivo em um contêiner no armazenamento de blobs do Azure e verifique se o webhook recebeu o evento. Para obter mais informações, consulte Enviar um evento ao ponto de extremidade.

Descartar ou limpar

Para concluir a movimentação, exclua o grupo de recursos que contém a conta de armazenamento e o tópico do sistema associado na região de origem.

Para começar de novo, exclua o grupo de recursos da região de destino e repita as etapas nas seções Preparar e Recriar deste artigo.

Para excluir um grupo de recursos (origem ou destino) usando o portal do Azure:

1. Na janela de pesquisa na parte superior de portal do Microsoft Azure, digiteGrupo de Recursose selecione Grupo de Recursosnos resultados da pesquisa.

2. Selecione o grupo de recursos a ser excluído e selecioneExcluirna barra de ferramentas.

   

3. Na página de confirmação, insira o nome do rupo de recurso e selecioneExcluir.

Conteúdo relacionado

• Realocar tópicos personalizados entre regiões.
• Realocar domínios entre regiões.
• Mover recursos para um novo grupo de recursos ou assinatura.