Info::pcCollect
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