lecoffre_node/scripts/README.md

Scripts LeCoffre Node

Ce répertoire contient tous les scripts nécessaires au déploiement et à la gestion de l'architecture LeCoffre Node.

🚀 Scripts de Déploiement

start.sh

Script principal de démarrage séquentiel

• Lance tous les services dans l'ordre logique
• Affiche la progression détaillée en temps réel
• Compatible avec le réseau Bitcoin Signet
• Gestion des timeouts et erreurs

./scripts/start.sh

deploy-master.sh

Déploiement de l'architecture autonome

• Construit et lance le conteneur master
• Configure tous les ports et volumes
• Lance automatiquement les services

./scripts/deploy-master.sh

deploy-autonomous.sh

Déploiement autonome complet

• Déploiement sans intervention manuelle
• Configuration automatique de tous les services

./scripts/deploy-autonomous.sh

💾 Scripts de Gestion des Données

backup-data.sh

Sauvegarde des données critiques

• Sauvegarde Bitcoin, BlindBit, SDK Storage, SDK Signer
• Création d'archives compressées
• Gestion des permissions

./scripts/backup-data.sh

restore-data.sh

Restauration des données

• Restaure depuis une sauvegarde
• Remplace les données existantes
• Confirmation de sécurité

./scripts/restore-data.sh <backup_name>

update-images.sh

Mise à jour des images Docker

• Sauvegarde automatique avant mise à jour
• Téléchargement des nouvelles images
• Protection des données

./scripts/update-images.sh

📊 Scripts de Monitoring

collect-logs.sh

Collecte des logs de tous les services

• Collecte automatique ou par service
• Organisation par répertoires
• Timestamps sur les fichiers

# Tous les services
./scripts/collect-logs.sh

# Service spécifique
./scripts/collect-logs.sh bitcoin-signet

test-monitoring.sh

Tests des services de monitoring

• Vérification Grafana, Loki, Promtail
• Tests de connectivité
• Validation des dashboards

./scripts/test-monitoring.sh

test-dashboards.sh

Tests des dashboards Grafana

• Vérification des dashboards
• Tests des données sources
• Validation des métriques

./scripts/test-dashboards.sh

🔧 Scripts de Configuration

sync-configs.sh

Synchronisation des configurations

• Copie des configs vers les conteneurs
• Mise à jour des paramètres
• Redémarrage des services

./scripts/sync-configs.sh

sync-monitoring-config.sh

Configuration du monitoring

• Configuration Grafana
• Configuration Loki/Promtail
• Déploiement des dashboards

./scripts/sync-monitoring-config.sh

setup-logs.sh

Configuration des logs

• Création des répertoires de logs
• Configuration des permissions
• Setup des rotations

./scripts/setup-logs.sh

🛠️ Scripts de Maintenance

fix_relay_funds.sh

Correction des fonds du relay

• Vérification des fonds
• Correction des problèmes
• Tests de connectivité

./scripts/fix_relay_funds.sh

optimize-relay-startup.sh

Optimisation du démarrage du relay

• Optimisation des paramètres
• Amélioration des performances
• Tests de stabilité

./scripts/optimize-relay-startup.sh

verify_mining_fix.sh

Vérification du minage

• Tests du minage Signet
• Vérification des blocs
• Validation des transactions

./scripts/verify_mining_fix.sh

🔒 Scripts de Sécurité

generate-ssl-certs.sh

Génération des certificats SSL

• Création des certificats
• Configuration HTTPS
• Sécurisation des communications

./scripts/generate-ssl-certs.sh

uninstall-host-nginx.sh

Désinstallation de Nginx host

• Nettoyage de Nginx
• Suppression des configurations
• Libération des ports

./scripts/uninstall-host-nginx.sh

📁 Structure des Volumes

Les données sont persistées dans les volumes Docker suivants :

• 4nk_node_bitcoin_data : Données Bitcoin Signet
• 4nk_node_blindbit_data : Données BlindBit Oracle
• 4nk_node_sdk_data : Données SDK Relay
• 4nk_node_sdk_signer_data : Données SDK Signer
• 4nk_node_sdk_storage_data : Données SDK Storage
• 4nk_node_grafana_data : Données Grafana
• 4nk_node_loki_data : Données Loki

🔄 Workflow de Déploiement

1. Déploiement initial : ./scripts/deploy-master.sh
2. Démarrage des services : ./scripts/start.sh
3. Vérification : ./scripts/test-monitoring.sh
4. Sauvegarde : ./scripts/backup-data.sh

🔄 Workflow de Mise à Jour

1. Sauvegarde : ./scripts/backup-data.sh
2. Mise à jour : ./scripts/update-images.sh
3. Redémarrage : ./scripts/start.sh
4. Vérification : ./scripts/test-monitoring.sh

🆘 Récupération d'Urgence

En cas de problème :

1. Arrêt des services : docker compose down
2. Restauration : ./scripts/restore-data.sh <backup>
3. Redémarrage : ./scripts/start.sh

📝 Logs et Debugging

• Logs des services : ./logs/<service>/
• Collecte des logs : ./scripts/collect-logs.sh
• Monitoring : Grafana sur port 3005
• Status API : Port 3006

⚠️ Notes Importantes

• Tous les scripts préservent les données importantes
• Les sauvegardes sont automatiques lors des mises à jour
• Le réseau Bitcoin Signet est utilisé par défaut
• Les volumes Docker garantissent la persistance des données