maj readme

This commit is contained in:
Grégory Lebreton 2026-02-05 10:17:39 +01:00
parent d6e1fa6920
commit 542e908842

View File

@ -11,7 +11,36 @@ Ce guide sadresse aux systèmes **Debian / Ubuntu et dérivés**.
---
## 🧱 1. Prérequis
<!-- TOC -->
- [📦 Créer un paquet Debian .deb](#-cr%C3%A9er-un-paquet-debian-deb)
- [Prérequis](#pr%C3%A9requis)
- [Arborescence minimale dun paquet Debian](#arborescence-minimale-dun-paquet-debian)
- [Création des dossiers](#cr%C3%A9ation-des-dossiers)
- [Le fichier DEBIAN/control](#le-fichier-debiancontrol)
- [Exemple complet](#exemple-complet)
- [Champs importants](#champs-importants)
- [Gérer les dépendances](#g%C3%A9rer-les-d%C3%A9pendances)
- [Syntaxe](#syntaxe)
- [Exemples](#exemples)
- [Arborescence complète recommandée](#arborescence-compl%C3%A8te-recommand%C3%A9e)
- [Création rapide](#cr%C3%A9ation-rapide)
- [Scripts Debian postinst, prerm, postrm](#scripts-debian-postinst-prerm-postrm)
- [postinst après installation](#postinst-apr%C3%A8s-installation)
- [prerm avant suppression](#prerm-avant-suppression)
- [Permissions obligatoires](#permissions-obligatoires)
- [Construire le paquet .debb](#construire-le-paquet-debb)
- [Tester le paquet](#tester-le-paquet)
- [Installation](#installation)
- [Vérification](#v%C3%A9rification)
- [Analyse qualité](#analyse-qualit%C3%A9)
- [](#)
<!-- /TOC -->
---
## Prérequis
Outils nécessaires :
```bash
@ -25,7 +54,7 @@ sudo apt install fakeroot
---
## 📁 2. Arborescence minimale dun paquet Debian
## Arborescence minimale dun paquet Debian
Un paquet Debian est **une simple arborescence de fichiers**.
@ -49,7 +78,7 @@ mkdir -p mon-paquet-1.0/usr/bin
---
## 📄 3. Le fichier DEBIAN/control
## Le fichier DEBIAN/control
Le fichier `control` est **obligatoire**.
@ -84,7 +113,7 @@ Description: Exemple de paquet Debian
---
## 🔗 4. Gérer les dépendances
## Gérer les dépendances
Les dépendances sont listées dans `Depends:`.
@ -105,7 +134,7 @@ APT installera automatiquement les dépendances lors de linstallation.
---
## 🧩 5. Arborescence complète recommandée
## Arborescence complète recommandée
```text
mon-paquet-1.0/
@ -137,7 +166,7 @@ mkdir -p mon-paquet-1.0/usr/share/{doc/mon-paquet,applications}
---
## ⚙️ 6. Scripts Debian (postinst, prerm, postrm)
## Scripts Debian (postinst, prerm, postrm)
Ces scripts sont exécutés automatiquement.
@ -169,7 +198,7 @@ chmod 755 mon-paquet-1.0/DEBIAN/postrm
---
## 📦 7. Construire le paquet `.deb`
## Construire le paquet .debb`
```bash
dpkg-deb --build --root-owner-group mon-paquet-1.0
@ -183,7 +212,7 @@ mon-paquet-1.0.deb
---
## 🧪 8. Tester le paquet
## Tester le paquet
### Installation
@ -203,16 +232,8 @@ dpkg -l mon-paquet
lintian mon-paquet-1.0.deb
```
---
## 📚 9. Bonnes pratiques
* ✔ Respecter le FHS (`/usr`, `/etc`, `/var`)
* ❌ Ne jamais utiliser `/usr/local`
* ✔ Utiliser `Architecture: all` pour scripts
* ✔ Versionner correctement
* ✔ Tester sur une VM propre
###
---
✉️ Maintenu par **Le Garage Numérique**
✉️ Maintenu par [**Le Garage Numérique**](mailto:support@lgn.dev)