# colis avec Wasabi

> Livrez vos fichiers à vos clients depuis un bucket Wasabi avec colis : la configuration createBucket(), le fichier de départ de la CLI, et ce qu’il faut savoir sur ce fournisseur.

Canonical: https://colis-site.vercel.app/providers/wasabi · Markdown: https://colis-site.vercel.app/providers/wasabi.md · English: https://colis-site.vercel.app/en/providers/wasabi

Compatible S3, sur un endpoint régional.

**createBucket()**
```ts
import { createBucket } from '@colis/core'

const store = createBucket({
  bucket: 'transfers',
  region: 'eu-central-1',
  endpoint: 'https://s3.eu-central-1.wasabisys.com',
  credentials: {
    accessKeyId: process.env.WASABI_ACCESS_KEY!,
    secretAccessKey: process.env.WASABI_SECRET_KEY!,
  },
})
```

## Pourquoi celui-ci
Wasabi est compatible S3 et joignable via un endpoint régional. Il fonctionne avec colis comme tout autre fournisseur à endpoint : définissez l’endpoint et la région, et donnez-lui une paire de clés.

## Un fichier de départ, et ce qu’il reste à faire.
init écrit le fichier avec des références ${VAR} plutôt que des secrets : il est fait pour être versionné ; le fichier d’environnement qu’il désigne, non.

```sh
colis init --provider wasabi --bucket transfers
```
**colis.config.json**
```json
{
  "bucket": "transfers",
  "region": "eu-central-1",
  "endpoint": "https://s3.eu-central-1.wasabisys.com",
  "prefix": "transfers",
  "expiresIn": "24h",
  "envFile": ".env",
  "credentials": {
    "accessKeyId": "${WASABI_ACCESS_KEY}",
    "secretAccessKey": "${WASABI_SECRET_KEY}"
  }
}
```

### Ensuite
1. Mettez WASABI_ACCESS_KEY et WASABI_SECRET_KEY dans .env.
2. Ajoutez une règle de cycle de vie sur le préfixe.
3. Lancez `colis verifier`. Il effectue les opérations dont colis a besoin et rapporte ce qui s’est passé.

## Notes sur Wasabi.
- **Lisez les conditions de stockage** — La durée pendant laquelle un objet supprimé reste facturé dépend des conditions du fournisseur. Les colis vivent peu de temps par nature : vérifiez-les avant de compter sur des durées courtes.
- **Nettoyage des expirés** — L’expiration empêche un colis d’être remis ; seule une règle de cycle de vie supprime l’objet. Donnez au préfixe une règle qui expire les objets après un jour ou deux, et colis verifier passe au vert.

[Le guide complet](https://colis-docs.vercel.app/docs/stockages)