轉移代理程式指令列選項

移轉代理程式會將資料從檔案系統移轉至 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-file

JSON 格式的服務帳戶憑證檔案 (選用)。如要進一步瞭解如何產生服務帳戶憑證檔案,請參閱「建立及管理服務帳戶金鑰」。

--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 值 記憶體上限設定
6g 6 GiB
6gb 6 GiB
6GiB 6 GiB
--project-id=project-id

必要字串,代表託管已建立及計費轉移資源的專案 ID。

--version

顯示代理目前的版本。