Aller au contenu

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.

Vous pouvez construire et déployer rapidement un site Astro vers de nombreux hébergeurs, via l’interface de leur site internet ou une CLI.

Une 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 :

  1. Ajoutez votre dépôt à un provider Git (ex. sur GitHub, GitLab, Bitbucket)

  2. 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.)

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

Certains 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 :

  1. Installez globalement la CLI de votre hébergeur, par exemple :

    Fenêtre de terminal
    npm install --global netlify-cli
  2. Exécutez la CLI et suivez les instructions de connexion, mise en place etc.

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

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

Fenêtre de terminal
npm run build

Par défaut, le dossier de build sera placé à dist/. Ce dossier peut être changé en utilisant l’option outDir.