Misc typo, reword, and droping page that are empty or duplicate

This commit is contained in:
Alexandre Aubin 2024-07-11 00:52:08 +02:00
parent d5c5ce47f5
commit e3fdb5c41f
7 changed files with 18 additions and 52 deletions

View file

@ -1,5 +1,5 @@
--- ---
title: Créer une image du système title: Créer une image complète du système de fichier
template: docs template: docs
taxonomy: taxonomy:
category: docs category: docs
@ -10,8 +10,6 @@ page-toc:
depth: 3 depth: 3
--- ---
!! Les images de cette page sont manquantes
L'outil de sauvegarde de YunoHost ne sauvegarde que les fichiers utiles et se base sur des scripts de restauration pour réinstaller les dépendances de vos applications. Autrement dit, le mécanisme de YunoHost revient à réinstaller, puis réincorporer les données. L'outil de sauvegarde de YunoHost ne sauvegarde que les fichiers utiles et se base sur des scripts de restauration pour réinstaller les dépendances de vos applications. Autrement dit, le mécanisme de YunoHost revient à réinstaller, puis réincorporer les données.
Réaliser des images complètes du système peut être un moyen complémentaire ou alternatif de sauvegarder votre machine. L'intérêt est que votre système pourra être restauré dans l'état exact du moment de la sauvegarde. Réaliser des images complètes du système peut être un moyen complémentaire ou alternatif de sauvegarder votre machine. L'intérêt est que votre système pourra être restauré dans l'état exact du moment de la sauvegarde.
@ -38,6 +36,9 @@ Ci-dessous, quelques documentations pour les fournisseurs les plus connus:
- [Scaleway (EN)](https://www.scaleway.com/en/docs/backup-your-data-with-snapshots/) - [Scaleway (EN)](https://www.scaleway.com/en/docs/backup-your-data-with-snapshots/)
[/ui-tab] [/ui-tab]
[ui-tab title="VirtualBox"] [ui-tab title="VirtualBox"]
!! FIXME: Les images sont manquantes dans cet onglet
Sélectionner la machine virtuelle et cliquer sur `Snapshots`, puis spécifier le nom du snapshot et cliquer sur `OK`. Sélectionner la machine virtuelle et cliquer sur `Snapshots`, puis spécifier le nom du snapshot et cliquer sur `OK`.
![Le bouton snapshot se trouve en haut à droite](image://virtualbox-snapshot2.webp) ![Le bouton snapshot se trouve en haut à droite](image://virtualbox-snapshot2.webp)

View file

@ -1,5 +1,5 @@
--- ---
title: Create a filesystem image title: Snapshotting the entire filesystem
template: docs template: docs
taxonomy: taxonomy:
category: docs category: docs
@ -10,8 +10,6 @@ page-toc:
depth: 3 depth: 3
--- ---
!! Images are missing on this page
Lo strumento di backup di YunoHost salva solamente i files utili e si basa su degli script di ripristino per reinstallare le dipendenze dei vostri programmi installati. In altre parole, il ripristino di YunoHost prevede in un primo tempo la reinstallazione del sistema e in seguito il ripristino dei dati. Lo strumento di backup di YunoHost salva solamente i files utili e si basa su degli script di ripristino per reinstallare le dipendenze dei vostri programmi installati. In altre parole, il ripristino di YunoHost prevede in un primo tempo la reinstallazione del sistema e in seguito il ripristino dei dati.
Realizzare un'immagine completa può essere un metodo, complementare o alternativo, per un backup del vostro server. Il vantaggio sta nel fatto che il vostro server può essere ripristinato nella stessa configurazione presente al momento del backup. Realizzare un'immagine completa può essere un metodo, complementare o alternativo, per un backup del vostro server. Il vantaggio sta nel fatto che il vostro server può essere ripristinato nella stessa configurazione presente al momento del backup.
@ -38,6 +36,9 @@ Sotto la documentazione per i provider più conosciuti:
- [Scaleway (EN)](https://www.scaleway.com/en/docs/backup-your-data-with-snapshots/) - [Scaleway (EN)](https://www.scaleway.com/en/docs/backup-your-data-with-snapshots/)
[/ui-tab] [/ui-tab]
[ui-tab title="VirtualBox"] [ui-tab title="VirtualBox"]
!! FIXME: Images are missing in this section
Seleziona la macchina virtuale e clicca su `Snapshot`, poi indica il nome dello snapshot e clicca `OK`. Seleziona la macchina virtuale e clicca su `Snapshot`, poi indica il nome dello snapshot e clicca `OK`.
![Il bottone per gli snapshot button si trova in alto a destra](image://virtualbox-snapshot2.webp) ![Il bottone per gli snapshot button si trova in alto a destra](image://virtualbox-snapshot2.webp)

View file

@ -1,5 +1,5 @@
--- ---
title: Create a filesystem image title: Snapshotting the entire filesystem
template: docs template: docs
taxonomy: taxonomy:
category: docs category: docs
@ -10,15 +10,13 @@ page-toc:
depth: 3 depth: 3
--- ---
!! Images are missing on this page
YunoHost's backup tool only backs up useful files and relies on restore scripts to reinstall the dependencies of your applications. In other words, YunoHost's mechanism amounts to reinstalling and then reincorporating the data. YunoHost's backup tool only backs up useful files and relies on restore scripts to reinstall the dependencies of your applications. In other words, YunoHost's mechanism amounts to reinstalling and then reincorporating the data.
Making full system images can be a complementary or alternative way to backup your machine. The advantage is that your system can be restored to the exact state it was in at the time of the backup. Making full system images can be a complementary or alternative way to backup your machine. The advantage is that your system can be restored to the exact state it was in at the time of the backup.
Depending on your type of installation, you can either create a snapshot or clone the storage medium by removing it from your server (turned off). Depending on your type of installation, you can either create a snapshot or clone the storage medium by removing it from your server (turned off).
## Trigger a snapshot ## Creating a snapshot
A snapshot allows you to freeze an image of the file system. Snapshots are very useful when doing an update or testing, because they allow you to easily go back in case of a glitch. On the other hand, apart from some very high availability clusters, snapshots do not really protect you against hardware failures or disasters (cf. OVH fire in Strasbourg in 2021). A snapshot allows you to freeze an image of the file system. Snapshots are very useful when doing an update or testing, because they allow you to easily go back in case of a glitch. On the other hand, apart from some very high availability clusters, snapshots do not really protect you against hardware failures or disasters (cf. OVH fire in Strasbourg in 2021).
@ -38,6 +36,9 @@ Below, some documentation for the most known suppliers:
- [Scaleway (EN)](https://www.scaleway.com/en/docs/backup-your-data-with-snapshots/) - [Scaleway (EN)](https://www.scaleway.com/en/docs/backup-your-data-with-snapshots/)
[/ui-tab] [/ui-tab]
[ui-tab title="VirtualBox"] [ui-tab title="VirtualBox"]
!! FIXME: Images are missing in this tab
Select the virtual machine and click `Snapshots`, then specify the snapshot name and click `OK`. Select the virtual machine and click `Snapshots`, then specify the snapshot name and click `OK`.
![The snapshot button is located at the top right](image://virtualbox-snapshot2.webp) ![The snapshot button is located at the top right](image://virtualbox-snapshot2.webp)

View file

@ -1,10 +1,10 @@
--- ---
title: Avoid hardware failure title: Prevent hardware failures
template: docs template: docs
taxonomy: taxonomy:
category: docs category: docs
routes: routes:
default: '/backup/avoid_hardware_failure' default: '/backup/prevent_hardware_failure'
page-toc: page-toc:
active: true active: true
depth: 3 depth: 3
@ -17,13 +17,13 @@ Very often people who self-host don't have proper storage for their system. Leav
## Secure your hard drives ## Secure your hard drives
Ideally, your hard disks should be fixed to avoid vibrations which can accelerate the wear of the equipment or even reduce its performance, especially if there is another disk next to it. Ideally, your hard disks should be fixed to prevent vibrations which can accelerate the wear of the equipment or even reduce its performance, especially if there is another disk next to it.
## Reduce swapiness for SD cards and SSDs ## Reduce swapiness for SD cards and SSDs
If you use a swap file with an SSD or SD card with too much swapiness, your storage media could give up the ghost prematurely due to too many writes. If you use a swap file with an SSD or SD card with too much swapiness, your storage media could give up the ghost prematurely due to too many writes.
To avoid this: To prevent this:
```bash ```bash
cat /proc/sys/vm/swappiness cat /proc/sys/vm/swappiness
@ -48,7 +48,7 @@ In order to limit hardware failures of storage media, it can be relevant to set
There are also more advanced clusters that maximize fault tolerance (failure of 2 disks like RAID6) or storage (see RAID 5). There are also more advanced clusters that maximize fault tolerance (failure of 2 disks like RAID6) or storage (see RAID 5).
However, these disk clustering techniques should not be considered as backups. A RAID array should be considered as a single storage medium. Indeed, if this technique avoids having to reinstall in case of a probable disk crash, it is far from zero risk. However, these disk clustering techniques should not be considered as backups. A RAID array should be considered as a single storage medium. Indeed, if this technique prevents having to reinstall in case of a probable disk crash, it is far from zero risk.
Some examples of situations known to professional system administrators: Some examples of situations known to professional system administrators:

View file

@ -1,22 +0,0 @@
---
title: Install unpackaged apps
template: docs
taxonomy:
category: docs
routes:
default: '/install_unpackaged_apps'
---
## PHP or HTML/JS apps
If your app is a PHP or HTML/JS app, you probably should use the `Custom Webapp`, also know as `my_webapp`, in order to configure nginx, php, mysql, YunoHost permission and backup for you.
## Other technologies
If you use some other technology, you should install it like on a classical Debian.
To expose the app on the web through nginx and be able to manage access permissions to the webapp, you could use the [`redirect` app](https://github.com/YunoHost-Apps/redirect_ynh/) to create a nginx reverse proxy on your local ip/port running the service.
!!! You should use the proxy mode of the redirect app and not HTTP redirections mode.
You probably should create custom backup and restore hooks to integrate your app to your YunoHost backup/restore process. See [Backup and restore hooks](/packaging_apps_hooks#backup-restore)

View file

@ -1,10 +0,0 @@
---
title: Configuration management
template: docs
taxonomy:
category: docs
routes:
default: '/configuration_management'
---
!! This page is to be written

View file

@ -1,5 +0,0 @@
---
title: App helpers
template: docs
redirect: '/packaging_apps_scripts_helpers'
---