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 estejam cheios. O dispositivo é devolvido ao Google, e os dados copiados são movidos para seu bucket do Cloud Storage.

  • Transferência on-line: os dados copiados para o dispositivo são transmitidos para seu bucket do Cloud Storage. Após o upload dos dados 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 o gsutil 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

Quando 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. Essa é uma chave de download único.

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

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

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 as instruções abaixo:

  1. Verifique sua conectividade de saída do dispositivo para os endpoints HTTPS listados abaixo:

    • https://gcr.io

    • https://storage.googleapis.com

    • https://oauth2.googleapis.com

    • https://storagetransfer.googleapis.com

    • https://pubsub.googleapis.com

    Execute o seguinte comando usando cada um dos endpoints HTTPS:

    ping URL

    Se o comando falhar, isso pode indicar que o DNS está configurado incorretamente no dispositivo. Se o dispositivo estiver 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. Para isso, faça 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. 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.

  4. Opcional: altere 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 para o qual você está atualizando.

    Se o comando for bem-sucedido, ele vai retornar uma saída parecida com a 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 para o 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.