移轉代理程式會將資料從檔案系統移轉至 Google Cloud。透過本頁所述的旗標和選項執行代理程式時,您可以控管代理程式選項。
指令摘要
sudo docker run [--ulimit memlock=64000000 -d --rm -v host-directory:container-directory]
--env environment-variable=variable-value
gcr.io/cloud-ingest/tsop-agent:latest
{--help | --version | --project-id=project-id}
[--agent-pool=pool-name --agent-id-prefix=id-prefix
--creds-file=credential-file --enable-mount-directory
--hostname=hostname
--kerberos-disable-pa-fx-fast
--log-dir=logs-directory
--max-physical-mem=maximum-memory]
Docker 選項
--ulimit memlock=64000000- 鎖定 Docker 共用集區的共用記憶體,使其一律位於記憶體中,供多個工作階段存取。
-d以分離模式或在背景啟動 Docker 容器。這樣您就能繼續從 Linux 終端機發出指令。
詳情請參閱卸離 -d
--rm在 Docker 結束時刪除容器和容器的檔案系統。
詳情請參閱「清除 (--rm)」
-v host-directory:container-directory指定一或多個磁碟區,從主機對應至容器。使用
-v時,host-directory和container-directory必須相同,否則 Storage 移轉服務無法成功找到要移轉的檔案。詳情請參閱「VOLUME (共用檔案系統)」
--env environment-variable=variable-value指定 Docker 容器的環境變數。使用這個旗標,即可將代理程式設為使用轉送 Proxy。詳情請參閱「使用轉送 Proxy」。
代理選項
--agent-id-prefix=id-prefix可加在代理程式 ID 前面的選用前置字串,用於在 Google Cloud 控制台中識別代理程式或其機器。使用前置字串時,代理程式 ID 的格式為
prefix + hostname + Docker container ID。--agent-pool=pool-name要新增這個代理的代理集區。如省略,代理程式會加入
transfer_service_default集區。--creds-file=credential-fileJSON 格式的服務帳戶憑證檔案 (選用)。如要進一步瞭解如何產生服務帳戶憑證檔案,請參閱「建立及管理服務帳戶金鑰」。
--enable-mount-directory告知代理程式,主機的整個檔案系統都掛接在容器中的
/transfer_root。請務必搭配-v /:/transfer_root使用,而非個別Docker-v磁碟區掛接。代理程式會在來源、目的地、記錄和憑證路徑前面加上/transfer_root,且/transfer_root不會顯示在移轉記錄或錯誤範例中。--help顯示簡短的使用說明。
--hostname=hostname設定代理程式執行所在的主機名稱。用於回報特定代理程式執行所在機器的主機名稱。
--kerberos-disable-pa-fx-fast防止代理使用 Kerberos 進行 FAST 協商,以便傳輸 HDFS。如果 Kerberos 金鑰分配中心 (KDC) 不支援 FAST 協商,請使用這個旗標。
--log-dir=logs-directory代理寫入記錄檔的目錄 (選用)。預設目錄為
/tmp/。--max-physical-mem=maximum-memory代理預設會使用 8 GiB 的緩衝區集區。如果預設值不適合您的環境,可以採用下列格式指定相關的記憶體用量上限:
max-physical-mem值記憶體上限設定 6g6 GiB 6gb6 GiB 6GiB6 GiB --project-id=project-id必要字串,代表託管已建立及計費轉移資源的專案 ID。
--version顯示代理目前的版本。