# Stockage objet

> Stockez les fichiers de votre application dans des buckets compatibles S3, créés et sécurisés par Wakastart dans chaque environnement.

Le stockage objet de Wakastart fournit à votre application des [buckets](/v1.0/glossaire#bucket) compatibles S3 pour ses fichiers : documents envoyés par vos utilisateurs, exports, médias. Vous déclarez le bucket une fois dans l'architecture de l'application ; chaque environnement reçoit son propre bucket, avec un compte d'accès qui ne peut lire et écrire que dans ce bucket.

Les buckets sont hébergés sur OVHcloud Object Storage. Votre code y accède avec n'importe quel SDK S3.

## Comment ça marche

```mermaid
flowchart LR
  D["Déclaration<br/>Architecture › Dépendances<br/>onglet Stockage"]
  subgraph ENV["Environnement (ex. prod)"]
    B["Bucket OVHcloud<br/>onglet Storage"]
    U["Compte d'accès dédié<br/>limité à ce bucket"]
    C["Identifiants<br/>DOCS_ENDPOINT, DOCS_BUCKET…<br/>onglet Configuration"]
    S["Service<br/>variables S3_*"]
  end
  D -- "Provisionner" --> B
  B --> U
  U -- "statut Prêt" --> C
  C -- "liaison" --> S
```

1. Vous déclarez le bucket dans **Architecture › Dépendances**, onglet **Stockage (N)**, avec sa région.
2. Dans chaque environnement, vous le provisionnez depuis l'onglet **Storage**, ou Wakastart le crée pour vous si vous avez coché **Créer automatiquement les instances**.
3. Wakastart crée le bucket et un compte d'accès qui n'a de droits que sur lui.
4. Les six champs de connexion apparaissent dans l'onglet **Configuration** de l'environnement, filtre **Stockage**.
5. Vous reliez les variables de vos services à ces champs.

## Commencer

::::cards{cols=3}
:::card{title="Déclarer un bucket" href="/v1.0/stockage/declarer-un-bucket" icon="Layers"}
Ajouter un bucket à l'architecture de l'application.
:::
:::card{title="Provisionner un bucket" href="/v1.0/stockage/provisionner-un-bucket" icon="HardDrive"}
Créer le bucket réel dans un environnement.
:::
:::card{title="Connecter un service" href="/v1.0/stockage/connecter-un-service" icon="Cable"}
Lire et écrire des fichiers depuis votre code avec un SDK S3.
:::
::::

## Fonctionnalités

::::cards{cols=3}
:::card{title="Un compte par bucket" href="/v1.0/stockage/fonctionnement-d-un-bucket" icon="KeyRound"}
Des identifiants dédiés, limités aux objets du bucket, jamais affichés en clair.
:::
:::card{title="Explorateur en lecture seule" href="/v1.0/stockage/explorer-un-bucket" icon="FolderOpen"}
Parcourir les dossiers, lire les métadonnées et télécharger un fichier depuis la console.
:::
:::card{title="Sauvegardes" href="/v1.0/sauvegardes" icon="ArchiveRestore"}
Sauvegarder le contenu d'un bucket et le restaurer en place.
:::
::::

## Produits liés

::::cards{cols=3}
:::card{title="Bases de données" href="/v1.0/bases-de-donnees" icon="Database"}
Les données structurées de votre application.
:::
:::card{title="Variables et secrets" href="/v1.0/variables-et-secrets" icon="Lock"}
Relier les variables d'un service aux valeurs de l'environnement.
:::
:::card{title="Antivirus" href="/v1.0/antivirus" icon="ShieldAlert"}
Analyser les fichiers envoyés par vos utilisateurs avant de les stocker.
:::
::::

## Ressources

- [Référence des écrans et des champs](/v1.0/stockage/reference)
- [Résoudre les problèmes de stockage](/v1.0/stockage/depannage)
- [Limites et quotas](/v1.0/limites)
