Aller au contenu

Migration du nom de domaine

Billet #89 : Migration du Projet vers le Domaine justingoufo.com

Type : Opération d'Infrastructure / Maintenance Stratégique
Composants Affectés : Configuration DNS, Configuration Nginx (VPS), Configuration du Projet (mkdocs.yml), Templates Applicatifs (demo_index.html).

Objectif : Mettre à jour l'intégralité du projet "Augmented Financial Analyst" pour rendre l'application et sa documentation accessibles via les nouvelles adresses sécurisées https://invest.justingoufo.com et https://docs.invest.justingoufo.com.

1. Actions Réalisées

Pour atteindre cet objectif, une série de modifications a été opérée sur trois couches distinctes de l'infrastructure : la configuration des noms de domaine (DNS), la configuration du serveur web (Nginx), et le code source du projet.

Au niveau du DNS (chez Namecheap) : * Les enregistrements A pour les sous-domaines invest et docs.invest ont été créés et configurés pour pointer vers l'adresse IP correcte du serveur VPS.

Au niveau du Serveur VPS (chez Hostinger) : * Configuration Nginx : Les fichiers de configuration de Nginx ont été renommés et mis à jour pour répondre aux requêtes des nouveaux domaines. La logique de "reverse proxy" a été confirmée pour diriger correctement le trafic de invest.justingoufo.com vers l'application Docker. * Sécurisation (HTTPS) : L'outil Certbot a été utilisé pour générer et installer des certificats SSL/TLS pour les deux nouveaux domaines, activant le chiffrement et la redirection automatique de HTTP vers HTTPS.

Au niveau du Code du Projet (Dépôt GitHub) : * Configuration MkDocs : Le fichier mkdocs.yml a été mis à jour avec la nouvelle site_url (https://docs.invest.justingoufo.com) pour garantir que tous les liens internes du site de documentation soient corrects. * Templates Applicatifs : Le lien vers la documentation dans le template demo_index.html a été mis à jour pour pointer vers la nouvelle URL. * Pipeline de Déploiement (CI/CD) : Le workflow deploy-docs.yml a été ajusté pour que la copie des fichiers via SCP se fasse vers le bon répertoire sur le serveur, correspondant à la nouvelle configuration Nginx.

2. Défis Rencontrés et Résolution

La migration a présenté un défi principal lié à la configuration DNS, qui a dû être résolu avant que les autres étapes puissent aboutir.

  • Défi : Lors de la tentative initiale de sécurisation avec Certbot, le processus échouait avec une erreur 404 Unauthorized.
  • Cause Racine : L'investigation a révélé que les enregistrements DNS pour invest.justingoufo.com pointaient vers une adresse IP incorrecte et obsolète. Cela empêchait les serveurs de validation de Let's Encrypt d'atteindre le bon VPS.
  • Résolution : Le problème a été résolu en se connectant à l'interface de gestion DNS de Namecheap et en corrigeant l'enregistrement A défectueux. Une fois ce changement propagé sur Internet, la validation par Certbot a pu s'effectuer avec succès.

3. Résultat Final

La migration est un succès complet. L'application et sa documentation sont maintenant servies de manière sécurisée depuis leurs nouvelles URLs dédiées. Toutes les configurations, du DNS jusqu'au code applicatif, sont maintenant alignées, et les pipelines de déploiement automatisés sont pleinement fonctionnels avec la nouvelle architecture.