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.
Guide de déploiement
Titre de la section Guide de déploiement
Options 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.)
-
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 :
Fenêtre du terminal npm install --global netlify-cliFenêtre du terminal pnpm add --global netlify-cliFenêtre du terminal yarn global add netlify-cli -
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.)
D’autres hébergeurs vont vous demander de construire votre site localement et déployer en utilisant la CLI.
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.
npm run buildpnpm run buildyarn run buildPar défaut, le dossier de build sera placé à dist/. Ce dossier peut être changé en utilisant l’option outDir.