Documentation · Cadriciels

Déployer Astro.

Les sites Astro statiques se déploient tels quels. Le rendu serveur exige un seul changement de configuration : l’adaptateur Node.

Sortie statique (par défaut)

Un projet Astro par défaut (output: 'static') compile vers dist/ et Canner le sert directement. Poussez le dépôt ou déposez le dossier — terminé.

Le rendu serveur exige l’adaptateur Node

Pour le SSR (output: 'server' ou le prérendu par route), Astro exige un adaptateur de déploiement. Sur Canner, c’est @astrojs/node en mode autonome :

// astro.config.mjs
import { defineConfig } from 'astro/config';
import node from '@astrojs/node';

export default defineConfig({
  output: 'server',
  adapter: node({ mode: 'standalone' }),
});

npx astro add node s’occupe de la dépendance, ou ajoutez-la manuellement et redéployez.

Les adaptateurs Vercel/Netlify sont rejetés à dessein. Si votre configuration contient @astrojs/vercel ou @astrojs/netlify, le build échoue avec un message clair plutôt que de déployer quelque chose de cassé — ces adaptateurs produisent une sortie propre à leur plateforme qui ne peut pas s’exécuter comme un serveur normal. Passez à l’adaptateur Node et redéployez.

Bon à savoir

  • Astro en SSR se marie bien avec la mise en cache par étiquette — l’assistant @canner-ca/astro-cache tient en une ligne par page.
  • Les variables d’environnement sont disponibles au build et à l’exécution; celles côté client suivent la règle du préfixe PUBLIC_ d’Astro.
  • Routage i18n, collections de contenu et transitions de vue fonctionnent — aucun comportement propre à la plateforme à prévoir.