Aller au contenu

Déployer votre site Astro

Prêt à compiler et déployer votre site Astro ? Suivez l’un de nos guides sur les différents services de déploiement, ou faites défiler vers le bas pour avoir des conseils généraux sur comment le déploiement d’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 rapide

Vous pouvez compiler et déployer rapidement un site Astro vers de nombreux hébergeurs à l’aide de l’interface utilisateur du tableau de bord de leur site web ou d’une CLI.

Interface utilisateur du site web

Titre de la section Interface utilisateur du site web

Une façon rapide de déployer votre site web est de connecter le dépôt Git (p. 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, compilent votre site et le déploient sur le web sur une URL personnalisée ou sur votre nom de domaine personnel. Souvent, la configuration d’un déploiement sur ces plateformes suivra des étapes similaires à celles-ci :

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

  2. Choisissez un hébergeur qui supporte le déploiement continu (p. 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 compiler 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 web sera créé avec une URL unique (p. ex. nouveau-site-astro.netlify.app).

L’hébergeur sera automatiquement configuré pour surveiller les modifications apportées à la branche principale de votre fournisseur Git, et pour recompiler et republier votre site à chaque nouveau commit. Ces paramètres peuvent généralement être configurés dans l’interface utilisateur du tableau de bord de votre hébergeur.

Déploiement via une CLI

Titre de la section Déploiement via une CLI

Certains hébergeurs proposent leur propre interface en 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 du terminal
    npm install --global netlify-cli

  2. Exécutez la CLI et suivez les instructions de connexion, mise en place etc.

  3. Compilez 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 compiler 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 compiler votre site localement et déployer en utilisant la CLI.

Compiler votre site localement

Titre de la section Compiler votre site localement

De nombreux hébergeurs comme Netlify ou Vercel vont compiler votre site pour vous puis le publier. Mais, certains sites vous demanderont de compiler localement puis d’exécuter une commande de déploiement.

Vous souhaiterez peut-être également compiler votre site localement pour le prévisualiser ou pour détecter d’éventuelles erreurs et avertissement dans votre propre environnement.

Exécutez la commande npm run build pour compiler votre site Astro.

Fenêtre du terminal
npm run build

Par défaut, la sortie de compilation sera placée dans dist/. Ce dossier peut être modifié en utilisant l’option de configuration outDir.

Ajouter un adaptateur pour le rendu à la demande

Titre de la section Ajouter un adaptateur pour le rendu à la demande
Contribuer Communauté Parrainer