Opciones de línea de comandos del agente de transferencia

Los agentes de transferencia transfieren datos desde tu sistema de archivos a Google Cloud. Puedes controlar las opciones del agente cuando ejecutas un agente mediante las marcas y las opciones que se describen en esta página.

Resumen del comando

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]

Opciones de Docker

--ulimit memlock=64000000
Bloquea la memoria compartida con un grupo compartido para Docker, de modo que siempre esté en la memoria a fin de permitir el acceso de varias sesiones.
-d

Inicia el contenedor de Docker en modo desconectado o en segundo plano. Esto te permite continuar emitiendo comandos desde la terminal de Linux.

Para obtener más información, consulta Detached -d (-d desconectado).

--rm

Borra el contenedor y el sistema de archivos del contenedor cuando se cierra Docker.

Para obtener más información, consulta Clean up (--rm) [Realiza una limpieza (--rm)].

-v host-directory:container-directory

Especifica uno o más volúmenes para mapear desde el host hasta el contenedor. Cuando se usa -v, se requiere que host-directory y container-directory sean iguales; de lo contrario, el Servicio de transferencia de almacenamiento no ubicará los archivos de forma correcta para la transferencia.

Para obtener más información, consulta VOLUME (shared filesystems) [VOLUMEN (sistemas de archivos compartidos)].

--env environment-variable=variable-value

Especifica una variable de entorno para el contenedor de Docker. Usa esta marca a fin de configurar tus agentes para que usen un proxy de reenvío. Para obtener más información, consulta la sección Usa un proxy de reenvío.

Opciones de agentes

--agent-id-prefix=id-prefix
Es un prefijo que se antepone al ID del agente para ayudar a identificar al agente o su máquina en la consola de Google Cloud. Cuando se usa un prefijo, el ID del agente tiene el formato prefix + hostname + Docker container ID.
--creds-file=credential-file

Es un archivo opcional de credenciales de cuenta de servicio con formato JSON. Si deseas obtener más información sobre cómo generar un archivo de credenciales de cuenta de servicio, consulta Crea y administra claves de cuentas de servicio.

--enable_mount_directory

De manera opcional, activa todo el sistema de archivos en el directorio /transfer_root dentro del contenedor de Docker, en lugar de especificar activaciones de volúmenes -v individuales en Docker. Si usas esta marca, no necesitas agregar el prefijo /transfer_root al directorio de registro o la ruta del archivo de credenciales de la cuenta de servicio y /transfer_root no es visible en los registros de transferencia o las muestras de errores de la GUI.

--help

Muestra una breve guía de uso.

--hostname=hostname

Establece el nombre de host en el que se ejecuta el agente. Se usa para informar el nombre de host de la máquina en la que se ejecuta un agente en particular.

--log-dir=logs-directory

Un directorio opcional en el que el agente escribe registros. El directorio predeterminado es /tmp/.

--max-physical-mem=maximum-memory

De forma predeterminada, los agentes usan un máximo de 8 GiB de memoria del sistema. Si el valor predeterminado no se ajusta a tu entorno, puedes especificar un uso máximo de memoria adecuado en los siguientes formatos:

Valor max-physical-mem Configuración del uso máximo de memoria
6g 6 gigabytes
6gb 6 gigabytes
6GiB 6 gibibytes
--project-id=project-id

Es la cadena obligatoria del ID del proyecto que aloja los recursos de transferencia que se crean y facturan.

--version

Muestra la versión actual del agente.