転送エージェントは、ファイル システムから 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 の共有プールの共有メモリをロックしてメモリに常駐させることにより、複数のセッションからアクセスできるようにします。
-dDocker コンテナを切断モードで起動するか、バックグラウンドで起動します。これにより、引き続き Linux ターミナルからコマンドを発行できます。
詳細については、Detached -d をご覧ください。
--rmDocker の終了時にコンテナとそのファイル システムを削除します。
詳細については、Clean up (--rm) をご覧ください。
-v host-directory:container-directoryホストからコンテナにマッピングする 1 つ以上のボリュームを指定します。
-vを使用する場合は、host-directoryとcontainer-directoryを同一にする必要があります。そうしないと、Storage Transfer Service は転送するファイルを見つけることができません。詳細については、VOLUME(共有ファイルシステム)をご覧ください。
--env environment-variable=variable-valueDocker コンテナの環境変数を指定します。転送プロキシを使用するようにエージェントを構成するには、このフラグを使用します。詳細については、転送プロキシの使用をご覧ください。
エージェントのオプション
--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にマウントされていることをエージェントに通知します。個々の Docker-vボリューム マウントではなく、-v /:/transfer_rootと組み合わせてのみ使用します。エージェントは、ソース、宛先、ログ、認証情報のパスの先頭に/transfer_rootを追加します。/transfer_rootは、転送ログやエラーサンプルでは表示されません。--help使い方の簡単な説明が表示されます。
--hostname=hostnameエージェントが動作しているホスト名を設定します。特定のエージェントが動作しているマシンのホスト名の報告に使用されます。
--kerberos-disable-pa-fx-fastエージェントが HDFS 転送に Kerberos で FAST ネゴシエーションを使用できないようにします。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エージェントの現行バージョンを表示します。