Aller au contenu principal

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 de Cloudflare, prêt à être déployé sans configuration supplémentaire.

info

Si vous utilisez un adaptateur de serveur ou un framework web, déployez votre application comme vous le feriez habituellement avec ce framework.

Avant de commencer
Lien direct vers Avant de commencer

Vous aurez besoin d’une application Mastra et d’un compte Cloudflare.

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 avec une URL de fichier, passez à une base de données hébergée à distance.

Installation
Lien direct vers Installation

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

npm install @mastra/deployer-cloudflare@latest

Importez CloudflareDeployer et définissez-le comme déployeur dans votre configuration Mastra :

src/mastra/index.ts
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 :

npm install -D wrangler

Utilisation
Lien direct vers 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. Vous pouvez importer des secrets depuis votre fichier .env avec npx wrangler secret bulk .env. Consultez Secrets 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 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 avant d’exposer publiquement vos endpoints.

On this page