✎ apt-get [Wiki ubuntu-fr]

Vous affichez une ancienne révision du document ! Si vous l'enregistrez, vous créerez une nouvelle version avec ce contenu.

====== APT ======

**Apt** autrefois **Apt-get**, est un outil logiciel à utiliser en [[:commande_shell|ligne de commande]].\\
Il permet d'effectuer l'installation et la désinstallation de paquets en provenance d'un [[:depots|dépôt APT]].

<note>Depuis [[http://packages.ubuntu.com/search?suite=default&section=all&arch=any&searchon=names&keywords=apt|apt 0.7]] (et donc sur toutes les versions actuellement supportées d'Ubuntu), **apt** et **[[:aptitude]]**, (et par conséquent aussi les interfaces graphiques qui les utilisent, par ex **Synaptic** et la **Logithèque Ubuntu**), partagent les mêmes informations. L'utilisation alternée de l'un ou l'autre ne présente donc pas de risque. [[http://raphaelhertzog.com/2011/06/20/apt-get-aptitude-%E2%80%A6-pick-the-right-debian-package-manager-for-you|Source]]</note>

La commande **apt** centralise les actions les plus communes pour l'utilisateur classique (install/remove/full-upgrade/search/list) et ajoute quelques fonctionnalités de façon à rendre l'usage de celles-ci plus "sympathiques" (couleurs dans les retours + certaines actions activées par défaut), voir **man apt** pour plus d'informations.

===== Pré-requis =====

Pour utiliser ''apt'', vous devez disposer des [[:sudo|droits d'administration]].\\ 
Si vous ne faites que télécharger les codes sources, vous pouvez vous passer des droits d'administration. Les paquets téléchargés sont placés dans votre dossier personnel.

==== Vérifier la version ====
Avant de lancer l'installation, il est parfois utile de vérifier la version qui sera installée, les dépendances…:\\
<code>apt show <nom_du_paquet></code>
==== Installation d'une version présente dans les dépôts ====

* <code>sudo apt install <paquet>=<version> -V</code> L'option **''=<version>''** passée à **''apt install''** permet d'**installer la version souhaitée du paquet indiqué**.
Très utile pour revenir à une version officielle d'un paquet (qui aurait été "upgradé à la main").

==== Installation avec réponse oui ====

* <code>sudo apt install -y <paquet(s)></code> L'option -y permet de répondre oui par avance aux demandes de confirmations. Utile pour une utilisation dans un script, par exemple.

==== Réparer une installation ====
Bien que ce cas de figure soit un peu rare, il peut arriver qu'une dépendance vienne à manquer à un logiciel installé sur votre système.\\
La commande suivante permettra de résoudre le problème :
<code>sudo apt install -f</code>
Il faut cependant que la dépendance soit disponible dans les dépôts.
<note tip>Utilisée avec ''install'' ou ''remove'', cette commande exclura le paquet spécifié pour rechercher une solution viable pour le système.\\
Exemple :
<code>sudo apt -f install vlc</code>
recherchera une solution pour faire fonctionner [[vlc|VLC media player]] sans corrompre le système (FIXME).
</note>

==== Forcer une installation ====
Il n'existe pas de solution sur apt pour forcer une installation. [[dpkg|Dpkg]] a quelques options dans ce sens, mais qui ne résolvent pas toutes les situations pour autant.
<code>sudo dpkg -i --force-overwrite package.deb
sudo dpkg -i --force-all package.deb</code>

==== Trouver un paquet ====

Pour rechercher un paquet dans vos [[:dépôts]], tapez simplement la commande suivante :
<code>apt-cache search <word1 word2 ...></code>

L'option ''search'' passée à ''apt-cache'' permet de chercher les paquets contenant certains mots.

<note>Les réponses dépendent de vos dépôts et peuvent donc différer d'un système à l'autre.</note>

<note tip> Pour rechercher un paquet installé, il faut utiliser [[dpkg]], par exemple :
<code>dpkg -l NomDuPaquet</code></note>

==== Obtention des codes sources ====

* <code>apt source <paquet(s)></code> L'option ''source'' passée à ''apt'' permet de **télécharger les paquets de codes sources indiqués**.

**''sudo''** n'est pas utilisé ici parce que ce n'est pas nécessaire. Le paquet sera enregistré dans votre //Dossier Personnel//.

Notez que "apt source" se sert des entrées "deb-src" dans le fichier **/etc/apt/sources.list** ou autres dans **/etc/apt/sources.list.d**.

L'instruction "apt source" va de pair avec "apt build-dep", qui installera les dépendances du paquet. Exemple complet:
<code>
apt install build-essential fakeroot
cd /tmp
apt source nano
apt build-dep nano
cd nano-2.2.6/
dpkg-buildpackage -rfakeroot -us -b
</code>

===== Suppression de paquets =====

==== Principe ====

* <code>sudo apt remove <paquets(s)></code> L'option ''remove'' permet de **désinstaller les paquets indiqués**.  //Ceci laisse toutefois en place les fichiers de configuration de ces paquets.//
  * <code>sudo apt autoremove <paquets(s)></code> L'option ''autoremove'' permet de **désinstaller les paquets indiqués avec leurs dépendances logicielles**.  //Ceci laisse toutefois en place les fichiers de configuration de ces paquets.//

==== Suppression + purge ====

* <code>sudo apt purge <paquets(s)></code> L'action ''purge'', passée à la commande ''apt'', **désinstalle les paquets indiqués **et** leurs fichiers de configuration** ((ceux marqués comme "conffile", souvent placés dans /etc.)). //Les fichiers de préférences((dans les dossiers personnels)), et les logs((dans le /var)) ne sont pas supprimés.//

* <code>sudo apt autoremove --purge <paquets(s)></code> L'option ''%%--%%purge'', passée à la commande ''autoremove'', **désinstalle les paquets indiqués, les dépendances logicielles et leurs fichiers de configuration** ((ceux marqués comme "conffile", souvent placés dans /etc.)). //Les fichiers de préférences((dans les dossiers personnels)), et les journaux (logs) ((dans le /var)) ne sont pas supprimés.//

* <code>sudo apt autoremove --purge</code> L'option ''%%--%%purge'', passée à la commande ''autoremove'' **sans** nom de paquet, **désinstalle toutes les dépendances devenues inutiles et leurs fichiers de configuration** ((ceux marqués comme "conffile", souvent placés dans /etc.)). //Les fichiers de préférences((dans les dossiers personnels)), les journaux (logs) ((dans le /var)) et ceux, des anciens noyaux, marqués "d'installation manuelle" ne sont pas supprimés.//

==== Suppression de paquets d'installation ====

APT conserve une copie de chaque paquet installé et désinstallé sur votre disque dur (dans le dossier ///var/cache/apt/archives//). Utiliser les options ci-dessous permet de récupérer de l'espace disque par le nettoyage correspondant à l'option.

* <code>sudo apt clean</code> L'option ''clean'', option radicale, **supprime la totalité des paquets** présents dans ///var/cache/apt/archives//. (//Notez que cela n'a aucun impact sur les paquets installés.//)
  * <code>sudo apt autoclean</code> L'option ''autoclean'' permet de **supprimer les paquets** présents dans ///var/cache/apt/archives// , mais **en conservant ceux qui ont un équivalent dans les dépôts**; par exemple, si  ///var/cache/apt/archives// contient plusieurs versions du même logiciel, les plus anciennes, plus présentes dans les dépôts, seront supprimées, mais la version à jour (ayant un équivalent dans le dépôt) sera conservée. //Ceci vous permet de récupérer beaucoup d'espace disque//, mais moins toutefois qu'avec "clean".

===== Mises à jour =====
==== Mise à jour dépôts ====

* <code>sudo apt update</code> L'option ''update'' **met à jour la liste des fichiers disponibles dans les dépôts APT présents dans le fichier de configuration ''/etc/apt/sources.list''**.  L'exécuter régulièrement est une bonne pratique, afin de maintenir à jour votre liste de paquets disponibles.

==== Mise à jour de paquets ====

* <code>sudo apt install <paquet(s)> -V</code> L'option ''install'' met à jour les paquets **indiqués** déjà installés, vers leurs dernières versions  (rarement utilisé).

*  <code>apt --simulate upgrade</code> L'option  ''simulate'' simule la mise à jour des paquets sans réellement les installer (rarement utilisé).

* <code>sudo apt upgrade</code> L'option ''upgrade'' met à jour **tous les paquets installés sur le système** vers les dernières versions (couramment utilisé).

* <code>sudo apt dist-upgrade</code> L'option ''dist-upgrade'' met à jour tous les paquets installés vers les dernières versions **en installant de nouveaux paquets si nécessaire**, par opposition à l'upgrade simple qui n'ajoute pas de nouveaux paquets.

Remarque : taper "man apt" dans un terminal donne une réponse en français et une explication plus complète et plus claire.

==== Bloquer la mise à jour d'un paquet ====
[[:tutoriel:comment_modifier_un_fichier|Ouvrez avec les droits d'administration]] le fichier **/etc/apt/preferences** (si le fichier n'existe pas, le créer) pour y insérer les lignes suivantes:
<file>Package: nom_du_paquet
Pin: version du paquet à conserver
Pin-priority: 1001</file>
La Priorité du Pin à 1001 bloque les futures mises à jour :-)

== Exemple == 
Si par exemple vous souhaiter conserver la version 0.8.8 de kaffeine, vous indiquerez dans **/etc/apt/preferences**
<file>Package: kaffeine
Pin: version 0.8.8
Pin-priority: 1001</file>
Dans le doute, vérifier en tapant la commande **sudo apt-cache policy nom_du_paquet**, pour l'exemple du paquet kaffeine
<code>sudo apt-cache policy kaffeine</code>

<note tip>Une méthode plus simple (toujours avec le paquet kaffeine):

//__Pour les utilisateurs d'apt__ ://
<code bash>sudo apt-mark hold kaffeine</code>
Pour vérifier que le paquet n'a plus le statut install mais hold ((bloqué)) :
<code bash>apt-mark showhold</code> devrait afficher
<code>kaffeine</code> dans la liste des réponses

Pour le débloquer :
<code bash>sudo apt-mark unhold kaffeine</code>
[[https://manpages.debian.org/testing/apt/apt-mark.8.fr.html|Source]]

//__Pour les utilisateurs d'[[:aptitude]]__((merci à cthuluh #debian-fr))://

Pour geler un paquet
<code bash>sudo aptitude hold kaffeine</code>

Pour dégeler un paquet
<code bash>sudo aptitude unhold kaffeine</code>

Pour lister les paquets gelés : 
<code bash>sudo dpkg --list | grep ^hi</code>
ou
<code bash>sudo aptitude search "~ahold"</code>

Remplacer kaffeine par le paquet que vous voulez bloquer ;)</note>

==== Sauvegarde de la liste ====
Voir [[:tutoriel:comment_sauver_et_restaurer_la_liste_des_paquets|cette page]] pour pouvoir facilement faire une sauvegarde de la liste des paquets installés.

==== Mises à jour automatisées ====

[[:tutoriel:comment_installer_un_paquet|Installer le paquet]] **[[apt>unattended-upgrades|unattended-upgrades]]** et lire cette [[https://help.ubuntu.com/14.04/serverguide/automatic-updates.html|documentation]] //(en français)//.\\ 
Si vous le souhaitez, vous pouvez paramétrer uniquement les mises à jour de sécurité en automatique.

==== Mettre en cache pour un déploiement sur réseau local ====
Si vous disposez d'un réseau local, pour économiser de la bande passante externe lors des mises à jours vous pouvez mettre en cache sur une des machines les paquets téléchargés et les déployer ensuite sur les autres postes en faisant appel à [[:apt-cacher]].

===== Divers =====
==== Utiliser un proxy ====

Il suffit d'exporter les paramètres du [[:proxy]] à utiliser dans la [[:variables d'environnement|variable d'environnement]] **http_proxy**, sous la forme suivante :
<code>export http_proxy=http://utilisateur:motdepasse@example.com:port</code>
où :
  * //utilisateur// est le nom d'utilisateur pour se connecter au proxy si nécessaire, 
  * //mot de passe// le mot de passe éventuellement associé
  * //example.com// l'adresse du proxy,
  * //port// le port pour y accéder.

Pour rendre le changement permanent vous pouvez rajouter la ligne dans le fichier **.bashrc** ou créer un fichier **proxy** dans **/etc/apt/apt.conf.d/proxy** puis rajouter la ligne suivante :
<file>
Acquire::http::Proxy "http://utilisateur:motdepasse@example.com:port";
</file>

Pour un proxy FTP ajouter une partie comme suit :
<file>
Acquire::ftp
{
 Proxy "ftp://proxy:2121/";
 ProxyLogin
 {
   "USER $(SITE_USER)@$(SITE)";
   "PASS $(SITE_PASS)";
 }
}
</file>
N'oubliez pas, bien sûr, de changer le nom d'hôte proxy et le port.

==== Suppression d'un proxy ====

- Allez dans //Système -> Préférences ->Serveur Mandataire//
  - Décochez "Configuration manuelle du  serveur mandataire"
  - Cochez "Connexion direct à internet" 
  - Cliquez sur "Appliquer à l'ensemble du système"
  - Fermez
  - [[:tutoriel:comment_modifier_un_fichier|Ouvrez avec les droits d'administration]] le fichier **/etc/apt/apt.conf**
  - Effacez la ou les ligne(s) en rapport avec le proxy
  - Après enregistrement, redémarrez votre PC

Et voilà il n'y a plus de proxy

==== Limiter la vitesse téléchargement  ====
[[:tutoriel:comment_modifier_un_fichier|Créer avec les droits d'administration]] le fichier **/etc/apt/apt.conf.d/76download** et copier les lignes suivantes pour limiter le téléchargement.\\
Par exemple ici à 25kB/s :
<file>
Acquire
{
Queue-mode "access";
http
{
Dl-Limit "25";
};
};
</file>

==== Historique  ====
   *  Le log (ou historique) des actions de apt se trouve dans **/var/log/apt/** 
<code> less /var/log/apt/history.log</code>

**history.log** correspond à l'historique du mois en cours.

* À la fin de chaque mois, ce fichier est archivé sous la forme history.log.1.gz
On affiche un tel fichier archivé avec zless
<code>zless /var/log/apt/history.log.1.gz </code>

===== Voir aussi =====

* [[:apt-fast|apt-fast]]
  * [[http://www.debian.org/doc/manuals/apt-howto/ch-apt-get.fr.html|Manuel Debian sur APT : Gestion des paquets]]
  * [[:probleme_apt|Problèmes avec les gestionnaires de paquets]]
----
//Contributeurs : [[:utilisateurs:trhilkil|TrHiLKiL]], [[:utilisateurs:ste]], Emmanuel Gontcho, [[:utilisateurs:david96|david96]], [[:utilisateurs:boogy]], [[:utilisateurs:crustyourmind|Crustyourmind]] .//

Merci de recopier le code ci-contre pour prouver que vous êtes humain : H K H U S Merci de laisser ce champ vide :

Résumé

Note : En modifiant cette page, vous acceptez que le contenu soit placé sous les termes de la licence suivante : CC Paternité-Partage des Conditions Initiales à l'Identique 3.0 Unported