Déployer votre Site Astro
Prêt à construire et déployer votre site Astro ? Suivez un de nos guides sur différents services de déploiement, ou scrollez plus bas pour avoir des orientations générales sur comment déployer un site Astro.
Guides de déploiement
Filtrer par type de déploiementOptions de déploiement rapide
Titre de la section Options de déploiement rapideVous pouvez construire et déployer rapidement un site Astro vers de nombreux hébergeurs, via l’interface de leur site internet ou une CLI.
Interface d’un hébergeur
Titre de la section Interface d’un hébergeurUne façon rapide de déployer votre site internet est de connecter le dépôt Git (ex. GitHub, GitLab, Bitbucket) de votre projet Astro à un hébergeur, afin de profiter du déploiement continu en utilisant Git.
Ces hébergeurs détectent automatiquement les push sur le dépôt de votre projet Astro, build votre site et le déploient sur le web sur une URL personnalisée ou sur votre nom de domaine personnel. La plupart du temps, mettre en place le déploiement sur ces plateformes suivra les étapes suivantes :
-
Ajoutez votre dépôt à un provider Git (ex. sur GitHub, GitLab, Bitbucket)
-
Choisissez un hébergeur qui supporte le déploiement continu (ex. Netlify ou Vercel) et importez votre dépôt Git en tant que nouveau projet / site.
De nombreux hébergeurs vont reconnaître votre projet en tant que site Astro, et devraient automatiquement appliquer la configuration appropriée pour construire et déployer votre site comme montré ci-dessous. (Dans le cas contraire, ces paramètres peuvent être modifiés.)
- Commande de build:
astro build
ounpm run build
- Dossier de publication:
dist
- Commande de build:
-
Cliquez sur “Déployer” et votre nouveau site internet sera créé avec une URL unique (ex.
new-astro-site.netlify.app
).
L’hébergeur va automatiquement inspecter votre branche main de votre dépôt, et dès que des changements seront détectés, va reconstruire et republier votre site. Ces paramètres peuvent typiquement être modifiés dans l’interface de votre hébergeur.
Déploiement via une CLI
Titre de la section Déploiement via une CLICertains hébergeurs proposent leur propre interface de ligne de commande (CLI) que vous pouvez installer globalement sur votre machine en utilisant npm. Souvent, utiliser une CLI pour déployer ressemble à ceci :
-
Installez globalement la CLI de votre hébergeur, par exemple :
-
Exécutez la CLI et suivez les instructions de connexion, mise en place etc.
-
Construisez votre site et déployez-le sur votre hébergeur
De nombreux hébergeurs vont reconnaître votre projet en tant que site Astro, et devraient automatiquement appliquer la configuration appropriée pour construire et déployer votre site comme montré ci-dessous. (Dans le cas contraire, ces paramètres peuvent être modifiés.)
- Commande de build:
astro build
ounpm run build
- Dossier de publication:
dist
D’autres hébergeurs vont vous demander de construire votre site localement et déployer en utilisant la CLI.
- Commande de build:
Construire votre site localement
Titre de la section Construire votre site localementDe nombreux hébergeurs comme Netlify ou Vercel vont construire votre site pour vous puis le publier. Mais, certains sites vous demanderont de construire localement puis d’exécuter une commande de déploiement.
Vous pouvez aussi vouloir construire votre site localement pour le prévisualiser, ou détecter des potentielles erreurs et avertissement dans votre propre environnement.
Exécutez la commande npm run build
pour construire votre site Astro.
Par défaut, le dossier de build sera placé à dist/
. Ce dossier peut être changé en utilisant l’option outDir
(EN).
Ajouter un Adapteur pour du SSR
Titre de la section Ajouter un Adapteur pour du SSRAvant de déployer votre site Astro avec du SSR (server-side rendering) (EN) activé, vérifiez que vous avez :
- Installé l’adapteur approprié (EN) en tant que dépendance de votre projet (que ça soit manuellement, ou en utilisant la commande de l’adapteur
astro add
, ex.npx astro add netlify
). - Ajouté l’adapteur (EN) à votre fichier
astro.config.mjs
si vous installez manuellement. (La commandeastro add
fera cette étape automatiquement !)