Almacenamiento de archivos: S3 (Pro)

Introducción

Sobre la base del complemento de gestión de archivos, se añade compatibilidad con tipos de almacenamiento de archivos compatibles con el protocolo S3. Cualquier servicio de almacenamiento de objetos compatible con el protocolo S3 puede integrarse fácilmente, como Amazon S3, Alibaba Cloud OSS, Tencent Cloud COS, MinIO y Cloudflare R2, lo que mejora aún más la compatibilidad y flexibilidad del servicio de almacenamiento.

Características

Carga desde el cliente: el proceso de carga de archivos no necesita pasar por el servidor de NocoBase, sino que se conecta directamente al servicio de almacenamiento de archivos para ofrecer una experiencia de carga más eficiente y rápida.
Acceso privado: al acceder a los archivos, todas las URL son direcciones temporales autorizadas mediante firma, lo que garantiza la seguridad y vigencia del acceso a los archivos.

Casos de uso

Gestión mediante tabla de archivos: gestiona y almacena de forma centralizada todos los archivos cargados. Admite varios tipos de archivos y métodos de almacenamiento, lo que facilita su clasificación y búsqueda.
Almacenamiento en campos de adjuntos: almacena los datos de los archivos adjuntos cargados en formularios o registros, con compatibilidad para asociarlos a registros de datos específicos.

Configuración del complemento

Habilita el complemento plugin-file-storage-s3-pro
Haz clic en "Setting-> FileManager" para acceder a la configuración de gestión de archivos
Haz clic en el botón "Add new" y selecciona "S3 Pro"

Después de que aparezca la ventana emergente, verás que hay muchos campos que completar. Puedes consultar la documentación siguiente para obtener la información de los parámetros correspondientes de cada servicio de archivos y rellenarlos correctamente en el formulario.

Configuración de proveedores de servicios

Amazon S3

Creación de un bucket

Abre https://ap-southeast-1.console.aws.amazon.com/s3/home para acceder a la consola de S3
Haz clic en el botón "Create bucket" situado a la derecha

Completa Bucket Name (nombre del bucket). Los demás campos pueden mantener la configuración predeterminada. Desplázate hasta la parte inferior de la página y haz clic en el botón "Create" para finalizar la creación.

Configuración de CORS

Accede a la lista de buckets, busca el bucket que acabas de crear y haz clic en él para acceder a su página de detalles

Haz clic en la pestaña "Permission" y desplázate hacia abajo hasta encontrar la sección de configuración de CORS

Introduce la siguiente configuración (puedes personalizarla con mayor detalle) y guárdala

[
    {
        "AllowedHeaders": [
            "*"
        ],
        "AllowedMethods": [
            "POST",
            "PUT"
        ],
        "AllowedOrigins": [
            "*"
        ],
        "ExposeHeaders": [
            "ETag"
        ],
        "MaxAgeSeconds": 3000
    }
]

Cómo obtener AccessKey y SecretAccessKey

Haz clic en el botón "Security credentials" situado en la esquina superior derecha de la página

Desplázate hacia abajo, busca la sección "Access Keys" y haz clic en el botón "Create Access Key".

Haz clic en Aceptar (esta demostración utiliza la cuenta principal; en entornos de producción se recomienda utilizar IAM).

Guarda el Access key y el Secret access key que aparecen en la página

Obtención y configuración de parámetros

AccessKey ID y AccessKey Secret son los valores correspondientes obtenidos en el paso anterior. Introdúcelos correctamente
Accede al panel de propiedades de la página de detalles del bucket, donde podrás obtener el nombre del bucket y la información de Region (región).

Acceso público (opcional)

Esta configuración no es obligatoria. Configúrala cuando necesites que los archivos cargados sean completamente públicos

Accede al panel Permissions, desplázate hacia abajo hasta Object Ownership, haz clic en Edit y habilita ACLs

Desplázate hasta Block public access, haz clic en Edit y configúralo para permitir el control mediante ACLs

Marca Public access en NocoBase

Configuración de miniaturas (opcional)

Esta configuración es opcional y se utiliza para optimizar el tamaño o la calidad de la vista previa de las imágenes. Ten en cuenta que esta solución de implementación puede generar costes adicionales. Consulta las condiciones correspondientes de AWS para conocer los costes específicos.

Accede a Dynamic Image Transformation for Amazon CloudFront.
Haz clic en el botón Launch in the AWS Console situado en la parte inferior de la página para comenzar a implementar la solución.
Sigue las indicaciones para completar la configuración. Presta especial atención a las siguientes opciones:
1. Al crear la pila, debes especificar el nombre de un bucket de Amazon S3 que contenga las imágenes originales. Introduce el nombre del bucket que creaste anteriormente.
2. Si eliges implementar la interfaz de demostración, podrás probar las funciones de procesamiento de imágenes desde ella una vez finalizada la implementación. En la consola de AWS CloudFormation, selecciona la pila, accede a la pestaña “Outputs”, busca el valor correspondiente a la clave DemoUrl y haz clic en el enlace para abrir la interfaz de demostración.
3. Esta solución utiliza la biblioteca sharp de Node.js para procesar imágenes de forma eficiente. Puedes descargar el código fuente desde el repositorio de GitHub y personalizarlo según tus necesidades.
Una vez completada la configuración, espera hasta que el estado de implementación cambie a CREATE_COMPLETE.
En la configuración de NocoBase, ten en cuenta lo siguiente:
1. Thumbnail rule: introduce los parámetros relacionados con el procesamiento de imágenes, como ?width=100. Consulta la documentación de AWS para obtener más información.
2. Access endpoint: introduce el valor de Outputs -> ApiEndpoint después de la implementación.
3. Full access URL style: marca Ignore (dado que el nombre del bucket ya se ha introducido durante la configuración, no es necesario especificarlo de nuevo al acceder).

Ejemplo de configuración