Opzioni a riga di comando dell'agente di trasferimento

Gli agenti di trasferimento trasferiscono i dati dal file system a Google Cloud. Puoi controllare le opzioni dell'agente quando lo esegui tramite i flag e le opzioni descritti in questa pagina.

Riepilogo dei comandi

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]

Opzioni Docker

--ulimit memlock=64000000
Blocca la memoria condivisa per un pool condiviso per Docker, in modo che sia sempre in memoria per l'accesso da parte di più sessioni.
-d

Avvia il container Docker in modalità scollegata o in background. In questo modo, puoi continuare a inviare comandi dal terminale Linux.

Per saperne di più, consulta Scollegato -d

--rm

Elimina il container e il relativo file system quando Docker viene chiuso.

Per saperne di più, consulta Esegui la pulizia (--rm).

-v host-directory:container-directory

Specifica uno o più volumi da mappare dall'host al container. Quando utilizzi -v, richiediamo che host-directory e container-directory siano uguali, altrimenti Storage Transfer Service non riuscirà a individuare i file da trasferire.

Per ulteriori informazioni, consulta VOLUME (file system condivisi)

--env environment-variable=variable-value

Specifica una variabile di ambiente per il container Docker. Utilizza questo flag per configurare gli agenti in modo che utilizzino un proxy di inoltro. Per saperne di più, consulta Utilizzo di un proxy di inoltro.

Opzioni agente

--agent-id-prefix=id-prefix

Un prefisso facoltativo che viene aggiunto all'ID agente per aiutare a identificare l'agente o la relativa macchina nella console Google Cloud . Quando viene utilizzato un prefisso, l'ID agente viene formattato come prefix + hostname + Docker container ID.

--agent-pool=pool-name

Il pool di agenti a cui aggiungere questo agente. Se omesso, l'agente si unisce al pool transfer_service_default.

--creds-file=credential-file

Un file di credenziali del account di servizio facoltativo in formato JSON. Per ulteriori informazioni sulla generazione di un file di credenziali del account di servizio, consulta Creazione e gestione account di servizio account.

--enable-mount-directory

Indica all'agente che l'intero file system dell'host è montato in /transfer_root nel container. Utilizzalo solo insieme a -v /:/transfer_root, anziché ai singoli punti di montaggio del volume Docker -v. L'agente antepone /transfer_root ai percorsi di origine, destinazione, log e credenziali e /transfer_root non è visibile nei log dei trasferimenti o negli esempi di errori.

--help

Visualizza una breve guida all'utilizzo.

--hostname=hostname

Imposta il nome host su cui è in esecuzione l'agente. Utilizzato per segnalare il nome host della macchina su cui è in esecuzione un determinato agente.

--kerberos-disable-pa-fx-fast

Impedisce agli agenti di utilizzare la negoziazione FAST con Kerberos per i trasferimenti HDFS. Utilizza questo flag se il tuo KDC (Key Distribution Center) Kerberos non supporta la negoziazione FAST.

--log-dir=logs-directory

Una directory facoltativa in cui l'agente scrive i log. La directory predefinita è /tmp/.

--max-physical-mem=maximum-memory

Per impostazione predefinita, gli agenti utilizzano un pool di buffer da 8 GiB. Se il valore predefinito non è adatto al tuo ambiente, puoi specificare una memoria utilizzata massima pertinente nei seguenti formati:

Valore max-physical-mem Impostazione della memoria massima
6g 6 gibibyte
6gb 6 gibibyte
6GiB 6 gibibyte
--project-id=project-id

Stringa obbligatoria dell'ID progetto che ospita le risorse di trasferimento create e fatturate.

--version

Mostra la versione corrente dell'agente.