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 da 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.

  2. Renomeie a chave para 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 como 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 a 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 comando a seguir 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 tiver sido 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. Faça o seguinte para copiar 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:

    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: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.