Compartir a través de

Instalación y administración de la extensión del agente de Azure File Sync en servidores Windows habilitados para Azure Arc

En este artículo se describe cómo instalar, validar y desinstalar la extensión del agente de Azure File Sync en servidores Windows habilitados para Azure Arc. La extensión Agente de Azure File Sync para Windows implementa el agente de Azure File Sync en un servidor de Windows conectado a través de Azure Arc, lo que permite que el servidor sincronice archivos con un recurso compartido de archivos de Azure. Microsoft publica la extensión y se puede administrar mediante Azure Portal, Azure PowerShell o la CLI de Azure.

Prerrequisitos

  • Servidor habilitado para Azure Arc (solo Windows): La máquina de destino debe estar conectada a Azure Arc (agente de Azure Connected Machine instalado e incorporado completado) y ejecutar un sistema operativo Windows Server compatible. Azure File Sync es compatible con Windows Server 2012 R2 o posterior (consulte Requisitos del sistema de Azure File Sync e interoperabilidad para más información sobre las versiones compatibles).

    Importante

    La extensión del agente de Azure File Sync solo se admite en Windows. Los servidores habilitados para Linux Arc no son compatibles con Azure File Sync.

  • El servidor habilitado para Arc debe tener instalado el certificado raíz de Microsoft (entidad de certificación raíz de Microsoft 2011). Para obtener más información, consulte este documento.

  • Recursos de Azure: Un servicio de sincronización de Azure Storage debe existir en la suscripción de Azure para registrar el servidor después de instalar el agente. (No es necesario que el servidor se registre antes de la instalación, pero lo registrará en un servicio de sincronización de almacenamiento para empezar a sincronizarse. Esto se trata en Pasos siguientes).

  • Entorno de Azure PowerShell o la CLI de Azure:

    • Para Azure PowerShell, instale el módulo de Azure PowerShell (módulo Az) con el módulo Az.ConnectedMachine . Asegúrese de que tiene instalada la versión más reciente de Az PowerShell y ejecute Connect-AzAccount para iniciar sesión en Azure.

    • Para la CLI de Azure, instale la CLI de Azure e inicie sesión (az login). Asegúrese de que la CLI de Azure tiene instalada la extensión Connected Machine mediante la ejecución de:

      az extension add --name connectedmachine

      La extensión Connected Machine proporciona los az connectedmachine comandos que necesitará.

  • Conectividad de red: El servidor debe tener acceso de red a los puntos de conexión de Azure necesarios para Azure Arc y Azure File Sync (por ejemplo, para descargar la extensión y llegar a los puntos de conexión de servicio de Azure File Sync). Asegúrese de que la configuración de firewall o proxy permita las direcciones URL de servicio de Azure necesarias. Consulte Configuración de firewall y proxy de Azure File Sync para más información.

Instale la extensión del agente

Puede instalar el agente de Azure File Sync para Windows en un servidor windows habilitado para Arc mediante Azure Portal, Azure PowerShell o la CLI de Azure.

  1. Abra el recurso de servidor habilitado para Arc: En Azure Portal, vaya a Azure Arc > Machines y seleccione el servidor windows habilitado para Arc en el que desea instalar la extensión.

  2. Agregar extensión: En la sección Extensiones del servidor, seleccione + Agregar. En la lista de extensiones disponibles, busque y seleccione la extensión Agente de Azure File Sync para Windows (publicada por Microsoft) y, a continuación, seleccione Siguiente.

Captura de pantalla que muestra cómo instalar la extensión del agente de Azure File Sync para Windows

  1. Configuración de las opciones: Configure los valores del agente de Azure File Sync que se instalará en la máquina de Arc. Consulte Configuración disponible para obtener la lista completa de configuraciones y su significado.

Captura de pantalla que muestra cómo configurar la extensión del agente de Azure File Sync para Windows

  1. Instalar: Seleccione Revisar y crear para implementar la extensión. Azure iniciará la instalación de la extensión que instala la versión más reciente del agente de Azure File Sync en el servidor. En unos minutos, se debe instalar la extensión. Puede supervisar el progreso de la implementación en Azure Portal. Una vez finalizada, la extensión aparecerá con el estado Aprovisionamiento correcto en la lista Extensiones.

Instalación mediante una plantilla de ARM

También puede implementar la extensión del agente de Azure File Sync en un servidor Windows habilitado para Arc mediante una plantilla de Azure Resource Manager (ARM). Este método es útil para la automatización o las implementaciones a gran escala.

1. Preparar el archivo de parámetros

Cree un parameters.json archivo con los detalles de personalización, incluido el nombre de la máquina virtual y la configuración de la extensión:

{
  "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "AgentInstallDir": { "value": "C:\\Program Files\\Azure\\StorageSyncAgent\\" },
    "UseCustomProxy": { "value": true },
    "ProxyAddress": { "value": "http://proxy.contoso.com" },
    "ProxyPort": { "value": "80" },
    "ProxyAuthRequired": { "value": true },
    "ProxyUserName": { "value": "ProxyUserName" },
    "ProxyPassword": { "value": "ProxyPassword" },
    "EnrollInMicrosoftUpdate": { "value": true },
    "EnableAgentAutoUpdate": { "value": true },
    "AutoUpdateScheduledDayOfWeek": { "value": "Monday" },
    "AutoUpdateScheduledHourOfDay": { "value": "23" },
    "EnableServerDiagnostics": { "value": true },
    "vmName": { "value": "ArcVM1" },
    "location": { "value": "eastus2euap" }
  }
}

2. Preparar el archivo de plantilla

Cree un template.json archivo como se muestra aquí. Esta plantilla define el recurso de extensión y asigna parámetros a la configuración de la extensión:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "0.43.0.0",
  "parameters": {
    "vmName": { "type": "string" },
    "location": { "type": "string" },
    "agentInstallDir": { "type": "string", "defaultValue": "C:\\Program Files\\Azure\\StorageSyncAgent\\" },
    "useCustomProxy": { "type": "bool", "defaultValue": false },
    "proxyAddress": { "type": "string", "defaultValue": "" },
    "proxyPort": { "type": "string", "defaultValue": "0" },
    "proxyAuthRequired": { "type": "bool", "defaultValue": false },
    "proxyUsername": { "type": "string", "defaultValue": "" },
    "proxyPassword": { "type": "securestring", "defaultValue": "" },
    "enrollInMicrosoftUpdate": { "type": "bool", "defaultValue": true },
    "enableAgentAutoUpdate": { "type": "bool", "defaultValue": false },
    "autoUpdateScheduledDayOfWeek": { "type": "string", "defaultValue": "Tuesday" },
    "autoUpdateScheduledHourOfDay": { "type": "string", "defaultValue": "18" },
    "enableServerDiagnostics": { "type": "bool", "defaultValue": true }
  },
  "variables": {
    "AgentInstallDir": "[parameters('agentInstallDir')]",
    "UseCustomProxy": "[parameters('useCustomProxy')]",
    "ProxyAddress": "[parameters('proxyAddress')]",
    "ProxyPort": "[int(parameters('proxyPort'))]",
    "ProxyAuthRequired": "[parameters('proxyAuthRequired')]",
    "ProxyUserName": "[parameters('proxyUserName')]",
    "ProxyPassword": "[parameters('proxyPassword')]",
    "EnrollInMicrosoftUpdate": "[parameters('enrollInMicrosoftUpdate')]",
    "EnableAgentAutoUpdate": "[parameters('enableAgentAutoUpdate')]",
    "AutoUpdateScheduledDayOfWeek": "[parameters('autoUpdateScheduledDayOfWeek')]",
    "AutoUpdateScheduledHourOfDay": "[parameters('autoUpdateScheduledHourOfDay')]",
    "EnableServerDiagnostics": "[parameters('enableServerDiagnostics')]"
  },
  "resources": [
    {
      "name": "[concat(parameters('vmName'),'/AzureFileSyncAgentExtension')]",
      "type": "Microsoft.HybridCompute/machines/extensions",
      "location": "[parameters('location')]",
      "apiVersion": "2021-05-20",
      "properties": {
        "publisher": "Microsoft.StorageSync",
        "type": "AzureFileSyncAgentExtension",
        "autoUpgradeMinorVersion": true,
        "enableAutomaticUpgrade": true,
        "settings": {
          "agentInstallDir": "[variables('AgentInstallDir')]",
          "useCustomProxy": "[variables('UseCustomProxy')]",
          "proxyAddress": "[variables('ProxyAddress')]",
          "proxyPort": "[variables('ProxyPort')]",
          "proxyAuthRequired": "[variables('ProxyAuthRequired')]",
          "proxyUsername": "[variables('ProxyUserName')]",
          "enrollInMicrosoftUpdate": "[variables('EnrollInMicrosoftUpdate')]",
          "enableAgentAutoUpdate": "[variables('EnableAgentAutoUpdate')]",
          "autoUpdateScheduledDayOfWeek": "[variables('AutoUpdateScheduledDayOfWeek')]",
          "autoUpdateScheduledHourOfDay": "[variables('AutoUpdateScheduledHourOfDay')]",
          "enableServerDiagnostics": "[variables('EnableServerDiagnostics')]"
        },
        "protectedSettings": {
          "proxyPassword": "[parameters('proxyPassword')]"
        }
      }
    }
  ]
}

3. Implementación de la plantilla

Use el siguiente comando de PowerShell para implementar la plantilla en el grupo de recursos:

New-AzResourceGroupDeployment -ResourceGroupName "<ResourceGroupName>" -TemplateFile "template.json" -TemplateParameterFile "parameters.json"

Reemplace <ResourceGroupName> por el nombre del grupo de recursos que contiene la máquina habilitada para Arc. Esto implementará la extensión del agente de Azure File Sync con la configuración especificada en el servidor windows habilitado para Arc de destino.

Configuración disponible

Puede configurar las siguientes opciones durante la instalación de la extensión del agente de Azure File Sync:

Nombre Propósito Tipo de valor/Opciones Predeterminado
AgentInstallDir Directorio para instalar el agente de Azure File Sync Ruta de acceso del archivo C:\Program Files\Azure\StorageSyncAgent\
EnableAgentAutoUpdate Instalar automáticamente las actualizaciones más recientes del agente true / false false
AutoUpdateScheduledDayOfWeek Día de la semana para programar la actualización automática Sunday a Saturday Tuesday
AutoUpdateScheduledHourOfDay Hora del día para la actualización automática programada 0 a 23 (formato de 24 horas) 18 (6 p. m.)
EnableServerDiagnostics Habilitación o deshabilitación del registro de diagnóstico del agente true / false true
EnrollInMicrosoftUpdate Inscribirse en el servicio Microsoft Update true / false true
UseCustomProxy Uso de un servidor proxy personalizado para la conectividad true / false false
ProxyAddress Dirección del servidor proxy personalizado Dirección URL o dirección IP (por ejemplo, http://proxy.example.com o https://192.168.1.1) (Obligatorio si UseCustomProxy es true)
ProxyPort Puerto para la comunicación del servidor proxy Número de puerto (por ejemplo, 8080) (Obligatorio si UseCustomProxy es true)
ProxyAuthRequired Indica si el proxy requiere autenticación. true / false false
ProxyUserName Nombre de usuario para la autenticación de proxy Cadena de nombre de usuario (Obligatorio si ProxyAuthRequired es true)
ProxyPassword Contraseña para la autenticación de proxy Cadena de contraseña (Obligatorio si ProxyAuthRequired es true)

Si la máquina de Azure Arc ya tiene instalado un agente de Azure File Sync, la extensión se instalará correctamente y no modificará el agente de Azure File Sync existente instalado en la máquina.

Validación de la instalación

Después de la instalación, compruebe que la extensión del agente de Azure File Sync se implementó correctamente y que el agente se está ejecutando en el servidor.

En Azure Portal, vaya al recurso de servidor habilitado para Arc y abra la hoja Extensiones . Asegúrese de que la extensión del agente de Azure File Sync aparece y su estado muestra Correcto. Puede hacer clic en la extensión para ver más detalles, como el número de versión y el mensaje de estado. Además, en el propio servidor, puede confirmar que el agente de Azure File Sync está instalado (por ejemplo, compruebe Programas y características o asegúrese de que el servicio FileSyncSvc se está ejecutando).

La salida incluirá información sobre la extensión, como su provisioningState (que debe ser Correcto si el agente se instaló correctamente), el tipo (nombre de tipo de extensión) y typeHandlerVersion (que indica la versión del agente de Azure File Sync que se instaló). Compruebe que el estado de aprovisionamiento es correcto y que la versión notificada coincide con la versión esperada del agente. Si la extensión no aparece o el estado no se realiza correctamente, revise los detalles del error en la salida o en Azure Portal para solucionar problemas.

Pasos siguientes

Después de instalar la extensión, el agente de Azure File Sync debe instalarse en la máquina de Arc. Sin embargo, para habilitar Azure File Sync en las máquinas, debe completar los pasos siguientes.

  • Registre el servidor con Azure File Sync: La instalación del agente es solo el primer paso. Para empezar a sincronizar archivos, debe registrar windows Server con un servicio de sincronización de Azure Storage para establecer la confianza entre el servidor y Azure File Sync. Siga los pasos descritos en Administración de servidores registrados con Azure File Sync (registrar o anular el registro de un servidor) para registrar el servidor si aún no lo ha hecho.

  • Cree grupos de sincronización y puntos de conexión en la nube: Después del registro, cree un grupo de sincronización en el servicio de sincronización de almacenamiento. Un grupo de sincronización vincula un recurso compartido de archivos de Azure (punto de conexión en la nube) y una carpeta en el servidor registrado (punto de conexión de servidor). Consulte Implementación de Azure File Sync para obtener una guía de un extremo a otro sobre cómo configurar el servicio de sincronización de almacenamiento, crear grupos de sincronización y agregar puntos de conexión de servidor.

  • Más información y solución de problemas: Para más información, consulte Planeamiento de una implementación de Azure File Sync para comprender los requisitos y los procedimientos recomendados. Si tiene problemas durante la instalación o el registro del servidor, consulte Solución de problemas de instalación y registro del agente de Azure File Sync para problemas y soluciones comunes.

Desinstalación de la extensión del agente

Si ya no necesita la extensión del agente de Azure File Sync en un servidor habilitado para Arc determinado, puede desinstalar la extensión mediante Azure Portal, Azure PowerShell o la CLI de Azure. La desinstalación de la extensión no quitará el agente de Azure File Sync del servidor.

Al quitar el agente de Azure File Sync, se detendrá cualquier sincronización en la nube en ese servidor. Si el servidor está registrado actualmente en un servicio de sincronización de almacenamiento y participa en grupos de sincronización, la desinstalación del agente interrumpirá la conexión de sincronización y la topología de sincronización de archivos. Si decide quitar el agente en la máquina de Arc, asegúrese de ver el desaprovisionamiento o eliminación del punto de conexión del servidor de Azure File Sync para obtener instrucciones detalladas sobre cómo desinstalar el agente de Azure File Sync.

Para desinstalar la extensión del agente de Azure File Sync mediante Azure Portal:

  1. En Azure Portal, vaya al servidor habilitado para Arc y abra la sección Extensiones y aplicaciones .
  2. Busque la extensión del agente de Azure File Sync en la lista de extensiones instaladas. Seleccione la extensión para abrir sus detalles.
  3. Seleccione Desinstalar (o Eliminar extensión) y confirme el mensaje para quitar la extensión. Azure desinstalará la extensión de la máquina.
  4. Espere a que se quite la extensión. La entrada de extensión desaparecerá de la lista Extensiones una vez completada la desinstalación. En el servidor de Windows, el software del agente de Azure File Sync se desinstalará automáticamente como parte de este proceso.

Puede comprobar la eliminación comprobando la lista extensiones en Azure Portal (la extensión ya no debería aparecer) o ejecutando los comandos de validación anteriores (que ya no deberían encontrar la extensión). Si la extensión no se puede desinstalar, compruebe el registro de actividad de Azure o la vista de instancia de extensión para obtener detalles de error.