转移代理命令行选项

转移代理可将数据从文件系统转移到 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 终端发出命令。

如需了解详情,请参阅 Detached -d

--rm

在 Docker 退出时,删除容器和容器的文件系统。

如需了解详情,请参阅清理 (--rm)

-v host-directory:container-directory

指定从主机映射到容器的一个或多个卷。使用 -v 时,我们要求 host-directory 和 container-directory 相同,否则 Storage Transfer Service 无法成功找到要转移的文件。

如需了解详情,请参阅卷(共享文件系统)

--env environment-variable=variable-value

为 Docker 容器指定环境变量。使用此标志将代理配置为使用转发代理。如需了解详情,请参阅使用转发代理。

代理选项

--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

禁止代理在 HDFS 传输中使用 FAST 协商和 Kerberos。如果您的 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

显示代理的当前版本。