Merge pull request #1264 from ericgaspar/enh-index_fr

Update index_fr.md
This commit is contained in:
Alexandre Aubin 2020-04-26 18:22:28 +02:00 committed by GitHub
commit 3117a2aa83
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
6 changed files with 61 additions and 59 deletions

View file

@ -1,40 +1,42 @@
# Propulser une contribution avec Git
Il est bien sûr possible de contribuer directement sur la documentation de YunoHost, mais ce n'est pas la manière la plus pratique de le faire tant pour le·la contributeur·rice que pour la personne qui va injecter votre contribution dans la documentation. Voici un tutoriel pour comprendre et créer une contribution à la documentation de Yunohost en utilisant l'outil [Git (en)](https://git-scm.com/) et [github.com](http://github.com/) qui est le service de forge Git qui héberge et stocke le code source de YunoHost ainsi que sa documentation.
Il est bien sûr possible de contribuer directement sur la documentation de YunoHost, mais ce nest pas la manière la plus pratique de le faire tant pour le·la contributeur·rice que pour la personne qui va injecter votre contribution dans la documentation. Voici un tutoriel pour comprendre et créer une contribution à la documentation de YunoHost en utilisant loutil [Git (en)](https://git-scm.com/) et [github.com](http://github.com/) qui est le service de forge Git qui héberge et stocke le code source de YunoHost ainsi que sa documentation.
## Création d'un compte sur github.com
Pour pouvoir envoyer vos contributions via GitHub, il est nécessaire d'avoir un compte sur GitHub. Pour créer le compte vous aurez besoin d'une adresse e-mail valide à laquelle vous avez accès. GitHub est un outil puissant qui propose de nombreuses fonctionnalités, l'interface peut être un peu effrayante au début.
Vous n'êtes pas obligé·e de donner vos noms et prénoms, vous pouvez utiliser un pseudonyme (lors de l'inscription `Username`).
## Création dun compte sur github.com
Pour pouvoir envoyer vos contributions via GitHub, il est nécessaire davoir un compte sur GitHub. Pour créer le compte vous aurez besoin dune adresse e-mail valide à laquelle vous avez accès. GitHub est un outil puissant qui propose de nombreuses fonctionnalités, linterface peut être un peu effrayante au début.
Vous nêtes pas obligé·e de donner vos noms et prénoms, vous pouvez utiliser un pseudonyme (lors de linscription `Username`).
## Forker la documentation de YunoHost dans votre dépôt personnel
Forker le code source permet de créer une nouvelle branche de développement d'un code source de logiciel ou dans le cas présent, le code source de la documentation. En créant une nouvelle branche, cela vous permet de modifier le code et d'ajouter vos contributions sans altérer le code de la branche `master` qui est le rendu public de la documentation. Ce qui vous permet de ne pas devoir tout marquer mais le faire en plusieurs étapes. (Notamment pour les contributions demandant plus de temps de travail).
## Forker la documentation de YunoHost dans votre dépôt personnel
Forker le code source permet de créer une nouvelle branche de développement dun code source de logiciel ou dans le cas présent, le code source de la documentation. En créant une nouvelle branche, cela vous permet de modifier le code et dajouter vos contributions sans altérer le code de la branche `master` qui est le rendu public de la documentation. Ce qui vous permet de ne pas devoir tout marquer mais le faire en plusieurs étapes. (Notamment pour les contributions demandant plus de temps de travail).
Forker un projet sur GitHub est extrêmement simple, il suffit de cliquer sur le bouton Fork, cela créera un nouveau dépôt sur votre espace de GitHub.
![Capture d'écran bouton fork GitHub](/images/dug_fork.png)
Dans le titre du nouveau dépôt, vous verrez de quelle provenance vient le dépôt, dans le cas présent `YunoHost/doc`
![Capture d'écran titre et sous-titre du dépot](/images/dug_fork_source.png)
![Capture décran bouton fork GitHub](/images/dug_fork.png)
Dans le titre du nouveau dépôt, vous verrez de quelle provenance vient le dépôt, dans le cas présent `YunoHost/doc`
![Capture décran titre et sous-titre du dépot](/images/dug_fork_source.png)
> **Point de vigilance !**
> Si vous forkez le dépôt d'un·e autre contributeur·rice que yunohost, vous aurez les mêmes fichiers. Sauf que quand vous enverrez vos modifications, elles seront envoyées au contributeur et non au dépôt yunohost. L'avantage est que ça vous permet de développer une autre branche créée par le·la contributeur·rice et ainsi travailler avec une autre personne à une amélioration avant proposition au dépôt principal.
> Il n'est pas possible d'avoir un fork du dépot d'un·e contributeur·rice et le fork dépôt d'origine au même moment dans votre propre dépôt.
> Si vous forkez le dépôt dun·e autre contributeur·rice que YunoHost, vous aurez les mêmes fichiers. Sauf que quand vous enverrez vos modifications, elles seront envoyées au contributeur et non au dépôt YunoHost. Lavantage est que ça vous permet de développer une autre branche créée par le·la contributeur·rice et ainsi travailler avec une autre personne à une amélioration avant proposition au dépôt principal.
> Il nest pas possible davoir un fork du dépot dun·e contributeur·rice et le fork dépôt dorigine au même moment dans votre propre dépôt.
## Modifier et ajouter votre contribution
Une fois le dépôt forké (copié), il faudra créer une nouvelle branche de développement au sein de votre dépôt. C'est à travers cette branche que vous allez modifier les fichiers et ainsi proposer des améliorations de la documentation. Le fait que ce soit une nouvelle branche vous permettra par la suite de faire une Pull Request, c'est à dire une demande d'ajout de vos contributions au sein de la branche `master` qui est la branche principale de la documentation. Les règles de développement sur GitHub changent selon les développeurs de chaque dépôt, certains ont une branche testing dans laquelle il faut proposer les contributions.
Plus d'informations sur ce qu'est une branche sur git-scm.com : [Les branches avec Git - Ce qu'est une branche](https://git-scm.com/book/fr/v1/Les-branches-avec-Git-Ce-qu-est-une-branche).
Une fois le dépôt forké (copié), il faudra créer une nouvelle branche de développement au sein de votre dépôt. Cest à travers cette branche que vous allez modifier les fichiers et ainsi proposer des améliorations de la documentation. Le fait que ce soit une nouvelle branche vous permettra par la suite de faire une Pull Request, cest à dire une demande dajout de vos contributions au sein de la branche `master` qui est la branche principale de la documentation. Les règles de développement sur GitHub changent selon les développeurs de chaque dépôt, certains ont une branche testing dans laquelle il faut proposer les contributions.
Plus dinformations sur ce quest une branche sur git-scm.com : [Les branches avec Git - Ce quest une branche](https://git-scm.com/book/fr/v1/Les-branches-avec-Git-Ce-qu-est-une-branche).
## Envoyer votre contribution par une Pull Request
Faire une Pull Request correspond au moment où vous souhaitez partager votre travail avec le reste des contributeurs⋅rices et l'intégrer au dépot master (dépôt principal de Yunohost). Lors de la publication d'une Pull Request, couramment nommée PR, les contributeurs⋅rices pourront amender, commenter, ajouter, corriger votre contribution avant intégration complète au dépot.
Faire une Pull Request correspond au moment où vous souhaitez partager votre travail avec le reste des contributeurs⋅rices et lintégrer au dépot master (dépôt principal de YunoHost). Lors de la publication dune Pull Request, couramment nommée PR, les contributeurs⋅rices pourront amender, commenter, ajouter, corriger votre contribution avant intégration complète au dépôt.
## Suivre votre contribution et prendre en compte les retours des contributeurs·trices
Lorsque vous avez déjà fait une PR (Pull Request), les modifications de votre branche de développement sur le dépôt Git se rajouteront automatiquement à la PR. Cela ne nécessite aucune action supplémentaire. Vous pouvez aussi intégrer les propositions de modifications de contributeurs, qui lorsqu'ils·elles auditeront le code, peuvent trouver des erreurs ou de nouvelles formulations plus adaptées.
Lorsque vous avez déjà fait une PR (Pull Request), les modifications de votre branche de développement sur le dépôt Git se rajouteront automatiquement à la PR. Cela ne nécessite aucune action supplémentaire. Vous pouvez aussi intégrer les propositions de modifications de contributeurs, qui lorsquils·elles auditeront le code, peuvent trouver des erreurs ou de nouvelles formulations plus adaptées.
## Faire remonter des erreurs et des souhaits par des issues
YunoHost dispose d'un dépôt Git spécifique pour le recueil des issues : [github.com/YunoHost/issues](https://github.com/YunoHost/issues)
Une issue aussi appelé ticket, est un problème identifié ou alors un souhait de développement ; dans le cas présent pour la documentation, mais c'est valable pour tout dépôt logiciel. Dans le cadre de la documentation de YunoHost il sera surtout proposé des issues pour le développement de la documentation, les problèmes identifiés étant facilement corrigeables.
YunoHost dispose dun dépôt Git spécifique pour le recueil des issues : [github.com/YunoHost/issues](https://github.com/YunoHost/issues)
Une issue aussi appelé ticket, est un problème identifié ou alors un souhait de développement ; dans le cas présent pour la documentation, mais cest valable pour tout dépôt logiciel. Dans le cadre de la documentation de YunoHost il sera surtout proposé des issues pour le développement de la documentation, les problèmes identifiés étant facilement corrigeables.
## Aller plus loin avec Git et travailler sur son poste de travail
Utiliser la puissance de Git et ainsi travailler sur son ordinateur personnel, permet entre autres de ne pas avoir à créer de `commit` à chaque enregistrement intermédiaire des pages de documentations modifiées. Cela permet aussi d'utiliser des outils et logiciels qui permettent une distinction plus facile des codes utilisés dans une page de documentation.
Utiliser la puissance de Git et ainsi travailler sur son ordinateur personnel, permet entre autres de ne pas avoir à créer de `commit` à chaque enregistrement intermédiaire des pages de documentations modifiées. Cela permet aussi dutiliser des outils et logiciels qui permettent une distinction plus facile des codes utilisés dans une page de documentation.
- Ressource en ligne : [docs.microsoft.com - Configurer un référentiel Git localement pour la documentation](https://docs.microsoft.com/fr-fr/contribute/get-started-setup-local)

View file

@ -2,8 +2,8 @@
<div class="alert alert-danger">
<b>
Yunohost doesn't support Docker officially since issues with versions 2.4+.
In question, YunoHost 2.4+ doesn't work anymore on Docker
YunoHost doesnt support Docker officially since issues with versions 2.4+.
In question, YunoHost 2.4+ doesnt work anymore on Docker
because YunoHost requires systemd and Docker has chosen to not support it natively (and
there are other problems link to the firewall and services).
</b>
@ -11,13 +11,13 @@ there are other problems link to the firewall and services).
## Community images
However, community images exist and are available on Docker Hub :
However, community images exist and are available on Docker Hub:
* AMD64 (classic)
* https://hub.docker.com/r/domainelibre/yunohost3/ (Yunohost v3)
* https://hub.docker.com/r/domainelibre/yunohost3/ (YunoHost v3)
* I386 (old computers)
* https://hub.docker.com/r/domainelibre/yunohost3-i386/ (Yunohost v3)
* ARMV7 (raspberry pi 2/3 ...)
* https://hub.docker.com/r/domainelibre/yunohost3-arm/ (Yunohost v3)
* ARMV6 (raspberry pi 1)
* https://hub.docker.com/r/tuxalex/yunohost-armv6/ (old yunohost version)
* https://hub.docker.com/r/domainelibre/yunohost3-i386/ (YunoHost v3)
* ARMV7 (Raspberry Pi 2/3 ...)
* https://hub.docker.com/r/domainelibre/yunohost3-arm/ (YunoHost v3)
* ARMV6 (Raspberry Pi 1)
* https://hub.docker.com/r/tuxalex/yunohost-armv6/ (old yunoHost version)

View file

@ -2,8 +2,8 @@
<div class="alert alert-danger">
<b>
Yunohost ne supporte plus officiellement Docker depuis les problèmes rencontrés avec la version 2.4+.
En cause, YunoHost dépend désormait de systemd et docker a décidé qu'ils ne le
YunoHost ne supporte plus officiellement Docker depuis les problèmes rencontrés avec la version 2.4+.
En cause, YunoHost dépend désormait de systemd et docker a décidé quils ne le
supporteraient pas nativement (et il y a d'autres problèmes liés au firewall et aux
services).
</b>
@ -14,10 +14,10 @@ services).
Cependant il existe des images communautaires disponibles sur Docker Hub :
* AMD64 (classique)
* https://hub.docker.com/r/domainelibre/yunohost3/ (Yunohost v3)
* https://hub.docker.com/r/domainelibre/yunohost3/ (YunoHost v3)
* I386 (anciens pc)
* https://hub.docker.com/r/domainelibre/yunohost3-i386/ (Yunohost v3)
* ARMV7 (raspberry pi 2/3 ...)
* https://hub.docker.com/r/domainelibre/yunohost3-arm/ (Yunohost v3)
* ARMV6 (raspberry pi 1)
* https://hub.docker.com/r/tuxalex/yunohost-armv6/ (ancienne version de Yunohost)
* https://hub.docker.com/r/domainelibre/yunohost3-i386/ (YunoHost v3)
* ARMV7 (Raspberry Pi 2/3 ...)
* https://hub.docker.com/r/domainelibre/yunohost3-arm/ (YunoHost v3)
* ARMV6 (Raspberry Pi 1)
* https://hub.docker.com/r/tuxalex/yunohost-armv6/ (ancienne version de YunoHost)

View file

@ -1,14 +1,14 @@
# Fail2ban
# Fail2Ban
**Fail2Ban** is an intrusion prevention software that protects computer servers against brute-force attacks. It monitors certain logs and will ban IP addresses that show brute-force-like behavior.
In particular, **Fail2ban** monitors `SSH` connection attempts. After 5 failed SSH connection attempts, Fail2ban will ban the IP address from connecting via SSH for 10 minutes. If this address fails several times, it might get banned for a week.
In particular, **Fail2Ban** monitors `SSH` connection attempts. After 5 failed SSH connection attempts, Fail2Ban will ban the IP address from connecting via SSH for 10 minutes. If this address fails several times, it might get banned for a week.
## Unban an IP
## Unban an IP address
To unblock an IP address, you must first access your server by some means (for example from another IP or from another internet connection than the banned one).
To unblock an IP address, you must first access your server by some means (for example from another IP address or from another internet connection than the banned one).
Then, look at the **fail2ban's log** to identify in which `jail` the IP has been banned:
Then, look at the **Fail2Bans log** to identify in which `jail` the IP address has been banned:
```bash
sudo tail /var/log/fail2ban.log
@ -21,7 +21,7 @@ sudo tail /var/log/fail2ban.log
2019-01-07 16:24:57 fail2ban.filter [1837]: NOTICE [recidive] Ban 11.22.33.44
```
Here, the `11.22.33.44` IP has been banned in the `sshd` and `recidive` jails.
Here, the `11.22.33.44` IP address has been banned in the `sshd` and `recidive` jails.
Then deban the IP address with the following commands:
@ -30,9 +30,9 @@ sudo fail2ban-client set sshd unbanip 11.22.33.44
sudo fail2ban-client set recidive unbanip 11.22.33.44
```
## Whitelist an IP
## Whitelist an IP address
If you don't want a "legitimate" IP address to be blocked by **YunoHost** anymore, then you have to fill it in the whitelist of the `jail` configuration file.
If you dont want a "legitimate" IP address to be blocked by **YunoHost** anymore, then you have to fill it in the whitelist of the `jail` configuration file.
When updating the **Fail2ban** software, the original `/etc/fail2ban/jail.conf` file is overwritten. So it is on a new dedicated file that we will store the changes. They will thus be preserved over time.
@ -56,7 +56,7 @@ When updating the **Fail2ban** software, the original `/etc/fail2ban/jail.conf`
ignoreip = 127.0.0.1/8 XXX.XXX.XXX.XXX #<= the IP address (you can put more than one, separated by a space) that you want to whitelist
```
4. Save the file and reload the fail2ban configuration:
4. Save the file and reload the Fail2Ban configuration:
```bash
sudo fail2ban-client reload

View file

@ -1,14 +1,14 @@
# Fail2ban
# Fail2Ban
**Fail2Ban** est un logiciel de prévention des intrusions qui protège les serveurs informatiques contre les attaques de brute-force. Il surveille certains journaux et bannira les adresses IP qui montrent un comportement de brute-forcing.
En particulier, **Fail2ban** surveille les tentatives de connexion `SSH`. Après 5 tentatives de connexion échouées sur SSH, Fail2ban banniera l'adresse IP de se connecter via SSH pendant 10 minutes. Si cette adresse récidive plusieurs fois, elle peut être bannie pendant une semaine.
En particulier, **Fail2Ban** surveille les tentatives de connexion `SSH`. Après 5 tentatives de connexion échouées sur SSH, Fail2Ban banniera ladresse IP pendant 10 minutes. Si cette adresse récidive plusieurs fois, elle peut être bannie pendant une semaine.
## Débannir une IP
## Débannir une adresse IP
Pour débloquer une addresse IP, vous devez d'abord accéder à votre serveur par un moyen quelconque (par exemple à partir d'une autre adresse IP ou d'une autre connexion internet que celle bannie).
Pour débloquer une addresse IP, vous devez dabord accéder à votre serveur par un moyen quelconque (par exemple à partir dune autre adresse IP ou dune autre connexion internet que celle bannie).
Ensuite, regardez le **journal de fail2ban** pour identifier dans quelle `prison` ou `jail` l'adresse IP a été bannie :
Ensuite, regardez le **journal de Fail2Ban** pour identifier dans quelle `prison` ou `jail` ladresse IP a été bannie :
```bash
sudo tail /var/log/fail2ban.log
@ -21,20 +21,20 @@ sudo tail /var/log/fail2ban.log
2019-01-07 16:24:57 fail2ban.filter [1837]: NOTICE [recidive] Ban 11.22.33.44
```
Ici, l'IP `11.22.33.44` a été bannie dans les jails `sshd` et `recidive`.
Ici, ladresse IP `11.22.33.44` a été bannie dans les jails `sshd` et `recidive`.
Puis débanissez l'adresse IP avec les commandes suivantes :
Puis débanissez ladresse IP avec les commandes suivantes :
```bash
sudo fail2ban-client set sshd unbanip 11.22.33.44
sudo fail2ban-client set recidive unbanip 11.22.33.44
```
## Passer une IP en liste blanche / whitelist
## Passer une adresse IP en liste blanche / whitelist
Si vous ne voulez plus qu'une adresse IP "légitime" soit bloquée par **YunoHost**, alors il faut la renseigner dans la liste blanche ou whitelist du fichier de configuration de la `prison`.
Si vous ne voulez plus quune adresse IP « légitime » soit bloquée par **YunoHost**, alors il faut la renseigner dans la liste blanche ou whitelist du fichier de configuration de la `prison`.
Lors d'une mise à jour du logiciel **Fail2ban**, le fichier d'origine `/etc/fail2ban/jail.conf` est écrasé. C'est donc dans un nouveau fichier que nous allons stocker les modifications. Elles seront ainsi conservées dans le temps.
Lors dune mise à jour du logiciel **Fail2Ban**, le fichier dorigine `/etc/fail2ban/jail.conf` est écrasé. Cest donc dans un nouveau fichier que nous allons stocker les modifications. Elles seront ainsi conservées dans le temps.
1. Commencez par créer le nouveau fichier de configuration des prisons qui sappelera `yunohost-whitelist.conf` :
@ -48,7 +48,7 @@ Lors d'une mise à jour du logiciel **Fail2ban**, le fichier d'origine `/etc/fai
sudo nano /etc/fail2ban/jail.d/yunohost-whitelist.conf
```
3. Coller le contenu suivant dans le fichier et adapter l'adresse IP `XXX.XXX.XXX.XXX` :
3. Coller le contenu suivant dans le fichier et adapter ladresse IP `XXX.XXX.XXX.XXX` :
```bash
[DEFAULT]
@ -56,7 +56,7 @@ Lors d'une mise à jour du logiciel **Fail2ban**, le fichier d'origine `/etc/fai
ignoreip = 127.0.0.1/8 XXX.XXX.XXX.XXX #<= l'adresse IP (on peut en mettre plusieurs, séparées par un espace) que vous voulez passer en liste blanche / whitelist
```
4. Sauvegardez le fichier et rechargez la configuration de fail2ban :
4. Sauvegardez le fichier et rechargez la configuration de Fail2Ban :
```bash
sudo fail2ban-client reload

View file

@ -27,7 +27,7 @@
<div class="boring-part" markdown="1">
<h1><small>Avec</small> YunoHost<small>, gère facilement un serveur pour tes amis, ton asso, ton entreprise.</small> <a href="/whatsyunohost" style="font-size:0.6em;">En savoir plus</a></small></h1>
<h1><small>Avec</small> YunoHost<small>, gérez facilement un serveur pour vos amis, votre association, votre entreprise.</small> <a href="/whatsyunohost" style="font-size:0.6em;">En savoir plus</a></small></h1>
<div class="home-panel">
<img src="/images/home_panel.jpg" />
@ -71,8 +71,8 @@
<div class="row cf">
<div class="col-md-7 text-right">
<h1>Construisez <small>votre petit bout d'Internet en ajoutant des applications en quelques clics</small></h1>
<p><br /><a href="/apps">Parcourir le catalogue d'applications</a></p>
<h1>Construisez <small>votre petit bout dInternet en ajoutant des applications en quelques clics</small></h1>
<p><br /><a href="/apps">Parcourir le catalogue dapplications</a></p>
</div>
<div class="col-md-4">
<div class="feature-pic">