Requisitos para las transferencias del sistema de archivos

Antes de crear un trabajo de transferencia del sistema de archivos, deberás habilitar las API necesarias y, luego, instalar Docker.

Si recibes errores durante la primera configuración, confirma que el usuario con el que accediste tenga los permisos necesarios para realizar los pasos de configuración. En muchos casos, estos permisos no están disponibles para todos los usuarios, por lo que es posible que debas comunicarte con un administrador del proyecto a fin de obtener asistencia.

Requisitos del sistema

Si quieres usar el Servicio de transferencia de almacenamiento para las transferencias del sistema de archivos, necesitas lo siguiente:

A continuación, se enumeran los requisitos de la máquina del agente de transferencia:

  • Un servidor Linux de 64 bits compatible con Docker o una máquina virtual que pueda acceder a los datos que planeas transferir Docker Community Edition, admite los sistemas operativos CentOs, Debian, Fedora y Ubuntu.

    Para usar otros sistemas operativos de Linux, consulta Docker Enterprise.

  • Al menos 8 GB de memoria por contenedor y al menos 4 CPU para que sean más eficaces.

  • Cualquier restricción a nivel del sistema o del usuario en la cantidad de IDs de proceso permitidos, como los configurados con ulimit -u, debe tener en cuenta la cantidad de agentes que planeas ejecutar. Cada proceso de agente puede crear hasta muchos cientos de subprocesos. Te recomendamos que quites los límites de ID de proceso cuando ejecutes agentes de transferencia.

    Los clientes que usan Podman para crear contenedores de agentes deben especificar un valor de --pids-limit lo suficientemente alto como para alojar los subprocesos del agente del Servicio de transferencia de almacenamiento. El valor predeterminado de --pids-limit es 2048, lo que puede causar problemas cuando se ejecuta más de un agente. Te recomendamos que configures --pids-limit=-1 para permitir IDs de proceso ilimitados por contenedor.

Extremos obligatorios

El agente de transferencia debe poder acceder a los siguientes extremos de DNS. Si bien un agente solo puede usar un subconjunto de estos extremos según su configuración, se deben permitir todos los extremos para garantizar la funcionalidad completa.

Extremos deGoogle Cloud

Esta lista de extremos obligatorios está sujeta a cambios. Para evitar interrupciones en las transferencias, te recomendamos que permitas el dominio base googleapis.com y gcr.io, siempre que las políticas de seguridad de tu organización lo permitan.

Extremo Servicio Objetivo
storagetransfer.googleapis.com Servicio de transferencia de almacenamiento El agente lo usa para conectarse al Servicio de transferencia de almacenamiento, recibir tareas de transferencia y, además, informar su estado.
storage.googleapis.com Cloud Storage Se usa para realizar operaciones de transferencia de datos principales, como enumerar, leer y escribir objetos en tus buckets de Cloud Storage.
www.googleapis.com API de Google Se usa para descargar actualizaciones de versión del agente de transferencia.
monitoring.googleapis.com Cloud Monitoring Se usa para exportar las métricas de rendimiento de la transferencia y de estado del agente.
logging.googleapis.com Cloud Logging Se usa para publicar los registros de actividad y del sistema del agente.
oauth2.googleapis.com OAuth 2.0 Se usa para intercambiar credenciales de forma segura y recuperar tokens de acceso de corta duración para la autorización de APIs.
iamcredentials.googleapis.com Credenciales de cuenta de servicio de IAM Se usa para generar credenciales temporales cuando el agente está configurado para actuar en nombre de una cuenta de servicio específica.
cloudresourcemanager.googleapis.com Resource Manager Se usa durante la instalación y configuración del agente para verificar la configuración y los permisos del proyecto.
gcr.io Container Registry Se usa para descargar la imagen de contenedor del agente del Servicio de transferencia de almacenamiento durante la instalación.

Para optimizar el rendimiento de la transferencia, el agente puede usar diferentes protocolos HTTP, incluidos HTTP/1.1 y HTTP/2 como mínimo, cuando se comunica con varios extremos. Asegúrate de que los proxies o firewalls configurados admitan correctamente todos estos tipos de protocolos y tengan un buen rendimiento en ellos.

Extremos regionales

Si configuraste tus agentes para que usen extremos regionales (p.ej., storage.REGION.rep.googleapis.com), tus reglas de proxy o firewall deben permitir esos nombres de dominio específicos en lugar del extremo storage.googleapis.com estándar.

Extremos de almacenamiento de origen y destino

El agente también requiere acceso de red a los sistemas de almacenamiento de origen y destino específicos, como las APIs compatibles con S3, los clústeres de HDFS o NFS para POSIX.

Restricciones de escalamiento en trabajos y agentes

El Servicio de transferencia de almacenamiento tiene las siguientes restricciones de escalamiento en los trabajos y agentes de transferencia:

  • Menos de mil millones de archivos por trabajo
  • El límite de ancho de banda debe ser de al menos 1 MBps (megabytes por segundo)
  • Hasta 100 agentes por grupo de agentes
  • Hasta 800 grupos de agentes por proyecto

Habilita las APIs

  1. Habilita la API de Google Storage Transfer si aún no está habilitada.

    Roles necesarios para habilitar las APIs

    Para habilitar las APIs, necesitas el permiso serviceusage.services.enable. Si creaste el proyecto, es probable que ya tengas este permiso a través del rol de propietario (roles/owner). De lo contrario, puedes obtenerlo a través del rol de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin). Obtén más información para otorgar roles.

    Habilitar la API

Instala Docker

Si usas Google Cloud CLI o Docker para instalar y ejecutar agentes de transferencia, instala Docker Engine en una máquina virtual o física de Linux.

Si usas Podman para instalar y ejecutar agentes de transferencia, ve directamente a las instrucciones de instalación específicas de Podman.

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
sudo systemctl enable docker --now

Si se produce un error de instalación, consulta Solución de problemas.

Permite que Docker se autentique

Para permitir que el contenedor de Docker se autentique con tus credenciales predeterminadas de gcloud, crea un volumen de Docker que contenga un archivo con las credenciales predeterminadas de tu aplicación. Para ello, ejecuta el siguiente comando:

sudo docker run -ti --name gcloud-config google/cloud-sdk gcloud auth application-default login

Próximos pasos