Substituindo seu agente AWS DataSync - AWS DataSync

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Substituindo seu agente AWS DataSync

Para substituir um agente AWS DataSync, você deve criar um novo agente e atualizar todos os locais de transferência que estejam usando o agente antigo.

Criar um novo agente

Para criar seu novo agente do DataSync, siga o mesmo processo de criação do agente antigo:

  1. Implante um agente em seu ambiente de armazenamento.

  2. Escolha um endpoint de serviço que o atendente use para se comunicar com AWS.

  3. Configure sua rede para que o agente possa se comunicar com seu armazenamento e AWS.

  4. Ative seu agente.

  5. Depois de ativado, anote o nome do recurso da Amazon (ARN) do agente.

    Você precisa desse ARN ao atualizar sua localização no DataSync para usar o novo agente.

Atualizando sua localização com o novo agente

Depois de criar um novo agente, você pode atualizar um local existente do DataSync para usar esse agente. Na maioria dos casos, você também precisa inserir as credenciais de acesso novamente para atualizar o local. Isso ocorre porque o DataSync armazena as credenciais de localização de uma forma que somente seu agente pode usá-las.

As instruções a seguir descrevem como atualizar locais com um novo agente usando o console do DataSync.

NFS
  1. Abra o console AWS DataSync em https://console.aws.amazon.com/datasync/.

  2. No painel de navegação esquerdo, expanda Transferência de dados e, em seguida, escolha Locais.

  3. Escolha o local que você deseja atualizar e, em seguida, escolha Editar.

  4. Em Agentes, escolha seu novo agente.

    Você pode escolher mais de um agente se estiver substituindo vários agentes em um local.

  5. Escolha Salvar alterações.

SMB
  1. Abra o console AWS DataSync em https://console.aws.amazon.com/datasync/.

  2. No painel de navegação esquerdo, expanda Transferência de dados e, em seguida, escolha Locais.

  3. Escolha o local que você deseja atualizar e, em seguida, escolha Editar.

  4. Em Agentes, escolha seu novo agente.

    Você pode escolher mais de um agente se estiver substituindo vários agentes em um local.

  5. Em Password (Senha), insira a senha do usuário que pode montar o servidor de arquivos SMB e tenha permissão para acessar os arquivos e pastas envolvidos na sua transferência.

  6. Escolha Salvar alterações.

HDFS
  1. Abra o console AWS DataSync em https://console.aws.amazon.com/datasync/.

  2. No painel de navegação esquerdo, expanda Transferência de dados e, em seguida, escolha Locais.

  3. Escolha o local que você deseja atualizar e, em seguida, escolha Editar.

  4. Em Agentes, escolha seu novo agente.

    Você pode escolher mais de um agente se estiver substituindo vários agentes em um local.

  5. Se você estiver usando a autenticação Kerberos, faça o upload do seu arquivo Keytab e do arquivo de configuração do Kerberos.

  6. Escolha Salvar alterações.

Object storage
  1. Abra o console AWS DataSync em https://console.aws.amazon.com/datasync/.

  2. No painel de navegação esquerdo, expanda Transferência de dados e, em seguida, escolha Locais.

  3. Escolha o local que você deseja atualizar e, em seguida, escolha Editar.

  4. Em Agentes, escolha seu novo agente.

    Você pode escolher mais de um agente se estiver substituindo vários agentes em um local.

  5. Se o local exigir credenciais, insira a chave secreta que permite que o DataSync acesse o bucket de armazenamento de objetos.

  6. Escolha Salvar alterações.

Armazenamento de blobs do Azure

Faça o seguinte para atualizar sua localização Microsoft Azure Blob Storage:

  1. Abra o console AWS DataSync em https://console.aws.amazon.com/datasync/.

  2. No painel de navegação esquerdo, expanda Transferência de dados e, em seguida, escolha Locais.

  3. Escolha o local que você deseja atualizar e, em seguida, escolha Editar.

  4. Em Agentes, escolha seu novo agente.

    Você pode escolher mais de um agente se estiver substituindo vários agentes em um local.

  5. Em token, insira o token de assinatura de acesso compartilhado (SAS) que permite que o DataSync acesse seu armazenamento de blobs.

  6. Escolha Salvar alterações.

As instruções a seguir descrevem como atualizar locais com um novo agente usando o AWS CLI. (Também é possível fazer isso usando a API do DataSync).

NFS
  1. Copie o seguinte comando update-location-nfs:

    aws datasync update-location-nfs \ --location-arn datasync-nfs-location-arn \ --on-prem-config AgentArns=new-datasync-agent-arn
  2. Para o parâmetro --location-arn, especifique o ARN do local do NFS que você está atualizando.

  3. Para a opção --on-prem-config do parâmetro AgentArns, especifique o ARN do seu novo agente.

    Você pode especificar mais de um ARN se estiver substituindo vários agentes em um local.

  4. Execute o comando update-location-nfs para atualizar o local.

SMB
  1. Copie o seguinte comando pdate-location-smb:

    aws datasync update-location-smb \ --location-arn datasync-smb-location-arn \ --agent-arns new-datasync-agent-arn \ --password smb-file-server-password
  2. Para o parâmetro --location-arn, especifique o ARN do local do SMB que você está atualizando.

  3. Para o parâmetro --agent-arns, especifique o ARN do seu novo agente.

    Você pode especificar mais de um ARN se estiver substituindo vários agentes em um local.

  4. Para o parâmetro --password, especifique a senha do usuário que pode montar o servidor de arquivos SMB e tenha permissão para acessar os arquivos e pastas envolvidos na sua transferência.

  5. Execute o comando update-location-smb para atualizar o local.

HDFS
  1. Copie o seguinte comando update-location-hdfs:

    aws datasync update-location-hdfs \ --location-arn datasync-hdfs-location-arn \ --agent-arns new-datasync-agent-arn \ --kerberos-keytab keytab-file \ --kerberos-krb5-conf krb5-conf-file
  2. Para o parâmetro --location-arn, especifique o ARN do local do HDFS que você está atualizando.

  3. Para o parâmetro --agent-arns, especifique o ARN do seu novo agente.

    Você pode especificar mais de um ARN se estiver substituindo vários agentes em um local.

  4. Se você estiver usando a autenticação Kerberos, inclua os parâmetros --kerberos-keytab e --kerberos-krb5-conf:

    • Para o parâmetro --kerberos-keytab, a tabela de chaves Kerberos (keytab) que contém mapeamentos entre a entidade principal Kerberos definida e as chaves criptografadas.

      Você pode carregar o arquivo keytab fornecendo o endereço do arquivo.

    • Para o parâmetro --kerberos-krb5-conf, especifique o arquivo que contém a configuração do seu realm Kerberos.

      Você pode especificar o arquivo krb5.conf fornecendo o endereço do arquivo.

    Se você estiver usando uma autenticação simples, não precisará incluir esses parâmetros relacionados ao Kerberos no seu comando.

  5. Execute o comando update-location-hdfs para atualizar o local.

Object storage
  1. Copie o seguinte comando pdate-location-object-storage:

    aws datasync update-location-object-storage \ --location-arn datasync-object-storage-location-arn \ --agent-arns new-datasync-agent-arn \ --secret-key bucket-secret-key
  2. Para o parâmetro --location-arn, especifique o ARN do local de armazenamento do objeto que você está atualizando.

  3. Para o parâmetro --agent-arns, especifique o ARN do seu novo agente.

    Você pode especificar mais de um ARN se estiver substituindo vários agentes em um local.

  4. Faça o seguinte, dependendo de se o local de armazenamento de objetos exige credenciais de acesso:

    • Se o local exigir credenciais: no parâmetro --secret-key, especifique a chave secreta que permite que o DataSync acesse o bucket de armazenamento de objetos.

    • Se o local exigir credenciais: especifique strings vazias para os parâmetros --access-key e --secret-key. Veja um exemplo de comando :

      aws datasync update-location-object-storage \ --location-arn arn:aws:datasync:us-east-2:111122223333:location/loc-abcdef01234567890 \ --agent-arns arn:aws:datasync:us-east-2:111122223333:agent/agent-1234567890abcdef0 \ --access-key "" \ --secret-key ""
  5. Execute o comando update-location-object-storage para atualizar o local.

Armazenamento de blobs do Azure
  1. Copie o seguinte comando update-location-azure-blob:

    aws datasync update-location-azure-blob \ --location-arn datasync-azure-blob-storage-location-arn \ --agent-arns new-datasync-agent-arn \ --sas-configuration '{ "Token": "sas-token-for-azure-blob-storage" }'
  2. Para o parâmetro --location-arn, especifique o ARN do local Azure Blob Storage que você está atualizando.

  3. Para o parâmetro --agent-arns, especifique o ARN do seu novo agente.

    Você pode especificar mais de um ARN se estiver substituindo vários agentes em um local.

  4. Para a opção --sas-configuration do parâmetro Token, especifique o token SAS que permite que o DataSync acesse seu armazenamento de blob.

  5. Execute o comando update-location-azure-blob para atualizar o local.

Próximas etapas

  1. Exclua seu agente antigo. Se você tiver alguma tarefa do DataSync em execução usando esse agente, espere até que essas tarefas terminem antes de excluí-las.

  2. Se você precisar substituir agentes em vários locais, repita as etapas anteriores.

  3. Quando terminar, você pode retomar a execução das tarefas.

    nota

    Substituição de agentes para tarefas agendadas: se substituir um agente para uma tarefa agendada, inicie a tarefa manualmente se o novo agente estiver usando um tipo de endpoint de serviço diferente do antigo. Se você não executar a tarefa manualmente antes da execução agendada, haverá falha na tarefa.

    Por exemplo, se o agente antigo usava um endpoint de serviço público, mas o novo agente usa um endpoint da VPC, inicie a tarefa manualmente usando o console ou a operação StartTaskExecution. Depois disso, a execução da tarefa será retomada segundo o agendamento.