Skip to main content
App Storage est le stockage d’objets intégré de Replit qui permet à votre application d’héberger et d’enregistrer facilement des téléversements tels que des images, des vidéos et des documents. Les buckets sont des conteneurs permettant de stocker des objets comme des fichiers. Ils incluent des politiques d’accès pour limiter les actions que les utilisateurs ou les applications peuvent effectuer sur leur contenu.
Object Storage s’appelle désormais App Storage.
Avec App Storage, vous pouvez créer des applications telles que :
  • Plateformes de partage de photos : Permettez aux créateurs de téléverser, stocker et afficher des images
  • Services de streaming vidéo : Gérez les téléversements de vidéos et distribuez le contenu aux spectateurs
  • Systèmes de gestion de documents : Stockez et organisez les fichiers des créateurs avec un accès sécurisé
  • Sites portfolio : Mettez en valeur votre travail avec des fichiers médias qui se chargent de manière fiable
  • Services de sauvegarde de fichiers : Offrez aux créateurs un stockage cloud pour leurs fichiers importants
Demandez à Agent d’ajouter App Storage à votre application en précisant les types de fichiers que votre application doit gérer. Agent configurera l’intégration, créera les buckets nécessaires et mettra à jour votre application pour téléverser, stocker et récupérer des fichiers avec des fonctionnalités avancées telles que l’authentification et les contrôles d’accès.
L’outil App Storage vous permet de partager des données entre les environnements de développement et de production d’une même application Replit. Chaque bucket appartient à un seul projet et ne peut pas être partagé entre plusieurs applications.

​
Fonctionnalités

App Storage est alimenté par Google Cloud Storage (GCS). Vous bénéficiez ainsi des avantages d’une disponibilité, d’une accessibilité et d’une sécurité de premier ordre.
App Storage fournit les fonctionnalités suivantes pour vos applications Replit :
  • Stockage cloud persistant : Stockez des fichiers qui restent accessibles à votre application publiée et à vos utilisateurs
  • Gestion de fichiers évolutive : Gérez des besoins de données croissants sans vous soucier des limites de stockage
  • Accès programmatique : Téléversez, téléchargez et gérez des fichiers à l’aide d’API intuitives
  • Intégration Agent améliorée : Laissez Agent configurer App Storage avec des configurations avancées, inspecter les configurations existantes et générer du code backend et frontend complet avec authentification et contrôles d’accès
Voici quelques façons d’utiliser App Storage dans vos applications Replit :
  • Stocker des photos de profil et des téléversements médias des créateurs
  • Servir des images de produits pour des sites e-commerce
  • Gérer les téléversements de documents pour les soumissions de formulaires
  • Créer des fonctionnalités de partage et de collaboration de fichiers
  • Construire des systèmes de gestion de contenu avec des bibliothèques médias
Intégration Agent améliorée : Vous pouvez demander à Replit Agent d’ajouter automatiquement App Storage à vos applications ! Agent peut désormais configurer le stockage d’objets, inspecter les configurations et générer du code backend et frontend complet avec des fonctionnalités avancées telles que l’authentification et les contrôles d’accès. Mentionnez simplement « App Storage » ou « stockage de fichiers » dans votre invite.En savoir plus sur les intégrations Agent et voir toutes les invites App Storage disponibles.

​
Utilisation

Votre application Replit doit s’authentifier auprès de Google Cloud Storage pour accéder à un bucket et à ses objets. Utilisez les bibliothèques clientes officielles Replit App Storage pour vous authentifier automatiquement.
Vous pouvez accéder à l’outil App Storage directement dans votre éditeur de projet.
Depuis l’onglet Tools :
  1. Sélectionnez Tools dans l’en-tête du volet.
  2. Sous Replit Cloud, sélectionnez Icône App Storage App Storage.
L'onglet Tools ouvert dans l'éditeur de projet, avec App Storage sélectionné sous Replit Cloud dans la barre latérale Tools
Depuis un nouvel onglet :
  1. Sélectionnez + dans la barre d’onglets.
  2. Tapez « App Storage » dans Search tools et sélectionnez-le dans les résultats.
Pour associer un nouveau bucket de stockage à votre application Replit, créez un bucket.
Depuis l’outil App Storage :
  1. Cliquez sur Create new bucket.
  2. Entrez un nom pour le bucket dans le champ Name et sélectionnez Create bucket.
L’onglet App Storage devrait ressembler à la capture d’écran suivante :
Un bucket App Storage vide dans la vue Objects, avec les commandes Upload files, Upload folder, Create folder, Search et Refresh au-dessus du message No objects
Pour créer des buckets supplémentaires, ouvrez le menu déroulant des buckets en haut à gauche de l’onglet App Storage et sélectionnez Create new bucket.
Les sections suivantes expliquent les options de gestion des buckets et des objets dans l’outil App Storage.

​
Sélectionner un bucket

Pour basculer entre les buckets de stockage de votre projet, sélectionnez le menu déroulant dans le coin supérieur gauche de l’onglet App Storage. Le bucket sélectionné affiche une coche à côté de son nom.

​
Accéder à l’identifiant du bucket

Pour afficher l’identifiant du bucket, sélectionnez la vue Settings depuis le menu déroulant en haut de l’onglet App Storage. L’identifiant du bucket identifie de façon unique le bucket, que votre code doit référencer pour effectuer une opération. Si vous avez plusieurs buckets, sélectionnez le bon bucket dans le menu déroulant en haut à gauche. La capture d’écran suivante montre l’identifiant du bucket pour le bucket « docs-demo-bucket » :
La vue Settings de l'outil App Storage affichant l'identifiant du bucket docs-demo-bucket

​
Téléverser ou télécharger des objets

Pour téléverser un objet dans le bucket sélectionné :
  1. Naviguez vers la vue Objects dans l’onglet App Storage.
  2. Sélectionnez icône téléverser fichier Upload files, ou icône téléverser dossier Upload folder pour téléverser tous les fichiers d’un dossier. Ensuite, sélectionnez un ou plusieurs fichiers à téléverser depuis la boîte de dialogue de fichiers. Vous pouvez également faire glisser un fichier ou un dossier dans la zone qui liste le contenu du bucket.
Pour télécharger un objet depuis le bucket sélectionné :
  1. Naviguez vers la vue Objects dans l’onglet App Storage.
  2. Sélectionnez l’icône icône télécharger de téléchargement à droite du fichier pour le télécharger.

​
Organiser les objets dans des dossiers

Pour créer un dossier dans le bucket sélectionné :
  1. Naviguez vers la vue Objects dans l’onglet App Storage.
  2. Sélectionnez icône créer dossier Create folder dans la vue Objects.
  3. Entrez un nom pour le dossier.
Pour ajouter des objets à un dossier dans la vue Objects, faites glisser un objet vers le dossier de destination. Pour déplacer un objet vers un dossier parent, faites-le glisser sur le nom de ce dossier dans le fil d’Ariane au-dessus de la liste d’objets. Par exemple, pour déplacer product_demo.mov du dossier videos vers la racine du bucket, faites-le glisser sur Objects dans le fil d’Ariane.

​
Supprimer des objets ou des buckets

La suppression est irréversible. Assurez-vous de sauvegarder toutes les données essentielles avant de continuer.
Pour supprimer définitivement un objet :
  1. Naviguez vers la vue Objects dans l’onglet App Storage.
  2. Sélectionnez l’icône icône corbeille de corbeille à côté de l’objet que vous souhaitez supprimer.
  3. Confirmez la suppression dans la boîte de dialogue de confirmation.
Pour supprimer un bucket et tous les objets qu’il contient :
  1. Naviguez vers la vue Settings dans l’onglet App Storage.
  2. Assurez-vous de sélectionner le bucket que vous souhaitez supprimer dans le menu déroulant des buckets en haut à gauche.
  3. Sélectionnez icône corbeille Delete Bucket.
  4. Confirmez la suppression dans la boîte de dialogue de confirmation.

​
Copier des extraits de code

La vue Commands affiche du code prêt à l’emploi pour les opérations courantes d’App Storage, comme le téléversement, le téléchargement, la liste et la suppression d’objets.
  1. Sélectionnez la vue Commands depuis le menu déroulant en haut de l’onglet App Storage.
  2. Sélectionnez JavaScript, Python ou All other languages.
  3. Si le paquet client App Storage n’est pas encore installé, sélectionnez Install package pour l’ajouter à votre projet.
  4. Copiez l’extrait correspondant à l’opération dont vous avez besoin.

​
Gestion des accès aux buckets

Chaque bucket App Storage est exclusif au projet dans lequel vous l’avez créé. Vous ne pouvez pas associer ce bucket à un autre projet, même si les deux projets appartiennent au même compte. Pour utiliser App Storage dans un autre projet, créez un bucket distinct dans l’outil App Storage de ce projet.

​
Accès programmatique à App Storage

Pour accéder à App Storage depuis votre application Replit, utilisez l’une des bibliothèques suivantes : Pour les instructions sur l’utilisation des bibliothèques clientes, consultez les ressources suivantes :

​
Accès et sécurité

​
Les buckets sont privés

Les buckets App Storage sont toujours privés ; l’outil App Storage n’a donc aucun paramètre de confidentialité. Replit crée chaque bucket avec la prévention de l’accès public de Google Cloud Storage activée. Cela bloque les lectures anonymes et rejette toute autorisation accordée à allUsers ou allAuthenticatedUsers.
Votre application contrôle qui peut accéder à vos fichiers. Toute personne disposant d’une URL signée peut l’utiliser jusqu’à son expiration, et toute route publique qui renvoie des fichiers stockés les expose. Ne délivrez des URL signées et ne servez des fichiers qu’aux utilisateurs que votre application a autorisés.

​
Autorisations et paramètres des buckets

Votre application peut téléverser, télécharger, lister et supprimer des objets dans ses propres buckets. Elle ne peut ni lire ni modifier les paramètres des buckets ; des appels comme storage.buckets.get ou storage.buckets.getIamPolicy renvoient donc 403 Forbidden. C’est le comportement attendu : ces autorisations ne sont pas disponibles pour les applications. App Storage ne prend pas en charge les règles de cycle de vie, le versionnage des objets ni les politiques de rétention. Pour nettoyer des fichiers temporaires, utilisez un déploiement planifié qui supprime les objets plus anciens qu’un âge défini.

​
Facturation et utilisation des ressources

Pour surveiller votre utilisation d’App Storage, ouvrez Utilisation. Pour en savoir plus sur la tarification d’App Storage, consultez la Facturation App Storage.