Debian
Debian-France
Debian-Facile
Debian-fr.org
Forum-Debian.fr
Debian ?
Communautés
Vous n'êtes pas identifié(e).
L'icône rouge permet de télécharger chaque page du wiki visitée au format
PDF et la grise au format ODT →
Ci-dessous, les différences entre deux révisions de la page.
| Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente | ||
|
doc:systeme:apt:sources.list [08/07/2014 19:55] captnfab [Introduction] |
doc:systeme:apt:sources.list [30/09/2023 18:39] captnfab [Syntaxe des fichiers sources.list] |
||
|---|---|---|---|
| Ligne 1: | Ligne 1: | ||
| - | ====== APT : fichiers sources.list ====== | + | ====== APT : fichier sources.list ====== |
| - | * Objet : Bien configurer son sources.list | + | * Objet : Bien configurer son sources.list |
| - | * Niveau requis : {{tag>débutant avisé}} | + | * Niveau requis : {{tag>débutant avisé}} |
| - | * Commentaires : //Pour bien comprendre comment apt-get ou aptitude trouvent et récupèrent les logiciels que vous leur demandez d'installer.// | + | * Commentaires : //Pour bien comprendre comment apt-get ou aptitude trouvent et récupèrent les logiciels que vous leur demandez d’installer.// |
| - | * Débutant, à savoir : [[:doc:systeme:commandes:le_debianiste_qui_papillonne|Utiliser GNU/Linux en ligne de commande, tout commence là !.]], [[:doc:systeme:apt|La gestion des paquets avec APT]] | + | * Débutant, à savoir : |
| - | * Suivi : | + | * [[:doc:systeme:commandes:le_debianiste_qui_papillonne|Utiliser GNU/Linux en ligne de commande, tout commence là!.]] |
| + | * [[:doc:systeme:apt|La gestion des paquets avec APT]] | ||
| + | * Suivi : | ||
| * Création par [[user>captnfab]] le 25/05/2013 | * Création par [[user>captnfab]] le 25/05/2013 | ||
| - | * Le retour sur le forum est [[http://debian-facile.org/viewtopic.php?id=2290| ici]]((N'hésitez pas à y faire part de vos remarques, succès, améliorations ou échecs !)) | + | * Mise à jour par [[user>nIQnutn]] le 18/06/2017 |
| + | * Mise à jour par [[user>arpinux]] le 21/08/2021 | ||
| + | * Mise à jour par [[user>captnfab]] le 30/09/2023 | ||
| + | * Le retour sur le forum est [[http://debian-facile.org/viewtopic.php?id=2290| ici]]((N’hésitez pas à y faire part de vos remarques, succès, améliorations ou échecs!)) | ||
| ===== Introduction ===== | ===== Introduction ===== | ||
| - | L'utilisation normale de Debian se fait sans jamais manipuler de fichier ''.deb'' à la main, mais en indiquant à **APT** où récupérer ces fichiers. | + | Les fichiers ''sources.list'' sont des fichiers de type texte, on trouve le fichier de base, ''/etc/apt/sources.list'', et le répertoire ''/etc/apt/sources.list.d/'' qui peut contenir d'autres fichiers installés par des paquets ou créés par l'administrateur de la machine. |
| - | En général, ils se trouvent sur des serveurs appelés //dépôts//. Il convient alors de renseigner son fichier ''/etc/apt/sources.list'' afin d'indiquer de quelles //sections// de quelles //branches// de quels //dépôts// il lui faut récupérer les listes de paquets. | + | L'ensemble des adresses web inscrites dans ce ou ces fichiers déterminent les dépôts utilisés par votre système pour installer ou mettre à jour vos applications. Prenez donc soin de n'utiliser que des adresses de confiance. |
| - | Cela se fait en renseignant les fichiers présents dans ''/etc/apt/sources.list.d/'' ou en complétant le fichier ''/etc/apt/sources.list'' lui-même. | + | Si vous venez d'installer debian depuis une clé USB ou un CDROM, commencez par [[doc:programmation:commenter|commenter]] ou supprimer les lignes des sources du CDROM commençant par : |
| + | <file apt_sources nom.apt_sources> | ||
| + | deb cdrom:[Debian GNU/Linux etc... | ||
| + | </file> | ||
| + | Car alors, apt peut demander d'insérer le CD-ROM lors de l'installation d'un paquet ! | ||
| - | <note important>**Sauvegarde** | + | Par exemple, avec [[doc:editeurs:nano|l'éditeur nano]], le rédiger ainsi : |
| + | <file apt_sources nom.apt_sources> | ||
| + | #deb cdrom:[Debian GNU/Linux etc... | ||
| + | </file> | ||
| + | Ou supprimer toute la ligne. | ||
| - | Toute modification d'un fichier de configuration doit commencer par la sauvegarde de l'ancien afin de le conserver intact au cas où. De plus, il est **fortement recommandé**, afin d'éviter les fautes de frappe, d'utiliser [[doc:programmation:bash:autocompletion | l'autocompletion]]. | + | Même si le cdrom est présent (ou la clé usb), apt ira chercher une version plus récente sur le net si le réseau est disponible. |
| - | Exemple de procédure de sauvegarde (cf. [[doc:systeme:cp |cp]] et [[doc:editeurs:less | less]]) du fichier **sources.list** : | + | Voir ensuite le détail d'une installation propre : [[doc:install:install|Premières configurations après l'installation de debian]] |
| - | <code root># Faire la copie de sauvegarde | + | |
| - | cp /etc/apt/sources.list /root/sources.list.sav | + | |
| - | # Vérifier la copie avec less | + | |
| - | less /root/sources.list.sav</code> | + | |
| - | </note> | + | |
| - | <note tip>**Contenu privateur** | + | L’installation de logiciels (plus généralement appelé **paquets**) se fait directement par le gestionnaire de paquets APT. Contrairement à Windows, il est inutile de télécharger directement un logiciel. Le gestionnaire de paquets s’occupe de le télécharger et de l’installer à votre place. |
| - | Les sections ''contrib'' et ''non-free'' contiennent des logiciels privateurs. Ils apparaissent ici afin de les présenter à l'utilisateur qui fera, ou non, le choix de les utiliser. | + | Les fichiers ''sources.list'' permettent simplement de définir les logithèques (appelées **dépôts**) utilisées par Debian. L’utilisation de dépôts additionnels permet d’avoir accès à un plus grand nombre de logiciels ou des versions plus récentes. |
| + | <note warning>**ATTENTION** ! Pour les manipulations des sources, il faut savoir ce que l'on fait réellement, vous atteignez ici aux limites fondamentales de votre installation, n'hésitez pas à intervenir sur le forum si vous ne trouvez pas d'explications claires sur le sujet dans les liens du wiki.</note> | ||
| - | Si vous souhaitez obtenir un système composé à 100% de logiciels libres (et nous vous encourageons à le faire si possible), vous ne devez utiliser que la section ''main''. | + | ===== Syntaxe des fichiers sources.list ===== |
| - | Le paquet [[doc:systeme:apt:vrms|vrms]] vous renseignera sur la présence éventuelle de logiciels privateurs dans votre système.</note> | + | Les fichier ''sources.list'' sont structurés de cette manière : |
| + | <file apt_sources /etc/apt/sources.list># structure du fichier sources.list | ||
| + | deb url-du-miroir branche section1 (section2 section3)</file> | ||
| - | ===== Utilisation ===== | + | Sur votre Debian, il est probable que vous ayez un fichier ''sources.list'' très similaire à : |
| + | <file apt_sources /etc/apt/sources.list># Debian repository | ||
| + | deb http://deb.debian.org/debian/ bookworm main</file> | ||
| - | ==== Mise à jour de la liste des paquets ==== | + | Voir [[doc:systeme:apt:sources.list | les dépôts officiels Debian]] pour des ''sources.list'' standards et complets. |
| - | Après chaque modification des ''sources.list'', il est nécessaire de lancer un //update// de la liste des paquets, via la commande suivant : | + | <note warning>Un fichier ''sources.list'' mal configuré peut aboutir à des messages d'erreur, voire une impossibilité d'installer ou de mettre à jour les logiciels.</note> |
| - | <code root>apt-get update</code> | + | |
| - | Cette opération doit être lancée en tant que super-utilisateur((i.e. en tant que root)). | + | |
| - | ==== Syntaxe et organisation des fichiers de sources ==== | + | ==== Binaires ou sources ==== |
| - | * [[:doc:systeme:apt:sources.list:syntaxe|Comprendre la syntaxe des fichiers sources.list]] | + | Les paquets **binaires** sont [[doc:systeme:noyau:compiler | des paquets compilés]] c’est-à-dire prêts à l’emploi. Il est également possible d’utiliser les paquets **sources** pour pouvoir modifier les paquets et les recompiler soi-même (pour utilisateur averti). |
| - | * Où enregistrer les fichiers sources.list ? [[:doc:systeme:apt:sources.list:sources.list.d|sources.list vs sources.list.d]]. | + | |
| + | Pour utiliser les sources, il faut utiliser les dépôts ''deb-src'', exemple: | ||
| + | <file apt_sources /etc/apt/sources.list> | ||
| + | deb-src http://deb.debian.org/debian/ bookworm main</file> | ||
| - | ==== Configurations détaillées suivant votre version ==== | + | ==== Miroirs / URL ==== |
| - | * [[:doc:systeme:apt:sources.list:stable|Debian stable]] | + | Les paquets sont disponibles sur une multitude de serveurs miroirs éparpillés dans tous les pays du monde. Nous voulons en général utiliser le miroir le plus proche de chez nous. |
| - | * [[:doc:systeme:apt:sources.list:testing|Debian testing + sid]] | + | <note>Il est possible de rencontrer URL d’un miroir qui commence par : \\ |
| - | * [[:doc:systeme:apt:sources.list:unstable|Debian unstable + testing + experimental]] | + | 1. **http:%%/%%/** pour indiquer une source accessible depuis un serveur web, ou \\ |
| + | 2. **cdrom:%%/%%/**pour indiquer l’utilisation d’un lecteur de CD avec la possibilité de changer de media, ou encore \\ | ||
| + | 2. **file:%%/%%/** pour indiquer une source locale située dans l’arborescence de fichiers du système (dans ce cas, il faut bien veiller à ce que l’URL se termine par un slash : %%/%%), ou \\ | ||
| + | 3. **ftp:%%/%%/** pour une source disponible sur un serveur FTP.</note> | ||
| - | ===== Configurations types recommandées en version monolithique ===== | + | ====Branches ==== |
| - | ==== Debian Stable (Wheezy) ==== | + | La branche permet de définir la **version de Debian** qui sera utilisée (*wheezy*, *jessie*, *stretch*, *buster*, *bullseye*, *bookworm*, *sid*, etc.). |
| - | <file apt_sources /etc/apt/sources.list> | + | La branche peut en principe soit être désignée sous son **nom de code** (eg. *bookworm*) soit sous son *nom d’archive* (*oldstable*, *stable*, *testing*, *unstable*). Cependant, il est recommandé de toujours utiliser le *nom de code* et jamais le *nom d'archive*. |
| - | # wheezy | + | |
| - | deb http://ftp.fr.debian.org/debian/ wheezy main contrib non-free | + | |
| - | # wheezy updates | + | |
| - | deb http://ftp.fr.debian.org/debian/ wheezy-updates main contrib non-free | + | |
| - | # wheezy-backports | + | |
| - | deb http://ftp.fr.debian.org/debian wheezy-backports main contrib non-free | + | |
| - | # wheezy security | + | |
| - | deb http://security.debian.org/ wheezy/updates main contrib non-free | + | |
| - | </file> | + | |
| - | <note info>Pour installer un paquet ''le_paquet'' depuis les backports, on utilisera la commande suivante : | + | Quelle différence entre nom de code et nom d’archive ?\\ |
| - | <code root>apt-get -t wheezy-backports install le_paquet</code></note> | + | À un moment donné, la version *bullseye* était la version *stable*. Puis lors de la sortie de *bookworm*, *bullseye* est devenu la version *oldstable* alors que *bookworm* qui était *testing* est devenue *stable*. Autant dire que c'est un bon moyen de faire une grosse mise à jour par erreur. |
| - | ==== Debian Testing avec Unstable en roue de secours === | + | > L’utilisation du nom d’archive est plutôt recommandée aux développeurs. Cela permet par exemple de rester avec une version de test et corriger les bugs. |
| + | > Certaines personnes utilisent également les versions de tests pour bénéficier des dernières versions de paquets (à réserver aux personnes avisées qui savent réparer leur système quand il casse). | ||
| - | <file apt_sources /etc/apt/sources.list> | + | __En résumé :__ ces deux méthodes pour définir la version utilisée ne sont pas équivalentes, l’utilisation du nom de code est pérenne (buster proposera les mêmes paquets aujourd’hui que dans cinq ans), alors que l’utilisation du nom d’archive changera de cible tous les deux ans environ, lors de la publication d’une nouvelle version. |
| - | # testing | + | |
| - | deb http://ftp.fr.debian.org/debian/ testing main contrib non-free | + | |
| - | # sid | + | |
| - | deb http://ftp.fr.debian.org/debian/ sid main contrib non-free | + | |
| - | </file> | + | |
| - | ==== Debian Unstable (Sid) ==== | + | Plus d’informations sur [[doc:systeme:apt:branches-debian|Les branches de Debian]]. |
| - | <file apt_sources /etc/apt/sources.list> | + | ==== Commentaires ==== |
| - | # testing | + | |
| - | deb http://ftp.fr.debian.org/debian/ testing main contrib non-free | + | |
| - | # sid | + | |
| - | deb http://ftp.fr.debian.org/debian/ sid main contrib non-free | + | |
| - | # experimental (contient iceweasel version release) | + | |
| - | deb http://ftp.fr.debian.org/debian/ experimental main contrib non-free | + | |
| - | </file> | + | |
| - | <note warning> | + | Certaines bonnes habitudes consistent à documenter les modifications qui sont effectuées. Il suffit de précéder le [[doc:programmation:commenter|commentaire]] par le caractère **#**. \\ |
| - | Les dépôts testing sont là pour permettre de réinstaller la version précédente si on a installé la version de sid et qu'elle ne fonctionne pas. | + | De la même manière, il est possible de désactiver certains dépôts en le précédant de #. |
| + | <code apt_sources># Commentaire: désactivation du CD-Rom qui a servi de dépôt pour l'installation | ||
| + | # deb cdrom:[Debian GNU/Linux testing _Stretch_ - Official Snapshot amd64 NETINST Binary-1 20150323-08:15]/ testing main</code> | ||
| - | <code root>apt-get install nomdupaquet -t testing</code> | + | ===== Les dépôts ===== |
| - | </note> | + | |
| - | <note info> | + | - [[:doc:systeme:apt:sources.list:debian|Dépôts Debian officiels]] (recommandés) |
| - | Si vous avez une distribution amd64, il vous est possible d'ajouter les dépôts experimental, à condition de faire du [[:doc:systeme:apt:pinning#sid_avec_les_depots_multimedia_de_experimental|pinning pour Multimedia Experimental]] pour leur mettre une faible priorité (1). Qui plus est, une fois de plus, nous ne vous recommandons pas d'utiliser ces dépôts. | + | - [[:doc:systeme:apt:sources.list:depots-tiers|Dépôts tiers]] (à éviter de manière générale) |
| - | <file apt_sources /etc/apt/sources.list># experimental deb-multimedia | + | |
| - | deb http://www.deb-multimedia.org experimental main non-free | + | |
| - | </file></note> | + | |
| - | <note info>La version release de Iceweasel est dans les dépôts officiels ''experimental'', pour les autres versions, utilisez les dépôts des développeurs mozilla. | ||
| - | Exemple : | ||
| - | <file apt_sources /etc/apt/sources.list># iceweasel beta | ||
| - | deb http://mozilla.debian.net/ experimental iceweasel-beta</file></note> | ||
| - | <note warning>Attention, il est nécessaire de créer un fichier de [[:doc:systeme:apt:pinning#testing_avec_sid_non-prioritaire|pinning pour Debian Testing]] afin de donner une priorité 100 aux dépôts **sid** et 1 au dépôt //deb-multimedia// **experimental** éventuels. Sans quoi, vous allez vous retrouvez en sid.</note> | ||
| ===== Aller plus loin ===== | ===== Aller plus loin ===== | ||
| + | Pour trouver de l’aide supplémentaire, il suffit de taper dans le terminal: | ||
| + | |||
| + | <code user>man sources.list</code> | ||
| + | |||
| + | ==== Épinglage ("pinning" en anglais) ==== | ||
| + | |||
| + | L’épinglage (**pinning** en anglais) permet de définir des priorités entre les versions proposées lors de l’installation et la mise à jour d’un paquet. Cela permet notamment d’utiliser un paquet issu d’une version de test ou de rester sur une version définie d’un logiciel. \\ | ||
| + | L’épinglage est défini dans le fichier ''/etc/apt/preferences'' et les fichiers du dossier ''/etc/apt/preferences.d/''. Son utilisation est réservée aux personnes averties. | ||
| - | ==== TP - Création des sources par fichiers distincts ==== | + | Plus d’informations sur [[doc:systeme:apt:pinning|Les fichiers apt_preferences]]. |
| - | testé par **smolski** le 09/09/2013 | + | ==== Installer différentes versions de Debian en parallèle ==== |
| - | Ce tuto se réalise par la ligne de commande en session [[:doc:systeme:superutilisateur]]. | + | Plutôt qu'avoir une frankendebian((une version de debian avec des dépôts ou des branches différentes)), mieux vaut souvent installer une autre Debian en parallèle. Cela peut se faire avec des [[:doc:autres:vm:vm|VM ou des conteneurs]]. |
| + | |||
| + | ==== TP : créer les sources.list via cat ==== | ||
| + | Un petit exercice pratique pour éditer son fichier sources.list grâce à l’utilitaire cat. | ||
| - | === Sources Stables === | + | Retrouver le TP [[doc:systeme:apt:sources.list:tp-creation-des-sources.list-via-cat|TP : créer les sources.list via cat]]. |
| + | |||
| + | ==== sources.list.d ==== | ||
| - | Dans ce TP, on utilise le nom release ''wheezy'' de la stable actuelle. | + | ''/etc/apt/sources.list.d'' est un dossier qui permet d’organiser les dépôts utilisés dans des fichiers de type ''sources.list'' séparés. |
| - | Modifier le nom du sources.list pour le conserver intact : | + | Au final, le gestionnaire de paquet APT ne fera pas de différence mais cette méthode peut s’avérer utile dans l’administration de plusieurs machines, dans le cas d’un système utilisant un grand nombre de dépôts différents, ou simplement pour faire un peu de rangement. |
| - | <code root> mv /etc/apt/sources.list /etc/apt/sources.list-sav</code> | + | |
| - | Nous allons maintenant créer et éditer un à un les fichiers des sources officielles mais aussi des sources multimedia et iceweasel((mozilla)) ainsi :\\ | + | Plus d’informations sur la gestion des dépôts avec ''sources.list.d'' : [[doc:systeme:apt:sources.list:sources.list.d|APT : le dossier sources.list.d]]. |
| - | Créer et rédiger((Voir [[:doc:systeme:cat | la commande cat]])) les fichiers à volonté, par exemple avec ces commandes : | + | ==== liste des miroirs ==== |
| - | <code root>cat > /etc/apt/sources.list.d/00debian-officielle.list <<EOF | + | |
| - | # wheezy | + | |
| - | deb http://ftp.fr.debian.org/debian/ wheezy main contrib non-free | + | |
| - | # wheezy updates | + | |
| - | deb http://ftp.fr.debian.org/debian/ wheezy-updates main contrib non-free | + | |
| - | # wheezy-backports | + | |
| - | deb http://ftp.fr.debian.org/debian wheezy-backports main contrib non-free | + | |
| - | # wheezy security | + | |
| - | deb http://security.debian.org/ wheezy/updates main contrib non-free | + | |
| - | # wheezy proposed updates | + | |
| - | deb http://ftp.fr.debian.org/debian/ wheezy-proposed-updates main contrib non-free | + | |
| - | EOF</code> | + | |
| - | Vérifiez la conformité par [[:doc:editeurs:less | la commande less]] ainsi : | + | Pour trouver l’ensemble des sites miroirs dans le monde. [[https://www.debian.org/mirror/list |liste des miroirs Debian]] |
| - | <code user>less /etc/apt/sources.list.d/00debian-officielle.list</code> | + | |
| - | Puis continuez de même avec les propositions de noms des fichiers suivants : | + | Pour vérifier l’état des serveurs : [[http://ftp.de.debian.org/dmc/ |Vérifier l’état des serveurs]]. |
| - | <code root>cat > /etc/apt/sources.list.d/10deb-multi.list <<EOF | + | |
| - | # wheezy multimedia | + | |
| - | deb http://www.deb-multimedia.org wheezy main non-free | + | |
| - | EOF</code> | + | |
| - | <code root>cat > /etc/apt/sources.list.d/20deb-mozilla.list <<EOF | + | ==== deb.debian.org ==== |
| - | # wheezy iceweasel release | + | |
| - | deb http://mozilla.debian.net/ wheezy-backports iceweasel-release | + | |
| - | EOF</code> | + | |
| - | Enfin, mettez à jour(([[:doc:systeme:apt:apt-get]])). | + | Ce **méta-dépôt** choisira à chaque installation/mise-à-jour de paquets le miroir le plus adapté sans intervention de votre part. |
| + | Description en anglais sur son site officiel : [[http://deb.debian.org/|http://deb.debian.org/]]\\ | ||
| + | Description en français de quelques avantages par rapport à la méthode "ancienne" de définir directement un dépôt, sur le forum debian-facile :[[https://debian-facile.org/viewtopic.php?pid=120850#p120850]] | ||
| - | ===== Outils externes ===== | + | ==== Autres ressources ==== |
| - | - Outil externe pour générer son sources.list sur mesure: | + | * [[http://www.debian.org/releases/proposed-updates.fr.html]] |
| - | [[http://debgen.simplylinux.ch/]] | + | * [[http://www.debian.org/security/]] |
| + | principaux contributeurs: milou, smolski, vv222, nIQnutn, deuchdeb. | ||
