# Déclarer un bucket dans l'architecture

> Ajoutez un bucket compatible S3 à l'architecture de votre application et, si vous le souhaitez, créez-le d'un coup dans tous les environnements existants.

La déclaration décrit le bucket une fois pour toute l'application : son nom, son identifiant court et sa région. Elle peut aussi créer immédiatement une instance du bucket dans chaque environnement existant.

## Avant de commencer

- Votre application existe et vous voyez l'entrée **Architecture** sous son nom, dans le menu latéral.
- Vous avez choisi la région : elle détermine où sont stockés les fichiers.

## Déclarer le bucket

::::steps
### Ouvrir l'onglet Stockage des dépendances

1. Dans le menu latéral, sous le nom de votre application, cliquez sur **Architecture**, puis sur **Dépendances**.
2. Cliquez sur l'onglet **Stockage (N)**.

### Créer la déclaration

Cliquez sur **Nouveau bucket**.

La page **Nouveau bucket de stockage** s'affiche.

### Nommer le bucket

1. Dans **Nom \***, saisissez un nom lisible, par exemple `Stockage documents`.
2. Vérifiez l'**Identifiant court \*** proposé, par exemple `stockage-doc`, et remplacez-le si besoin par un identifiant plus parlant, par exemple `docs`.

L'identifiant court compte 12 caractères au plus, commence par une lettre et ne contient que des minuscules, des chiffres et des tirets. Il nomme les variables du bucket (`DOCS_ENDPOINT`, `DOCS_BUCKET`…) et ne pourra plus être modifié.

### Choisir la région

Dans **Région par défaut**, choisissez **Gravelines (GRA)**, **Strasbourg (SBG)**, **Beauharnois (BHS)** ou **Varsovie (WAW)**.

Laissez les autres options à leur valeur par défaut.

### Choisir la création automatique

Optionnel : cochez **Créer automatiquement les instances** pour créer tout de suite le bucket dans chacun des environnements existants de l'application.

Sans cette case, vous provisionnerez le bucket environnement par environnement. Un environnement créé plus tard ne reçoit pas le bucket automatiquement.

### Enregistrer

Cliquez sur **Créer**.

Le message **Bucket créé** s'affiche et vous revenez sur la page **Dépendances**.
::::

## Vérifier le résultat

1. Dans l'onglet **Stockage (N)** de la page **Dépendances**, le bucket apparaît avec son **Nom**, son **Shortname** et sa **Région**.
2. Si vous avez coché la création automatique, ouvrez l'onglet **Storage** d'un environnement : le bucket y figure, en **En attente** puis **Provisionnement**, puis **Prêt**.

## Voir aussi

- [Provisionner un bucket dans un environnement](/v1.0/stockage/provisionner-un-bucket)
- [Fonctionnement d'un bucket](/v1.0/stockage/fonctionnement-d-un-bucket)
