Ativar ou desativar a transferência on-line

O Transfer Appliance tem dois modos:

  • Transferência off-line: os dados são copiados para o dispositivo até que ele esteja cheio. O dispositivo é enviado de volta para o Google, e os dados copiados são movidos para o bucket do Cloud Storage.

  • Transferência on-line: os dados copiados para o dispositivo são transmitidos para o bucket do Cloud Storage. Depois que os dados são enviados para o bucket do Cloud Storage, eles são removidos do dispositivo. A transferência on-line compacta e criptografa os dados em trânsito e acelera a transferência de dados em comparação com a CLI gcloud e outras ferramentas de linha de comando.

É possível alternar entre os modos off-line e on-line.

Fazer o download da chave da conta de serviço do dispositivo

Depois que a configuração do projeto for concluída, prepare uma chave de conta de serviço:

  1. Crie uma chave de conta de serviço para a conta de serviço do dispositivo. Esta é uma chave de download única.

    A chave precisa pertencer à conta de serviço do dispositivo que você criou clicando em Criar conta de serviço na lista de verificação de configuração (ID@PROJECT_ID.iam.gserviceaccount.com) ou à conta de serviço gerenciado pelo usuário que você configurou manualmente. Não crie uma chave para a conta de serviço da sessão ou para qualquer agente de serviço do Serviço de transferência do Cloud Storage.

  2. Renomeie a chave como key.json e salve-a em um local seguro.

  3. Depois de receber o dispositivo, faça upload de key.json para o diretório /tmp no dispositivo.

Definir para o modo on-line

Antes de ativar o modo de transferência on-line pela primeira vez, siga as instruções para concluir a configuração do projeto.

A conectividade de saída é necessária para ativar e usar o modo on-line. Para ativar o modo de transferência on-line, siga estas etapas:

  1. Verifique a conectividade de saída do dispositivo com os seguintes hosts. O dispositivo se conecta a eles por HTTPS (porta 443):

    • gcr.io

    • storage.googleapis.com

    • oauth2.googleapis.com

    • storagetransfer.googleapis.com

    • pubsub.googleapis.com

    Execute o comando a seguir para cada host. Use apenas o nome do host: não inclua https:// ou um caminho.

    ping HOSTNAME

    Exemplo:

    ping storagetransfer.googleapis.com

    Se o comando falhar, isso pode indicar que o DNS está configurado incorretamente no dispositivo. Se o dispositivo foi configurado para usar um endereço IP estático, atualize-o para usar o DHCP:

    ta config --data_port=PORT --ip=dhcp

    Substitua PORT pela porta de dados que você está usando no dispositivo, RJ45 ou QSFP.

  2. Copie a chave de serviço salva em Fazer o download da chave da conta de serviço do dispositivo para a pasta tmp do dispositivo, fazendo o seguinte:

    Windows

    1. Usando a ferramenta SCP, conecte-se ao dispositivo usando as seguintes configurações:

      • Protocolo de arquivo: SFTP
      • Nome do host: o endereço IP do dispositivo.
      • Número da porta: 22
      • Nome de usuário: o nome de usuário do dispositivo fornecido pela equipe do Transfer Appliance.
      • Senha: a senha do dispositivo fornecida pela equipe do Transfer Appliance.

    2. Copie o arquivo para a pasta /tmp.

    Linux

    1. Execute este comando:

      scp PATH_TO_KEY_FILE/key.json USERNAME@IP_ADDRESS:/tmp

      Substitua:

      • PATH_TO_KEY_FILE: o caminho para o arquivo de chave que você está copiando.
      • USERNAME: o nome de usuário do dispositivo fornecido pela equipe do Transfer Appliance.
      • IP_ADDRESS: o endereço IP do dispositivo.

    2. Quando solicitado, digite a senha do dispositivo fornecida pela equipe do Transfer Appliance.

    Apple macOS

    1. Execute este comando:

      scp PATH_TO_KEY_FILE/key.json USERNAME@IP_ADDRESS:/tmp

      Substitua:

      • PATH_TO_KEY_FILE: o caminho para o arquivo de chave que você está copiando.
      • USERNAME: o nome de usuário do dispositivo fornecido pela equipe do Transfer Appliance.
      • IP_ADDRESS: o endereço IP do dispositivo.

    2. Quando solicitado, digite a senha do dispositivo fornecida pela equipe do Transfer Appliance.

  3. Atualize o software do dispositivo para a versão mais recente. O modo on-line requer os binários mais recentes do appliance:

    ta update --binaries

    Para mais informações, consulte Atualizar software.

  4. Para definir o dispositivo no modo on-line, execute o seguinte comando:

    ta online

    A resposta de exemplo a seguir é parecida com a saída retornada:

    
Starting containers for online transfer...
Copied new credentials.          ## Or, Using old credentials
Running binary to enable online transfer.
This may take several minutes to finish...

Containers have been successfully started. You can transfer data in
online mode.

  5. Opcional: mude o bucket de destino da transferência e o prefixo do objeto do job.

    ta online --bucket=BUCKET --object_prefix=OBJECT_PREFIX

    Substitua BUCKET pelo bucket de destino e OBJECT_PREFIX pelo prefixo do objeto que você está atualizando.

    Se o comando for bem-sucedido, ele vai retornar uma saída semelhante à da etapa em que você executa a transferência on-line sem esses dois argumentos.

Para resolver problemas no modo on-line, consulte Solução de problemas no modo on-line.

Definir como modo off-line

Para especificar o modo off-line, execute o seguinte comando:

ta offline

A resposta de exemplo a seguir é parecida com a saída retornada:


Putting the appliance in offline mode...
Appliance is successfully put into the offline mode.