mirror of
https://github.com/YunoHost/doc.git
synced 2024-09-03 20:06:26 +02:00
Nginx -> NGINX
This commit is contained in:
parent
79f90ea5bf
commit
e927fdcfe3
21 changed files with 50 additions and 50 deletions
|
@ -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
|
||||
|
|
|
@ -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)
|
||||
|
|
|
@ -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)
|
||||
|
|
|
@ -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.
|
||||
|
||||
|
|
|
@ -20,7 +20,7 @@ permet d’avoir 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 d’abord le sous-domaine à la liste des domaines disponibles. La création d’un 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 d’abord le sous-domaine à la liste des domaines disponibles. La création d’un sous-domaine dans YunoHost créera les fichiers de configuration correspondants pour NGINX (le serveur web de YunoHost).
|
||||
|
||||
Puis dans la partie installation d’une application, on installe l’application 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 d’avertissement indiquant qu’on ne pourra plus installer d’applications sur ce sous-domaine. On valide. Ça s’installe.
|
||||
|
||||
|
|
2
faq.md
2
faq.md
|
@ -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>
|
||||
|
|
|
@ -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>
|
||||
|
|
|
@ -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 l’objectif des paquets d’application YunoHost est subtilement différent de celui des paquets traditionnels (comme les .deb de Debian) qui remplissent le rôle d’installer des éléments bas-niveau tels que des fichiers, commandes, programmes ou services sur le système. Il est à la charge de l’administrateur de les configurer ensuite proprement, simplement parce qu’il n’existe pas d’environnement standard. Typiquement, les applications web requièrent beaucoup de configuration car elles ont besoin de s’interfacer 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 l’administrateur.</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 l’administrateur.</p>
|
||||
|
||||
<p>Si vous restez persuadé que l’on peut néanmoins bricoler les paquets .deb pour gérer tout cela, voir les réponses précédentes.</p>
|
||||
</div>
|
||||
|
|
|
@ -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>
|
||||
|
|
|
@ -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>
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -6,7 +6,7 @@ Le multi-instance est la capacité d’une application à être installée plusi
|
|||
#### Scripts
|
||||
Lorsque YunoHost installe l’application, il passe au script dans la variable `$YNH_APP_INSTANCE_NAME` la valeur `id__n` avec l’identifiant de l’application `id` provenant du manifeste et `n` un nombre incrémentée à chaque nouvelle instance de l’application.
|
||||
|
||||
**Par exemple** : dans le script roundcube, il faut nommer la base de données `roundcube`, le dossier d’installation `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 d’installation `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) :
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -1,7 +1,7 @@
|
|||
# Configuration Nginx
|
||||
Ce tutoriel a pour but d’aider à la mise en place d’une configuration Nginx pour le packaging d’application.
|
||||
# Configuration NGINX
|
||||
Ce tutoriel a pour but d’aider à la mise en place d’une configuration NGINX pour le packaging d’application.
|
||||
|
||||
#### Configuration Nginx
|
||||
#### Configuration NGINX
|
||||
La configuration doit être mise dans `conf/nginx.conf`. Il s’agira d’utiliser **FastCGI** ou un **proxy_pass** suivant l’application :
|
||||
* **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 s’agit de supprimer la configuration Nginx pour cette application, puis de recharger la configuration de Nginx :
|
||||
Il s’agit 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
|
||||
|
|
|
@ -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
|
||||
```
|
||||
|
|
|
@ -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
|
||||
```
|
||||
|
|
|
@ -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
|
||||
```
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
Loading…
Reference in a new issue