Uniformiser un peu plus le langage

This commit is contained in:
François Pelletier 2021-03-07 14:30:43 -05:00
parent 9a36176385
commit f999a8f86d

View file

@ -8,11 +8,11 @@ Note: il est possible que cette la version de l'image par défaut ait changé de
## Création d'une machine virtuelle Debian
On débute par ouvrir le logiciel VirtualBox qui est habituellement disponible via votre distribution Linux ou via le [site web de VirtualBox](https://www.virtualbox.org/)
On débute par ouvrir le logiciel VirtualBox qui est habituellement disponible via la distribution Linux ou via le [site web de VirtualBox](https://www.virtualbox.org/)
![Accueil de Virtualbox](Nextcloud-Installation-VirtualBox-001.png)
Nous allons créer une nouvelle machine virtuelle de Type Linux et de version Debian (64-bit). Veuillez vous assurer que le dossier de la machine contienne au moins 20 Go d'espace libre pour assurer le bon fonctionnement de la machine virtuelle.
On crée une nouvelle machine virtuelle de Type Linux et de version Debian (64-bit). Le dossier de la machine doit avoir au moins 20 Go d'espace libre pour assurer le bon fonctionnement de la machine virtuelle.
![créer une nouvelle machine virtuelle](Nextcloud-Installation-VirtualBox-002.png)
@ -32,7 +32,7 @@ Choisissez la taille du disque à utiliser pour la machine virtuelle. Je conseil
![taille disque](Nextcloud-Installation-VirtualBox-007.png)
Nous avons maintenant une configuration de base. Nous allons ajuster quelques paramètres pour notre besoin.
Nous avons maintenant une configuration de base. On ajuste quelques paramètres pour le besoin.
![configuration de base](Nextcloud-Installation-VirtualBox-008.png)
@ -40,11 +40,11 @@ Je conseille de mettre au moins deux processeurs si possible.
![deux processeurs](Nextcloud-Installation-VirtualBox-009.png)
Si vous le désirez, vous pouvez enregistrer votre installation pour garder une trace pour référence future. C'est d'ailleurs ce que je fais pour préparer cette formation.
Il est possible d'enregistrer l'installation pour garder une trace pour référence future.
![enregistrer](Nextcloud-Installation-VirtualBox-010.png)
Nous allons configurer une redirection de port afin de pouvoir nous connecter à la machine virtuelle en SSH avec une console virtuelle ou un logiciel tel que PuTTY au lieu de devoir utiliser l'interface de VirtualBox.
On configure une redirection de port afin de pouvoir se connecter à la machine virtuelle en SSH avec une console virtuelle ou un logiciel tel que PuTTY au lieu de devoir utiliser l'interface de VirtualBox.
![redirection](Nextcloud-Installation-VirtualBox-011.png)
@ -61,7 +61,7 @@ Ensuite, sélectionner Afficher depuis l'écran d'accueil. Ceci démarre l'insta
![configuration de base](Nextcloud-Installation-VirtualBox-008.png)
Sélectionner l'image ISO du système Debian 10 que vous avez téléchargée préalablement.
Sélectionner l'image ISO du système Debian 10 téléchargée préalablement.
![image ISO](Nextcloud-Installation-VirtualBox-013.png)
@ -73,21 +73,21 @@ Démarrer l'installation
## Installation de Debian
Nous allons maintenant installer le système Debian sur notre machine virtuelle.
On installe le système Debian sur la machine virtuelle.
Choisir l'option "install" comme nous n'installons pas un système avec une interface graphique.
Choisir l'option "install" comme on n'installe pas un système avec une interface graphique.
![install](Nextcloud-Installation-VirtualBox-016.png)
Choisissez votre langue. Cette installation fonctionnera dans toutes les langues disponibles.
Choisissez la langue. Cette installation fonctionnera dans toutes les langues disponibles.
![langue](Nextcloud-Installation-VirtualBox-017.png)
Choisissez votre pays
Choisissez le pays
![pays](Nextcloud-Installation-VirtualBox-018.png)
Choisissez votre disposition de clavier
Choisissez la disposition de clavier
![disposition de clavier](Nextcloud-Installation-VirtualBox-019.png)
@ -127,21 +127,21 @@ Choisissez "non" à cette invite qui demande s'il y a d'autres disques à analys
![disque analyser](Nextcloud-Installation-VirtualBox-027.png)
Choisissez votre pays pour un miroir. Ici, c'est la proximité géographique qui est la plus importante.
Choisissez le pays pour un miroir. Ici, c'est la proximité géographique qui est la plus importante.
![pays du miroir](Nextcloud-Installation-VirtualBox-028.png)
Choisissez ensuite un miroir pour télécharger les packages additionnels de Debian que vous installerez.
Choisissez ensuite un miroir pour télécharger les packages additionnels de Debian qui seront installés.
![miroir](Nextcloud-Installation-VirtualBox-029.png)
Laissez le champ du mandataire vide sauf si vous en avez un (c'est très rare sur un réseau résidentiel)
Laissez le champ du mandataire vide sauf si applicable (c'est très rare sur un réseau résidentiel)
Un autre ensemble de packages sera téléchargé puis installé. En cours de route, vous aurez à répondre à un invite sur popularity-contest. Choisissez Non.
Un autre ensemble de packages sera téléchargé puis installé. En cours de route, il faut répondre à un invite sur popularity-contest. Le choix recommandé est `Non`.
![popularity-contest](Nextcloud-Installation-VirtualBox-030.png)
L'installation se poursuivre par la suite. On vous invitera à choisir différentes options. Comme nous installons Yunohost, nous allons réduire ces options au minimum, car son propre script d'installation s'en chargera.
L'installation se poursuivre par la suite. On aura à choisir différentes options. On réduit ces options au minimum, car Yunohost a son propre script d'installation qui se chargera du reste.
![sélection logiciels](Nextcloud-Installation-VirtualBox-031.png)
@ -156,7 +156,7 @@ Ensuite, choisissez "continuer" et la machine virtuelle redémarrera. Debian est
## Se connecter en SSH sur la machine virtuelle
Pour se connecter sur la machine virtuelle, nous utiliserons le port configuré lors de la création de la machine virtuelle ainsi que l'utilisateur demo.
Pour se connecter sur la machine virtuelle, on utilise le port configuré lors de la création de la machine virtuelle ainsi que l'utilisateur demo.
Dans un terminal, saisir:
@ -164,7 +164,7 @@ Dans un terminal, saisir:
ssh -p 3022 demo@localhost
```
Vous authentifier avec le mot de passe `demo`
S'authentifier avec le mot de passe `demo`
Avec PuTTY
@ -173,7 +173,7 @@ Avec PuTTY
Ensuite, se connecter en tant que root avec `su -` et saisir le mot de passe root `nextcloud` entré lors de l'installation de Debian.
Vous êtes maintenant connecté en tant qu'administrateur sur votre machine virtuelle Debian 10 et prêt à installer Yunohost.
Nous sommes maintenant connecté en tant qu'administrateur sur la machine virtuelle Debian 10 et prêts à installer Yunohost.
```text
(base) ~ ssh -p 3022 demo@localhost
@ -196,17 +196,17 @@ Avec PuTTY:
![putty user](Nextcloud-Installation-VirtualBox-036.png)
Avec un terminal, vous verrez un invite de commandes précédé d'un dièse lorsque connecté en root.
**Note**: Dans un terminal, l'invite de commandes est précédé d'un dièse lorsque connecté en root.
## Installation de screen (optionnel)
Comme nous allons rouler des commandes qui prennent un temps considérable à exécuter, nous allons utiliser screen, qui permet de garder une session active sur le serveur même si la connexion fait défaut.
Pour rouler des commandes qui prennent un temps considérable à exécuter, il est recommandé d'utiliser des sessions screen, qui permettent de garder une session active sur le serveur même si la connexion fait défaut.
```bash
sudo apt install -y screen
```
Pour la suite de ce tutoriel, si vous choisissez d'utiliser screen, nous allons assumer que vous avez lu la [section d'introduction du manuel](https://www.gnu.org/software/screen/manual/screen.html#Getting-Started).
Pour la suite de ce tutoriel, on assume que la [section d'introduction du manuel](https://www.gnu.org/software/screen/manual/screen.html#Getting-Started) de screen ou les principales fonctionnalités sont connues.
## Installation de Yunohost
@ -221,17 +221,17 @@ Lancez l'installation
![débuter installation](Nextcloud-Installation-VirtualBox-037.png)
Laisser Yunohost gérer le SSH. Ce faisant, lorsque vous vous connecterez la prochaine fois, l'utilisateur administrateur sera `admin`. C'est un rôle intermédiaire entre `demo` et `root` en terme de permissions.
Laisser Yunohost gérer le SSH. À la prochaine connexion, l'utilisateur administrateur sera `admin`. C'est un rôle intermédiaire entre `demo` et `root` en terme de permissions.
![gestion ssh](Nextcloud-Installation-VirtualBox-038.png)
Une fois l'installation terminée, nous allons maintenant effectuer la post-installation.
Une fois l'installation terminée, il faut effectuer la post-installation.
Nous aurons besoin d'un nom de domaine pour notre installation. Nous utiliserons `nextcloud.local`.
Un nom de domaine est requis pour l'installation. On utilisera `nextcloud.local`.
Le mot de passe d'administration sera `nextcloud`.
Nous allons aussi créer un premier utilisateur `utilisateur`
On crée un premier utilisateur `utilisateur`
```bash
yunohost user create utilisateur
@ -246,43 +246,43 @@ mail: utilisateur@nextcloud.local
username: utilisateur
```
## Accès à la machine virtuelle comme un serveur séparé sur notre réseau local.
## Accès à la machine virtuelle comme un serveur séparé sur le réseau local
Nous allons maintenant configurer la machine virtuelle en mode "pont" afin qu'elle ait sa propre adresse IP. Ce faisant, nous allons pouvoir associer le nom de domaine à cette adresse pour simplifier les manipulations futures. Ceci va simuler comme si on avait une machine physique séparée ou un serveur avec une adresse IP publique tel un serveur privé virtuel (VPS).
On onfigure maintenant la machine virtuelle en mode "pont" afin qu'elle ait sa propre adresse IP. Le nom de domaine pourra être associé à cette adresse pour simplifier les manipulations futures. Ceci va simuler comme si on avait une machine physique séparée ou un serveur avec une adresse IP publique tel un serveur privé virtuel (VPS).
![reseau pont](Nextcloud-Installation-VirtualBox-039.png)
Nous allons ensuite redémarrer la machine virtuelle depuis VirtualBox (Menu Machine/Redémarrage).
Ensuite, redémarrer la machine virtuelle depuis VirtualBox (Menu Machine/Redémarrage).
Une fois redémarrée, l'affichage VirtualBox de la machine virtuelle affiche son adresse IP. Dans cet exemple, c'est 192.168.0.151.
![reseau pont](Nextcloud-Installation-VirtualBox-040.png)
Dans notre configuration de routeur DHCP à la maison, nous allons figer cette adresse. Voici un exemple pour un routeur D-Link
Dans le configuration de routeur DHCP à la maison, figer cette adresse. Voici un exemple pour un routeur D-Link
![figer IP](Nextcloud-Installation-VirtualBox-041.png)
Nous allons maintenant ajouter notre domaine au fichier "hosts".
On ajoute le domaine au fichier "hosts".
- Sur Windows (éditer en mode administrateur): `C:\Windows\System32\drivers\etc\hosts`
- Sur Linux (éditer avec sudo): `/etc/hosts`
- Sur MacOS (éditer avec sudo): `/private/etc/hosts`
Ajouter la ligne suivante au fichier (Changer selon l'adressse IP de votre machine virtuelle):
Ajouter la ligne suivante au fichier (Changer selon l'adressse IP de la machine virtuelle):
```text
192.168.0.151 nextcloud.local
```
Vous pouvez maintenant vous connecter à votre instance Yunohost via l'adresse `https://nextcloud.local` dans votre navigateur. Attention, le navigateur va vous demander d'accepter le risque d'une adresse sans certificat valide.
On se connecte à l'instance Yunohost via l'adresse `https://nextcloud.local` dans le navigateur. Attention, ça va demander d'accepter le risque d'une adresse sans certificat valide.
![accepter https](Nextcloud-Installation-VirtualBox-042.png)
Une fois arrivé à la fenêtre de connexion, entrez `utilisateur` et `nextcloud`
Une fois arrivé à la fenêtre de connexion, on entre `utilisateur` et `nextcloud`
![connexion](Nextcloud-Installation-VirtualBox-043.png)
Si vous voyez cette fenêtre, vous avez réussi ! Votre installation de Yunohost est fonctionnelle.
Nous avons réussi ! L'installation de Yunohost est fonctionnelle.
![accueil yunohost](Nextcloud-Installation-VirtualBox-044.png)
@ -296,11 +296,11 @@ ssh -p 22 admin@nextcloud.local
On installe une instance de Nextcloud.
```
```bash
sudo yunohost app install nextcloud
```
Vous pouvez conserver les paramètres par défaut proposés à monis que vous désiriez utiliser un sous-domaine. Les paramètres de l'installation devraient ressembler à ceci.
On conserve les paramètres par défaut proposés à moins d'utiliser un sous-domaine. Les paramètres de l'installation devraient ressembler à ceci.
```text
Choose the domain where this app should be installed [nextcloud.local] (default: nextcloud.local):
@ -311,13 +311,13 @@ Access the users home folder from Nextcloud? [yes | no] (default: no):
## Validation de l'installation
Pour vous assurer que l'installation de Nextcloud est bien fonctionnelle, ouvrez l'URL suivante dans votre navigateur: `https://nextcloud.local/nextcloud`
Pour s'assurer que l'installation de Nextcloud est bien fonctionnelle, ouvrez l'URL suivante dans le navigateur: `https://nextcloud.local/nextcloud`
![Interface Nextcloud](Nextcloud-Installation-VirtualBox-045.png)
## Installation d'Elasticsearch
Nous allons installer Elasticsearch comme engin de recherche plein texte
On installe Elasticsearch comme engin de recherche plein texte
```bash
wget -qO - https://artifacts.elastic.co/GPG-KEY-elasticsearch | sudo apt-key add -
@ -332,7 +332,7 @@ Il faut maintenant mettre en place et activer le service pour qu'Elasticsearch r
sudo systemctl enable elasticsearch.service
```
Enfin, nous allons installer et activer le plugin d'indexations de documents pour Elasticsearch
Enfin, il faut installer et activer le plugin d'indexations de documents pour Elasticsearch
```bash
/usr/share/elasticsearch/bin/elasticsearch-plugin install --batch ingest-attachment
@ -364,7 +364,7 @@ Indiquer `http://localhost:9200` comme adresse du Servlet et `nc_index` comme in
## Initialiser l'index
Depuis la session SSH, idéalement dans un screen, nous allons initialiser l'index Elasticsearch. Exécuter en tant que root.
Depuis la session SSH, idéalement dans un screen, on initialise l'index Elasticsearch. Exécuter en tant que root.
```bash
cd /var/www/nextcloud
@ -376,7 +376,7 @@ sudo -u nextcloud php ./occ fulltextsearch:index
## Activer l'indexation en continu
Nous souhaitons que tous les nouveaux documents ajoutés dans Nextcloud soit indexés. Pour ce faire, nous allons créer un service dans systemd qui permet l'indexation en continu.
Tous les nouveaux documents ajoutés dans Nextcloud devraient être indexés. Pour ce faire, on crée un service dans systemd qui permet l'indexation en continu.
Avec un éditeur de texte, ouvrir et modifier le fichier "unit" du service.
@ -404,7 +404,7 @@ Restart=always
WantedBy=multi-user.target
```
Activer et démarrer le service
Apres avoir modifié un fichier "unit" il faut recharger systemd avant d'activer et de démarrer le service.
```bash
systemctl daemon-reload
@ -412,7 +412,7 @@ systemctl enable nextcloud-fulltext-elasticsearch-worker.service
systemctl start nextcloud-fulltext-elasticsearch-worker.service
```
Valider que le service est bien activé
Valider ensuite que le service est bien activé:
```bash
systemctl status nextcloud-fulltext-elasticsearch-worker.service
@ -422,4 +422,4 @@ systemctl status nextcloud-fulltext-elasticsearch-worker.service
On peut utiliser la recherche plein texte depuis l'URL suivante: `https://nextcloud.local/nextcloud/apps/fulltextsearch/`
![exemple recherche](Nextcloud-Installation-VirtualBox-050.png)
![exemple recherche](Nextcloud-Installation-VirtualBox-050.png)