Partilhar via

Instalar e gerenciar a extensão do agente do Azure File Sync em servidores Windows habilitados para Azure Arc

Este artigo descreve como instalar, validar e desinstalar a extensão do agente do Azure File Sync em servidores Windows habilitados para Azure Arc. A extensão do Agente de Sincronização de Arquivos do Azure para Windows implanta o Agente de Sincronização de Arquivos do Azure em um servidor Windows conectado por meio do Azure Arc, permitindo que o servidor sincronize arquivos com um compartilhamento de arquivos do Azure. A extensão é publicada pela Microsoft e pode ser gerenciada usando o portal do Azure, o Azure PowerShell ou a CLI do Azure.

Pré-requisitos

  • Servidor habilitado para Azure Arc (somente Windows): A máquina de destino deve estar conectada ao Azure Arc (agente do Azure Connected Machine instalado e integração concluída) e executando um sistema operacional Windows Server com suporte. A Extensão de Sincronização de Ficheiros do Azure é suportada no Windows Server 2016 e versões posteriores. Apenas versões RTM são suportadas. Consulte Requisitos de sistema e interoperabilidade do Azure File Sync para obter detalhes sobre as versões suportadas.

    Importante

    A extensão do agente do Azure File Sync só é suportada no Windows. Os servidores habilitados para Linux Arc não são suportados para o Azure File Sync.

  • O servidor habilitado para Arc deve ter o Certificado Raiz da Microsoft (Microsoft Root Certificate Authority 2011) instalado. Para obter mais detalhes, consulte este documento.

  • Recursos do Azure: Um Serviço de Sincronização de Armazenamento do Azure deve existir em sua assinatura do Azure para registrar seu servidor após a instalação do agente. (Você não precisa ter o servidor registrado antes da instalação, mas o registrará em um Serviço de Sincronização de Armazenamento para começar a sincronizar. Isso é abordado em Próximas etapas.)

  • Ambiente do Azure PowerShell ou CLI do Azure:

    • Para o Azure PowerShell, instale o módulo do Azure PowerShell (módulo Az) com o módulo Az.ConnectedMachine . Verifique se você tem o Az PowerShell mais recente instalado e execute Connect-AzAccount para entrar no Azure.

    • Para a CLI do Azure, instale a CLI do Azure e entre (az login). Verifique se a CLI do Azure tem a extensão Máquina Conectada instalada executando:

      az extension add --name connectedmachine

      A extensão Máquina Conectada fornece os az connectedmachine comandos de que você precisa.

  • Conectividade de rede: O servidor deve ter acesso de rede aos pontos de extremidade do Azure exigidos pelo Azure Arc e pelo Azure File Sync (por exemplo, para baixar a extensão e alcançar os pontos de extremidade do serviço Azure File Sync). Verifique se as configurações de firewall ou proxy permitem as URLs de serviço do Azure necessárias. Consulte Configurações de proxy e firewall do Azure File Sync para obter mais informações.

Instalar a extensão do agente

Você pode instalar a extensão do Azure File Sync Agent for Windows em um servidor Windows habilitado para Arc usando o portal do Azure, o Azure PowerShell ou a CLI do Azure.

  1. Abra o recurso de servidor habilitado para Arc: No portal do Azure, navegue até Azure Arc > Machines e selecione o servidor Windows habilitado para Arc no qual você deseja instalar a extensão.

  2. Adicionar extensão: Na seção Extensões do servidor, selecione + Adicionar. Na lista de extensões disponíveis, localize e selecione a extensão do Azure File Sync Agent for Windows (publicada pela Microsoft) e selecione Avançar.

Captura de ecrã a mostrar como instalar a extensão de agente do Azure File Sync para Windows

  1. Defina as configurações: Configure as configurações para o agente do Azure File Sync que será instalado na máquina Arc. Consulte Configurações disponíveis para obter a lista completa de configurações e seu significado.

Captura de ecrã a mostrar como configurar a extensão do agente do Azure File Sync para Windows

  1. Instalar: Selecione Rever + criar para implementar a extensão. O Azure iniciará a instalação da extensão que instala a versão mais recente do agente do Azure File Sync no servidor. Dentro de alguns minutos, a extensão deve ser instalada. Você pode monitorar o progresso da implantação no portal do Azure. Uma vez concluída, a extensão aparecerá com o status Provisionamento bem-sucedido na lista Extensões.

Instalar usando o modelo ARM

Você também pode implantar a extensão do agente do Azure File Sync em um servidor Windows habilitado para Arc usando um modelo do Azure Resource Manager (ARM). Esse método é útil para automação ou implantações em larga escala.

1. Prepare o arquivo de parâmetros

Crie um parameters.json arquivo com seus detalhes de personalização, incluindo o nome da VM e as configurações de extensão:

{
  "$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. Prepare o arquivo de modelo

Crie um template.json arquivo como mostrado aqui. Este modelo define o recurso de extensão e mapeia parâmetros para configurações de extensão:

{
  "$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. Implantar o modelo

Use o seguinte comando do PowerShell para implantar o modelo em seu grupo de recursos:

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

Substitua <ResourceGroupName> pelo nome do grupo de recursos que contém sua máquina habilitada para Arc. Isso desenrolará a extensão do agente do Azure File Sync com as configurações especificadas para o servidor Windows de destino com suporte para Arc.

Configurações disponíveis

Você pode definir as seguintes configurações durante a instalação da extensão do agente do Azure File Sync:

Nome Propósito Tipo de Valor / Opções Predefinido
AgentInstallDir Diretório para instalar o agente do Azure File Sync Caminho do arquivo C:\Program Files\Azure\StorageSyncAgent\
EnableAgentAutoUpdate Instalar automaticamente as atualizações mais recentes do agente true / false false
AutoUpdateScheduledDayOfWeek Dia da semana para agendar a atualização automática Sunday a Saturday Tuesday
AutoUpdateScheduledHourOfDay Hora do dia para atualização automática programada 0 até 23 (formato de 24 horas) 18 (18:00)
EnableServerDiagnostics Habilitar ou desativar o registo de diagnóstico do agente true / false true
EnrollInMicrosoftUpdate Inscrever-se no serviço Microsoft Update true / false true
UseCustomProxy Usar um servidor proxy personalizado para conectividade true / false false
ProxyAddress Endereço do servidor proxy personalizado URL ou endereço IP (por exemplo, http://proxy.example.com ou https://192.168.1.1) (Obrigatório se UseCustomProxy for true)
ProxyPort Porta para comunicação do servidor proxy Número da porta (por exemplo, 8080) (Obrigatório se UseCustomProxy for true)
ProxyAuthRequired Indica se o proxy requer autenticação true / false false
ProxyUserName Nome de usuário para autenticação de proxy Cadeia de caracteres de nome de usuário (Obrigatório se ProxyAuthRequired for true)
ProxyPassword Senha para autenticação de proxy Cadeia de caracteres de senha (Obrigatório se ProxyAuthRequired for true)

Se a máquina do Azure Arc já tiver um agente do Azure File Sync instalado, a extensão será instalada com êxito e não modificará o agente existente do Azure File Sync instalado no computador.

Validar instalação

Após a instalação, verifique se a extensão do agente do Azure File Sync foi implantada com êxito e se o agente está sendo executado no servidor.

No portal do Azure, navegue até o recurso de servidor com Arc habilitado e abra o painel Extensões. Verifique se a extensão do agente do Azure File Sync está listada e se seu Status mostra Bem-sucedido. Você pode clicar na extensão para ver mais detalhes, como o número da versão e a mensagem de status. Além disso, no próprio servidor, você pode confirmar se o Agente de Sincronização de Arquivos do Azure está instalado (por exemplo, verifique Programas e Recursos ou verifique se o serviço FileSyncSvc está em execução).

A saída incluirá informações sobre a extensão, como seu provisioningState (que deve ser bem-sucedido se o agente foi instalado corretamente), o Type (nome do tipo de extensão) e o typeHandlerVersion (que indica a versão do agente do Azure File Sync que foi instalada). Verifique se o estado de provisionamento foi bem-sucedido e se a versão relatada corresponde à versão esperada do agente. Se a extensão não estiver listada ou o status não for bem-sucedido, reveja os detalhes do erro na saída ou no portal do Azure para resolver problemas.

Próximos passos

Depois de instalar a extensão, o agente do Azure File Sync deve ser instalado na máquina Arc. No entanto, para habilitar a Sincronização de Arquivos do Azure nas máquinas, você precisa concluir as etapas a seguir.

  • Registre o servidor com o Azure File Sync: A instalação do agente é apenas o primeiro passo. Para começar a sincronizar ficheiros, tem de registar o seu Windows Server com um Serviço de Sincronização de Armazenamento do Azure para estabelecer confiança entre o servidor e a Sincronização de Ficheiros do Azure. Siga as etapas em Gerenciar servidores registrados com o Azure File Sync (Registrar/cancelar o registro de um servidor) para registrar seu servidor, caso ainda não tenha feito isso.

  • Crie grupos de sincronização e pontos de extremidade na nuvem: Após o registro, crie um grupo de sincronização no Serviço de Sincronização de Armazenamento. Um grupo de sincronização vincula um compartilhamento de arquivos do Azure (ponto de extremidade de nuvem) e uma pasta em seu servidor registrado (ponto de extremidade de servidor). Consulte Como implantar o Azure File Sync para obter um guia completo sobre como configurar o Serviço de Sincronização de Armazenamento, criar grupos de sincronização e adicionar pontos de extremidade de servidor.

  • Saiba mais e solucione problemas: Para obter informações adicionais, consulte Planejando uma implantação do Azure File Sync para entender os requisitos e as práticas recomendadas. Se você encontrar problemas durante a instalação ou o registro do servidor, consulte Solucionar problemas de instalação e registro do agente do Azure File Sync para obter problemas e soluções comuns.

Desinstale a extensão do agente

Se você não precisar mais da extensão do agente do Azure File Sync em um servidor habilitado para Arc específico, poderá desinstalar a extensão usando o portal do Azure, o Azure PowerShell ou a CLI do Azure. A desinstalação da extensão não removerá o agente do Azure File Sync do servidor.

A remoção do agente do Azure File Sync interromperá qualquer sincronização na nuvem nesse servidor. Se o servidor estiver atualmente registrado em um Serviço de Sincronização de Armazenamento e participando de grupos de sincronização, a desinstalação do agente interromperá a conexão de sincronização e a topologia de sincronização de arquivos. Se você decidir remover o agente na máquina Arc, certifique-se de ver o desprovisionamento ou excluir seu ponto de extremidade do servidor do Azure File Sync para obter instruções detalhadas sobre como desinstalar o agente do Azure File Sync.

Para desinstalar a extensão do agente do Azure File Sync usando o portal do Azure:

  1. No portal do Azure, navegue até o servidor habilitado para Arc e abra a seção Extensões + aplicativos .
  2. Encontre a extensão do agente do Azure File Sync na lista de extensões instaladas. Selecione a extensão para abrir seus detalhes.
  3. Selecione Desinstalar (ou Excluir extensão) e confirme o prompt para remover a extensão. O Azure desinstalará a extensão da máquina.
  4. Aguarde até que a extensão seja removida. A entrada de extensão desaparecerá da lista Extensões assim que a desinstalação for concluída. No servidor Windows, o software do agente Azure File Sync será desinstalado automaticamente como parte desse processo.

Você pode verificar a remoção verificando a lista Extensões no portal do Azure (a extensão não deve mais aparecer) ou executando os comandos de validação acima (que não devem mais encontrar a extensão). Se a extensão falhar ao desinstalar, verifique o Log de Atividades do Azure ou a exibição da instância de extensão para obter detalhes do erro.

  • Last updated on