Aller au contenu principal

Maintenance et diagnostic

Installation bloquée​

Vérifier la présence de NPM_PROXY_AUTH sans afficher sa valeur. Une erreur 401/403 du miroir demande un contrôle des droits avec l’administrateur. Pour DNS/TLS, vérifier réseau et certificat ; ne pas désactiver TLS ou changer silencieusement le registre. Ne pas extraire un secret d’un projet de référence.

Build en erreur​

Lire l’erreur Docusaurus ou TypeScript. Corriger les liens et les spdd_sources dans les pages originales. Ne pas éditer sources-spdd.md ou static/spdd : ils sont générés. Les sources canoniques sont dans docs/ et catalog/ à la racine du dépôt.

HTTP et navigation​

Après démarrage de votre conteneur de vérification :

curl -fsS http://localhost:3001/ -o /dev/null
curl -fsS http://localhost:3001/maintenance-et-diagnostic/ -o /dev/null
docker logs dataasso-22398-documentation

Une route inconnue doit renvoyer 404. L’index propre au site doit exister dans le build et répondre comme JSON, avec un nom empreinté et un cache durable. Les HTML et les téléchargements SPDD sont revalidés. Ces contrôles vérifient l’intégration et ne nécessitent pas une recherche d’un mot du corps d’une page.

Si le lien vers l’autre site échoue, vérifier les URL de compilation et la disponibilité du second site. Un port occupé ne justifie pas d’arrêter un service existant : choisir d’autres ports et aligner les URL avant build.

Fin de vérification​

docker stop dataasso-22398-documentation

Cette commande arrête uniquement votre conteneur nommé, supprimé par --rm. Aucun prune global. La reprise WALDEC est disponible : erreur de SHA/CSV avant publication, rollback et échec conservé, nouvelle tentative distincte. Exit 2 bloque la suite. En cas de résultat incertain ou tentative en_cours interrompue, relire tentative/état sans reset ni reclassement automatique ; une panne peut empêcher le diagnostic final. Les autres procédures métier restent à définir.

Consulter les sources SPDD de cette page.