Info::pcCollect

De wiki_pcwiki2
Aller à la navigationAller à la recherche

KEYWORDS: PCCOLLECT, COLLECTE INFOS SYSTÈME

Le 26/07/2026:

pcCollect

Version : 1.01

Date : 26/07/2026

Rôle : rassemble dans un répertoire local les informations et fichiers nécessaires pour reconstruire une machine Debian/Ubuntu à partir de rien - paquets installés, réponses debconf, configuration complète de /etc, crontabs utilisateur, services systemd actifs, partitionnement disque. Conçu pour être ensuite sauvegardé via pcLuks (module dédié, ex. -m system).

Fonctionnement

Chaque catégorie est collectée indépendamment, en best-effort : un outil absent (ex. debconf-get-selections non installé, paquet debconf-utils manquant) produit un avertissement sur la sortie d'erreur mais n'interrompt jamais la collecte des autres catégories. L'exécution est idempotente - les fichiers déjà présents dans --output sont écrasés, le répertoire n'est jamais vidé au préalable.

pcCollect ne modifie jamais la machine collectée : uniquement des lectures (dpkg, apt-mark, debconf-get-selections, systemctl, crontab -l, lsblk, blkid, parted --list, uname) et une copie de /etc (cp -a, jamais d'écriture dans /etc lui-même).

Couplage avec pcLuks

Le répertoire écrit par -o/--output est prévu pour devenir le --path d'un module pcLuks dédié :

pcCollect -o /Atelier/system
pcLuks -m system -p /Atelier/system --host=srv05 -c
pcLuks -m system -p /Atelier/system --host=srv05

Comme ce module est chiffré (LUKS), il est délibérément acceptable d'y inclure des fichiers sensibles (/etc/shadow via la copie de /etc, clés hôte ssh privées) - contrairement à un simple rsync en clair vers un serveur non chiffré.

Contenu collecté (sous --output)

  • packages/dpkg-selections.txt - sortie de

dpkg --get-selections : état de TOUS les paquets connus, dépendances automatiques incluses.

  • packages/manually-installed.txt - sortie de

apt-mark showmanual : uniquement les paquets installés volontairement. C'est cette liste qui sert à la réinstallation : apt-get install $(cat packages/manually-installed.txt).

  • debconf/selections.txt - sortie de

debconf-get-selections (paquet debconf-utils requis) : réponses aux questions de configuration interactive des paquets, à rejouer avec debconf-set-selections.

  • etc/ - copie complète de /etc

(cp -a, permissions et propriétaires préservés) : couvre notamment apt (sources, clés), réseau, hostname, ssh (clés hôte incluses), sudoers, fstab, cron système (/etc/cron.d, /etc/crontab).

  • system/etc-permissions.txt - une ligne par entrée de

/etc (~4000) : mode octal (bits spéciaux setuid/setgid/sticky inclus - réellement présents sous /etc sur certaines machines), propriétaire, groupe, chemin (colonnes séparées par tabulations). Filet de sécurité si /etc est restauré par copies sélectives plutôt que par cp -a etc/. /etc/ complet (qui préserve déjà tout) : voir scripts/restore-etc-permissions.sh.

  • root-ssh/ - copie complète de /root/.ssh

(clés privées/publiques, known_hosts, config) : accès ssh immédiatement fonctionnels sur une machine reconstruite, notamment vers les serveurs pcLuks distants.

  • root-config/ - copie complète de

/root/.config, y compris root-config/pcLuks (clés LUKS locales + pcLuks.ini). Attention : cette sauvegarde donne alors accès à TOUTES les autres sauvegardes pcLuks une fois déchiffrée - à ne collecter que si --output est ensuite lui-même sauvegardé via un module pcLuks chiffré, jamais laissé en clair.

  • cron/user-crontabs/<utilisateur>.txt - crontab de

chaque compte qui en possède une (crontab -l -u), absente de /etc (stockée dans /var/spool/cron/crontabs, lisible seulement par root).

  • systemd/enabled-units.txt - sortie de

systemctl list-unit-files --state=enabled : services à réactiver après réinstallation.

  • systemd/running-services.txt - sortie de

systemctl list-units --type=service --state=running : état de fonctionnement au moment de la collecte (information, ne se restaure pas directement).

  • systemd/timers.txt - sortie de

systemctl list-timers --all : équivalent moderne du cron, facilement oublié si des tâches planifiées utilisent des .timer systemd plutôt que /etc/cron.d.

  • systemd/units/<nom-unité> - définition EFFECTIVE

(sortie de systemctl cat, fichier de base + drop-in/override.conf déjà fusionnés) de chaque unité activée - plus fiable qu'une simple copie de fichier, fonctionne même pour les unités fournies hors de /etc (/usr/lib/systemd/system). Restaurées et activées par scripts/restore-services.sh.

  • scripts/restore-packages.sh - rejoue

apt-get install -y sur packages/manually-installed.txt. Généré exécutable et autonome (utilisable même si --output a été déplacé ou copié ailleurs).

  • scripts/restore-services.sh - copie

systemd/units/* vers /etc/systemd/system/, recharge la configuration systemd puis active et démarre chaque service (systemctl enable --now). Généré exécutable et autonome.

  • scripts/restore-etc-permissions.sh - rejoue

chown/chmod sur chaque entrée de system/etc-permissions.txt (ignore silencieusement les chemins absents - normal si /etc n'a été restauré que partiellement). Généré exécutable et autonome.

  • disk/lsblk.txt, disk/blkid.txt,

disk/partitions.txt - partitionnement et UUID des systèmes de fichiers. À consulter, jamais à rejouer à l'aveugle : un disque de remplacement peut différer du disque d'origine.

  • system/uname.txt, system/kernel-packages.txt

- version du noyau en cours et paquets linux-image-* installés.

  • hardware/lscpu.txt, hardware/free.txt -

processeur et mémoire disponible : documentation pour dimensionner une machine de remplacement, ne se restaure pas.

  • network/ip-addr.txt, network/ip-route.txt -

état RÉEL de l'adressage et du routage au moment de la collecte - utile si l'adressage vient du DHCP (aucune IP fixe visible dans la configuration copiée sous etc/).

  • network/iptables-rules.txt,

network/ip6tables-rules.txt, network/nftables-ruleset.txt - règles de pare-feu ACTIVES au moment de la collecte (iptables ET nftables tentés ; l'un des deux peut être vide sans que ce soit une erreur) - utile même si elles ne sont pas persistées dans un fichier sous /etc.

  • databases/mariadb-schema.sql,

databases/mariadb-users-grants.sql - structure (mysqldump --no-data --routines --triggers --events) et comptes/privilèges (dump complet de la base système mysql) de MariaDB/MySQL - le schéma uniquement, jamais les données des bases applicatives. Nécessite un accès root non interactif au serveur (ex. /root/.my.cnf) - sinon échoue proprement (Access denied) sans bloquer les autres catégories.

  • databases/postgresql-schema.sql - sortie de

pg_dumpall --schema-only (exécuté via l'utilisateur système postgres, authentification peer) : structure de TOUTES les bases ainsi que les rôles/mots de passe (hash) - là encore, jamais les données elles-mêmes.

  • README.txt - récapitule cette liste et l'ordre

recommandé de restauration, généré à chaque exécution.

Syntaxe

pcCollect -o RÉPERTOIRE [options]

Prérequis système

Doit être exécuté en tant que root : plusieurs catégories exigent un accès root (/etc/shadow, clés privées ssh hôte, crontabs des autres utilisateurs). Sans root, ces catégories échouent mais la collecte des autres catégories se poursuit normalement (avertissement affiché en début d'exécution).

Paquet optionnel pour la catégorie debconf :

apt install debconf-utils

Build

Paquets Debian requis :

apt install cmake g++

Compilation :

cmake -B build -S .
cmake --build build

Options

-h, --help

Affiche l'aide (fonctionnement, syntaxe, exemple par option) et quitte.

Exemple : pcCollect --help

-V, --version

Affiche le numéro de version et la date, puis quitte.

Exemple : pcCollect --version

-v, --verbose

Affiche le détail de chaque commande exécutée, en plus du résumé final catégorie par catégorie.

Exemple : pcCollect -o /Atelier/system -v

-o, --output <RÉPERTOIRE>

Répertoire local où écrire l'instantané (créé avec ses parents si besoin). Obligatoire. Rejouable : les fichiers existants sont écrasés, pas le répertoire entier.

Exemple : pcCollect -o /Atelier/system