轉移代理程式指令列選項

轉移代理程式會將資料從檔案系統轉移至 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-id-prefix=id-prefix --creds-file=credential-file
--enable_mount_directory --hostname=hostname
--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 (shared file systems)」

--env environment-variable=variable-value

指定 Docker 容器的環境變數。使用這個標記設定代理程式，以使用轉送 Proxy。詳情請參閱「使用轉送 Proxy」。

代理程式選項

--agent-id-prefix=id-prefix

可加入代理程式 ID 的選用前置字串，用於協助在 Google Cloud 控制台中識別代理程式或其機器。使用前置字元時，代理商 ID 的格式為 prefix + hostname + Docker container ID。

--creds-file=credential-file

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

注意： 除非使用 --enable_mount_directory，否則必須在路徑前加上 /transfer_root，例如 /transfer_root/path/to/cred_file.json。

--enable_mount_directory

選擇性地在 Docker 容器中，於 /transfer_root 目錄下掛接整個檔案系統，而非指定個別的 Docker -v 磁碟區掛接。使用這個旗標時，您不需要在記錄目錄或服務帳戶憑證檔案路徑前加上 /transfer_root，且 /transfer_root 不會顯示在移轉記錄或 GUI 錯誤範例中。

--help

顯示簡要的使用說明。

--hostname=hostname

設定代理程式執行的主機名稱。用於回報特定代理程式執行的電腦主機名稱。

注意： 使用這個旗標時，建議傳遞 --hostname=$(hostname)。

--log-dir=logs-directory

代理程式寫入記錄檔的目錄 (選用)。預設目錄為 /tmp/。

注意： 除非您使用 --enable_mount_directory，否則必須在路徑前加上 /transfer_root，例如 /transfer/root/path/to/log_file。

--max-physical-mem=maximum-memory

代理程式預設最多可使用 8 GiB 的系統記憶體。如果預設值不符合您的環境，您可以指定相關的最大記憶體用量，格式如下：

max-physical-mem 值	記憶體上限設定
6g	6 GB
6gb	6 GB
6GiB	6 GiB

--project-id=project-id

必要字串，為建立及計費的轉移資源代管專案 ID。

--version

顯示代理程式的目前版本。