Befehlszeilenoptionen für Übertragungs-Agent

Übertragungs-Agents übertragen Daten von Ihrem Dateisystem nach Google Cloud. Sie können die Agent-Optionen steuern, wenn Sie einen Agent mit den auf dieser Seite beschriebenen Flags und Optionen ausführen.

Zusammenfassung des Befehls

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

--ulimit memlock=64000000
Sperrt freigegebenen Speicher für einen freigegebenen Pool für Docker, sodass er immer als In-Memory-Speicher für den Zugriff durch mehrere Sitzungen verfügbar ist.
-d

Startet den Docker-Container im getrennten Modus oder im Hintergrund. Dadurch können Sie weiterhin Befehle über das Linux-Terminal ausführen.

Weitere Informationen finden Sie unter Detached -d.

--rm

Löscht den Container und das Dateisystem des Containers, wenn Docker beendet wird.

Weitere Informationen finden Sie unter Clean up (--rm).

-v host-directory:container-directory

Gibt ein oder mehrere Volumes an, die vom Host dem Container zugeordnet werden sollen. Wenn Sie -v verwenden, müssen host-directory und container-directory identisch sein. Andernfalls kann der Storage Transfer Service Ihre Dateien für die Übertragung nicht finden.

Weitere Informationen finden Sie unter VOLUME (freigegebene Dateisysteme).

--env environment-variable=variable-value

Gibt eine Umgebungsvariable für den Docker-Container an. Verwenden Sie dieses Flag, um Ihre Agents für die Verwendung eines Weiterleitungsproxys zu konfigurieren. Weitere Informationen finden Sie unter Weiterleitungsproxy verwenden.

Agent-Optionen

--agent-id-prefix=id-prefix

Ein optionales Präfix, das der Agent-ID vorangestellt wird, um den Agent oder seinen Computer in der Google Cloud Console leichter zu identifizieren. Wenn ein Präfix verwendet wird, hat die Agent-ID das Format prefix + hostname + Docker container ID.

--agent-pool=pool-name

Der Agent-Pool, dem dieser Agent hinzugefügt werden soll. Wenn kein Agent-Pool angegeben ist, wird er dem Pool transfer_service_default zugewiesen.

--creds-file=credential-file

Eine optionale Datei mit den Anmeldedaten für das Dienstkonto im JSON-Format. Weitere Informationen zum Generieren einer Datei mit Anmeldedaten für ein Dienstkonto finden Sie unter Dienstkontoschlüssel erstellen und verwalten.

--enable-mount-directory

Teilt dem Agenten mit, dass das gesamte Dateisystem des Hosts im Container unter /transfer_root bereitgestellt wird. Verwenden Sie es nur zusammen mit -v /:/transfer_root, anstatt einzelne Docker--v-Volume-Bereitstellungen zu verwenden. Der Agent stellt /transfer_root den Quell-, Ziel-, Log- und Anmeldedatenpfaden voran. /transfer_root ist in Übertragungslogs oder Fehlerbeispielen nicht sichtbar.

--help

Zeigt kurze Hilfetexte zur Nutzung an.

--hostname=hostname

Legen Sie den Hostnamen fest, auf dem der Agent ausgeführt wird. Wird verwendet, um den Hostnamen des Computers zu melden, auf dem ein bestimmter Agent ausgeführt wird.

--kerberos-disable-pa-fx-fast

Verhindert, dass Agents die FAST-Verhandlung mit Kerberos für HDFS-Übertragungen verwenden. Verwenden Sie dieses Flag, wenn Ihr Kerberos Key Distribution Center (KDC) keine FAST-Verhandlung unterstützt.

--log-dir=logs-directory

Ein optionales Verzeichnis, in das der Agent Logs schreibt. Das Standardverzeichnis ist /tmp/.

--max-physical-mem=maximum-memory

Standardmäßig verwenden Agents einen 8-GiB-Pufferpool. Wenn der Standardwert nicht zu Ihrer Umgebung passt, können Sie eine relevante maximale Speichernutzung in den folgenden Formaten angeben:

max-physical-mem Wert Einstellung für den maximalen Arbeitsspeicher
6g 6 Gibibyte
6gb 6 Gibibyte
6GiB 6 Gibibyte
--project-id=project-id

Erforderlicher String der Projekt-ID, die die erstellten und abgerechneten Übertragungsressourcen hostet.

--version

Zeigt die aktuelle Version des Agents an.