Nginx -> NGINX

This commit is contained in:
ericgaspar 2020-09-15 13:57:31 +02:00
parent 79f90ea5bf
commit e927fdcfe3
No known key found for this signature in database
GPG key ID: 574F281483054D44
21 changed files with 50 additions and 50 deletions

View file

@ -14,16 +14,16 @@ disrupting their core function._
**Customization brought by the package:**
* grant MySQL statistics access via a `netdata` user
* nginx root log statistics via putting `netdata` user in the `adm` group
* NGINX root log statistics via putting `netdata` user in the `adm` group
* Dovecot statistics via giving access to Dovecot stats stocket to `netdata` user (works only with Dovecot 2.2.16+)
**Further recommendations:**
We don't allow YunoHost packages to make sensible changes to system files. So here are further customizations you can make to allow more monitoring:
* Nginx:
* NGINX:
* requests/connections: follow [these recommandations](https://github.com/firehol/netdata/tree/master/python.d#nginx) to enable `/stab_status` (for example by putting the `location` section in `/etc/nginx/conf.d/yunohost_admin.conf`
* weblogs: you can monitor all your nginx weblogs for errors; follow [these recommendations](https://github.com/firehol/netdata/tree/master/python.d#nginx_log)
* phpfpm: follow [these recommandations](https://github.com/firehol/netdata/tree/master/python.d#phpfpm)
* weblogs: you can monitor all your NGINX weblogs for errors; follow [these recommendations](https://github.com/firehol/netdata/tree/master/python.d#nginx_log)
* PHP-FPM: follow [these recommandations](https://github.com/firehol/netdata/tree/master/python.d#phpfpm)
## Features
@ -50,15 +50,15 @@ We don't allow YunoHost packages to make sensible changes to system files. So he
- **Extensible**<br/>
you can monitor anything you can get a metric for,
using its Plugin API (anything can be a netdata plugin,
BASH, python, perl, node.js, java, Go, ruby, etc)
using its Plugin API (anything can be a NetData plugin,
BASH, Python, Perl, Node.JS, Java, Go, Ruby, etc.)
- **Embeddable**<br/>
it can run anywhere a Linux kernel runs (even IoT)
and its charts can be embedded on your web pages too
- **Customizable**<br/>
custom dashboards can be built using simple HTML (no javascript necessary)
custom dashboards can be built using simple HTML (no JavaScript necessary)
- **Zero configuration**<br/>
auto-detects everything, it can collect up to 5000 metrics
@ -112,18 +112,18 @@ This is a list of what it currently monitors:
- **IPv4 networking**<br/>
bandwidth, packets, errors, fragments,
tcp: connections, packets, errors, handshake,
udp: packets, errors,
TCP: connections, packets, errors, handshake,
UDP: packets, errors,
broadcast: bandwidth, packets,
multicast: bandwidth, packets
- **IPv6 networking**<br/>
bandwidth, packets, errors, fragments, ECT,
udp: packets, errors,
udplite: packets, errors,
UDP: packets, errors,
UDP-Lite: packets, errors,
broadcast: bandwidth,
multicast: bandwidth, packets,
icmp: messages, errors, echos, router, neighbor, MLDv2, group membership,
ICMP: messages, errors, echos, router, neighbor, MLDv2, group membership,
break down by type
- **Interprocess Communication - IPC**<br/>
@ -171,7 +171,7 @@ This is a list of what it currently monitors:
- **Apache and lighttpd web servers**<br/>
`mod-status` (v2.2, v2.4) and cache log statistics, for multiple servers
- **Nginx web servers**<br/>
- **NGINX web servers**<br/>
`stub-status`, for multiple servers
- **Tomcat**<br/>
@ -193,13 +193,13 @@ This is a list of what it currently monitors:
multiple servers, each showing: operations, hit rate, memory, keys, clients, slaves
- **mongodb**<br/>
operations, clients, transactions, cursors, connections, asserts, locks, etc
operations, clients, transactions, cursors, connections, asserts, locks, etc.
- **memcached databases**<br/>
multiple servers, each showing: bandwidth, connections, items
- **elasticsearch**<br/>
search and index performance, latency, timings, cluster statistics, threads statistics, etc
search and index performance, latency, timings, cluster statistics, threads statistics, etc.
- **ISC Bind name servers**<br/>
multiple servers, each showing: clients, requests, queries, updates, failures and several per view metrics
@ -225,10 +225,10 @@ This is a list of what it currently monitors:
multiple servers, each showing: clients bandwidth and requests, servers bandwidth and requests
- **HAproxy**<br/>
bandwidth, sessions, backends, etc
bandwidth, sessions, backends, etc.
- **varnish**<br/>
threads, sessions, hits, objects, backends, etc
threads, sessions, hits, objects, backends, etc.
- **OpenVPN**<br/>
status per tunnel

View file

@ -16,7 +16,7 @@
* [Scripts](packaging_apps_scripts)
* [Arguments management](packaging_apps_arguments_management)
* [Arguments format](packaging_apps_arguments_format)
* [Nginx configuration](packaging_apps_nginx_conf)
* [NGINX configuration](packaging_apps_nginx_conf)
* [Multi-instance](packaging_apps_multiinstance)
* [Helpers](packaging_apps_helpers)
* [Trap usage](/packaging_apps_trap)

View file

@ -16,7 +16,7 @@
* [Scripts](/packaging_apps_scripts)
* [Gestion des arguments](/packaging_apps_arguments_management)
* [Format des arguments](/packaging_apps_arguments_format)
* [Configuration nginx](/packaging_apps_nginx_conf)
* [Configuration NGINX](/packaging_apps_nginx_conf)
* [Multi-instance](/packaging_apps_multiinstance)
* [Fonctions utiles](/packaging_apps_helpers)
* [Utilisation de 'trap'](/packaging_apps_trap)

View file

@ -21,7 +21,7 @@ then you can access `agenda.mydomain.com`, `blog.mydomain.com` and `rss.mydomain
### Install an application on a subdomain
To install an application on a subdomain in YunoHost, for example `blog.mydomain.com`, the configuration is done in the administration panel. One first add the subdomain to the available domains list. The creation of a subdomain in YunoHost will create the corresponding configuration files for Nginx (the web server used in YunoHost).
To install an application on a subdomain in YunoHost, for example `blog.mydomain.com`, the configuration is done in the administration panel. One first add the subdomain to the available domains list. The creation of a subdomain in YunoHost will create the corresponding configuration files for NGINX (the web server used in YunoHost).
Then, in the applications>install panel, one follows the classic installation process by choosing the desired subdomain as domain (for example `blog.mydomain.com`). One needs to choose the path `/` (in place of `/wordpress` for example). A warning message will appear telling that it won't be possible to install other application to this subdomain. After validation, the installation starts.

View file

@ -20,7 +20,7 @@ permet davoir un `agenda.mondomaine.fr`, un `blog.mondomaine.fr` etc…
### Installer une application sur un sous-domaine
Pour installer une application sur un sous-domaine, par exemple `blog.mondomaine.fr`, dans YunoHost, tout se fait via la partie administration. On ajoute tout dabord le sous-domaine à la liste des domaines disponibles. La création dun sous-domaine dans YunoHost créera les fichiers de configuration correspondants pour Nginx (le serveur web de YunoHost).
Pour installer une application sur un sous-domaine, par exemple `blog.mondomaine.fr`, dans YunoHost, tout se fait via la partie administration. On ajoute tout dabord le sous-domaine à la liste des domaines disponibles. La création dun sous-domaine dans YunoHost créera les fichiers de configuration correspondants pour NGINX (le serveur web de YunoHost).
Puis dans la partie installation dune application, on installe lapplication de façon traditionnelle en choisissant ce sous-domaine comme domaine (par exemple `blog.mondomaine.fr`) et en indiquant comme chemin `/` (et non `/wordpress` qui est le chemin par défaut). On a alors un message davertissement indiquant quon ne pourra plus installer dapplications sur ce sous-domaine. On valide. Ça sinstalle.

2
faq.md
View file

@ -125,7 +125,7 @@ Medium answer: Apps were packaged in .deb in the past. It was a nightmare. We're
<p>Turns out, YunoHost apps packaging holds a subtly different purpose than traditional packaging like .deb. Debian packages fulfill the low-level purpose of installing files, commands, programs and services on the system. It is often your duty to configure them properly, simply because there is no standard server setup. Typically, web apps requires a lot of configuration because they rely on a web server and a database (and the single sign-on).</p>
<p>YunoHost manipulates high-level abstractions (apps, domains, users, ...) and defines a standard setup (Nginx, Postfix, Metronome, SSOwat, ...) and, because of this, can handle the configuration for the user.</p>
<p>YunoHost manipulates high-level abstractions (apps, domains, users...) and defines a standard setup (NGINX, Postfix, Metronome, SSOwat...) and, because of this, can handle the configuration for the user.</p>
<p>If you still think it's possible to handle everything by fiddling with .deb packages, see previous answers.</p>
</div>

View file

@ -102,7 +102,7 @@ Mittellange Antwort: Früher wurden die Apps in .deb gepackt. Was für ein Albtr
<p>Es hat sich herausgestellt, dass das Packen für YunoHost einen leicht anderen Zweck erfüllt als das Erstellen klassischer Pakete wie .deb. Debian Pakete haben nur den Anspruch Dateien, Befehle, Programme und Dienste auf dem System zu installieren. Es bleibt oft an Ihnen diese richtig zu konfigurieren, weil es einfach keinen standardisierte Server-Konfiguration gibt. Typischerweise erfordern Web-Apps einen sehr hohen Konfigurationsaufwand, weil sie auf dem Webserver und einer Datenbank (und dem single sign-on) aufbauen.</p>
<p>YunoHost richtet Konzepte auf höchster Ebene ein (Apps, Domain-Namen, Benutzer, ...) und definiert eine standardmäßige Einrichtung (Nginx, Postfix, Metronome, SSOwat, ...) und kann deshalb die Konfiguration für den Anwender übernehmen.</p>
<p>YunoHost richtet Konzepte auf höchster Ebene ein (Apps, Domain-Namen, Benutzer...) und definiert eine standardmäßige Einrichtung (NGINX, Postfix, Metronome, SSOwat...) und kann deshalb die Konfiguration für den Anwender übernehmen.</p>
<p>Wer trotzdem glaubt, man könne deb Pakete dazu bringen, all dies zu leisten, möge sich die vorherige Antwort anschauen.</p>
</div>

View file

@ -115,7 +115,7 @@ Réponse moyenne : Par le passé, les apps étaient gérées via des .deb. C
<p>Il se trouve que lobjectif des paquets dapplication YunoHost est subtilement différent de celui des paquets traditionnels (comme les .deb de Debian) qui remplissent le rôle dinstaller des éléments bas-niveau tels que des fichiers, commandes, programmes ou services sur le système. Il est à la charge de ladministrateur de les configurer ensuite proprement, simplement parce quil nexiste pas denvironnement standard. Typiquement, les applications web requièrent beaucoup de configuration car elles ont besoin de sinterfacer avec un serveur web et une base de données (et le système de connexion unique / SSO).</p>
<p>YunoHost manipule des abstractions haut-niveau (apps, domaines, utilisateurs…) et définit un environnement standard (Nginx, Postfix, Metronome, SSOwat…) et, grâce à cela, peut gérer la configuration à la place de ladministrateur.</p>
<p>YunoHost manipule des abstractions haut-niveau (apps, domaines, utilisateurs…) et définit un environnement standard (NGINX, Postfix, Metronome, SSOwat...) et, grâce à cela, peut gérer la configuration à la place de ladministrateur.</p>
<p>Si vous restez persuadé que lon peut néanmoins bricoler les paquets .deb pour gérer tout cela, voir les réponses précédentes.</p>
</div>

View file

@ -31,8 +31,8 @@ Since YunoHost has a unified architecture, you will be able to guess most of the
<a class="btn btn-lg btn-default" href="/packaging_apps_arguments_management">Arguments management</a>
### Nginx configuration
<a class="btn btn-lg btn-default" href="/packaging_apps_nginx_conf">Nginx configuration</a>
### NGINX configuration
<a class="btn btn-lg btn-default" href="/packaging_apps_nginx_conf">NGINX configuration</a>
### Multi-instance
<a class="btn btn-lg btn-default" href="/packaging_apps_multiinstance">Multi-instance</a>

View file

@ -33,8 +33,8 @@ Comme les instances de YunoHost possèdent une architecture unifiée, vous serez
<a class="btn btn-lg btn-default" href="/packaging_apps_arguments_management">Gestion des arguments</a>
### Configuration Nginx
<a class="btn btn-lg btn-default" href="/packaging_apps_nginx_conf">Configuration Nginx</a>
### Configuration NGINX
<a class="btn btn-lg btn-default" href="/packaging_apps_nginx_conf">Configuration NGINX</a>
### Multi-instance
<a class="btn btn-lg btn-default" href="/packaging_apps_multiinstance">Multi-instance</a>

View file

@ -6,7 +6,7 @@ Multi-instance is application capacity to be installed several times.
#### Scripts
When YunoHost installs the application, it passes `$YNH_APP_INSTANCE_NAME` var to the script, set to value `id__n` with the application `id` coming from the manifest and `n` being an integer incremented each time a new instance of the application is installed.
**E.g.** in the roundcube script, database is called `roundcube`, the install directory `roundcube` and the [Nginx configuration](/packaging_apps_nginx_conf) `roundcube`. This way, the second instance of roundcube will not conflict with the first one, and will be installed in the `roundcube__2` database, in the `roundcube__2`directory, and with the `roundcube__2` Nginx configuration.
**E.g.** in the Roundcube script, database is called `roundcube`, the install directory `roundcube` and the [NGINX configuration](/packaging_apps_nginx_conf) `roundcube`. This way, the second instance of Roundcube will not conflict with the first one, and will be installed in the `roundcube__2` database, in the `roundcube__2`directory, and with the `roundcube__2` NGINX configuration.
Retrieve app identifier (including the multi-instance id):
```bash

View file

@ -6,7 +6,7 @@ Le multi-instance est la capacité dune application à être installée plusi
#### Scripts
Lorsque YunoHost installe lapplication, il passe au script dans la variable `$YNH_APP_INSTANCE_NAME` la valeur `id__n` avec lidentifiant de lapplication `id` provenant du manifeste et `n` un nombre incrémentée à chaque nouvelle instance de lapplication.
**Par exemple** : dans le script roundcube, il faut nommer la base de données `roundcube`, le dossier dinstallation `roundcube` et la [configuration Nginx](/packaging_apps_nginx_conf) `roundcube`. De cette manière, la seconde installation de roundcube ne rentrera pas en conflit avec la première, et sera installée dans la base de données `roundcube__2`, dans le répertoire `roundcube__2`, et avec la configuration Nginx `roundcube__2`.
**Par exemple** : dans le script Roundcube, il faut nommer la base de données `roundcube`, le dossier dinstallation `roundcube` et la [configuration NGINX](/packaging_apps_nginx_conf) `roundcube`. De cette manière, la seconde installation de Roundcube ne rentrera pas en conflit avec la première, et sera installée dans la base de données `roundcube__2`, dans le répertoire `roundcube__2`, et avec la configuration NGINX `roundcube__2`.
Récupération de l'identifiant de l'app (incluant l'id multi-instance) :

View file

@ -1,7 +1,7 @@
# Nginx configuration
This tutorial aim to help setup Nginx configuration for application packaging.
# NGINX configuration
This tutorial aim to help setup NGINX configuration for application packaging.
#### Nginx configuration
#### NGINX configuration
Configuration must be in `conf/nginx.conf`. We must use **FastCGI** or a **proxy_pass** following the application:
* **FastCGI** is used with PHP applications:
```nginx
@ -44,15 +44,15 @@ sed -i "s@YNH_EXAMPLE_PATH@$path@g" ../conf/nginx.conf
sed -i "s@YNH_EXAMPLE_PORT@$port@g" ../conf/nginx.conf
sed -i "s@YNH_EXEMPLE_DOMAIN@$domain@g" ../conf/nginx.conf
```
We must move that configuration file in Nginx configuration, then reload Nginx configuration:
We must move that configuration file in NGINX configuration, then reload NGINX configuration:
```bash
cp ../conf/nginx.conf /etc/nginx/conf.d/$domain.d/$app.conf
sudo service nginx reload
```
If Nginx won't restart, it's possible that this configuration file isn't right.
If NGINX won't restart, it's possible that this configuration file isn't right.
#### Remove script
We must remove Nginx configuration of this application, then reload Nginx configuration:
We must remove NGINX configuration of this application, then reload NGINX configuration:
```bash
rm -f /etc/nginx/conf.d/$domain.d/$app.conf
sudo service nginx reload

View file

@ -1,7 +1,7 @@
# Configuration Nginx
Ce tutoriel a pour but daider à la mise en place dune configuration Nginx pour le packaging dapplication.
# Configuration NGINX
Ce tutoriel a pour but daider à la mise en place dune configuration NGINX pour le packaging dapplication.
#### Configuration Nginx
#### Configuration NGINX
La configuration doit être mise dans `conf/nginx.conf`. Il sagira dutiliser **FastCGI** ou un **proxy_pass** suivant lapplication :
* **FastCGI** est utilisé dans les applications PHP :
```nginx
@ -44,15 +44,15 @@ sed -i "s@YNH_EXAMPLE_PATH@$path@g" ../conf/nginx.conf
sed -i "s@YNH_EXAMPLE_PORT@$port@g" ../conf/nginx.conf
sed -i "s@YNH_EXEMPLE_DOMAIN@$domain@g" ../conf/nginx.conf
```
Il faut ensuite déplacer ce fichier de configuration dans la configuration de Nginx, puis recharger la configuration de Nginx :
Il faut ensuite déplacer ce fichier de configuration dans la configuration de NGINX, puis recharger la configuration de NGINX :
```bash
cp ../conf/nginx.conf /etc/nginx/conf.d/$domain.d/$app.conf
sudo service nginx reload
```
Si Nginx ne redémarre pas, il se peut que le fichier de configuration ne soit pas correct.
Si NGINX ne redémarre pas, il se peut que le fichier de configuration ne soit pas correct.
#### Script de suppression
Il sagit de supprimer la configuration Nginx pour cette application, puis de recharger la configuration de Nginx :
Il sagit de supprimer la configuration NGINX pour cette application, puis de recharger la configuration de NGINX :
```bash
rm -f /etc/nginx/conf.d/$domain.d/$app.conf
sudo service nginx reload

View file

@ -43,7 +43,7 @@ If you want to avoid being redirected to the SSO portal at login, you can deacti
#access_by_lua_file /usr/share/ssowat/access.lua;
```
### Restart nginx
### Restart NGINX
```bash
service nginx restart
```

View file

@ -42,7 +42,7 @@ Si vous voulez éviter dêtre redirigé vers le portail à la connexion pour
#access_by_lua_file /usr/share/ssowat/access.lua;
```
### Vérifier que l'on a pas fait d'erreurs dans la configuration de Nginx
### Vérifier que l'on a pas fait d'erreurs dans la configuration de NGINX
```bash
nginx -t
```

View file

@ -43,7 +43,7 @@ Se non vuoi essere rediretto al portale SSO al login puoi disattivare SSOwat spe
#access_by_lua_file /usr/share/ssowat/access.lua;
```
### Riavvia nginx
### Riavvia NGINX
```bash
service nginx restart
```

View file

@ -68,7 +68,7 @@ Out of the box YunoHost provide:
* A system of application
* A web interface
* A command-line interface (CLI): Moulinette
* A web server: Nginx
* A web server: NGINX
* A DNS server: Dnsmasq
* A database: MariaDB
* A backup system

View file

@ -68,7 +68,7 @@ YunoHost de base ofereix:
* Un sistema d'aplicacions
* Una interfície web
* Una interfície per línia de comandes (CLI): Moulinette
* Un servidor web: Nginx
* Un servidor web: NGINX
* Un servidor DNS: Dnsmasq
* Una base de dades: MariaDB
* Un sistema de còpies de seguretat

View file

@ -67,7 +67,7 @@ YunoHost fournit immédiatement:
* Un système d'application
* Une interface web
* Une interface de ligne de commande (CLI): Moulinette
* Un serveur Web : Nginx
* Un serveur Web : NGINX
* Un serveur DNS : Dnsmasq
* Une base de données: MariaDB
* Un système de sauvegarde

View file

@ -67,7 +67,7 @@ YunoHost provesís sul pic:
* Un sistèma d'aplicacion
* Una interfàcia web
* Una interfàcia en linha de comanda (CLI) : Moulinette
* Un servidor Web : Nginx
* Un servidor Web : NGINX
* Un servidor DNS : Dnsmasq
* Una basa de donadas : MariaDB
* Un sistèma de salvagarda