啟用或停用線上轉移功能

Transfer Appliance 有兩種模式：

• 離線轉移：資料會複製到設備，直到設備裝滿為止。Google 會在您送回設備後，將複製的資料移至 Cloud Storage bucket。

• 線上移轉：複製到設備的資料會串流至 Cloud Storage bucket。資料上傳至 Cloud Storage bucket 後，就會從設備中移除。線上移轉會壓縮及加密傳輸中的資料，且資料移轉速度比 gcloud CLI 和其他指令列工具更快。

您可以在離線和線上模式之間切換。

下載設備服務帳戶金鑰

專案設定完成後，請準備服務帳戶金鑰：

1. 為設備服務帳戶建立服務帳戶金鑰。這是一次性下載金鑰。

   金鑰必須屬於您在設定檢查清單 (ID@PROJECT_ID.iam.gserviceaccount.com) 中點選「Create service account」(建立服務帳戶) 建立的設備服務帳戶，或手動設定的使用者自行管理服務帳戶。請勿為工作階段服務帳戶或任何 Storage 移轉服務代理建立金鑰。

   注意：設備服務帳戶可以屬於與您訂購設備的專案不同的專案。在這種情況下，請在訂單專案和目的地 bucket 授予必要角色，並在包含服務帳戶的專案中啟用必要 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. 選用：變更移轉作業目的地 bucket 和工作物件前置字串。

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

   將 BUCKET 替換為目的地 bucket，並將 OBJECT_PREFIX 替換為要更新的物件前置字串。

   如果指令執行成功，傳回的輸出內容會與您在不使用這兩個引數的情況下，執行線上移轉作業時的輸出內容類似。

   注意：您可以單獨更新目標 bucket 和物件前置字串。如要更新為新的目的地值區，請確認已 [為新值區設定](/transfer-appliance/docs/4.0/prepare-permissions)必要的服務帳戶。此外，無論設備處於離線或線上狀態，每次叫用這個指令並搭配至少一個旗標時，都會觸發新的轉移作業。

如要排解線上模式的問題，請參閱「疑難排解線上模式」。

設為離線模式

如要指定離線模式，請執行下列指令：

ta offline

以下範例回應與傳回的輸出內容類似：

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