Debian 13 : tutoriel / Configurer les dépôts deb822 et les trousseaux Signed-By

Debian 13 stocke les définitions des dépôts de l'Advanced Package Tool (APT) dans /etc/apt/sources.list et dans les fichiers situés sous /etc/apt/sources.list.d. Un fichier deb822 .sources regroupe chaque définition de dépôt en champs nommés. Lors de la conversion d'une configuration existante, conservez ses adresses, ses branches de distribution, ses composants et les clés autorisées à vérifier ses signatures, désactivez les anciennes entrées en double, puis actualisez les listes et comparez les versions candidates des paquets.

Inspecter le format actuel du dépôt

Utilisez la VM Debian 13 ayant servi au laboratoire d’installation et de suppression de paquets avec APT. Les définitions de dépôts contrôlent à la fois les sources de paquets et la confiance. Ne collez pas de dépôts Ubuntu ou la configuration d'une autre version de Debian.

cat /etc/os-release
ls -l /etc/apt/sources.list
find /etc/apt/sources.list.d -maxdepth 1 -type f -print
cat /etc/apt/sources.list
apt-cache policy bash

Si un fichier .sources existe déjà, lisez le fichier pour vérifier les dépôts valides. Dans les environnements où les adresses de dépôts privés incluent des informations d'authentification, ne partagez pas le fichier entier à l'extérieur. Il est possible d'avoir une configuration sans /etc/apt/sources.list, donc ne supposez pas qu'il n'y a pas de dépôts simplement parce que le fichier est manquant.

Le relevé du cours d’origine porte sur Debian 13.7 avec APT 3.0.3. L'installateur a créé des entrées deb et deb-src sur une seule ligne dans sources.list, et sources.list.d était vide. La procédure de conversion décrite ici cible cet état. Si une configuration deb822 appropriée existe déjà, ne créez pas un nouveau fichier en double et examinez plutôt les champs du fichier actuel.

Lire les champs deb822 et les composants de l'archive

deb822 est un format qui écrit un dépôt comme un ensemble de noms de champs et de valeurs. Un ensemble est séparé par une ligne vide. Comme ce n'est ni YAML ni un script shell, vous n'exécutez pas un fichier .sources avec bash. manuel sources.list explique à la fois le format sur une seule ligne du fichier .list et le format deb822 du fichier .sources.

Champs Rôles Exemple de sélection
Types Types de listes de paquets binaires et sources deb demande des index de paquets binaires ; deb-src demande des index de paquets sources.
URIs Adresse de base du dépôt Fait la distinction entre les archives générales et les dépôts de sécurité.
Suites Branche de publication/mise à jour Utilise trixie, trixie-updates, trixie-security.
Components Zone d'archive à interroger Conserve les composants existants main et non-free-firmware.
Signed-By Trousseau de clés à utiliser pour vérifier ce dépôt Chemin absolu du trousseau de clés Debian installé.

Séparez plusieurs valeurs de champ par des espaces, pas par des virgules. Par exemple, les deux valeurs de Suites partagent un champ séparé par des espaces. Ajouter Enabled: no désactive l'ensemble du bloc dans un fichier .sources, y compris toutes les suites qu'il définit. Supprimez ce champ ou changez-le en yes pour réactiver le bloc. Passez en revue toutes les définitions actives afin que le dépôt de sécurité ne soit pas accidentellement laissé désactivé.

Pour maintenir Debian 13, une configuration qui spécifie le nom de code trixie rend l'intention claire plutôt que d'utiliser un nom mouvant comme stable. Même après qu'une nouvelle Debian devient stable, trixie fait encore référence à la même version. trixie-updates est la branche de mise à jour de la version stable, et trixie-security est la branche de mise à jour de sécurité. Changer le nom de code est lié au plan de mise à niveau de la distribution, donc ne le changez pas arbitrairement pour éviter les erreurs de dépôt.

Zone Critères de classification Confirmer lors de la sélection
main La zone de cette distribution qui est conforme aux principes du logiciel libre selon Debian (Debian Free Software Guidelines, DFSG) Le cœur de la configuration du paquet par défaut.
contrib Une zone où le logiciel lui-même respecte les directives du logiciel libre mais peut dépendre de composants en dehors de main. Vérifiez les programmes et dépendances nécessaires.
non-free Logiciel qui ne respecte pas les directives du logiciel libre. Vérifiez la licence et les politiques organisationnelles.
non-free-firmware Zone isolée séparément pour le micrologiciel non libre. Vérifiez le micrologiciel requis pour le dispositif et les conditions de distribution.

La base pour distinguer la zone peut être trouvée dans description des composants de l’archive dans la politique Debian. Le fait que le firmware soit nécessaire ne signifie pas que toutes les zones non libres doivent être automatiquement ajoutées. Cet exemple conserve la sélection existante de l'installateur telle quelle.

Sauvegarder les définitions et enregistrer un candidat de paquet

Le répertoire de sauvegarde ne doit pas déjà exister. S'il existe, choisissez un nouveau nom et ajustez tous les chemins de récupération de manière cohérente. Exécutez la première ligne séparément et continuez seulement si elle réussit ; arrêtez également si la copie ou toute vérification de fichier cible échoue. Ne poursuivez pas l'édition sans une sauvegarde utilisable.

sudo test ! -e /var/backups/lf-debian13-10 && sudo install -d -m 700 /var/backups/lf-debian13-10
sudo cp -a /etc/apt/sources.list /etc/apt/sources.list.d /var/backups/lf-debian13-10/
apt-cache policy bash | sudo tee /var/backups/lf-debian13-10/bash-policy-before.txt
sudo test ! -e /etc/apt/sources.list.d/debian.sources
ls -l /usr/share/keyrings/debian-archive-keyring.gpg
sudo -u _apt test -r /usr/share/keyrings/debian-archive-keyring.gpg && printf 'APT account can read the keyring\n'

Si debian.sources existe déjà, ne le remplacez pas. Le trousseau de clés est fourni par le paquet debian-archive-keyring, et dans cette machine virtuelle le chemin .gpg était un lien pointant vers un fichier .pgp. L’important est de savoir si le trousseau de clés public spécifié peut réellement être lu par le compte _apt. Si le fichier de clé est manquant ou corrompu, ne contournez pas le problème en recevant une clé non vérifiée ; vérifiez plutôt les paquets appropriés et les supports et sauvegardes de récupération.

Le relevé de la version candidate de bash permet de rechercher un changement involontaire de sélection causé par la conversion. Même si un paquet est le même, cela ne prouve pas que toutes les politiques de paquet sont identiques, donc comparez également l’adresse, la branche et les composants du dépôt.

Écrire le fichier deb822 complet et désactiver les anciennes entrées

Ouvrez un nouveau fichier avec la commande suivante. Continuez uniquement après avoir confirmé l’absence du fichier cible et la réussite de la sauvegarde.

sudo nano /etc/apt/sources.list.d/debian.sources

Entrez tout le contenu ci-dessous, enregistrez avec Ctrl+O et Entrée, puis quittez avec Ctrl+X. Regroupez les entrées régulières et mises à jour sous la même adresse, et placez les dépôts de sécurité dans un groupe séparé. Laissez une ligne vide entre les deux groupes.

Types: deb deb-src
URIs: http://deb.debian.org/debian
Suites: trixie trixie-updates
Components: main non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg

Types: deb deb-src
URIs: http://security.debian.org/debian-security
Suites: trixie-security
Components: main non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg

La raison d'inclure deb-src dans Types est de préserver la fonctionnalité existante de la liste des sources. Les serveurs qui ne téléchargent pas et ne compilent pas les sources peuvent utiliser uniquement deb selon les besoins, mais ce choix est séparé de la conversion de format. Mettez les adresses des dépôts dans URIs et le chemin du trousseau de clés approprié dans Signed-By ; ne remplacez pas un trousseau de clés par celui d'une autre distribution.

sudo chmod 644 /etc/apt/sources.list.d/debian.sources
sudo nano /etc/apt/sources.list

Commentez les lignes deb et deb-src de Debian déplacées depuis le sources.list existant vers le nouveau fichier pour les désactiver. Ne supprimez pas les entrées destinées à d'autres usages sans examen séparé. Par exemple, changez le deb http://deb.debian.org/debian trixie main non-free-firmware existant en commentaire. Si l'entrée cdrom existante est déjà commentée, laissez-la telle quelle.

Si le même dépôt est activé simultanément dans les fichiers .list et .sources, des avertissements de doublon ou des conflits de valeur Signed-By peuvent se produire. Si vous enregistrez le nom de fichier avec l'extension .sources.txt, APT ne le lira pas comme le format attendu, vérifiez donc aussi l'extension.

Actualisez les listes et comparez la sélection des paquets

L'opération suivante ne met pas à jour les paquets installés. Tout d'abord, elle vérifie si les définitions des dépôts et la vérification des signatures sont traitées correctement.

sudo apt update
apt-cache policy bash | sudo tee /var/backups/lf-debian13-10/bash-policy-after.txt
sudo diff -u /var/backups/lf-debian13-10/bash-policy-before.txt /var/backups/lf-debian13-10/bash-policy-after.txt
sudo apt-get -s install tree

Dans le test d’origine, le traitement des fichiers InRelease de trixie, trixie-updates et trixie-security a réussi. La comparaison des candidats et des priorités pour bash a réussi sans différences, et une installation simulée de tree a également créé un plan normalement. Si le dépôt publie de nouvelles versions pendant l’opération, les valeurs peuvent différer. Examinez les sources et les versions concernées pour distinguer un effet de la conversion d’une évolution du dépôt.

Une mise à jour peut échouer partiellement tandis que les commandes suivantes continuent à utiliser les anciennes listes de paquets. Ne vous contentez pas de regarder la dernière ligne ; vérifiez les erreurs de signature, les échecs de téléchargement et les avertissements de doublon. Si un dépôt échoué est un dépôt de sécurité, l'opération n'est pas marquée comme terminée simplement parce que des paquets existants peuvent être trouvés.

Comprendre Signed-By et la confiance dans les dépôts

Signed-By limite la gamme de clés publiques utilisées pour vérifier les métadonnées du dépôt. Le fait qu’un fichier clé existe et que la signature du dépôt soit correctement vérifiée sont des choses différentes. Le manuel apt-secure explique le système de vérification utilisant les informations Release signées et les hachages des paquets. La confiance envers un dépôt est également distincte d’une garantie que toutes les opérations de paquet sont inoffensives.

Cet exemple conserve l’adresse HTTP officielle de l’installateur et utilise la vérification de signature. HTTPS fournit une protection distincte pour le segment de transmission mais ne remplace pas la vérification de signature. Les organisations utilisant HTTPS doivent l’appliquer de manière cohérente en vérifiant la confiance des certificats et les politiques de proxy.

Lors de l'ajout de dépôts de fournisseurs externes, vérifiez si Debian 13 est pris en charge, l’adresse officielle de publication des paquets, l'empreinte de la clé et le chemin de la distribution. Les clés stockées par l'administrateur peuvent être séparées dans /etc/apt/keyrings, et les clés gérées par les paquets peuvent se trouver dans /usr/share/keyrings. N'ajoutez pas arbitrairement de clés externes pour une confiance globale ou ne désactivez pas la vérification des signatures, notamment avec Trusted: yes, pour contourner un problème. Il n'est également pas nécessaire de copier l'ancienne procédure apt-key add pour obtenir les clés des dépôts par défaut pour Debian 13.

Pour les erreurs de clé de signature, vérifiez le chemin Signed-By, les permissions de lecture, la clé exacte et le dépôt ; pour les erreurs de période de validité de la Release, vérifiez l'horloge du serveur et le statut du dépôt. La méthode pour vérifier l'heure peut suivre les critères expliqués dans Distinction des fuseaux horaires et synchronisation réelle. Ne désactivez pas les vérifications de date ou de validité sans en déterminer la cause.

Restaurer les définitions originales du dépôt

La restauration suivante concerne uniquement l’état initial de cet exemple : les dépôts étaient définis dans sources.list et debian.sources a été ajouté pendant cet exercice. Avant de restaurer, comparez avec une sauvegarde pour vérifier qu'il n'y a eu aucune autre modification légitime. Si un fichier .sources déjà en fonctionnement a été modifié, vous devez restaurer individuellement la sauvegarde de ce fichier.

sudo cp -a /var/backups/lf-debian13-10/sources.list /etc/apt/sources.list
sudo rm -- /etc/apt/sources.list.d/debian.sources
sudo apt update
apt-cache policy bash

Supprimez uniquement le nouveau fichier debian.sources ; conservez le reste de sources.list.d. Dans le test du cours d’origine, le sources.list restauré correspondait à l’original octet par octet et la mise à jour ultérieure de la liste a réussi. La conversion du format de dépôt ne fait pas revenir les paquets installés à des versions antérieures. Toute mise à niveau de paquet effectuée par la suite nécessite son propre plan de récupération.