Cómo conectar Google Cloud Storage
Este tutorial muestra cómo dar acceso a Dattos a un bucket de Google Cloud Storage para que los procesos busquen archivos de entrada y entreguen allí los archivos exportados. Para entender la integración en su conjunto, consulta Repositorios de archivos: cuáles conecta Dattos y cómo registrarlos.
Qué necesitas
Acceso a la consola de Google Cloud con permiso para crear cuentas de servicio y asignar roles en el bucket (o alguien del equipo de nube que pueda hacerlo).
El bucket ya creado.
Permiso para generar una clave de cuenta de servicio.
Es posible que la creación de claves esté bloqueada en tu organización. En las organizaciones de Google Cloud creadas a partir del 3 de mayo de 2024, la creación de claves de cuenta de servicio viene bloqueada de forma predeterminada por la política iam.managed.disableServiceAccountKeyCreation. Si aparece un error al hacer clic en el botón para crear una clave, el administrador de la organización en Google Cloud debe habilitar esta política para el proyecto del bucket. Dattos solo se conecta a Cloud Storage mediante la clave JSON.
1. Crea las carpetas en el bucket
En Cloud Storage, las carpetas son prefijos de los nombres de archivo. Para que la carpeta aparezca en la lista de Dattos aunque esté vacía, créala primero en la consola: abre el bucket en la página Buckets y haz clic en Crear carpeta. Por ejemplo, dattos/entrada/extratos y dattos/saida/relatorios.
2. Crea la cuenta de servicio
En la página Cuentas de servicio de la consola, dentro del proyecto del bucket, crea una cuenta de servicio exclusiva para Dattos.
Abre el bucket, ve a Permisos › Conceder acceso, introduce el correo electrónico de la cuenta de servicio y asígnale el rol Storage Object User (
roles/storage.objectUser). Este rol permite enumerar, leer, escribir y eliminar archivos, únicamente en ese bucket, y es el rol de menor alcance que satisface las necesidades de Dattos.Vuelve a la página Cuentas de servicio y haz clic en el correo electrónico de la cuenta que creaste. En la pestaña Claves, abre Añadir clave › Crear nueva clave, elige JSON y haz clic en Crear. Google descargará un archivo
.jsonen tu computadora, y no podrás volver a descargarlo.
El permiso para eliminar es necesario porque Dattos mueve los archivos leídos a subcarpetas de control (.processing, .processed y .error). En Cloud Storage, mover un archivo consiste en copiarlo y eliminar el original.
3. Registra la credencial en Dattos
Haz clic en el ícono del engranaje y abre General › Credenciales.
Haz clic en + Nueva credencial y, en la pestaña Almacenamiento, elige Google Cloud Storage.
Completa los campos:
Campo | Qué indicar | Obligatorio |
|---|---|---|
Nombre de la credencial | Un nombre que identifique el bucket, como «GCS Finanzas - extractos» | Sí |
Nombre del bucket | Solo el nombre del bucket, sin | Sí |
JSON de la cuenta de servicio | Todo el contenido del archivo | Sí |
Prefijo | Opcional. Limita Dattos a una parte del bucket, por ejemplo | No |
Perfiles de privacidad | Quién puede usar esta credencial en los procesos | Sí |
Haz clic en Guardar. Después de guardarlo, elimina el archivo
.jsonde tu computadora: la clave queda almacenada en Dattos.
Google Cloud Storage no tiene el botón Probar conexión. Para comprobar el acceso, sigue el paso siguiente.
4. Comprueba y conecta el bucket a un proceso
Abre un proceso Turbo AI con el flujo publicado y ve a Directorio de origen.
Haz clic en Editar en la fuente deseada y, luego, en Añadir destino.
En Integración de almacenamiento, elige la credencial que creaste.
Si las carpetas del bucket aparecen en Carpetas de importación, el acceso está configurado correctamente. Elige la carpeta y guarda.
Las instrucciones completas, incluida la configuración de salida, están en Integración con repositorios de archivos: directorios de origen y de salida.
Cómo ver los archivos del bucket
Dattos muestra las carpetas, pero no los archivos. Para comprobar si el archivo llegó, si se movió a .processed o a .error, o si se entregó la exportación, abre el bucket en la página Buckets de la consola de Google Cloud con un usuario de tu empresa que tenga acceso de lectura.
Problemas frecuentes
Qué ves | Causa probable |
|---|---|
Error al cargar las carpetas | JSON pegado parcialmente, clave revocada en Google Cloud, nombre del bucket incorrecto o cuenta de servicio sin un rol asignado en el bucket |
Las carpetas aparecen, pero la ejecución termina con un error al escribir o mover el archivo | La cuenta de servicio solo tiene un rol de lectura; cámbialo por Storage Object User |
Una carpeta no aparece en la lista | La carpeta está fuera del Prefijo indicado o aún no se ha creado en el bucket |