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-id-prefix=id-prefix --creds-file=credential-file
--enable_mount_directory --hostname=hostname
--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à detached o in background. In questo modo puoi continuare a eseguire comandi dal terminale Linux.

Per ulteriori informazioni, consulta Detached -d

--rm

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

Per saperne di più, consulta Clean up (--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, vedi 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ù, vedi Utilizzo di un proxy di inoltro.

Opzioni dell'agente

--agent-id-prefix=id-prefix

Un prefisso facoltativo anteposto all'ID agente per 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.

--creds-file=credential-file

Un file delle credenziali del account di servizio facoltativo in formato JSON. Per ulteriori informazioni sulla generazione di un file delle credenziali del account di servizio, vedi Creare e gestire le account di servizio account.

Nota: a meno che tu non utilizzi --enable_mount_directory, devi anteporre a questo percorso /transfer_root, ad esempio /transfer_root/path/to/cred_file.json.

--enable_mount_directory

Monta facoltativamente l'intero file system nella directory /transfer_root all'interno del container Docker, anziché specificare singoli montaggi di volumi -vDocker. Quando utilizzi questo flag, non devi aggiungere il prefisso /transfer_root alla directory dei log o al percorso del file delle credenziali del account di servizio e /transfer_root non è visibile nei log di trasferimento o negli esempi di errori della GUI.

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

Nota: ti consigliamo di passare --hostname=$(hostname) quando utilizzi questo flag.

--log-dir=logs-directory

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

Nota:a meno che tu non utilizzi --enable_mount_directory, devi anteporre a questo percorso /transfer_root, ad esempio, /transfer/root/path/to/log_file.

--max-physical-mem=maximum-memory

Gli agenti utilizzano per impostazione predefinita un massimo di 8 GiB di memoria di sistema. Se il valore predefinito non è adatto al tuo ambiente, puoi specificare un utilizzo massimo della memoria pertinente nei seguenti formati:

Valore max-physical-mem	Impostazione della memoria massima
6g	6 gigabyte
6gb	6 gigabyte
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 attuale dell'agente.