Configura el acceso a una fuente: sistema de archivos

Para transferir datos desde un sistema de archivos local o de nube privada (como los sistemas de archivos compatibles con POSIX, NFS o SMB), debes instalar y configurar agentes del Servicio de transferencia de almacenamiento en máquinas con acceso de red a los archivos de origen.

Requisitos previos

Antes de configurar la transferencia, asegúrate de haber configurado lo siguiente:

• Permisos del usuario: Asegúrate de que tu cuenta de usuario o cuenta de servicio administrada por el usuario tenga permiso para configurar trabajos de transferencia y grupos de agentes. Consulta Permisos de usuario obligatorios.
• Permisos a nivel de proyecto basados en agentes: Asegúrate de haber configurado los roles necesarios a nivel de proyecto para tu agente de servicio y tu cuenta de agente de transferencia. Consulta Permisos a nivel del proyecto basados en agentes.
• Permisos de destino: Según el destino de la transferencia, configura los permisos de receptor necesarios:
  • Para las transferencias a Cloud Storage, consulta Configura el acceso a un receptor: Cloud Storage.
  • Para las transferencias a otro sistema de archivos, consulta Configura el acceso a un receptor: sistema de archivos.

Permisos del sistema de archivos local

Los agentes de transferencia se ejecutan dentro de contenedores de Docker o Podman en tus máquinas host. Para permitir que los agentes lean tus archivos, sigue estos pasos:

1. Permisos de usuario del SO: Asegúrate de que el usuario del sistema operativo que ejecuta el contenedor tenga permisos de lectura (y ejecución en directorios) para todos los archivos y directorios que planeas transferir.

2. Activa directorios: Cuando instales tus agentes, activa los directorios que quieras copiar en el contenedor con la marca --mount-directories (o las marcas -v en Docker):

   gcloud transfer agents install --pool=AGENT_POOL_NAME \
     --mount-directories=/path/to/source/dir
   

   Precaución: Si varios agentes del mismo grupo de agentes se ejecutan en diferentes máquinas físicas, todos deben tener acceso uniforme a la red (como una activación de NFS compartida) a las mismas rutas de acceso. Si un agente no puede acceder a una ruta de acceso asignada, el trabajo de transferencia falla.

Para restringir los directorios de host que pueden ver los agentes, consulta Restringe el acceso al directorio del agente.

Rendimiento y optimización

• Para maximizar la capacidad de procesamiento cuando se transfieren datos desde sistemas de archivos grandes, instala varios agentes en tu grupo de agentes de origen (se recomienda un mínimo de 3). Consulta las Prácticas recomendadas para los agentes de transferencia.
• Para archivos de más de 1 GB, considera habilitar las cargas de varias partes.

¿Qué sigue?

• Obtén más información para instalar agentes de transferencia.
• Obtén información para crear un grupo de agentes.
• Obtén más información para configurar el acceso a un receptor: Cloud Storage.
• Obtén más información para configurar el acceso a un receptor: sistema de archivos.