Accueil
» Comment faire
»
Connectez un compartiment S3 à ownCloud 10 en tant que stockage externe.
Connectez un compartiment S3 à ownCloud 10 en tant que stockage externe.
Pour que les fichiers d'un compartiment Amazon S3 apparaissent dans ownCloud 10, ajoutez ce compartiment comme point de montage de stockage externe : un dossier visible dans ownCloud qui accède à un service de stockage externe en lecture et en écriture. À partir de la version 10.3 d'ownCloud, installez et activez l' files_external_s3application dédiée ainsi que la prise en charge du stockage externe ; puis ajoutez un point de montage Amazon S3 dans Paramètres > Administration > Stockage . Vous aurez besoin du nom du compartiment, de la clé d'accès, de la clé secrète et des informations de région ou de point de terminaison.
Cette illustration d'interface représente les deux lignes d'application activées nécessaires pour un montage S3 : la prise en charge du stockage externe et le backend Amazon S3 distinct.
Que faut-il préparer avant de configurer le support ?
S3 est un stockage objet : il stocke des objets nommés dans des compartiments plutôt que des fichiers sur le disque local du serveur. ownCloud présente le compartiment comme un dossier classique, mais ne le transforme pas en système de fichiers POSIX. Les étapes ci-dessous permettent de configurer un point de montage secondaire pour les fichiers utilisateur. Cette configuration est différente de celle consistant à configurer S3 comme stockage de données principal d'ownCloud, ce qui nécessite une application et une configuration distinctes.
Vérifiez la version d'ownCloud. Ces instructions concernent ownCloud Classic 10, la documentation 10.16 étant utilisée pour la configuration du stockage externe. Depuis la version 10.3, le stockage externe S3 n'est plus intégré à ownCloud. Installez une files_external_s3version compatible avec votre serveur depuis l'ownCloud Market ou via la méthode d'installation manuelle prise en charge, puis activez-la. Si l'option S3 est absente, consultez cette application avant de modifier la configuration du serveur. Consultez les notes de version d'ownCloud Server .
Obtenez les informations d'accès au bucket. Demandez à l'administrateur du bucket le nom exact de celui-ci, une clé d'accès, une clé secrète et la région du bucket. Ces identifiants doivent permettre les opérations nécessaires à vos utilisateurs, telles que l'affichage, le téléchargement, le chargement et la suppression d'objets. Utilisez des identifiants dédiés et limités à ce bucket si votre fournisseur le permet ; ne divulguez jamais une clé secrète dans un ticket ou un article.
Collectez les informations de point de terminaison pour les services compatibles. Si la cible est un service privé compatible S3 et non Amazon S3, obtenez son nom d'hôte, son port, sa région, ses exigences TLS et indiquez si des requêtes de type chemin sont nécessaires. Ces informations sont spécifiques au fournisseur. N'utilisez pas un point de terminaison AWS générique à la place d'un point de terminaison de stockage d'objets privé.
Choisissez qui peut voir le montage. Un montage créé par un administrateur est accessible à tous les utilisateurs par défaut. Vous pouvez limiter son accès à certains utilisateurs ou groupes dans la section « Disponible pour le contrôle ».
L'illustration du stockage d'administration met en évidence le contrôle Activer le stockage externe, qui doit être activé avant d'ajouter un montage.
Installez le backend et ajoutez le bucket.
Activez la prise en charge du stockage externe. Connectez-vous en tant qu'administrateur ownCloud. Ouvrez Paramètres > Applications , recherchez « Prise en charge du stockage externe » et activez-la si nécessaire. Ensuite, installez et activez l'application de stockage externe Amazon S3 ( files_external_s3si elle n'est pas déjà installée sur votre serveur). Les noms des applications et les options d'installation peuvent varier selon le package ; assurez-vous donc d'utiliser une version compatible avec votre version d'ownCloud.
Ouvrez les paramètres de stockage. Accédez à Paramètres > Administration > Stockage et assurez-vous que l'option « Activer le stockage externe » est sélectionnée. Le manuel d'ownCloud indique que cette condition préalable se trouve dans Paramètres > Applications et l'option d'activation dans Stockage.
Créez une ligne de montage. Dans la section « Stockage externe », sélectionnez « Amazon S3 » dans le sélecteur de type de stockage. Saisissez un nom de dossier court, par exempleTeamArchive ; il s'agit du dossier visible par les utilisateurs dans ownCloud, et non du nom du compartiment. Choisissez l'option d'authentification par clé d'accès, puis saisissez le nom du compartiment, la clé d'accès et la clé secrète dans les champs correspondants.
Configurez les options de connexion. Pour Amazon S3, saisissez la région réelle du compartiment lorsque vous y êtes invité. Laissez les valeurs par défaut pour le nom d'hôte et le port, sauf si vous devez les modifier. Pour un service compatible S3, saisissez le nom d'hôte, le port et la région du point de terminaison fournis par son administrateur. Sélectionnez « Activer SSL » pour utiliser HTTPS ; ownCloud recommande SSL. Désactivez l' option « Activer le style de chemin » pour une utilisation standard d'Amazon S3. ownCloud indique que les requêtes de type chemin sont généralement inutiles et incompatibles avec les centres de données Amazon récents, mais peuvent être nécessaires pour les services non Amazon dont le DNS ne peut pas acheminer les noms de compartiment en tant que sous-domaines. Le manuel d'ownCloud 10.16 décrit la procédure de montage générale ; les options détaillées spécifiques au fournisseur se trouvent dans la documentation de référence du backend Amazon S3 d'ownCloud 11.0 . Les libellés des champs peuvent donc varier selon la version de l'application. Vérifiez les exigences spécifiques aux services non AWS auprès de votre fournisseur.
Limitez l'accès et enregistrez. Dans « Disponible pour » , choisissez les utilisateurs ou groupes autorisés à utiliser le montage. Les montages d'administration sont globaux par défaut ; restreignez donc l'accès si le bucket n'est pas destiné à tous. ownCloud enregistre le montage une fois les champs obligatoires renseignés. Les champs affichés dépendent du backend et de la méthode d'authentification sélectionnés.
Le formulaire d'exemple illustre que le nom du dossier visible diffère du nom du compartiment et masque la clé secrète.
Consultez l'état et résolvez les problèmes de connexion.
Consultez l'icône d'état à côté du point de montage. Le guide de configuration du stockage externe d'ownCloud indique qu'un point vert signifie que le stockage est prêt ; un indicateur rouge ou jaune signifie qu'il n'a pas pu se connecter. Corrigez les informations de connexion de base avant de modifier les autorisations ou de supprimer et recréer le point de montage.
L'option Amazon S3 n'est pas disponible : vérifiez que la prise en charge du stockage externe files_external_s3est installée et activée. Sur ownCloud 10.3 et versions ultérieures, cette dernière est distincte de l'application de support intégrée.
Statut rouge ou jaune : vérifiez l’orthographe du nom du compartiment, la paire de clés d’accès, la région, le nom d’hôte du point de terminaison et le port. Assurez-vous que le serveur ownCloud peut accéder au point de terminaison et que les certificats TLS sont approuvés. Pour un certificat auto-signé, ownCloud exige son importation avant utilisation du montage.
La connexion réussit, mais les utilisateurs ne peuvent pas l'utiliser : vérifiez la disponibilité et assurez-vous que les informations d'identification du compartiment autorisent les opérations sur l'objet demandées. Un indicateur de connexion fonctionnel n'accorde pas d'autorisations aux utilisateurs exclus du montage.
Les fichiers ajoutés directement dans le bucket n'apparaissent pas : la documentation de la version 10.16 indique occ files:scanqu'il est impossible de réanalyser S3 ou les systèmes de fichiers compatibles. Les modifications effectuées via ownCloud sont prises en compte par le montage ; les objets ajoutés ou modifiés en externe peuvent ne pas être détectés de manière fiable. Évitez d'utiliser une analyse manuelle des fichiers comme étape de réparation S3.
Lorsqu'ownCloud signale un montage défaillant comme indisponible, le guide de configuration indique qu'il peut rester indisponible pendant dix minutes. Cliquez sur l'indicateur d'état coloré ou rechargez la page d'administration pour vérifier à nouveau après avoir corrigé la cause du problème. Ne supprimez et ne recréez pas un montage de production sans précaution : la modification ou la suppression d'une configuration de stockage externe peut laisser d'anciennes métadonnées dans la base de données d'ownCloud.
L'illustration finale de l'interface associe un statut « Disponible » à un exemple de fichier visible dans le dossier monté.
Vérifiez le montage avec un petit test
Ouvrez la vue Fichiers ownCloud avec un compte figurant dans la liste des comptes disponibles . Vérifiez que le dossier de montage apparaît, chargez un fichier de test sans danger, ouvrez-le ou téléchargez-le, puis supprimez-le via ownCloud. Si l'opération est autorisée, vérifiez que le même fichier est présent dans le bucket. Cette procédure vérifie la visibilité et l'accès en écriture ; un statut de connexion vert confirme uniquement qu'ownCloud peut se connecter au stockage configuré.