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-cachetient 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.