S3 Writer

El componente S3 Writer permite subir archivos a un bucket de Amazon S3. Solo necesitas indicar la ruta de destino (prefijo), el nombre del archivo y el contenido que quieres almacenar. El proceso se ejecuta de forma asíncrona y devuelve la ruta completa donde se guardó el archivo.

¿Cómo funciona?

Cuando activas el componente, se crea una instancia de AsyncS3Wrapper usando las credenciales que hayas configurado en Nappai. El wrapper se encarga de comunicarse con la API de Amazon S3 y subir los datos. El contenido del archivo puede provenir de cualquier fuente compatible (texto, datos binarios, mensajes de otros componentes). Una vez que la carga se completa, el componente devuelve la ruta completa del objeto dentro del bucket, lo que te permite usarla en pasos posteriores de tu flujo de trabajo.

Entradas

• File content: Contenido del archivo que se va a subir. Puede ser texto, datos binarios o la salida de otro componente.
• S3 Prefix to upload file: Carpeta o prefijo dentro del bucket donde se guardará el archivo. Se selecciona mediante un selector de directorio.
• S3 Object: Nombre del archivo que se creará en S3. Este campo es obligatorio.

Salidas

• Path to File: Devuelve la ruta completa del archivo recién subido dentro del bucket. El tipo de dato es Data, lo que permite que se conecte a otros componentes que acepten rutas de archivos.

Ejemplo de Uso

1. Selecciona el archivo que quieres subir (por ejemplo, un informe PDF).
2. Define el prefijo: reports/2025/ para organizar los archivos por año y carpeta.
3. Escribe el nombre del archivo, por ejemplo, summary.pdf.
4. Conecta la salida Path to File a otro componente que necesite la ubicación del archivo, como un correo electrónico o un registro en una base de datos.

El flujo completo quedaría así:

[Upload File] → [S3 Writer] → [Email Sender]

El componente sube el archivo a reports/2025/summary.pdf y pasa esa ruta al siguiente paso.

Componentes Relacionados

• S3 Reader – Descarga archivos desde S3 para su procesamiento.
• S3 Lister – Lista los objetos dentro de un prefijo específico.
• S3 Delete – Elimina archivos de un bucket.

Consejos y Mejores Prácticas

• Verifica las credenciales: Asegúrate de que el token de credenciales tenga permisos de escritura en el bucket.
• Usa nombres únicos: Evita sobrescribir archivos existentes usando nombres con timestamps o UUIDs.
• Comprueba la ruta: Revisa que el prefijo exista o que el componente tenga permiso para crearlo.

Consideraciones de Seguridad

• Protege las credenciales: Nunca expongas el token de acceso en el código ni en logs.
• Encripta los datos: Si el contenido es sensible, habilita la encriptación en el bucket de S3.
• Control de acceso: Utiliza políticas de IAM que limiten el acceso solo a los buckets y prefijos necesarios.