From e9e42e305e19fce1c1fcfa65c70925003705c04c Mon Sep 17 00:00:00 2001 From: Emmanuel Garette Date: Fri, 11 Aug 2023 09:38:05 +0200 Subject: [PATCH] update doc --- seed/README.md | 145 +++++++++++++++--- seed/apache/README.md | 9 +- seed/base-debian-bullseye/README.md | 7 +- seed/base-debian/README.md | 7 +- seed/base-fedora-35/README.md | 7 +- seed/base-fedora-36/README.md | 7 +- seed/base-fedora-37/README.md | 7 +- seed/base-fedora-38/README.md | 7 +- seed/base-fedora/README.md | 7 +- seed/base-machine/README.md | 4 +- seed/base/README.md | 4 +- seed/base/dictionaries/00_base.xml | 4 +- seed/dns-external/README.md | 20 +-- .../dictionaries/14_dns-external.xml | 4 +- seed/dns-local/README.md | 8 +- seed/dovecot/README.md | 77 +++++----- seed/dovecot/applicationservice.yml | 3 +- seed/dovecot/dictionaries/31_dovecot.xml | 12 +- seed/dovecot/templates/config-v1.1.xml | 2 +- seed/forgejo/README.md | 69 ++++----- seed/gitea/README.md | 68 ++++---- seed/grafana/README.md | 58 ++++--- seed/host-systemd-machined/README.md | 37 ++--- .../dictionaries/21_machined.xml | 9 +- .../extras/machined/00_machined.xml | 2 +- seed/imap-client/README.md | 8 +- .../dictionaries/21_imap_client.xml | 2 +- seed/journald/README.md | 11 +- seed/journald/dictionaries/20_journald.xml | 2 +- seed/journald_remote/README.md | 11 +- .../extras/accounts/00_accounts.xml | 4 +- seed/ldap-client/README.md | 22 +-- .../dictionaries/21_ldap-client.xml | 26 ++-- seed/lemonldap/README.md | 79 +++++----- seed/lemonldap/extras/oauth2/00_oauth2.xml | 6 +- seed/loki/README.md | 20 ++- seed/loki/dictionaries/20_loki.xml | 2 +- seed/mailman/README.md | 70 ++++----- seed/mariadb-client/README.md | 11 +- .../dictionaries/20_mariadb.xml | 4 +- seed/mariadb/README.md | 20 ++- seed/mariadb/extras/accounts/00_accounts.xml | 10 +- seed/nextcloud/README.md | 110 ++++++------- seed/nextcloud/applicationservice.yml | 2 +- seed/nextcloud/dictionaries/31_nextcloud.xml | 2 +- seed/nginx-common/README.md | 19 +-- seed/nginx-common/dictionaries/21_nginx.xml | 12 +- seed/nginx-https/README.md | 7 +- seed/nginx-reverse-proxy/README.md | 60 +++++--- .../applicationservice.yml | 3 + .../dictionaries/25_nginx.xml | 14 +- .../extras/nginx/00_nginx.xml | 2 +- seed/nginx-static/README.md | 54 +++---- seed/nsd-local/README.md | 49 ++++-- seed/nsd-local/dictionaries/21_nsd-local.xml | 2 +- seed/nsd/README.md | 30 ++-- seed/oauth2-client/README.md | 10 +- .../dictionaries/30_oauth2_client.xml | 6 +- seed/odoo/README.md | 82 +++++----- seed/openldap/README.md | 28 ++-- seed/openldap/extras/accounts/00_account.xml | 2 +- seed/peertube/README.md | 83 +++++----- seed/php-fpm/README.md | 4 +- seed/php/README.md | 30 ++-- seed/php/dictionaries/20_php.xml | 23 +-- seed/php/templates/php.ini | 9 +- seed/piwigo/README.md | 106 ++++++------- seed/pki-tls/README.md | 4 +- seed/postfix-lmtp-relay/README.md | 11 +- .../extras/lmtp/00_lmtp.xml | 6 +- seed/postfix-relay/README.md | 47 ++++-- seed/postfix-relay/applicationservice.yml | 3 + .../postfix-relay/dictionaries/30_postfix.xml | 28 ++-- seed/postgresql-client/README.md | 25 +-- .../dictionaries/23_postgresql.xml | 10 +- seed/postgresql/README.md | 40 ++--- .../extras/accounts/00_accounts.xml | 10 +- seed/postgresql/templates/postgresql.conf | 5 +- seed/prometheus/README.md | 20 +-- .../prometheus/dictionaries/20_prometheus.xml | 2 +- seed/provider-systemd-machined/README.md | 36 +---- .../dictionaries/16_machined.xml | 6 +- seed/redis-client/README.md | 24 +-- seed/redis-client/dictionaries/23_redis.xml | 12 +- seed/redis-common/README.md | 7 +- seed/redis/README.md | 37 +++-- seed/redis/extras/accounts/00_accounts.xml | 8 +- seed/relay-lmtp-client/README.md | 8 +- .../dictionaries/30_lmtp.xml | 2 +- seed/relay-mail-client/README.md | 8 +- .../dictionaries/20_smtp_client.xml | 6 +- seed/resolved/README.md | 7 +- seed/reverse-proxy-client/README.md | 30 ++-- .../dictionaries/21_revprox_client.xml | 8 +- seed/roundcube/README.md | 97 ++++-------- seed/speedtest-rs/README.md | 40 ++--- seed/systemd/README.md | 7 +- seed/systemd/dictionaries/15_systemd.xml | 2 +- .../templates/systemd-firstboot.service | 2 +- seed/unbound/README.md | 24 +-- seed/unbound/dictionaries/20_unbound.xml | 8 +- seed/vaultwarden/README.md | 41 ++--- seed/vector/README.md | 54 +++++-- seed/vector/dictionaries/20_vector.xml | 6 +- seed/znc/README.md | 56 ++++--- seed/znc/applicationservice.yml | 1 + seed/znc/dictionaries/40_znc.xml | 18 +-- 107 files changed, 1168 insertions(+), 1239 deletions(-) diff --git a/seed/README.md b/seed/README.md index e13feb25..416df8f7 100644 --- a/seed/README.md +++ b/seed/README.md @@ -1,6 +1,6 @@ # Application services -- [dovecot](dovecot/README.md): Postfix and Dovecot as mail servers (Submission and IMAP) +- [dovecot](dovecot/README.md): Postfix and Dovecot as mail servers (IMAP and submission) - [forgejo](forgejo/README.md): Forgejo, a community managed lightweight code hosting solution - [gitea](gitea/README.md): Transitional package for Gitea to Forgejo - [grafana](grafana/README.md): Grafana is an analytics and interactive visualization web application @@ -77,50 +77,155 @@ - ExternalDNS: - Provider: [unbound](unbound/README.md) - Suppliers: - - [dns-external](dns-external/README.md) + - [postfix-relay](postfix-relay/README.md) + - [peertube](peertube/README.md) + - [znc](znc/README.md) - [nsd-local](nsd-local/README.md) -- Host: - - Provider: [host-systemd-machined](host-systemd-machined/README.md) - - Supplier: [provider-systemd-machined](provider-systemd-machined/README.md) - IMAP: - Provider: [dovecot](dovecot/README.md) - - Supplier: [imap-client](imap-client/README.md) + - Supplier: [roundcube](roundcube/README.md) - Journald: - - Provider: [journald_remote](journald_remote/README.md) - - Supplier: [journald](journald/README.md) + - Provider: [vector](vector/README.md) + - Suppliers: + - [odoo](odoo/README.md) + - [nginx-static](nginx-static/README.md) + - [grafana](grafana/README.md) + - [postgresql](postgresql/README.md) + - [postfix-relay](postfix-relay/README.md) + - [mailman](mailman/README.md) + - [peertube](peertube/README.md) + - [piwigo](piwigo/README.md) + - [vector](vector/README.md) + - [dovecot](dovecot/README.md) + - [unbound](unbound/README.md) + - [redis](redis/README.md) + - [loki](loki/README.md) + - [forgejo](forgejo/README.md) + - [nsd](nsd/README.md) + - [speedtest-rs](speedtest-rs/README.md) + - [nginx-reverse-proxy](nginx-reverse-proxy/README.md) + - [roundcube](roundcube/README.md) + - [znc](znc/README.md) + - [vaultwarden](vaultwarden/README.md) + - [prometheus](prometheus/README.md) + - [mariadb](mariadb/README.md) + - [nsd-local](nsd-local/README.md) + - [nextcloud](nextcloud/README.md) + - [lemonldap](lemonldap/README.md) + - [openldap](openldap/README.md) + - [gitea](gitea/README.md) - LDAP: - Provider: [openldap](openldap/README.md) - - Supplier: [ldap-client](ldap-client/README.md) + - Suppliers: + - [odoo](odoo/README.md) + - [piwigo](piwigo/README.md) + - [dovecot](dovecot/README.md) + - [roundcube](roundcube/README.md) + - [nextcloud](nextcloud/README.md) + - [lemonldap](lemonldap/README.md) - LMTP: - - Provider: [postfix-lmtp-relay](postfix-lmtp-relay/README.md) - - Supplier: [relay-lmtp-client](relay-lmtp-client/README.md) + - Provider: [postfix-relay](postfix-relay/README.md) + - Suppliers: + - [mailman](mailman/README.md) + - [dovecot](dovecot/README.md) - LocalDNS: - Provider: [nsd-local](nsd-local/README.md) - - Supplier: [dns-local](dns-local/README.md) + - Suppliers: + - [odoo](odoo/README.md) + - [nginx-static](nginx-static/README.md) + - [grafana](grafana/README.md) + - [postgresql](postgresql/README.md) + - [mailman](mailman/README.md) + - [piwigo](piwigo/README.md) + - [vector](vector/README.md) + - [dovecot](dovecot/README.md) + - [redis](redis/README.md) + - [loki](loki/README.md) + - [forgejo](forgejo/README.md) + - [nsd](nsd/README.md) + - [speedtest-rs](speedtest-rs/README.md) + - [nginx-reverse-proxy](nginx-reverse-proxy/README.md) + - [roundcube](roundcube/README.md) + - [vaultwarden](vaultwarden/README.md) + - [prometheus](prometheus/README.md) + - [mariadb](mariadb/README.md) + - [nsd-local](nsd-local/README.md) + - [nextcloud](nextcloud/README.md) + - [lemonldap](lemonldap/README.md) + - [openldap](openldap/README.md) + - [gitea](gitea/README.md) - Loki: - Provider: [loki](loki/README.md) - Supplier: [vector](vector/README.md) - MariaDB: - Provider: [mariadb](mariadb/README.md) - - Supplier: [mariadb-client](mariadb-client/README.md) + - Supplier: [piwigo](piwigo/README.md) - OAuth2: - Provider: [lemonldap](lemonldap/README.md) - - Supplier: [oauth2-client](oauth2-client/README.md) + - Suppliers: + - [odoo](odoo/README.md) + - [grafana](grafana/README.md) + - [mailman](mailman/README.md) + - [peertube](peertube/README.md) + - [piwigo](piwigo/README.md) + - [dovecot](dovecot/README.md) + - [forgejo](forgejo/README.md) + - [roundcube](roundcube/README.md) + - [nextcloud](nextcloud/README.md) + - [gitea](gitea/README.md) - Postgresql: - Provider: [postgresql](postgresql/README.md) - - Supplier: [postgresql-client](postgresql-client/README.md) + - Suppliers: + - [odoo](odoo/README.md) + - [grafana](grafana/README.md) + - [mailman](mailman/README.md) + - [peertube](peertube/README.md) + - [forgejo](forgejo/README.md) + - [roundcube](roundcube/README.md) + - [vaultwarden](vaultwarden/README.md) + - [nextcloud](nextcloud/README.md) + - [gitea](gitea/README.md) - Prometheus: - Provider: [prometheus](prometheus/README.md) - - Supplier: [host-systemd-machined](host-systemd-machined/README.md) - Redis: - Provider: [redis](redis/README.md) - - Supplier: [redis-client](redis-client/README.md) + - Suppliers: + - [peertube](peertube/README.md) + - [piwigo](piwigo/README.md) + - [forgejo](forgejo/README.md) + - [roundcube](roundcube/README.md) + - [nextcloud](nextcloud/README.md) + - [gitea](gitea/README.md) - ReverseProxy: - Provider: [nginx-reverse-proxy](nginx-reverse-proxy/README.md) - - Supplier: [reverse-proxy-client](reverse-proxy-client/README.md) + - Suppliers: + - [odoo](odoo/README.md) + - [nginx-static](nginx-static/README.md) + - [grafana](grafana/README.md) + - [mailman](mailman/README.md) + - [peertube](peertube/README.md) + - [piwigo](piwigo/README.md) + - [dovecot](dovecot/README.md) + - [forgejo](forgejo/README.md) + - [speedtest-rs](speedtest-rs/README.md) + - [roundcube](roundcube/README.md) + - [vaultwarden](vaultwarden/README.md) + - [nextcloud](nextcloud/README.md) + - [lemonldap](lemonldap/README.md) + - [gitea](gitea/README.md) - SMTP: - Provider: [postfix-relay](postfix-relay/README.md) - - Supplier: [relay-mail-client](relay-mail-client/README.md) + - Suppliers: + - [odoo](odoo/README.md) + - [grafana](grafana/README.md) + - [mailman](mailman/README.md) + - [peertube](peertube/README.md) + - [piwigo](piwigo/README.md) + - [dovecot](dovecot/README.md) + - [forgejo](forgejo/README.md) + - [vaultwarden](vaultwarden/README.md) + - [nextcloud](nextcloud/README.md) + - [lemonldap](lemonldap/README.md) + - [gitea](gitea/README.md) - Vector: - Provider: [vector](vector/README.md) - - Supplier: [host-systemd-machined](host-systemd-machined/README.md) diff --git a/seed/apache/README.md b/seed/apache/README.md index 661853c5..e35218e8 100644 --- a/seed/apache/README.md +++ b/seed/apache/README.md @@ -3,19 +3,20 @@ gitea: none include_toc: true --- + +[Return to the list of application services.](../README.md) # apache ## Synopsis -Apache as web server. -[Software's website.](https://httpd.apache.org/) +[Apache as web server.](https://httpd.apache.org/) ## Variables for expert -### Général +### General #### Apache @@ -33,5 +34,3 @@ Paramètrage avancé du serveur web Apache. ## Used by [nextcloud](../nextcloud/README.md) - -[All applications services for this dataset.](../README.md) diff --git a/seed/base-debian-bullseye/README.md b/seed/base-debian-bullseye/README.md index ec2829ee..b64d6fef 100644 --- a/seed/base-debian-bullseye/README.md +++ b/seed/base-debian-bullseye/README.md @@ -3,13 +3,14 @@ gitea: none include_toc: true --- + +[Return to the list of application services.](../README.md) # base-debian-bullseye ## Synopsis -Base information of a Debian Bulleye server. -[Software's website.](https://www.debian.org/) +[Base information of a Debian Bulleye server.](https://www.debian.org/) ## Dependances @@ -27,5 +28,3 @@ Base information of a Debian Bulleye server. - [odoo](../odoo/README.md) - [mailman](../mailman/README.md) - [lemonldap](../lemonldap/README.md) - -[All applications services for this dataset.](../README.md) diff --git a/seed/base-debian/README.md b/seed/base-debian/README.md index 455c6d1e..91512b3d 100644 --- a/seed/base-debian/README.md +++ b/seed/base-debian/README.md @@ -3,13 +3,14 @@ gitea: none include_toc: true --- + +[Return to the list of application services.](../README.md) # base-debian ## Synopsis -Base information of a Debian server. -[Software's website.](https://www.debian.org/) +[Base information of a Debian server.](https://www.debian.org/) ## Dependances @@ -24,5 +25,3 @@ Base information of a Debian server. ## Used by [base-debian-bullseye](../base-debian-bullseye/README.md) - -[All applications services for this dataset.](../README.md) diff --git a/seed/base-fedora-35/README.md b/seed/base-fedora-35/README.md index a8164be4..1e793b0f 100644 --- a/seed/base-fedora-35/README.md +++ b/seed/base-fedora-35/README.md @@ -3,13 +3,14 @@ gitea: none include_toc: true --- + +[Return to the list of application services.](../README.md) # base-fedora-35 ## Synopsis -Base information of a Fedora 35. -[Software's website.](https://getfedora.org/) +[Base information of a Fedora 35.](https://getfedora.org/) ## Dependances @@ -25,5 +26,3 @@ Base information of a Fedora 35. ## Used by [postfix-relay](../postfix-relay/README.md) - -[All applications services for this dataset.](../README.md) diff --git a/seed/base-fedora-36/README.md b/seed/base-fedora-36/README.md index 03ef07a1..083a1635 100644 --- a/seed/base-fedora-36/README.md +++ b/seed/base-fedora-36/README.md @@ -3,13 +3,14 @@ gitea: none include_toc: true --- + +[Return to the list of application services.](../README.md) # base-fedora-36 ## Synopsis -Base information of a Fedora 36. -[Software's website.](https://getfedora.org/) +[Base information of a Fedora 36.](https://getfedora.org/) ## Dependances @@ -32,5 +33,3 @@ Base information of a Fedora 36. - [vaultwarden](../vaultwarden/README.md) - [mariadb](../mariadb/README.md) - [nextcloud](../nextcloud/README.md) - -[All applications services for this dataset.](../README.md) diff --git a/seed/base-fedora-37/README.md b/seed/base-fedora-37/README.md index d8472268..8a5bb61d 100644 --- a/seed/base-fedora-37/README.md +++ b/seed/base-fedora-37/README.md @@ -3,13 +3,14 @@ gitea: none include_toc: true --- + +[Return to the list of application services.](../README.md) # base-fedora-37 ## Synopsis -Base information of a Fedora 37. -[Software's website.](https://getfedora.org/) +[Base information of a Fedora 37.](https://getfedora.org/) ## Dependances @@ -30,5 +31,3 @@ Base information of a Fedora 37. - [nsd](../nsd/README.md) - [nginx-reverse-proxy](../nginx-reverse-proxy/README.md) - [openldap](../openldap/README.md) - -[All applications services for this dataset.](../README.md) diff --git a/seed/base-fedora-38/README.md b/seed/base-fedora-38/README.md index 1e0f4356..1d808c92 100644 --- a/seed/base-fedora-38/README.md +++ b/seed/base-fedora-38/README.md @@ -3,13 +3,14 @@ gitea: none include_toc: true --- + +[Return to the list of application services.](../README.md) # base-fedora-38 ## Synopsis -Base information of a Fedora 38. -[Software's website.](https://getfedora.org/) +[Base information of a Fedora 38.](https://getfedora.org/) ## Dependances @@ -31,5 +32,3 @@ Base information of a Fedora 38. - [loki](../loki/README.md) - [forgejo](../forgejo/README.md) - [prometheus](../prometheus/README.md) - -[All applications services for this dataset.](../README.md) diff --git a/seed/base-fedora/README.md b/seed/base-fedora/README.md index e532760d..a4960c40 100644 --- a/seed/base-fedora/README.md +++ b/seed/base-fedora/README.md @@ -3,13 +3,14 @@ gitea: none include_toc: true --- + +[Return to the list of application services.](../README.md) # base-fedora ## Synopsis -Base information of a Fedora. -[Software's website.](https://getfedora.org/) +[Base information of a Fedora.](https://getfedora.org/) ## Dependances @@ -27,5 +28,3 @@ Base information of a Fedora. - [base-fedora-35](../base-fedora-35/README.md) - [base-fedora-38](../base-fedora-38/README.md) - [base-fedora-37](../base-fedora-37/README.md) - -[All applications services for this dataset.](../README.md) diff --git a/seed/base-machine/README.md b/seed/base-machine/README.md index 1852ce7e..9bf06972 100644 --- a/seed/base-machine/README.md +++ b/seed/base-machine/README.md @@ -3,6 +3,8 @@ gitea: none include_toc: true --- + +[Return to the list of application services.](../README.md) # base-machine ## Synopsis @@ -28,5 +30,3 @@ Base information for a machine. ## Used by [systemd](../systemd/README.md) - -[All applications services for this dataset.](../README.md) diff --git a/seed/base/README.md b/seed/base/README.md index b8308440..e95b57d2 100644 --- a/seed/base/README.md +++ b/seed/base/README.md @@ -3,6 +3,8 @@ gitea: none include_toc: true --- + +[Return to the list of application services.](../README.md) # base ## Synopsis @@ -13,5 +15,3 @@ Base of all application services. - [host-systemd-machined](../host-systemd-machined/README.md) - [base-machine](../base-machine/README.md) - -[All applications services for this dataset.](../README.md) diff --git a/seed/base/dictionaries/00_base.xml b/seed/base/dictionaries/00_base.xml index 031667cf..2ccdace8 100644 --- a/seed/base/dictionaries/00_base.xml +++ b/seed/base/dictionaries/00_base.xml @@ -1,8 +1,10 @@ - diff --git a/seed/dns-external/README.md b/seed/dns-external/README.md index 56cb8084..7f5d073e 100644 --- a/seed/dns-external/README.md +++ b/seed/dns-external/README.md @@ -3,33 +3,17 @@ gitea: none include_toc: true --- + +[Return to the list of application services.](../README.md) # dns-external ## Synopsis DNS client with resolution on all zones (especially outside). - -## Variables - -### Général - -#### network - -| Parameter | Comments | -|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------| -| **[general.network.dns_is_only_local](dictionaries/14_dns-external.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | **Default:** False | - - ## Used by - [postfix-relay](../postfix-relay/README.md) - [peertube](../peertube/README.md) - [unbound](../unbound/README.md) - [znc](../znc/README.md) - -## Provider - -[unbound](../unbound/README.md) - -[All applications services for this dataset.](../README.md) diff --git a/seed/dns-external/dictionaries/14_dns-external.xml b/seed/dns-external/dictionaries/14_dns-external.xml index 06f3b086..2758fb93 100644 --- a/seed/dns-external/dictionaries/14_dns-external.xml +++ b/seed/dns-external/dictionaries/14_dns-external.xml @@ -2,10 +2,10 @@ - + - + diff --git a/seed/dns-local/README.md b/seed/dns-local/README.md index 78203c7b..4cd0191d 100644 --- a/seed/dns-local/README.md +++ b/seed/dns-local/README.md @@ -3,6 +3,8 @@ gitea: none include_toc: true --- + +[Return to the list of application services.](../README.md) # dns-local ## Synopsis @@ -12,9 +14,3 @@ DNS client with access to local zones. ## Used by [base-machine](../base-machine/README.md) - -## Provider - -[nsd-local](../nsd-local/README.md) - -[All applications services for this dataset.](../README.md) diff --git a/seed/dovecot/README.md b/seed/dovecot/README.md index ed2d5999..fbb0d601 100644 --- a/seed/dovecot/README.md +++ b/seed/dovecot/README.md @@ -3,71 +3,67 @@ gitea: none include_toc: true --- + +[Return to the list of application services.](../README.md) # dovecot ## Synopsis -Postfix and Dovecot as mail servers (Submission and IMAP). -[Software's website.](https://www.dovecot.org/) +[Postfix and Dovecot as mail servers (IMAP and submission).](https://www.dovecot.org/) + +This application service provides email server. Two servers are used: Dovecot as IMAP server and Postfix as submission server. In addition, an auto-detection file of the email configuration is set up. ## Basic variables -### Général +### General #### Mail configuration +Configure IMAP servers and submission to access email accounts and send emails. + ##### Mail domain This family is a leadership. -| Parameter | Comments | -|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------| -| **[general.mail.domain.mail_domains](dictionaries/31_dovecot.xml)**
mandatory, multiple
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Domaine de courriel géré localement.
**Example:** example.net | -| **[general.mail.domain.imap_domainname](dictionaries/31_dovecot.xml)**
mandatory
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Domaine exterieur d'accès au serveur IMAP.
**Example:** imap.example.net | -| **[general.mail.domain.submission_domainname](dictionaries/31_dovecot.xml)**
mandatory
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Domaine exterieur d'accès au serveur submission.
**Example:** submission.example.net | +| Parameter | Comments | +|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| **[general.mail.domain.mail_domains](dictionaries/31_dovecot.xml)**
mandatory, multiple
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Final destination email address.
These domain names are the domain names for emails (user@*example.net*) and for auto configuration of email clients (https://*example.net*/.well-known/autoconfig/mail/config-v1.1.xml).
**Example:** example.net | +| **[general.mail.domain.imap_domainname](dictionaries/31_dovecot.xml)**
mandatory
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | External IMAP server address.
Matches TLS connection’s SNI name, if it’s sent by the client. For some email clients, use in DNS configuration a line like "_submissions._tcp IN SRV 1 587 *imap.example.net*.".
**Example:** imap.example.net | +| **[general.mail.domain.submission_domainname](dictionaries/31_dovecot.xml)**
mandatory
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | External submission server address.
Matches TLS connection’s SNI name, if it’s sent by the client. For some email clients, add in DNS configuration a line like "_imaps._tcp IN SRV 0 1 993 *submission.example.net*.".
**Example:** submission.example.net | -## Variables +| Parameter | Comments | +|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| **[general.mail.mail_crt_provider](dictionaries/31_dovecot.xml)**
mandatory
**Type:** [`choice`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Type of certificate autority signing external IMAP and submission domain certificates.
The certificate can be self-signed (therefore invalid by default for the client) or obtained via the Let's Encrypt service (generally valid for the client).
**Choices:**
- `self-signed` ← default
- `letsencrypt` | -### Général - -#### Mail configuration - -##### Mail domain - -This family is a leadership. - -| Parameter | Comments | -|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------| -| **[general.mail.mail_crt_provider](dictionaries/31_dovecot.xml)**
mandatory
**Type:** [`choice`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Autorité de certification signant les certificats des domaines extérieurs.
**Choices:**
- `self-signed` ← default
- `letsencrypt` | ## Variables for expert -### Général +### General -#### Annuaire OpenLDAP +#### OpenLDAP directory ##### Client -| Parameter | Comments | -|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------| -| **[general.ldap.client.ldapclient_family](dictionaries/31_dovecot.xml)**
mandatory
**Type:** [`unix_user`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Nom de la famille LDAP.
**Default:** all | -| **[general.ldap.client.ldapclient_base_dn](dictionaries/21_ldap-client.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Base DN de l'annuaire.
**Default:** *calculated* | -| **[general.ldap.client.ldapclient_search_dn](dictionaries/21_ldap-client.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Base DN de l'annuaire des utilisateurs.
**Default:** *calculated* | -| **[general.ldap.client.ldapclient_group_dn](dictionaries/21_ldap-client.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Base DN de l'annuaire des groupes.
**Default:** *calculated* | -| **[general.ldap.client.ldapclient_user_dn](dictionaries/21_ldap-client.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Base DN de l'annuaire des utilisateurs n'appartenant à une famille.
**Default:** *calculated* | +| Parameter | Comments | +|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------| +| **[general.ldap.client.ldapclient_family](dictionaries/31_dovecot.xml)**
mandatory
**Type:** [`unix_user`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Restrict service configuration for a LDAP family.
"all" for all families.
**Default:** all | ## Requirements services -- **LocalDNS** -- Journald -- **SMTP** -- **LDAP** -- **ReverseProxy** -- **LMTP** -- **OAuth2** +### Mandatories + +- LocalDNS: [nsd-local](../nsd-local/README.md) +- SMTP: [postfix-relay](../postfix-relay/README.md) +- LDAP: [openldap](../openldap/README.md) +- ReverseProxy: [nginx-reverse-proxy](../nginx-reverse-proxy/README.md) +- OAuth2: [lemonldap](../lemonldap/README.md) + +### Optionals + +- Journald: [vector](../vector/README.md) **bold**: provider is mandatory @@ -82,10 +78,9 @@ dovecot: zones_name: - ldap - localdns + - oauth2 - reverseproxy - smtp - - lmtp - - oauth2 values: general.mail.domain.mail_domains: - example.net @@ -114,8 +109,6 @@ dovecot: - [nginx-common](../nginx-common/README.md) - [reverse-proxy-client](../reverse-proxy-client/README.md) -## Supplier +## Useful for service -[imap-client](../imap-client/README.md) - -[All applications services for this dataset.](../README.md) +[roundcube](../roundcube/README.md): Roundcube, a webmail. diff --git a/seed/dovecot/applicationservice.yml b/seed/dovecot/applicationservice.yml index 3875576a..9c6d8123 100644 --- a/seed/dovecot/applicationservice.yml +++ b/seed/dovecot/applicationservice.yml @@ -1,5 +1,6 @@ format: '0.1' -description: Postfix and Dovecot as mail servers (Submission and IMAP) +description: Postfix and Dovecot as mail servers (IMAP and submission) +help: "This application service provides email server. Two servers are used: Dovecot as IMAP server and Postfix as submission server. In addition, an auto-detection file of the email configuration is set up." website: https://www.dovecot.org/ depends: - base-fedora-36 diff --git a/seed/dovecot/dictionaries/31_dovecot.xml b/seed/dovecot/dictionaries/31_dovecot.xml index 6aab8278..0884b6c3 100644 --- a/seed/dovecot/dictionaries/31_dovecot.xml +++ b/seed/dovecot/dictionaries/31_dovecot.xml @@ -63,21 +63,21 @@ - + - + - + self-signed self-signed letsencrypt - + diff --git a/seed/dovecot/templates/config-v1.1.xml b/seed/dovecot/templates/config-v1.1.xml index f45092d7..55e986b8 100644 --- a/seed/dovecot/templates/config-v1.1.xml +++ b/seed/dovecot/templates/config-v1.1.xml @@ -1,5 +1,5 @@ -# GNUNUX: from https://wiki.mozilla.org/Thunderbird:Autoconfiguration:ConfigFileFormat --> + {%set domain = rougail_variable %} {%set leader = general.mail.domain.mail_domains[mail_domains.index(domain)] %} {%set imap_domain = leader.imap_domainname %} diff --git a/seed/forgejo/README.md b/seed/forgejo/README.md index 1454e67d..4458aa3d 100644 --- a/seed/forgejo/README.md +++ b/seed/forgejo/README.md @@ -3,28 +3,29 @@ gitea: none include_toc: true --- + +[Return to the list of application services.](../README.md) # forgejo ## Synopsis -Forgejo, a community managed lightweight code hosting solution. -[Software's website.](https://forgejo.org/) +[Forgejo, a community managed lightweight code hosting solution.](https://forgejo.org/) ## Basic variables -### Général +### General #### Reverse proxy -##### Point d'entrée des clients +##### Clients configuration This family is a leadership. -| Parameter | Comments | -|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------| -| **[general.revprox.revprox_client.revprox_client_external_domainnames](dictionaries/21_revprox_client.xml)**
mandatory, multiple
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Nom de domaine exterieur du serveur.
**Example:** service.example.net | -| **[general.revprox.revprox_client.revprox_client_location](dictionaries/21_revprox_client.xml)**
mandatory
**Type:** [`filename`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Nom de l'arborescence racine du site. | +| Parameter | Comments | +|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------| +| **[general.revprox.revprox_client.revprox_client_external_domainnames](dictionaries/21_revprox_client.xml)**
mandatory, multiple
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Service external domain name.
**Example:** service.example.net | +| **[general.revprox.revprox_client.revprox_client_location](dictionaries/21_revprox_client.xml)**
mandatory
**Type:** [`filename`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | URI to route request to the correct service.
**Default:** / | #### Forgejo @@ -38,32 +39,17 @@ Git forge Forgejo. ## Variables for expert -### Général +### General #### Reverse proxy -##### Point d'entrée des clients +##### Clients configuration This family is a leadership. -| Parameter | Comments | -|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------| -| **[general.revprox.revprox_client.revprox_client_max_body_size](dictionaries/21_revprox_client.xml)**
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Taille maximum du corps. | - -#### PostgreSQL - -| Parameter | Comments | -|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------| -| **[general.postgresql.pg_client_username](dictionaries/23_postgresql.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Client username.
**Default:** *calculated* | -| **[general.postgresql.pg_client_password](dictionaries/23_postgresql.xml)**
mandatory
**Type:** [`password`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Client password.
**Default:** *calculated* | -| **[general.postgresql.pg_client_database](dictionaries/23_postgresql.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Client database.
**Default:** *calculated* | - -#### Redis - -| Parameter | Comments | -|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------| -| **[general.redis.redis_client_username](dictionaries/23_redis.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Nom d'utilisateur.
**Default:** *calculated* | -| **[general.redis.redis_client_password](dictionaries/23_redis.xml)**
mandatory
**Type:** [`password`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Mot de passe de connexion.
**Default:** *calculated* | +| Parameter | Comments | +|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------| +| **[general.revprox.revprox_client.revprox_client_max_body_size](dictionaries/21_revprox_client.xml)**
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | The maximum allowed size of the client request body. | #### OAuth2 client @@ -89,13 +75,18 @@ This family is a leadership. ## Requirements services -- **LocalDNS** -- Journald -- **SMTP** -- **ReverseProxy** -- **Postgresql** -- **Redis** -- **OAuth2** +### Mandatories + +- LocalDNS: [nsd-local](../nsd-local/README.md) +- SMTP: [postfix-relay](../postfix-relay/README.md) +- ReverseProxy: [nginx-reverse-proxy](../nginx-reverse-proxy/README.md) +- Postgresql: [postgresql](../postgresql/README.md) +- OAuth2: [lemonldap](../lemonldap/README.md) +- Redis: [redis](../redis/README.md) + +### Optionals + +- Journald: [vector](../vector/README.md) **bold**: provider is mandatory @@ -108,11 +99,11 @@ forgejo: applicationservice: forgejo zones_name: - localdns - - reverseproxy - - smtp - - redis - oauth2 - postgresql + - redis + - reverseproxy + - smtp values: general.revprox.revprox_client.revprox_client_external_domainnames: - service.example.net @@ -140,5 +131,3 @@ forgejo: ## Used by [gitea](../gitea/README.md) - -[All applications services for this dataset.](../README.md) diff --git a/seed/gitea/README.md b/seed/gitea/README.md index a6e085ae..08f194cc 100644 --- a/seed/gitea/README.md +++ b/seed/gitea/README.md @@ -3,6 +3,8 @@ gitea: none include_toc: true --- + +[Return to the list of application services.](../README.md) # gitea ## Synopsis @@ -11,18 +13,18 @@ Transitional package for Gitea to Forgejo. ## Basic variables -### Général +### General #### Reverse proxy -##### Point d'entrée des clients +##### Clients configuration This family is a leadership. -| Parameter | Comments | -|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------| -| **[general.revprox.revprox_client.revprox_client_external_domainnames](dictionaries/21_revprox_client.xml)**
mandatory, multiple
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Nom de domaine exterieur du serveur.
**Example:** service.example.net | -| **[general.revprox.revprox_client.revprox_client_location](dictionaries/21_revprox_client.xml)**
mandatory
**Type:** [`filename`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Nom de l'arborescence racine du site. | +| Parameter | Comments | +|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------| +| **[general.revprox.revprox_client.revprox_client_external_domainnames](dictionaries/21_revprox_client.xml)**
mandatory, multiple
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Service external domain name.
**Example:** service.example.net | +| **[general.revprox.revprox_client.revprox_client_location](dictionaries/21_revprox_client.xml)**
mandatory
**Type:** [`filename`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | URI to route request to the correct service.
**Default:** / | #### Forgejo @@ -36,7 +38,7 @@ Git forge Forgejo. ## Variables -### Général +### General #### Forgejo @@ -54,32 +56,17 @@ Git forge Forgejo. ## Variables for expert -### Général +### General #### Reverse proxy -##### Point d'entrée des clients +##### Clients configuration This family is a leadership. -| Parameter | Comments | -|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------| -| **[general.revprox.revprox_client.revprox_client_max_body_size](dictionaries/21_revprox_client.xml)**
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Taille maximum du corps. | - -#### PostgreSQL - -| Parameter | Comments | -|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------| -| **[general.postgresql.pg_client_username](dictionaries/23_postgresql.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Client username.
**Default:** *calculated* | -| **[general.postgresql.pg_client_password](dictionaries/23_postgresql.xml)**
mandatory
**Type:** [`password`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Client password.
**Default:** *calculated* | -| **[general.postgresql.pg_client_database](dictionaries/23_postgresql.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Client database.
**Default:** *calculated* | - -#### Redis - -| Parameter | Comments | -|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------| -| **[general.redis.redis_client_username](dictionaries/23_redis.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Nom d'utilisateur.
**Default:** *calculated* | -| **[general.redis.redis_client_password](dictionaries/23_redis.xml)**
mandatory
**Type:** [`password`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Mot de passe de connexion.
**Default:** *calculated* | +| Parameter | Comments | +|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------| +| **[general.revprox.revprox_client.revprox_client_max_body_size](dictionaries/21_revprox_client.xml)**
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | The maximum allowed size of the client request body. | #### OAuth2 client @@ -105,13 +92,18 @@ This family is a leadership. ## Requirements services -- **LocalDNS** -- Journald -- **SMTP** -- **ReverseProxy** -- **Postgresql** -- **Redis** -- **OAuth2** +### Mandatories + +- LocalDNS: [nsd-local](../nsd-local/README.md) +- SMTP: [postfix-relay](../postfix-relay/README.md) +- ReverseProxy: [nginx-reverse-proxy](../nginx-reverse-proxy/README.md) +- Postgresql: [postgresql](../postgresql/README.md) +- OAuth2: [lemonldap](../lemonldap/README.md) +- Redis: [redis](../redis/README.md) + +### Optionals + +- Journald: [vector](../vector/README.md) **bold**: provider is mandatory @@ -124,11 +116,11 @@ gitea: applicationservice: gitea zones_name: - localdns - - reverseproxy - - smtp - - redis - oauth2 - postgresql + - redis + - reverseproxy + - smtp values: general.revprox.revprox_client.revprox_client_external_domainnames: - service.example.net @@ -152,5 +144,3 @@ gitea: - [redis-client](../redis-client/README.md) - [redis-common](../redis-common/README.md) - [oauth2-client](../oauth2-client/README.md) - -[All applications services for this dataset.](../README.md) diff --git a/seed/grafana/README.md b/seed/grafana/README.md index 46cbcb0a..fd06154b 100644 --- a/seed/grafana/README.md +++ b/seed/grafana/README.md @@ -3,28 +3,29 @@ gitea: none include_toc: true --- + +[Return to the list of application services.](../README.md) # grafana ## Synopsis -Grafana is an analytics and interactive visualization web application. -[Software's website.](https://grafana.com/) +[Grafana is an analytics and interactive visualization web application.](https://grafana.com/) ## Basic variables -### Général +### General #### Reverse proxy -##### Point d'entrée des clients +##### Clients configuration This family is a leadership. -| Parameter | Comments | -|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------| -| **[general.revprox.revprox_client.revprox_client_external_domainnames](dictionaries/21_revprox_client.xml)**
mandatory, multiple
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Nom de domaine exterieur du serveur.
**Example:** service.example.net | -| **[general.revprox.revprox_client.revprox_client_location](dictionaries/21_revprox_client.xml)**
mandatory
**Type:** [`filename`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Nom de l'arborescence racine du site. | +| Parameter | Comments | +|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------| +| **[general.revprox.revprox_client.revprox_client_external_domainnames](dictionaries/21_revprox_client.xml)**
mandatory, multiple
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Service external domain name.
**Example:** service.example.net | +| **[general.revprox.revprox_client.revprox_client_location](dictionaries/21_revprox_client.xml)**
mandatory
**Type:** [`filename`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | URI to route request to the correct service.
**Default:** / | #### OAuth2 client @@ -37,25 +38,17 @@ This family is a leadership. ## Variables for expert -### Général +### General #### Reverse proxy -##### Point d'entrée des clients +##### Clients configuration This family is a leadership. -| Parameter | Comments | -|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------| -| **[general.revprox.revprox_client.revprox_client_max_body_size](dictionaries/21_revprox_client.xml)**
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Taille maximum du corps. | - -#### PostgreSQL - -| Parameter | Comments | -|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------| -| **[general.postgresql.pg_client_username](dictionaries/23_postgresql.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Client username.
**Default:** *calculated* | -| **[general.postgresql.pg_client_password](dictionaries/23_postgresql.xml)**
mandatory
**Type:** [`password`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Client password.
**Default:** *calculated* | -| **[general.postgresql.pg_client_database](dictionaries/23_postgresql.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Client database.
**Default:** *calculated* | +| Parameter | Comments | +|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------| +| **[general.revprox.revprox_client.revprox_client_max_body_size](dictionaries/21_revprox_client.xml)**
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | The maximum allowed size of the client request body. | #### OAuth2 client @@ -79,12 +72,17 @@ This family is a leadership. ## Requirements services -- **LocalDNS** -- Journald -- **SMTP** -- **ReverseProxy** -- **Postgresql** -- **OAuth2** +### Mandatories + +- LocalDNS: [nsd-local](../nsd-local/README.md) +- SMTP: [postfix-relay](../postfix-relay/README.md) +- ReverseProxy: [nginx-reverse-proxy](../nginx-reverse-proxy/README.md) +- Postgresql: [postgresql](../postgresql/README.md) +- OAuth2: [lemonldap](../lemonldap/README.md) + +### Optionals + +- Journald: [vector](../vector/README.md) **bold**: provider is mandatory @@ -97,10 +95,10 @@ grafana: applicationservice: grafana zones_name: - localdns - - reverseproxy - - smtp - oauth2 - postgresql + - reverseproxy + - smtp values: general.revprox.revprox_client.revprox_client_external_domainnames: - service.example.net @@ -122,5 +120,3 @@ grafana: - [oauth2-client](../oauth2-client/README.md) - [reverse-proxy-client](../reverse-proxy-client/README.md) - [relay-mail-client](../relay-mail-client/README.md) - -[All applications services for this dataset.](../README.md) diff --git a/seed/host-systemd-machined/README.md b/seed/host-systemd-machined/README.md index 8799fc55..6c7516fc 100644 --- a/seed/host-systemd-machined/README.md +++ b/seed/host-systemd-machined/README.md @@ -3,17 +3,18 @@ gitea: none include_toc: true --- + +[Return to the list of application services.](../README.md) # host-systemd-machined ## Synopsis -Host with machine started in Systemd Machined environment. -[Software's website.](https://www.freedesktop.org/wiki/Software/systemd/machined/) +[Host with machine started in Systemd Machined environment.](https://www.freedesktop.org/wiki/Software/systemd/machined/) ## Basic variables -### Général +### General #### network @@ -34,7 +35,7 @@ This family is a leadership. ## Variables -### Général +### General | Parameter | Comments | |----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------| @@ -46,22 +47,22 @@ This family is a leadership. This family is a leadership. -| Parameter | Comments | -|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------| -| **[general.network.interfaces.interface_type](dictionaries/21_machined.xml)**
mandatory
**Type:** [`choice`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Type de la carte.
**Choices:**
- `dhcp`
- `ipv4` | +| Parameter | Comments | +|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------| +| **[general.network.interfaces.interface_type](dictionaries/21_machined.xml)**
mandatory
**Type:** [`choice`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Type de la carte.
**Choices:**
- `dhcp` ← default
- `ipv4` | + +## Variables for expert + +### General + +#### base + +| Parameter | Comments | +|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------| +| **[general.base.time_zone](dictionaries/21_machined.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Time zone.
**Default:** Europe/Paris | + ## Dependances - [base](../base/README.md) - -## Supplier - -[provider-systemd-machined](../provider-systemd-machined/README.md) - -## Providers - -- [prometheus](../prometheus/README.md) -- [vector](../vector/README.md) - -[All applications services for this dataset.](../README.md) diff --git a/seed/host-systemd-machined/dictionaries/21_machined.xml b/seed/host-systemd-machined/dictionaries/21_machined.xml index b6fbbe85..39e9befb 100644 --- a/seed/host-systemd-machined/dictionaries/21_machined.xml +++ b/seed/host-systemd-machined/dictionaries/21_machined.xml @@ -33,10 +33,10 @@ - + + + + 25 + postfix_mail_hostname + + True + outgoing_ports + diff --git a/seed/postgresql-client/README.md b/seed/postgresql-client/README.md index cdb79b1f..db56626b 100644 --- a/seed/postgresql-client/README.md +++ b/seed/postgresql-client/README.md @@ -3,27 +3,14 @@ gitea: none include_toc: true --- + +[Return to the list of application services.](../README.md) # postgresql-client ## Synopsis -Application service needs interact with a Postgresql server. -[Software's website.](https://www.postgresql.org) - - - -## Variables for expert - -### Général - -#### PostgreSQL - -| Parameter | Comments | -|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------| -| **[general.postgresql.pg_client_username](dictionaries/23_postgresql.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Client username.
**Default:** *calculated* | -| **[general.postgresql.pg_client_password](dictionaries/23_postgresql.xml)**
mandatory
**Type:** [`password`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Client password.
**Default:** *calculated* | -| **[general.postgresql.pg_client_database](dictionaries/23_postgresql.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Client database.
**Default:** *calculated* | +[Application service needs interact with a Postgresql server.](https://www.postgresql.org) ## Used by @@ -35,9 +22,3 @@ Application service needs interact with a Postgresql server. - [roundcube](../roundcube/README.md) - [vaultwarden](../vaultwarden/README.md) - [nextcloud](../nextcloud/README.md) - -## Provider - -[postgresql](../postgresql/README.md) - -[All applications services for this dataset.](../README.md) diff --git a/seed/postgresql-client/dictionaries/23_postgresql.xml b/seed/postgresql-client/dictionaries/23_postgresql.xml index d70417a8..11d9604f 100644 --- a/seed/postgresql-client/dictionaries/23_postgresql.xml +++ b/seed/postgresql-client/dictionaries/23_postgresql.xml @@ -10,11 +10,11 @@ - - - - - diff --git a/seed/postgresql/README.md b/seed/postgresql/README.md index c1a841e1..3813d0a8 100644 --- a/seed/postgresql/README.md +++ b/seed/postgresql/README.md @@ -3,18 +3,19 @@ gitea: none include_toc: true --- + +[Return to the list of application services.](../README.md) # postgresql ## Synopsis -Postgresql, a database. -[Software's website.](https://www.postgresql.org) +[Postgresql, a database.](https://www.postgresql.org) ## Variables -### Général +### General #### PostgreSQL @@ -39,21 +40,16 @@ Paramétrage du serveur de gestion de bases de données PostgreSQL. | **[general.postgresql.pg_effective_cache_size](dictionaries/22_postgresql.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Taille du cache.
Initialise l'estimation faite par le planificateur pour le nombre de bloc de 8ko réelle du cache disque disponible pour une requête.
**Default:** 4 | | **[general.postgresql.pg_effective_cache_size_unit](dictionaries/22_postgresql.xml)**
mandatory
**Type:** [`choice`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Unité de la taille du cache.
**Choices:**
- `MB`
- `kB`
- `GB` ← default | -### Accounts - -#### Account for *suffix value* - -This a dynamic family generated from the variable "accounts.remotes". - -| Parameter | Comments | -|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------| -| **[accounts.remote_*suffix value*.remote_ip_*suffix value*](extras/accounts/00_accounts.xml)**
mandatory
**Type:** [`ip`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Remote IP .
**Default:** *calculated* | - ## Requirements services -- **LocalDNS** -- Journald +### Mandatories + +- LocalDNS: [nsd-local](../nsd-local/README.md) + +### Optionals + +- Journald: [vector](../vector/README.md) **bold**: provider is mandatory @@ -81,8 +77,14 @@ postgresql: - [journald](../journald/README.md) - [resolved](../resolved/README.md) -## Supplier +## Useful for services -[postgresql-client](../postgresql-client/README.md) - -[All applications services for this dataset.](../README.md) +- [forgejo](../forgejo/README.md): Forgejo, a community managed lightweight code hosting solution. +- [gitea](../gitea/README.md): Transitional package for Gitea to Forgejo. +- [grafana](../grafana/README.md): Grafana is an analytics and interactive visualization web application. +- [mailman](../mailman/README.md): GNU Mailman, managing electronic mail discussion and e-newsletter lists. +- [nextcloud](../nextcloud/README.md): Nextcloud, Online collaboration platform. +- [odoo](../odoo/README.md): Odoo, an ERP and CRM. +- [peertube](../peertube/README.md): Peertube, a federated (ActivityPub) video streaming platform. +- [roundcube](../roundcube/README.md): Roundcube, a webmail. +- [vaultwarden](../vaultwarden/README.md): Vaultwarden, a password manager. diff --git a/seed/postgresql/extras/accounts/00_accounts.xml b/seed/postgresql/extras/accounts/00_accounts.xml index ff655c4b..7d23316d 100644 --- a/seed/postgresql/extras/accounts/00_accounts.xml +++ b/seed/postgresql/extras/accounts/00_accounts.xml @@ -1,12 +1,12 @@ - - + diff --git a/seed/postgresql/templates/postgresql.conf b/seed/postgresql/templates/postgresql.conf index 73316079..84b31639 100644 --- a/seed/postgresql/templates/postgresql.conf +++ b/seed/postgresql/templates/postgresql.conf @@ -627,7 +627,7 @@ log_destination = 'syslog' #FIXME en dure ? #>GNUNUX #log_timezone = 'GMT' -log_timezone = 'Europe/Paris' +log_timezone = '{{ general.base.time_zone }}' #GNUNUX -#FIXME en dure ? -timezone = 'Europe/Paris' +timezone = '{{ general.base.time_zone }}' # - + diff --git a/seed/provider-systemd-machined/README.md b/seed/provider-systemd-machined/README.md index 4be5dc95..f0888f92 100644 --- a/seed/provider-systemd-machined/README.md +++ b/seed/provider-systemd-machined/README.md @@ -3,38 +3,14 @@ gitea: none include_toc: true --- + +[Return to the list of application services.](../README.md) # provider-systemd-machined ## Synopsis -Machine started in Systemd Machined environment. -[Software's website.](https://www.freedesktop.org/wiki/Software/systemd/machined/) - - -## Variables - -### Général - -| Parameter | Comments | -|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------| -| **[general.use_systemd_repart](dictionaries/16_machined.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | **Default:** False | - -#### network - -| Parameter | Comments | -|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------| -| **[general.network.netwokd_interface_name_type](dictionaries/16_machined.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | **Default:** host | - -## Variables for expert - -### Général - -#### network - -| Parameter | Comments | -|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------| -| **[general.network.zones_list](dictionaries/16_machined.xml)**
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | | +[Machine started in Systemd Machined environment.](https://www.freedesktop.org/wiki/Software/systemd/machined/) ## Dependances @@ -45,9 +21,3 @@ Machine started in Systemd Machined environment. - [pki-tls](../pki-tls/README.md) - [journald](../journald/README.md) - [resolved](../resolved/README.md) - -## Provider - -[host-systemd-machined](../host-systemd-machined/README.md) - -[All applications services for this dataset.](../README.md) diff --git a/seed/provider-systemd-machined/dictionaries/16_machined.xml b/seed/provider-systemd-machined/dictionaries/16_machined.xml index a32b0a6d..48d9b4de 100644 --- a/seed/provider-systemd-machined/dictionaries/16_machined.xml +++ b/seed/provider-systemd-machined/dictionaries/16_machined.xml @@ -26,16 +26,16 @@ /var/lib/risotto/journals