From ad1c3e1333f6208f595e448bc745b76d8b87aa78 Mon Sep 17 00:00:00 2001 From: Alexandre Aubin Date: Sat, 6 Feb 2021 23:27:51 +0100 Subject: [PATCH] Merge commandline into ssh.md --- .../04.learn/03.webadmin/admin.es.md | 18 --------- .../04.learn/03.webadmin/admin.fr.md | 19 ---------- .../04.learn/03.webadmin/admin.md | 18 --------- .../04.commandline/02.cli/commandline.es.md | 37 ------------------- .../04.commandline/02.cli/commandline.fr.md | 37 ------------------- .../04.commandline/02.cli/commandline.md | 37 ------------------- .../04.commandline/{01.ssh => }/ssh.de.md | 30 +++++++++++++++ .../04.commandline/{01.ssh => }/ssh.es.md | 31 ++++++++++++++++ .../04.commandline/{01.ssh => }/ssh.fr.md | 31 ++++++++++++++++ .../04.commandline/{01.ssh => }/ssh.it.md | 29 +++++++++++++++ .../04.commandline/{01.ssh => }/ssh.md | 33 ++++++++++++++++- 11 files changed, 153 insertions(+), 167 deletions(-) delete mode 100644 pages/01.administrate/04.learn/03.webadmin/admin.es.md delete mode 100644 pages/01.administrate/04.learn/03.webadmin/admin.fr.md delete mode 100644 pages/01.administrate/04.learn/03.webadmin/admin.md delete mode 100644 pages/01.administrate/04.learn/04.commandline/02.cli/commandline.es.md delete mode 100644 pages/01.administrate/04.learn/04.commandline/02.cli/commandline.fr.md delete mode 100644 pages/01.administrate/04.learn/04.commandline/02.cli/commandline.md rename pages/01.administrate/04.learn/04.commandline/{01.ssh => }/ssh.de.md (75%) rename pages/01.administrate/04.learn/04.commandline/{01.ssh => }/ssh.es.md (71%) rename pages/01.administrate/04.learn/04.commandline/{01.ssh => }/ssh.fr.md (69%) rename pages/01.administrate/04.learn/04.commandline/{01.ssh => }/ssh.it.md (75%) rename pages/01.administrate/04.learn/04.commandline/{01.ssh => }/ssh.md (67%) diff --git a/pages/01.administrate/04.learn/03.webadmin/admin.es.md b/pages/01.administrate/04.learn/03.webadmin/admin.es.md deleted file mode 100644 index 8453c7ad..00000000 --- a/pages/01.administrate/04.learn/03.webadmin/admin.es.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: La interfaz de administración web -template: docs -taxonomy: - category: docs -routes: - default: '/admin' ---- - -YunoHost tiene una interfaz gráfica de administración. El otro método consiste en utilizar la [linea de comando](/commandline). - -### Acceso - -La interfaz admin está accesible desde tu instancia YunoHost en esta dirección : https://ejemplo.org/yunohost/admin (reemplaza ejemplo.org por tu nombre de dominio) - -
- -
diff --git a/pages/01.administrate/04.learn/03.webadmin/admin.fr.md b/pages/01.administrate/04.learn/03.webadmin/admin.fr.md deleted file mode 100644 index bb04c026..00000000 --- a/pages/01.administrate/04.learn/03.webadmin/admin.fr.md +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: L'interface d'administration Web -template: docs -taxonomy: - category: docs -routes: - default: '/admin' ---- - -YunoHost est fourni avec une interface graphique d’administration. L’autre méthode est d’utiliser la [ligne de commande](/commandline). - -### Accès - -L’interface admin est accessible depuis votre instance YunoHost à l’adresse https://exemple.org/yunohost/admin (remplacez exemple.org par la bonne valeur) - -
- -
- diff --git a/pages/01.administrate/04.learn/03.webadmin/admin.md b/pages/01.administrate/04.learn/03.webadmin/admin.md deleted file mode 100644 index df229452..00000000 --- a/pages/01.administrate/04.learn/03.webadmin/admin.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: Administrator web interface -template: docs -taxonomy: - category: docs -routes: - default: '/admin' ---- - -YunoHost has an administrator web interface. The other way to administrate your YunoHost install is through the [command line](/commandline). - -### Access - -You can access your administrator web interface at this address: https://example.org/yunohost/admin (replace 'example.org' with your own domain name) - -
- -
diff --git a/pages/01.administrate/04.learn/04.commandline/02.cli/commandline.es.md b/pages/01.administrate/04.learn/04.commandline/02.cli/commandline.es.md deleted file mode 100644 index ab6f4f7a..00000000 --- a/pages/01.administrate/04.learn/04.commandline/02.cli/commandline.es.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: Administrar YunoHost con la interfaz de línea de comandos -template: docs -taxonomy: - category: docs -routes: - default: '/commandline' ---- - -La interfaz de línea de comandos (CLI) es, en informática, la manera original (y más técnica) de interactuar con un ordenador. Está generalmente considera como más completa, más potente y eficaz que las interfaces gráficas, aunque sea más difícil de aprenderla. - -En el contexto de YunoHost, o de la administración de sistemas en general, la línea de comandos comúnmente se utiliza después de haberse [conectado en SSH](/ssh). - -
-Proveer un tutorial completo sobre la línea de comandos saldría del marco de la documentación de YunoHost : por eso, refiérete a totorales como [éste](https://www.fing.edu.uy/inco/cursos/sistoper/recursosLaboratorio/tutorial0.pdf) o [éste (en)](http://linuxcommand.org/). Pero no te preocupes : no hace falta ser un experto para comenzar a utilizarla ! -
- -El comando `yunohost` puede ser utilizado para administrar tu servidor o realizar las mismas acciones que en la interfaz gráfica webadmin. Hay que iniciarla como usuario `root`, o como el usuario `admin` poniendo `sudo` antes del comando. (ProTip™ : puedes convertirte en usuario `root` vía el comando `sudo su` cuando eres `admin`.) - -Los comandos YunoHost tienen este tipo de estructura : - -```bash -yunohost app install wordpress --label Webmail - ^ ^ ^ ^ - | | | | - categoría acción argumento opción -``` - -No dudes en navegar ni en pedir información a propósito de una categoría o acción utilizando la opción `--help`. Por ejemplo, estos comandos : - -```bash -yunohost --help -yunohost user --help -yunohost user create --help -``` - -de manera sucesiva van a enumerar todas las categorías disponibles, luego las acciones de la categoría `user`, y luego explicar cómo utilizar la acción `user create`. Deberías notar que el árbol de los comandos YunoHost tiene la misma estructura que las páginas del webadmin. diff --git a/pages/01.administrate/04.learn/04.commandline/02.cli/commandline.fr.md b/pages/01.administrate/04.learn/04.commandline/02.cli/commandline.fr.md deleted file mode 100644 index 323ed32b..00000000 --- a/pages/01.administrate/04.learn/04.commandline/02.cli/commandline.fr.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: Administrer YunoHost en ligne de commande -template: docs -taxonomy: - category: docs -routes: - default: '/commandline' ---- - -L'interface en ligne de commande (CLI) est, en informatique, la manière originale (et plus technique) d'interagir avec un ordinateur comparé aux interfaces graphiques. La ligne de commande est généralement considéré comme plus complète, puissante et efficace que les interfaces graphiques, bien que plus difficile à apprendre. - -Dans le contexte de YunoHost, ou de l'administration système en général, la ligne de commande est communément utilisée après s'être [connecté en SSH](/ssh). - -
-Fournir un tutorial complet sur la ligne de commande est bien au dela du cadre de la documentation de YunoHost : pour cela, référez-vous à des tutoriaux comme [celui-ci](https://doc.ubuntu-fr.org/tutoriel/console_ligne_de_commande) ou [celui-ci (en)](http://linuxcommand.org/). Mais soyez rassuré qu'il n'y a pas besoin d'être un expert pour commencer à l'utiliser ! -
- -La commande `yunohost` peut être utilisée pour administrer votre serveur ou réaliser les mêmes actions que celles disponibles sur la webadmin. Elle doit être lancée en depuis l'utilisateur `root`, ou bien depuis l'utilisateur `admin` en précédant la commande de `sudo`. (ProTip™ : il est possible de devenir `root` via la commande `sudo su` en tant qu'`admin`.) - -Les commandes YunoHost ont ce type de structure : - -```bash -yunohost app install wordpress --label Webmail - ^ ^ ^ ^ - | | | | - categorie action argument options -``` - -N'hesitez pas à naviguer et demander des informations à propos d'une catégorie ou action donnée via l'option `--help`. Par exemple, ces commandes : - -```bash -yunohost --help -yunohost user --help -yunohost user create --help -``` - -vont successivement lister toutes les catégories disponibles, puis les actions de la catégorie `user`, puis expliquer comment utiliser l'action `user create`. Vous devriez remarquer que l'arbre des commandes YunoHost suit une structure similaire aux pages de la webadmin. diff --git a/pages/01.administrate/04.learn/04.commandline/02.cli/commandline.md b/pages/01.administrate/04.learn/04.commandline/02.cli/commandline.md deleted file mode 100644 index 759bb702..00000000 --- a/pages/01.administrate/04.learn/04.commandline/02.cli/commandline.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: Administrate YunoHost in command line -template: docs -taxonomy: - category: docs -routes: - default: '/commandline' ---- - -The command line interface (CLI) is, in the computer world, the original (and more technical) way of interacting with a computer compared to graphical interface. Command line interfaces are generally said to be more complete, powerful or efficient than a graphical interface, though it is more difficult to learn. - -In the context of YunoHost, or system administration in general, the CLI is commonly used to remotely control machines after connecting through [connecting to it via SSH](/ssh). - -
-Providing a full tutorial about the command line is quite beyond the scope of the YunoHost documentation : for this, consider reading a dedicated tutorial such as [this one](https://ryanstutorials.net/linuxtutorial/) or [this one](http://linuxcommand.org/). But be reassured that you don't need to be a CLI expert to start using it ! -
- -The `yunohost` command can be used to administrate your server and perform the various actions similarly to what you do on the webadmin. The command must be launched either from the `root` user or from the `admin` user by preceeding them with `sudo`. (ProTip™ : you can become `root` with the command `sudo su` as `admin`). - -YunoHost commands usually have this kind of structure : - -```bash -yunohost app install wordpress --label Webmail - ^ ^ ^ ^ - | | | | - category action argument options -``` - -Don't hesitate to browse and ask for more information about a given category or action using the the `--help` option. For instance, those commands : - -```bash -yunohost --help -yunohost user --help -yunohost user create --help -``` - -will successively list all the categories available, then the actions available in the `user` category, then the usage of the action `user create`. You might notice that the YunoHost command tree is built with a structure similar to the YunoHost admin pages. diff --git a/pages/01.administrate/04.learn/04.commandline/01.ssh/ssh.de.md b/pages/01.administrate/04.learn/04.commandline/ssh.de.md similarity index 75% rename from pages/01.administrate/04.learn/04.commandline/01.ssh/ssh.de.md rename to pages/01.administrate/04.learn/04.commandline/ssh.de.md index eb8d1d8f..05374c96 100644 --- a/pages/01.administrate/04.learn/04.commandline/01.ssh/ssh.de.md +++ b/pages/01.administrate/04.learn/04.commandline/ssh.de.md @@ -5,6 +5,10 @@ taxonomy: category: docs routes: default: '/ssh' + aliases: + - '/commandline' +page-toc: + active: true --- ## Was ist SSH? @@ -102,3 +106,29 @@ yunohost user ssh list-keys N.B. : `fail2ban` will ban your IP for 10 mimutes if you perform 5 failed login attempts. If you need to unban the IP, have a look at the page about [Fail2Ban](/fail2ban) A more extensive discussion about security & SSH can be found on the [dedicated page](/security). + + +## Yunohost command line + +!!! Providing a full tutorial about the command line is quite beyond the scope of the YunoHost documentation : for this, consider reading a dedicated tutorial such as [this one](https://ryanstutorials.net/linuxtutorial/) or [this one](http://linuxcommand.org/). But be reassured that you don't need to be a CLI expert to start using it ! + +The `yunohost` command can be used to administrate your server and perform the various actions similarly to what you do on the webadmin. The command must be launched either from the `root` user or from the `admin` user by preceeding them with `sudo`. (ProTip™ : you can become `root` with the command `sudo su` as `admin`). + +YunoHost commands usually have this kind of structure : + +```bash +yunohost app install wordpress --label Webmail + ^ ^ ^ ^ + | | | | + category action argument options +``` + +Don't hesitate to browse and ask for more information about a given category or action using the the `--help` option. For instance, those commands : + +```bash +yunohost --help +yunohost user --help +yunohost user create --help +``` + +will successively list all the categories available, then the actions available in the `user` category, then the usage of the action `user create`. You might notice that the YunoHost command tree is built with a structure similar to the YunoHost admin pages. diff --git a/pages/01.administrate/04.learn/04.commandline/01.ssh/ssh.es.md b/pages/01.administrate/04.learn/04.commandline/ssh.es.md similarity index 71% rename from pages/01.administrate/04.learn/04.commandline/01.ssh/ssh.es.md rename to pages/01.administrate/04.learn/04.commandline/ssh.es.md index de65e3bb..520d8d8b 100644 --- a/pages/01.administrate/04.learn/04.commandline/01.ssh/ssh.es.md +++ b/pages/01.administrate/04.learn/04.commandline/ssh.es.md @@ -5,12 +5,18 @@ taxonomy: category: docs routes: default: '/ssh' + aliases: + - '/commandline' +page-toc: + active: true --- ## ¿ Qué es SSH ? **SSH** est un acrónimo por Secure Shell, y representa un protocolo que permite controlar remotamente una máquina vía la línea de comandos (CLI). También es un comando básico disponible en los terminales de GNU/Linux y macOS. En Windows, hace falta utilizar el programa [MobaXterm](https://mobaxterm.mobatek.net/download-home-edition.html) (después de haberlo iniciado, clicar sobre Session y luego SSH). +La interfaz de línea de comandos (CLI) es, en informática, la manera original (y más técnica) de interactuar con un ordenador. Está generalmente considera como más completa, más potente y eficaz que las interfaces gráficas, aunque sea más difícil de aprenderla. + ## Durante la instalación de YunoHost #### Encontrar su IP @@ -96,3 +102,28 @@ yunohost user ssh list-keys N.B. : `fail2ban` proscribirá tu IP durante 10 minutos si fracasas más de 5 veces consecutivas en identificarte. Si esto ocurre y que quieres re-validar tu IP, puedes echar un vistazo a la página [Fail2Ban](/fail2ban) Encontrarás explicaciones más completa sobre la seguridad y SSH en [la página dedicada](/security). + +## YunoHost de línea de comandos + +!!! Proveer un tutorial completo sobre la línea de comandos saldría del marco de la documentación de YunoHost : por eso, refiérete a totorales como [éste](https://www.fing.edu.uy/inco/cursos/sistoper/recursosLaboratorio/tutorial0.pdf) o [éste (en)](http://linuxcommand.org/). Pero no te preocupes : no hace falta ser un experto para comenzar a utilizarla ! + +El comando `yunohost` puede ser utilizado para administrar tu servidor o realizar las mismas acciones que en la interfaz gráfica webadmin. Hay que iniciarla como usuario `root`, o como el usuario `admin` poniendo `sudo` antes del comando. (ProTip™ : puedes convertirte en usuario `root` vía el comando `sudo su` cuando eres `admin`.) + +Los comandos YunoHost tienen este tipo de estructura : + +```bash +yunohost app install wordpress --label Webmail + ^ ^ ^ ^ + | | | | + categoría acción argumento opción +``` + +No dudes en navegar ni en pedir información a propósito de una categoría o acción utilizando la opción `--help`. Por ejemplo, estos comandos : + +```bash +yunohost --help +yunohost user --help +yunohost user create --help +``` + +de manera sucesiva van a enumerar todas las categorías disponibles, luego las acciones de la categoría `user`, y luego explicar cómo utilizar la acción `user create`. Deberías notar que el árbol de los comandos YunoHost tiene la misma estructura que las páginas del webadmin. diff --git a/pages/01.administrate/04.learn/04.commandline/01.ssh/ssh.fr.md b/pages/01.administrate/04.learn/04.commandline/ssh.fr.md similarity index 69% rename from pages/01.administrate/04.learn/04.commandline/01.ssh/ssh.fr.md rename to pages/01.administrate/04.learn/04.commandline/ssh.fr.md index 3da82c9d..bd348bca 100644 --- a/pages/01.administrate/04.learn/04.commandline/01.ssh/ssh.fr.md +++ b/pages/01.administrate/04.learn/04.commandline/ssh.fr.md @@ -5,12 +5,18 @@ taxonomy: category: docs routes: default: '/ssh' + aliases: + - '/commandline' +page-toc: + active: true --- ## Qu’est-ce que SSH ? **SSH** est un acronyme pour Secure Shell, et désigne un protocole qui permet de contrôler et administrer à distance une machine via la ligne de commande (CLI). C'est aussi une commande disponible de base dans les terminaux de GNU/Linux et macOS. Sous Windows, il vous faudra utiliser le logiciel [MobaXterm](https://mobaxterm.mobatek.net/download-home-edition.html) (après l'avoir lancé, cliquer sur Session puis SSH). +L'interface en ligne de commande (CLI) est, en informatique, la manière originale (et plus technique) d'interagir avec un ordinateur comparé aux interfaces graphiques. La ligne de commande est généralement considéré comme plus complète, puissante et efficace que les interfaces graphiques, bien que plus difficile à apprendre. + ## Quelle adresse utiliser pour se connecter au serveur ? Si vous hébergez votre serveur **à la maison** (par ex. Raspberry Pi ou OLinuXino ou vieil ordinateur) @@ -89,3 +95,28 @@ yunohost user ssh list-keys N.B. : `fail2ban` bannira votre IP pour 10 minutes si vous échouez plus de 5 fois à vous identifier. Pour débannir une IP, vous pouvez regarder la page sur [Fail2Ban](/fail2ban) Une discussion plus complète de la sécurité et de SSH peut être trouvée sur [la page dédiée](/security). + +## La ligne de commande Yunohost + +!!! Fournir un tutorial complet sur la ligne de commande est bien au dela du cadre de la documentation de YunoHost : pour cela, référez-vous à des tutoriaux comme [celui-ci](https://doc.ubuntu-fr.org/tutoriel/console_ligne_de_commande) ou [celui-ci (en)](http://linuxcommand.org/). Mais soyez rassuré qu'il n'y a pas besoin d'être un expert pour commencer à l'utiliser ! + +La commande `yunohost` peut être utilisée pour administrer votre serveur ou réaliser les mêmes actions que celles disponibles sur la webadmin. Elle doit être lancée en depuis l'utilisateur `root`, ou bien depuis l'utilisateur `admin` en précédant la commande de `sudo`. (ProTip™ : il est possible de devenir `root` via la commande `sudo su` en tant qu'`admin`.) + +Les commandes YunoHost ont ce type de structure : + +```bash +yunohost app install wordpress --label Webmail + ^ ^ ^ ^ + | | | | + categorie action argument options +``` + +N'hesitez pas à naviguer et demander des informations à propos d'une catégorie ou action donnée via l'option `--help`. Par exemple, ces commandes : + +```bash +yunohost --help +yunohost user --help +yunohost user create --help +``` + +vont successivement lister toutes les catégories disponibles, puis les actions de la catégorie `user`, puis expliquer comment utiliser l'action `user create`. Vous devriez remarquer que l'arbre des commandes YunoHost suit une structure similaire aux pages de la webadmin. diff --git a/pages/01.administrate/04.learn/04.commandline/01.ssh/ssh.it.md b/pages/01.administrate/04.learn/04.commandline/ssh.it.md similarity index 75% rename from pages/01.administrate/04.learn/04.commandline/01.ssh/ssh.it.md rename to pages/01.administrate/04.learn/04.commandline/ssh.it.md index 079bb241..c87363d6 100644 --- a/pages/01.administrate/04.learn/04.commandline/01.ssh/ssh.it.md +++ b/pages/01.administrate/04.learn/04.commandline/ssh.it.md @@ -5,6 +5,10 @@ taxonomy: category: docs routes: default: '/ssh' + aliases: + - '/commandline' +page-toc: + active: true --- ## Cos'è SSH? @@ -97,3 +101,28 @@ yunohost user ssh list-keys N.B.: `fail2ban` bannerà il tuo IP per 10 minuti nel caso di almeno 5 tentativi di accesso falliti. Se devi togliere il ban al tuo IP leggi la pagina relativa [Fail2Ban](/fail2ban) Una discussione più approfondita relativa a sicurezza & SSH è su [questa pagina](/security). + +## Yunohost command line + +!!! Providing a full tutorial about the command line is quite beyond the scope of the YunoHost documentation : for this, consider reading a dedicated tutorial such as [this one](https://ryanstutorials.net/linuxtutorial/) or [this one](http://linuxcommand.org/). But be reassured that you don't need to be a CLI expert to start using it ! + +The `yunohost` command can be used to administrate your server and perform the various actions similarly to what you do on the webadmin. The command must be launched either from the `root` user or from the `admin` user by preceeding them with `sudo`. (ProTip™ : you can become `root` with the command `sudo su` as `admin`). + +YunoHost commands usually have this kind of structure : + +```bash +yunohost app install wordpress --label Webmail + ^ ^ ^ ^ + | | | | + category action argument options +``` + +Don't hesitate to browse and ask for more information about a given category or action using the the `--help` option. For instance, those commands : + +```bash +yunohost --help +yunohost user --help +yunohost user create --help +``` + +will successively list all the categories available, then the actions available in the `user` category, then the usage of the action `user create`. You might notice that the YunoHost command tree is built with a structure similar to the YunoHost admin pages. diff --git a/pages/01.administrate/04.learn/04.commandline/01.ssh/ssh.md b/pages/01.administrate/04.learn/04.commandline/ssh.md similarity index 67% rename from pages/01.administrate/04.learn/04.commandline/01.ssh/ssh.md rename to pages/01.administrate/04.learn/04.commandline/ssh.md index ac3ab095..f5bda742 100644 --- a/pages/01.administrate/04.learn/04.commandline/01.ssh/ssh.md +++ b/pages/01.administrate/04.learn/04.commandline/ssh.md @@ -1,16 +1,22 @@ --- -title: SSH +title: SSH and command line template: docs taxonomy: category: docs routes: default: '/ssh' + aliases: + - '/commandline' +page-toc: + active: true --- ## What's SSH? **SSH** stands for Secure Shell, and refers to a protocol that allows to remotely control and administrate a machine using the command line interface (CLI). It is available by default in any terminal on GNU/Linux and macOS. On Windows, you may want to use [MobaXterm](https://mobaxterm.mobatek.net/download-home-edition.html) (after launching it, click on Session then SSH). +The command line interface (CLI) is, in the computer world, the original (and more technical) way of interacting with a computer compared to graphical interface. Command line interfaces are generally said to be more complete, powerful or efficient than a graphical interface, though also more difficult to learn. + ## What address to use to connect to your server? If you are **installing at home** (e.g. on a Raspberry Pi or OLinuXino or old computer): @@ -94,3 +100,28 @@ yunohost user ssh list-keys N.B. : `fail2ban` will ban your IP for 10 minutes if you perform 5 failed login attempts. If you need to unban the IP, have a look at the page about [Fail2Ban](/fail2ban) A more extensive discussion about security & SSH can be found on the [dedicated page](/security). + +## Yunohost command line + +!!! Providing a full tutorial about the command line is quite beyond the scope of the YunoHost documentation : for this, consider reading a dedicated tutorial such as [this one](https://ryanstutorials.net/linuxtutorial/) or [this one](http://linuxcommand.org/). But be reassured that you don't need to be a CLI expert to start using it ! + +The `yunohost` command can be used to administrate your server and perform the various actions similarly to what you do on the webadmin. The command must be launched either from the `root` user or from the `admin` user by preceeding them with `sudo`. (ProTip™ : you can become `root` with the command `sudo su` as `admin`). + +YunoHost commands usually have this kind of structure : + +```bash +yunohost app install wordpress --label Webmail + ^ ^ ^ ^ + | | | | + category action argument options +``` + +Don't hesitate to browse and ask for more information about a given category or action using the the `--help` option. For instance, those commands : + +```bash +yunohost --help +yunohost user --help +yunohost user create --help +``` + +will successively list all the categories available, then the actions available in the `user` category, then the usage of the action `user create`. You might notice that the YunoHost command tree is built with a structure similar to the YunoHost admin pages.