Transferir grandes conjuntos de dados do Cloud Storage para o Filestore

Use o Serviço de transferência do Cloud Storage para mover grandes conjuntos de dados do Cloud Storage para os compartilhamentos de arquivos do Filestore.

Com o Serviço de transferência do Cloud Storage, você transfere grandes conjuntos de dados com rapidez e segurança entre sistemas de armazenamento de objetos e arquivos, estejam os dados hospedados no Cloud Storage, em provedores de nuvem de terceiros ou no local.

O Serviço de transferência do Cloud Storage é compatível com transferências aceleradas de grandes conjuntos de dados, processando centenas de TB de dados ou mais. Mova conjuntos de dados grandes para a nuvem e aproveite as operações de análise e machine learning disponíveis nas instâncias do Compute Engine em que as instâncias do Filestore estão montadas.

Com o Serviço de transferência do Cloud Storage, é fácil criar transferências gerenciadas pelo Google ou configurar transferências auto-hospedadas para controlar totalmente o roteamento de rede e o uso da largura de banda.

Observação :para transferir menos de 1 TB de dados de buckets do Cloud Storage, use gsutil ou gcloud. Para mais informações, consulte Como copiar dados de um bucket do Cloud Storage para um compartilhamento de arquivos do Filestore ou Quando usar o Serviço de transferência do Cloud Storage.

Transferir dados de um bucket do Cloud Storage para um compartilhamento de arquivos do Filestore

A transferência de dados do Cloud Storage para um compartilhamento de arquivos do Filestore usando o Serviço de transferência do Cloud Storage requer as seguintes tarefas:

1. Configurar o ambiente.
2. Configure o Filestore.
3. Configure o Serviço de transferência do Cloud Storage.
4. Crie e inicie o job de transferência.

As seções a seguir explicam cada tarefa.

configure seu ambiente

1. Selecione ou crie um projeto.

   Para os fins deste guia, verifique se os recursos de origem e destino estão no mesmo projeto.

   No Console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

   Se você estiver testando o Filestore e não pretende manter os recursos criados, recomendamos criar um projeto em vez de selecionar um atual. Quando terminar os testes, é possível excluir o projeto, removendo todos os recursos associados a ele.

   Acessar o seletor de projetos

2. Ativar faturamento.

   Verifique se a cobrança está ativada para o seu projeto do Google Cloud. Saiba como confirmar se o faturamento está ativado para o projeto.

3. Ative as seguintes APIs:

   • API Filestore

   • API Resource Manager

   • API Pub/Sub

   • API Cloud Storage

   • API Storage Transfer

   • API Cloud Logging

   • API Compute Engine

   • API Service Usage

   • API Identity and Access Management

4. Opcional: o gcloud, um componente importante do SDK Google Cloud, é instalado em todas as VMs do Compute Engine. Se estiver executando alguma das seguintes etapas na linha de comando local, configure o SDK Google Cloud.

   Instale e inicialize o Google Cloud SDK.

   Se você já instalou o SDK Google Cloud, verifique se tem a versão mais recente disponível executando:

   gcloud components update
   

5. Crie uma conta de serviço. Na seção Conceda a essa conta de serviço acesso ao projeto, atribua os seguintes papéis:

   • Owner

   • Project IAM Admin

   • Role Administrator

   • Pub/Sub Editor

   • Cloud Filestore Editor

   • Storage Object Admin

   • Storage Transfer Admin

   • Storage Transfer Agent

   1. Copie e salve o nome da conta de serviço criada para uma etapa posterior.

   2. Crie uma chave de conta de serviço para a conta que você acabou de criar. Para os fins deste guia, crie apenas uma chave. Faça o download do arquivo de chave e salve para uma etapa posterior.

6. Atribua funções a uma conta de usuário. Na página IAM, encontre sua conta de usuário e atribua a ela os seguintes papéis:

   • Owner

   • Project IAM Admin

   • Role Administrator

   • Storage Transfer Admin

   • Storage Admin

   Para mais informações, consulte Permissões do usuário.

Configurar o Filestore

1. Crie uma instância do Filestore. Ao criar a instância, aplique as seguintes especificações:

   1. Verifique se o bucket do Cloud Storage, a VM do cliente e a instância do Filestore estão na mesma região.

   2. Selecione um tipo de instância Enterprise.

   3. Opcional: para conjuntos de dados maiores, solicite um aumento de cota.

   4. Copie o nome da instância e o endereço IP e salve para uma etapa posterior.

2. Monte uma instância do Filestore em uma máquina cliente.

   Neste guia, descrevemos uma transferência que usa quatro VMs do Compute Engine como máquinas cliente do NFS. Você criará uma única conta de serviço que opera em nome das quatro máquinas clientes. Cada máquina cliente terá três agentes do Serviço de transferência do Cloud Storage instalados.

   Observação :para melhorar o desempenho, os usuários precisam empregar no mínimo quatro VMs do Compute Engine nesse cenário.

   1. Criar uma instância de VM do Compute Engine com acesso a outros serviços do Google Cloud.

      1. Configure uma VM com as seguintes especificações:

         1. Ao especificar um local, verifique se o bucket do Google Cloud, a VM do cliente e a instância do Filestore estão todos na mesma região.

         2. Cada agente do Serviço de transferência do Cloud Storage precisa de 4 vCPUs e 8 GB de RAM. Para ter o melhor desempenho, execute vários agentes por VM. Para os fins deste guia, provisione uma instância de máquina virtual do Compute Engine e2-standard-32.

         3. Na seção Identidade e acesso à API, especifique as seguintes informações:

            1. No menu suspenso Contas de serviço, selecione a conta de serviço que você acabou de criar.

   2. Depois que a instância de VM do Compute Engine for criada, faça login na máquina usando SSH. Na página Instância de VM do Compute Engine, localize a instância que você criou e clique em SSH.

   3. Use um editor de texto, como o Vim, para criar uma cópia do arquivo de chave da conta de serviço e salvá-lo temporariamente na VM. Por exemplo, service-account-key.json.

   4. Instale o Docker na VM.

   5. gcloud já está instalado na instância de VM do Compute Engine. Na linha de comando SSH, digite o seguinte comando para autorizar a conta de serviço a usar gcloud:

      gcloud auth activate-service-account ACCOUNT --key-file=KEY_FILE
      

      onde:

      • ACCOUNT é o endereço de e-mail da conta de serviço que você criou. Por exemplo, [e-mail].

      • KEY_FILE é o caminho local relativo para o arquivo de chave que você copiou anteriormente. Por exemplo, sa-key.json.

   6. Ainda na linha de comando SSH, instale o NFS:

      sudo apt-get -y update && sudo apt-get install nfs-common
      

   7. Crie um diretório local para mapear para o compartilhamento de arquivos do Filestore. Ao repetir essas etapas nas próximas instâncias de VM do Compute Engine, use o mesmo nome e caminho:

      sudo mkdir -p MY_DIRECTORY
      

      onde:

      • MY_DIRECTORY é o nome do diretório POSIX local para a instância de VM do Compute Engine. Por exemplo, /usr/local/my_dir.

   8. Ative o compartilhamento de arquivos associado à instância do Filestore executando o comando mount. É possível usar qualquer opção de montagem do NFS. Para ter o melhor desempenho, consulte as recomendações de montagem de NFS em Como montar um compartilhamento de arquivos em uma instância de VM do Compute Engine:

      sudo mount -o rw,intr IP_ADDRESS:/FILE_SHARE MY_DIRECTORY
      

      onde:

      • IP_ADDRESS é o endereço IP da instância do Filestore. Ele pode ser encontrado na página Instâncias do Filestore.

      • FILE_SHARE é o nome do compartilhamento de arquivos na instância; Por exemplo, my_fs_instance.

      • MY_DIRECTORY é o nome do diretório que você mapeou na etapa anterior. Esse é um diretório na instância de VM do Compute Engine em que você quer ativar a instância do Filestore.

   9. Confirme o ponto de montagem:

      mount -l | grep nfs
      

      Isso retorna o seguinte ou um semelhante:

      10.66.55.194:/my_fs_instance on /home/usr/my_dir type nfs (rw,relatime,vers=3,rsize=262144,wsize=1048576,namlen=255,hard,proto=tcp,timeo=600,retrans=2,sec=sys,mountaddr=10.66.55.194,mountvers=3,mountport=2050,mountproto=udp,local_lock=none,addr=10.66.55.194)
      

      Como alternativa, também é possível usar o seguinte comando:

      df -h --type=nfs
      

      Isso retorna o seguinte ou um semelhante:

      Filesystem                       Size  Used Avail Use% Mounted on
      10.66.55.194:/my_fs_instance  1.0T     0  1.0T   0% /home/usr/my_dir
      

   10. Anote o caminho do diretório local no formato POSIX e salve para uma etapa posterior.

   11. Repita as etapas anteriores para criar mais três instâncias de VM do Compute Engine e montar a mesma instância do Filestore em cada uma. Usar a mesma conta de serviço para gerenciar as quatro VMs do Compute Engine. Salve temporariamente uma cópia local da chave da conta de serviço em cada VM.

Configurar o Serviço de transferência do Cloud Storage

1. Crie um pool de agentes.

2. Autorize a conta serviço gerenciado pelo Google para todos os recursos do Serviço de transferência do Cloud Storage.

   1. Digite este comando:

      gcloud transfer authorize --add-missing --creds-file=KEY_FILE
      

      onde:

      • KEY_FILE é o caminho local relativo para o arquivo de chave que você copiou anteriormente. Por exemplo, sa-key.json.

      Observe a notificação retornada sobre a conta de serviço gerenciado pelo Google e salve o endereço de e-mail associado para a próxima etapa.

   2. Depois de alguns minutos, a conta de serviço gerenciado pelo Google vai aparecer na página do IAM. Depois da propagação, verifique se os seguintes papéis estão atribuídos:

      • Pub/Sub Editor

      • Storage Admin

      Observação :normalmente, as permissões levam segundos para serem propagadas, mas, em alguns casos, pode levar até sete minutos.

3. Instale os agentes de transferência.

   Cada agente do Serviço de transferência do Cloud Storage requer 4 vCPUs e 8 GB de RAM.

   Observação: o Serviço de transferência do Cloud Storage preserva atributos POSIX e links simbólicos durante a transferência. Para mais informações, consulte preservação de metadados.

   1. Recomendamos instalar vários agentes para maximizar a tolerância a falhas e aproveitar o escalonamento dinâmico oferecido pelo Serviço de transferência do Cloud Storage. O exemplo a seguir mostra como instalar três agentes em uma máquina cliente. Na linha de comando SSH, execute o seguinte comando:

      gcloud transfer agents install --pool=MY_AGENT_POOL --count=3 \
      --creds-file=MY_SERVICE_ACCOUNT_KEY_FILE
      

      onde:

      • MY_AGENT_POOL é o nome do pool de agentes criado anteriormente. Por exemplo, my-agent-pool.

      • MY_SERVICE_ACCOUNT_KEY_FILE é o caminho relativo para a chave da conta de serviço. Por exemplo, /relative/path/to/service-account-key.json.

   2. Repita essas etapas para cada computador cliente.

Criar e iniciar o job de transferência

1. Crie um job de transferência para mover dados do bucket do Cloud Storage para a instância do Filestore. Consulte o diretório POSIX local que você salvou anteriormente para especificar o caminho de destino. Por exemplo, /home/usr/my_dir.

Monitorar o status da transferência

Console

Monitore o status da transferência na página Jobs de transferência no Console do Google Cloud.

Linha de comando

Você pode monitorar o status usando a linha de comando:

gcloud transfer jobs monitor JOB_NAME

onde:

• JOB_NAME é o nome do job de transferência. Por exemplo, transferJobs/OPI6300379522015192941.

A resposta vai mostrar o seguinte ou algo semelhante:

Polling for latest operation name...done.
Operation name: my-sts-project_transferJobs/OPI6300379522015192941_0000000001660692377
Parent job: OPI6300379522015192941
Start time: 2022-08-16T23:26:17.600981Z
SUCCESS | 100% (731.9MiB of 731.9MiB) | Skipped: 129.8kiB | Errors: 0
End time: 2022-08-16T23:27:23.429472Z

Para mais informações, consulte Monitorar a atividade do agente ou Detalhes da transferência do sistema de arquivos.

A seguir

• Melhore o desempenho nos recursos do Google Cloud.
• Crie uma instância de VM do Compute Engine com acesso a outros serviços do Google Cloud.