Leer en inglés

Compartir a través de

Traslado de un recurso de Azure SignalR a otra región

  • Artículo

Los recursos de Azure SignalR son específicos de la región y no se pueden migrar de una región a otra. Sin embargo, hay escenarios en los que es posible que quiera mover el recurso de SignalR existente a otra región.

Puede usar una plantilla de Azure Resource Manager para exportar la configuración existente de un recurso de Azure SignalR, modificar los parámetros para que coincidan con la región de destino y, a continuación, crear una copia del recurso de SignalR en otra región. Para más información sobre Resource Manager y las plantillas, consulte Inicio rápido: Creación e implementación de plantillas de Azure Resource Manager mediante Azure Portal.

Requisitos previos

  • Asegúrese de que el servicio y las características que está usando se admitan en la región de destino.
  • Compruebe que su suscripción de Azure permite crear un recurso SignalR en la región de destino.
  • Para habilitar la cuota necesaria, póngase en contacto con el soporte técnico.
  • En el caso de las características en versión preliminar, asegúrese de que la suscripción está en la lista de permitidos para la región de destino.

Preparación y traslado del recurso de SignalR

Para empezar, exporte y luego modifique una plantilla de Resource Manager.

Exportación de la plantilla e implementación desde Azure Portal

En los pasos siguientes se muestra cómo preparar el traslado de recursos de SignalR mediante una plantilla de Resource Manager y cómo trasladarlos a la región de destino con el portal.

  1. Inicie sesión en Azure Portal.

  2. Seleccione Grupos de recursos. Seleccione el grupo de recursos que contiene el recurso de SignalR de origen y selecciónelo.

  3. En Automatización, seleccione Exportar plantilla.

  4. Seleccione Implementar.

  5. Seleccione PLANTILLA>Editar parámetros para abrir el archivo parameters.json en el editor en línea.

  6. Para editar el parámetro del nombre del recurso signalR, cambie la value propiedad en parameters:

    JSON 
          {
        "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#",
        "contentVersion": "1.0.0.0",
        "parameters": {
          "SignalR_mySignalR_name": {
            "value": "<target-signalr-name>"
          }
        }
      }

  7. Cambie el valor en el editor por un nombre de su elección para el recurso SignalR de destino. Asegúrese de escribir el nombre entre comillas.

  8. Seleccione Guardar en el editor.

  9. Seleccione PLANTILLA>Editar plantilla para abrir el archivo template.json en el editor en línea.

  10. Para editar la región de destino, cambie la location propiedad en resources en el editor en línea:

    JSON 
        "resources": [
      {
        "type": "Microsoft.SignalRService/SignalR",
        "apiVersion": "2021-10-01",
        "name": "[parameters('SignalR_mySignalR_name')]",
        "location": "<target-region>",
        "properties": {
        }
      }
    ]

  11. Para obtener los códigos de ubicación de la región, consulte Ubicaciones de Azure SignalR. El código de una región es el nombre de la región sin espacios, Centro de EE. UU. = centralus.

  12. También puede cambiar otros parámetros de la plantilla si así lo desea; son opcionales según sus requisitos.

  13. Seleccione Guardar en el editor en línea.

  14. Seleccione ASPECTOS BÁSICOS>Suscripción para elegir la suscripción en la que se implementará el recurso de destino.

  15. Seleccione ASPECTOS BÁSICOS>Grupo de recursos para elegir el grupo de recursos en el que se implementará el recurso de destino. Puede seleccionar Crear nuevo para crear un grupo de recursos para el recurso de destino. Asegúrese de que el nombre no sea el mismo que el del grupo de recursos de origen del recurso existente.

  16. Compruebe que BÁSICO>Ubicación está establecido en la ubicación de destino en la que quiere implementar el recurso.

  17. Seleccione Revisar y crear para implementar el recurso de Azure SignalR de destino.

Exportación de la plantilla e implementación mediante Azure PowerShell

Para exportar una plantilla mediante PowerShell:

  1. Inicie sesión en la suscripción a Azure con el comando Connect-AzAccount y siga las instrucciones de la pantalla:

    Azure PowerShell 
    Connect-AzAccount

  2. Si su identidad está asociada a más de una suscripción, establezca su suscripción activa en la suscripción del recurso SignalR que quiere trasladar.

    Azure PowerShell 
    $context = Get-AzSubscription -SubscriptionId <subscription-id>
Set-AzContext $context

  3. Exporte la plantilla de su recurso SignalR de origen. Estos comandos guardan una plantilla JSON en el directorio actual.

    Azure PowerShell 
    $resource = Get-AzResource `
   -ResourceGroupName <resource-group-name> `
   -ResourceName <signalr-resource-name> `
   -ResourceType Microsoft.SignalRService/SignalR
Export-AzResourceGroup `
   -ResourceGroupName <resource-group-name> `
   -Resource $resource.ResourceId `
   -IncludeParameterDefaultValue

  4. El nombre del archivo descargado se asignará en función del grupo de recursos desde el que se exportó el recurso. Busque el archivo que se ha exportado desde el comando denominado <nombre-del-grupo-de-recursos>.json y ábralo en el editor que prefiera:

    Azure PowerShell 
    notepad <source-resource-group-name>.json

  5. Para editar el parámetro del nombre del recurso de SignalR, cambie la propiedad defaultValue del nombre del recurso de SignalR de origen por el nombre del recurso de SignalR de destino. Asegúrese de que el nombre esté entrecomillado:

    JSON 
      {
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
      "SignalR_mySignalR_name": {
      "defaultValue": "<target-signalr-name>",
        "type": "String"
      }
    }
  }

  6. Para editar la región de destino a la que se va a trasladar el recurso de SignalR, cambie la propiedad location en resources:

    JSON 
        "resources": [
      {
        "type": "Microsoft.SignalRService/SignalR",
        "apiVersion": "2021-10-01",
        "name": "[parameters('SignalR_mySignalR_name')]",
        "location": "<target-region>",
        "properties": {
        }
      }
    ]

  7. Para obtener los códigos de ubicación de la región, consulte Ubicaciones de Azure SignalR. El código de una región es el nombre de la región sin espacios, Centro de EE. UU. = centralus.

    También puede cambiar otros parámetros de la plantilla si lo prefiere, según sus requisitos.

  8. Guarde el archivo <nombre-del-grupo-de-recursos>.json.

  9. Cree un grupo de recursos en la región de destino para el recurso SignalR de destino que se va a implementar mediante New-AzResourceGroup.

    Azure PowerShell 
    New-AzResourceGroup -Name <target-resource-group-name> -location <target-region>

  10. Implemente el archivo <nombre-del-grupo-de-recursos>.json editado en el grupo de recursos que ha creado en el paso anterior mediante New-AzResourceGroupDeployment:

    Azure PowerShell 
    New-AzResourceGroupDeployment -ResourceGroupName <target-resource-group-name> -TemplateFile <source-resource-group-name>.json

  11. Para comprobar que los recursos se crearon en la región de destino, use Get-AzResourceGroup y Get-AzSignalR:

    Azure PowerShell 
    Get-AzResourceGroup -Name <target-resource-group-name>
Get-AzSignalR -Name <target-signalr-name> -ResourceGroupName <target-resource-group-name>

Nota

Después de la implementación, si quiere empezar de nuevo o descartar el recurso SignalR en el destino, elimine el grupo de recursos que se creó en el destino, lo que elimina el recurso de SignalR trasladado. Para ello, en el portal, seleccione el grupo de recursos en el panel y, luego, Eliminar en la parte superior de la página de información general. También puede usar Remove-AzResourceGroup:

Azure PowerShell 
Remove-AzResourceGroup -Name <target-resource-group-name>

Limpieza de la región de origen

Para confirmar los cambios y completar el traslado del recurso SignalR, elimine el recurso SignalR o el grupo de recursos de origen. Para ello, en el portal, seleccione el recurso SignalR o el grupo de recursos en el panel y seleccione Eliminar en la parte superior de cada página.

Pasos siguientes

En este tutorial, trasladó un recurso SignalR de Azure de una región a otra y ha limpiado los recursos de origen. Para más información sobre el traslado de recursos entre regiones y la recuperación ante desastres en Azure, consulte: