转移代理命令行选项

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

如需了解详情，请参阅 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 Console 中的代理或其机器。使用前缀时，代理 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

代理默认使用 8GiB 系统内存的上限。如果默认环境不适合您的环境，您可以通过以下格式指定相关的最大内存使用量：

max-physical-mem 值	内存上限设置
6g	6 GB
6gb	6 GB
6GiB	6 GiB

--project-id=project-id

托管创建和计费的转移资源的项目 ID 所需的字符串。

--version

显示代理的当前版本。