Diagramme expliquant l'organisation de la JAMSTACK

Déployer votre site web moderne pour moins de 10 euros !

Avec les services de Netlify, le déploiement n'a jamais été aussi simple.

Avec les services de Netlify, le déploiement n’a jamais été aussi simple.

Compiler et pousser les modifications sur GitHub

Maintenant que le contenu est prêt :

  1. Lancer le terminal avec CTRL+ùdans Visual Studio Code, s’il n’est pas déjà ouvert.
  2. Lancer la commande suivante :
1
npm run docs:build
  1. Si vous avez une erreur, contactez-moi en fournissant l’URL du dépôt. Sinon, continuez avec :
1
git add -A && git commit "pousser le contenu sur GitHub" && git push

Commande du domaine personnalisé

Sauf si vous avez besoin de mon aide, le seul coût sera celui du domaine personnalisé. Ex : mon-super-domaine.fr.

Je ne décris pas les étapes ici. Je vous invite à faire une petite recherche Google. Pour mes sites web, j’utilise OVH.

Mettre à jour la zone DNS chez votre registar de domaines.

Une fois que le domaine est provisionné, il faut paramétrer Netlify pour que le site web pointe sur le domaine.

Pour un domaine de base, il faut préalable supprimer les entrées DNS Asur le domaine mon-super-domaine.fret wwww.mon-super-domaine.fr.

Sur OVH…

J’ai eu une fois un temps de propagation de la suppression de l’entrée Asur le sous-domaine www qui a pris plus des dizaines de minutes.

Soyez patients ;)

Déployer le site sur Netlify

Rendez-vous sur app.netlify.com en vous connectant avec votre compte GitHub.

Connexion netlify via github SSO. Crédits: image extraite du site Netlify

Vous devez alors autoriser l’accès à votre compte par Netlify (pour lire la liste des dépôts).

Une fois connecté, sélectionnez Add new site puis Import an existing project :

Ajouter un site. Crédits: image extraite du site Netlify

Sélectionnez GitHub :

Sélectionner GitHub. Crédits: image extraite du site Netlify

Rechercher et sélectionner votre dépôt :

Rechercher et sélectionner votre dépôt. Crédits: image extraite du site Netlify

Configurez le déploiement en modifiant :

  • Base directory par docs/.vuepress.
  • Build command par yarn && npm run docs:build.
  • Publish directory en ajouter dist à la valeur.

Configurer le déploiement. Crédits: image extraite du site Netlify

Le déploiement ne devrait pas prendre plus de 2 minutes.

En attendant, allez dans Site settings et cliquez Change site name.

La valeur par défaut est aléatoire. Je mets en général une valeur plus sympa.

Dans mon cas, ce sera mon-site-demo-tutoriel. Le site est alors disponible sur https://mon-site-demo-tutoriel.netlify.app.

Mettre à jour l’application sur Netlify avec un domaine personnalisé

Une fois la zone DNS prête,

  • ajouter le domaine dans Netlify en sélectionnant votre site depuis app.netlify.com, puis en cliquant Site settings puis Domain management.
    • dansProduction domains , cliquer Add domain et confirmer l’ajout sans passer par Netlify DNS

Netlify DNS

Vous verrez sûrement l’alerte suivante :

.fr domains can’t be registered through Netlify. You can still add mon-site.fr to your Netlify site if you already own the domain. Select Add domain to add it to your site. You can configure Netlify DNS for this domain later.

Cliquer Add domain ou Add subdomain quand même.

  • une fois sur l’écran ci-dessous : Écran suite à l’ajout du domaine personnalisé. Crédits: image extraite du site Netlify

  • Cliquez Awaiting External DNS et suivez les instructions :

    • pour un domaine racine,
      • ajouter l’entrée A en utilisant l’adresse IP du loadbalancer que Netlify vous fournit.
      • ajouter l’entrée CNAME en utilisant le DNS que Netlify vous fournit. Instructions de Netlify pour une configuration par entrée CNAME. Crédits: image extraite du site Netlify
    • pour un sous-domaine,
      • vous aurez seulement l’entrée CNAME à ajouter.
  • Rendez-vous sur votre registar de domaines (ex : OVH) et dans la sectionDomain > mon-site.fr > DNS Zone , sélectionner Ajouter un entrée et le type selon votre besoin.

    • pour une entréeCNAME , ça ressemble à ceci :

    Choix du type d’entrée DNS. Crédits: image extraite du site Netlify

    Configurer l’entrée DNS. Crédits: image extraite du site Netlify

    Confirmer l’ajout de l’entrée DNS.Crédits: image extraite du site Netlify

    • confirmez et attendez quelques minutes (voire plus si votre registar de domaine est lent)
    • rafraichissez la page sur Netlify : quand tout est bon, le message Awaiting external DNS doit avoir disparu.

    Netlify a bien détecté la mise à jour DNS. Crédits: image extraite du site Netlify

    • Netlify provisionne ensuite un certificat Let’s encrypt automatiquement pour vous.

Certificat Let’s Encrypt en cours de provisionnement. Crédits: image extraite du site Netlify

Temps de provisionnement du certificat HTTPS

Cela prend un peu plus de temps sur un domaine racine qu’un sous-domaine seulement.

Une fois que le certificat est déployé, vous pourrez accéder à votre site web sécurisé ! Ex : https://mon-super-domaine.fr.

Certificat Let’s Encrypt est actif. Votre site web est sécurisé. Crédits: image extraite du site Netlify

Si vous souhaitez éditer le contenu depuis n’importe quel PC, cela est possible avec NetlifyCMS. Je vous explique comment l’activer sur votre site web.

Limitations

Pour un blog de très grande taille (plus de 400 pages générées incluant les pseudos liens si vous utilisez les catégories et les tags), l’hébergement sur Netlify risque d’être limite.

Toutefois, l’astuce serait de déployer le dossier dist généré sur votre PC et de le pousser sur GitHub ensuite. Cela donne le même résultat.

Je ne l’ai toutefois pas encore testé.

Remarque au 9 février 2024

Depuis la publication de cette article, j’ai trouvé une solution pour les sites avec beaucoup de contenu.

J’ai publié un article sur le sujet.

Licencié sous CC BY-NC-SA 4.0