> Discover all available pages from the documentation index: https://mastra.zisheng.pro/fr/llms.txt

# Déployer Mastra sur Cloudflare

Utilisez `@mastra/deployer-cloudflare` pour déployer votre serveur Mastra sur Cloudflare Workers. Le déployeur regroupe votre code et génère un fichier `wrangler.jsonc` conforme à la [configuration de wrangler](https://developers.cloudflare.com/workers/wrangler/configuration/) de Cloudflare, prêt à être déployé sans configuration supplémentaire.

> **Info:** Si vous utilisez un [adaptateur de serveur](https://mastra.zisheng.pro/fr/docs/server/server-adapters) ou un [framework web](https://mastra.zisheng.pro/fr/docs/deployment/web-framework), déployez votre application comme vous le feriez habituellement avec ce framework.

## Avant de commencer

Vous aurez besoin d’une [application Mastra](https://mastra.zisheng.pro/fr/guides/getting-started/quickstart) et d’un compte [Cloudflare](https://cloudflare.com/).

> **Attention:** Cloudflare Workers utilise un système de fichiers éphémère ; tout stockage que vous configurez, y compris celui d’observabilité, doit donc être hébergé à l’extérieur. Si vous utilisez [LibSQLStore](https://mastra.zisheng.pro/fr/reference/storage/libsql) avec une URL de fichier, passez à une base de données hébergée à distance.

## Installation

Ajoutez le package `@mastra/deployer-cloudflare` à votre projet :

**npm**:

```bash
npm install @mastra/deployer-cloudflare@latest
```

**pnpm**:

```bash
pnpm add @mastra/deployer-cloudflare@latest
```

**Yarn**:

```bash
yarn add @mastra/deployer-cloudflare@latest
```

**Bun**:

```bash
bun add @mastra/deployer-cloudflare@latest
```

Importez [`CloudflareDeployer`](https://mastra.zisheng.pro/fr/reference/deployer/cloudflare) et définissez-le comme déployeur dans votre configuration Mastra :

```typescript
import { Mastra } from '@mastra/core'
import { CloudflareDeployer } from '@mastra/deployer-cloudflare'

export const mastra = new Mastra({
  deployer: new CloudflareDeployer({
    name: 'your-project-name',
    vars: {
      NODE_ENV: 'production',
    },
  }),
})
```

Pour tester votre Cloudflare Worker localement, installez également la [CLI `wrangler`](https://developers.cloudflare.com/workers/wrangler/install-and-update/) :

**npm**:

```bash
npm install -D wrangler
```

**pnpm**:

```bash
pnpm add -D wrangler
```

**Yarn**:

```bash
yarn add --dev wrangler
```

**Bun**:

```bash
bun add --dev wrangler
```

## Utilisation

Après avoir configuré votre projet, poussez-le vers le fournisseur Git distant de votre choix, par exemple GitHub.

1. Connectez votre dépôt à Cloudflare. Dans le tableau de bord « Workers & Pages », sélectionnez **Create application**, puis choisissez votre fournisseur Git à l’étape suivante. Poursuivez le processus de configuration et sélectionnez le dépôt que vous souhaitez déployer.

   > **Remarque:** N’oubliez pas de définir les variables d’environnement nécessaires à l’exécution de votre application, par exemple la clé API de votre [fournisseur de modèles](https://mastra.zisheng.pro/fr/models/providers). Vous pouvez importer des secrets depuis votre fichier `.env` avec `npx wrangler secret bulk .env`. Consultez [Secrets](https://mastra.zisheng.pro/fr/reference/deployer/cloudflare) pour plus de détails.

2. Lorsque vous êtes prêt, cliquez sur le bouton **Deploy** et attendez que le premier déploiement se termine.

3. Testez votre fonction fraîchement déployée en accédant à `https://<your-project-name>.<slug>.workers.dev/api/agents`. Vous devriez obtenir une réponse JSON qui répertorie tous les Agents disponibles.

   Puisque le [serveur Mastra](https://mastra.zisheng.pro/fr/docs/server/mastra-server) préfixe chaque endpoint API par `/api`, vous devez l’ajouter à vos URL lorsque vous effectuez des requêtes.

4. Vous pouvez maintenant appeler vos endpoints Mastra via HTTP.

   > **Remarque:** Configurez l’[authentification](https://mastra.zisheng.pro/fr/docs/server/auth) avant d’exposer publiquement vos endpoints.