設定來源存取權：檔案系統

如要從地端部署或私有雲檔案系統 (例如符合 POSIX 規範的檔案系統、NFS 或 SMB) 移轉資料，您必須在可透過網路存取來源檔案的機器上，安裝及設定 Storage 移轉服務代理程式。

必要條件

設定移轉作業前，請務必先完成下列設定：

• 使用者權限：確認您的使用者帳戶或使用者自行管理的服務帳戶，有權設定移轉工作和代理程式集區。請參閱「必要的使用者授權」。
• 代理程式專案層級權限：請務必為服務代理和移轉代理帳戶，設定必要的專案層級角色。請參閱「代理程式專案層級權限」。
• 目的地權限：視移轉目的地而定，設定必要的接收器權限：
  • 如要移轉至 Cloud Storage，請參閱「設定接收器的存取權：Cloud Storage」。
  • 如要轉移至其他檔案系統，請參閱「設定接收端的存取權：檔案系統」。

本機檔案系統權限

移轉代理程式會在主機上的 Docker 或 Podman 容器中執行。如要允許代理讀取檔案，請按照下列步驟操作：

1. OS 使用者權限：確認執行容器的作業系統使用者，對您要移轉的所有檔案和目錄具備讀取 (和執行目錄) 權限。

2. 掛接目錄：安裝代理程式時，請使用 --mount-directories 旗標 (或 Docker 中的 -v 旗標)，掛接要複製到容器的目錄：

   gcloud transfer agents install --pool=AGENT_POOL_NAME \
     --mount-directories=/path/to/source/dir
   

   注意：如果同一個代理程式集區中的多個代理程式在不同的實體機器上執行，則所有代理程式都必須具有統一的網路存取權 (例如共用 NFS 掛接)，才能存取完全相同的路徑。如果其中一個代理程式無法存取指派的路徑，移轉工作就會失敗。

如要限制代理程式可查看的主機目錄，請參閱「限制代理程式目錄存取權」。

效能和最佳化

• 從大型檔案系統移轉資料時，請在來源代理程式集區中安裝多個代理程式 (建議至少 3 個)，盡可能提高處理量。請參閱「移轉代理程式最佳做法」。
• 如果檔案大於 1 GB，建議啟用多部分上傳。

後續步驟

• 瞭解如何安裝移轉代理程式。
• 瞭解如何建立代理程式集區。
• 瞭解如何設定接收器的存取權：Cloud Storage。
• 瞭解如何設定接收器的存取權：檔案系統。