Ajout du guide PDF HestiaCP réutilisable (HestiaCP 1.10.4)
- 14 chapitres + annexe en Markdown (chapitres/), 99 étapes - Générateur WeasyPrint (build/build.py) : PDF générique ou personnalisé via --vars fichier.conf - PDF générique + PDF personnalisé srv1.skglobalinstitute.com - Commandes v-* vérifiées contre le code source HestiaCP 1.10.4 - 03-bis-hestiacp.md pointe vers le nouveau guide Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_018J2PsVQ28oW4xEkWJpcU9G
This commit is contained in:
61
hestiacp/chapitres/99-annexe.md
Normal file
61
hestiacp/chapitres/99-annexe.md
Normal file
@@ -0,0 +1,61 @@
|
||||
# Annexe : adresses et régénération du guide
|
||||
|
||||
## Récapitulatif des adresses
|
||||
|
||||
| Service | Adresse |
|
||||
|---|---|
|
||||
| Panel HestiaCP | `https://{{FQDN}}:{{PANEL_PORT}}` |
|
||||
| SSH administrateur | `ssh -p {{SSH_PORT}} {{USER}}@{{IP}}` |
|
||||
| SSH déploiement | `ssh -p {{SSH_PORT}} {{CLIENT}}@{{IP}}` |
|
||||
| Webmail | `https://webmail.{{DOMAINE}}` |
|
||||
| Mail (IMAP / SMTP) | `mail.{{DOMAINE}}` : 993 / 465 ou 587 |
|
||||
| phpMyAdmin | `https://{{FQDN}}/<alias-du-chapitre-4>/` |
|
||||
| Portainer | `https://portainer.{{DOMAINE}}` |
|
||||
| Uptime Kuma | `https://status.{{DOMAINE}}` |
|
||||
| Netdata | tunnel SSH puis `http://localhost:19999` |
|
||||
| Serveurs DNS | `ns1.{{DOMAINE}}`, `ns2.{{DOMAINE}}` → {{IP}} |
|
||||
|
||||
## Générer ce guide pour un autre VPS
|
||||
|
||||
Ce PDF est produit à partir de fichiers Markdown, qui se trouvent dans le dépôt `vps-docs`, dossier `hestiacp/` :
|
||||
|
||||
| Élément | Rôle |
|
||||
|---|---|
|
||||
| `chapitres/*.md` | Le contenu, un fichier par chapitre ; `{{…}}` marque une variable |
|
||||
| `vps.conf.exemple` | Modèle de fichier de variables |
|
||||
| `build/build.py` | Le générateur (Markdown → HTML → PDF avec WeasyPrint) |
|
||||
| `build/style.css`, `build/fonts/` | La mise en page et les polices |
|
||||
| `build/meta.conf` | Version de HestiaCP et date de vérification affichées en couverture |
|
||||
|
||||
Installez une fois les outils (Ubuntu ou Debian) :
|
||||
|
||||
```bash
|
||||
sudo apt install -y python3-venv libpango-1.0-0 libpangoft2-1.0-0
|
||||
python3 -m venv ~/.venvs/guide
|
||||
~/.venvs/guide/bin/pip install weasyprint markdown pygments
|
||||
```
|
||||
|
||||
Puis, pour un nouveau VPS :
|
||||
|
||||
```bash
|
||||
cd vps-docs/hestiacp
|
||||
cp vps.conf.exemple nouveau-vps.conf
|
||||
micro nouveau-vps.conf
|
||||
~/.venvs/guide/bin/python build/build.py --vars nouveau-vps.conf
|
||||
```
|
||||
|
||||
Le fichier `Guide-VPS-HestiaCP-<FQDN>.pdf` est créé, avec toutes les valeurs déjà remplies. Sans `--vars`, vous obtenez la version générique.
|
||||
|
||||
> [!WARNING] Avant chaque nouvelle installation
|
||||
> HestiaCP évolue vite. Avant d'installer un nouveau serveur :
|
||||
> - consultez les notes de version sur <https://github.com/hestiacp/hestiacp/releases> ;
|
||||
> - vérifiez les options de l'installeur avec `bash hst-install.sh -h` ;
|
||||
> - en cas de doute sur une commande `v-…`, lisez son en-tête : `head -12 /usr/local/hestia/bin/<commande>` ;
|
||||
> - mettez à jour `build/meta.conf` après vérification.
|
||||
|
||||
## Sources officielles
|
||||
|
||||
- Documentation HestiaCP : <https://hestiacp.com/docs/>
|
||||
- Code source et scripts `v-*` : <https://github.com/hestiacp/hestiacp>
|
||||
- Forum : <https://forum.hestiacp.com>
|
||||
- Installation de Docker : <https://docs.docker.com/engine/install/ubuntu/>
|
||||
Reference in New Issue
Block a user