maj readme
This commit is contained in:
parent
d6e1fa6920
commit
542e908842
57
README.md
57
README.md
@ -11,7 +11,36 @@ Ce guide s’adresse 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 d’un 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 d’un paquet Debian
|
||||
## Arborescence minimale d’un 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 l’installation.
|
||||
|
||||
---
|
||||
|
||||
## 🧩 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)
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user