Stockage de fichiers : S3 (Pro)

Stockage de fichiers : S3 (Pro)Professional Edition+

Introduction

En complément du plugin de gestion de fichiers, cette version ajoute la prise en charge des types de stockage de fichiers compatibles avec le protocole S3. Tout service de stockage d'objets prenant en charge le protocole S3 peut être intégré facilement, comme Amazon S3, Alibaba Cloud OSS, Tencent Cloud COS, MinIO, Cloudflare R2, etc., ce qui améliore la compatibilité et la flexibilité des services de stockage.

Fonctionnalités

Téléchargement direct depuis le client : Les fichiers sont téléchargés directement vers le service de stockage sans passer par le serveur NocoBase, offrant ainsi une expérience de téléchargement plus efficace et plus rapide.
Accès privé : Toutes les URL de fichiers sont des adresses d'autorisation temporaires signées, garantissant un accès sécurisé et limité dans le temps aux fichiers.

Cas d'utilisation

Gestion des collections de fichiers : Gérez et stockez de manière centralisée tous les fichiers téléchargés, en prenant en charge divers types de fichiers et méthodes de stockage pour faciliter leur classification et leur récupération.
Stockage des champs de pièce jointe : Stockez les pièces jointes téléchargées via des formulaires ou des enregistrements, et associez-les à des entrées de données spécifiques.

Configuration du plugin

Activez le plugin plugin-file-storage-s3-pro.
Accédez à "Paramètres -> Gestionnaire de fichiers" pour configurer la gestion des fichiers.
Cliquez sur le bouton "Ajouter" et sélectionnez "S3 Pro".

Dans la fenêtre contextuelle, vous verrez un formulaire détaillé à remplir. Consultez la documentation suivante pour obtenir les paramètres pertinents de votre service de fichiers et saisissez-les correctement dans le formulaire.

Configuration du fournisseur de services

Amazon S3

Création d'un bucket

Rendez-vous sur la console Amazon S3.
Cliquez sur le bouton "Create bucket" (Créer un bucket) sur le côté droit.

Saisissez le nom du bucket (Nom du compartiment), laissez les autres champs par défaut, faites défiler jusqu'en bas et cliquez sur le bouton "Create" (Créer) pour finaliser la création.

Configuration CORS

Dans la liste des buckets, trouvez et cliquez sur le bucket que vous venez de créer pour accéder à ses détails.

Accédez à l'onglet "Permissions" (Autorisations) et faites défiler jusqu'à la section de configuration CORS.

Saisissez la configuration suivante (personnalisez si nécessaire) et enregistrez.

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

Récupération de l'AccessKey et du SecretAccessKey

Cliquez sur le bouton "Security credentials" (Identifiants de sécurité) dans le coin supérieur droit.

Faites défiler jusqu'à la section "Access Keys" (Clés d'accès) et cliquez sur "Create Access Key" (Créer une clé d'accès).

Acceptez les conditions (l'utilisation d'IAM est recommandée pour les environnements de production).

Enregistrez l'Access Key et le Secret Access Key affichés sur la page.

Récupération et configuration des paramètres

Utilisez l'AccessKey ID et le Secret AccessKey que vous avez récupérés lors de l'étape précédente.
Accédez au panneau des propriétés du bucket pour trouver le nom du bucket et la région.

Accès public (facultatif)

Cette configuration est facultative. Configurez-la si vous souhaitez rendre les fichiers téléchargés entièrement publics.

Dans le panneau "Permissions" (Autorisations), faites défiler jusqu'à "Object Ownership" (Propriété des objets), cliquez sur "Modifier" et activez les ACL.

Faites défiler jusqu'à "Block public access" (Bloquer l'accès public), cliquez sur "Modifier" et configurez-le pour autoriser le contrôle des ACL.

Cochez "Accès public" dans NocoBase.

Configuration des miniatures (facultatif)

Cette configuration est facultative et doit être utilisée lorsque vous avez besoin d'optimiser la taille ou l'effet de l'aperçu de l'image. Veuillez noter que ce déploiement peut entraîner des coûts supplémentaires. Pour plus de détails, veuillez consulter les conditions et tarifs d'AWS.

Rendez-vous sur Dynamic Image Transformation for Amazon CloudFront.
Cliquez sur le bouton Launch in the AWS Console (Lancer dans la console AWS) en bas de la page pour démarrer le déploiement.
Suivez les invites pour compléter la configuration. Les options suivantes nécessitent une attention particulière :
1. Lors de la création de la pile, vous devrez spécifier le nom du bucket Amazon S3 qui contient les images source. Veuillez saisir le nom du bucket que vous avez créé précédemment.
2. Si vous avez choisi de déployer l'interface utilisateur de démonstration, vous pourrez l'utiliser après le déploiement pour tester la fonctionnalité de traitement d'image. Dans la console AWS CloudFormation, sélectionnez votre pile, accédez à l'onglet "Outputs" (Sorties), trouvez la valeur correspondant à la clé DemoUrl et cliquez sur le lien pour ouvrir l'interface de démonstration.
3. Cette solution utilise la bibliothèque Node.js sharp pour un traitement efficace des images. Vous pouvez télécharger le code source depuis le dépôt GitHub et le personnaliser selon vos besoins.
Une fois la configuration terminée, attendez que l'état du déploiement passe à CREATE_COMPLETE.
Dans la configuration NocoBase, veuillez noter les points suivants :
1. Thumbnail rule (Règle de miniature) : Saisissez les paramètres de traitement d'image, par exemple ?width=100. Pour plus de détails, consultez la documentation AWS.
2. Access endpoint (Point d'accès) : Saisissez la valeur de Outputs -> ApiEndpoint après le déploiement.
3. Full access URL style (Style d'URL d'accès complet) : Cochez Ignorer (car le nom du bucket a déjà été renseigné lors de la configuration et n'est plus nécessaire pour l'accès).

Exemple de configuration