启用或停用在线转移

Transfer Appliance 有两种模式：

• 离线转移：将数据复制到设备，直到设备装满。将设备寄送回 Google，并将复制的数据移至 Cloud Storage 存储桶。

• 在线转移：复制到设备的数据会流式传输到 Cloud Storage 存储桶。数据上传到 Cloud Storage 存储桶后，系统会将其从设备中移除。与 gcloud CLI 和其他命令行工具相比，在线传输会压缩和加密传输中的数据，并加快数据传输速度。

您可以在离线模式和在线模式之间切换。

下载设备服务账号密钥

项目设置完成后，准备一个服务账号密钥：

1. 为设备服务账号创建服务账号账号密钥。这是一次性下载密钥。

   该密钥必须属于您通过在设置核对清单 (ID@PROJECT_ID.iam.gserviceaccount.com) 中点击创建服务账号而创建的设备服务账号，或者属于您手动配置的用户代管式服务账号。请勿为会话服务账号或任何 Storage Transfer Service 服务代理创建密钥。

   注意：设备服务账号可以属于与您订购设备的项目不同的项目。在这种情况下，请在订单项目和目标存储桶上授予所需角色，并在包含服务账号的项目中启用所需的 API。如需了解详情，请参阅 [为在线传输做好准备](/transfer-appliance/docs/4.0/prepare-online)。

2. 将密钥重命名为 key.json，并将其保存到安全位置。

3. 收到设备后，请将 key.json 上传到设备上的 /tmp 目录。

设为在线模式

首次启用在线转移模式之前，请按照说明完成项目设置。

若要启用和使用在线模式，必须具备出站连接。如需启用在线转移模式，请按以下步骤操作：

1. 验证从设备到以下主机的出站连接。设备通过 HTTPS（端口 443）连接到这些端点：

   • gcr.io

   • storage.googleapis.com

   • oauth2.googleapis.com

   • storagetransfer.googleapis.com

   • pubsub.googleapis.com

   对每个主机运行以下命令。仅使用主机名：请勿包含 https:// 或路径。

   ping HOSTNAME
   

   例如：

   ping storagetransfer.googleapis.com
   

   如果命令失败，则可能表示设备上的 DNS 配置有误。如果设备已配置为使用静态 IP 地址，请将其更新为使用 DHCP：

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

   将 PORT 替换为您在设备上使用的数据端口，可以是 RJ45 或 QSFP。

   注意：某些网络会屏蔽 ICMP 流量。如果 ping 失败，但 DNS 解析了主机名，请验证您的防火墙是否允许通过端口 443 向这些主机发送出站 HTTPS 流量。

2. 通过执行以下操作，将下载设备服务账号密钥中下载的服务密钥复制到设备的 tmp 文件夹：

   Windows

   1. 使用 SCP 工具，通过以下设置连接到设备：

      • 文件协议：SFTP
      • 主机名：设备的 IP 地址。
      • 端口号：22
      • 用户名：Transfer Appliance 团队提供的设备用户名。
      • 密码：Transfer Appliance 团队提供的设备密码。

   2. 将文件复制到 /tmp 文件夹

   Linux

   1. 运行以下命令：

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

      替换以下内容：

      • PATH_TO_KEY_FILE：要复制的密钥文件的路径。
      • USERNAME：Transfer Appliance 团队提供的设备用户名。
      • IP_ADDRESS：设备的 IP 地址。

   2. 收到提示时，输入 Transfer Appliance 团队提供的设备密码。

   Apple macOS

   1. 运行以下命令：

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

      替换以下内容：

      • PATH_TO_KEY_FILE：要复制的密钥文件的路径。
      • USERNAME：Transfer Appliance 团队提供的设备用户名。
      • IP_ADDRESS：设备的 IP 地址。

   2. 出现提示时，输入 Transfer Appliance 团队提供的设备密码。

3. 将设备软件更新到最新版本。在线模式需要最新的设备二进制文件：

   ta update --binaries
   

   如需了解详情，请参阅更新软件。

4. 如需将设备设置为在线模式，请运行以下命令：

   ta online
   

   以下示例响应类似于返回的输出：

   
   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. 可选：更改转移作业目标存储桶和作业对象前缀。

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

   将 BUCKET 替换为目标存储桶，并将 OBJECT_PREFIX 替换为您要更新到的对象前缀。

   如果该命令成功运行，则会返回与您在不使用这两个实参的情况下运行在线转移的步骤中的输出类似的输出。

   注意：您可以单独更新目标存储桶和对象前缀。如果更新到新的目标存储桶，请确保 [为新存储桶设置了所需的服务账号](/transfer-appliance/docs/4.0/prepare-permissions)。此外，无论设备处于离线还是在线状态，每次使用至少一个标志调用此命令都会触发新的传输操作。

如需排查在线模式问题，请参阅排查在线模式问题。

设为离线模式

如需指定离线模式，请运行以下命令：

ta offline

以下示例响应类似于返回的输出：

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