diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..364fdec --- /dev/null +++ b/.gitignore @@ -0,0 +1 @@ +public/ diff --git a/src/content/documentation.md b/src/content/documentation.md index 9647328..dd45dfe 100644 --- a/src/content/documentation.md +++ b/src/content/documentation.md @@ -4,83 +4,155 @@ slug = "documentation" template = "documentation.html" +++ -En cours d'Ă©criture đź“ť ! +En cours d'Ă©criture đź“ť...
+S'il vous manque une information, [contactez-moi](/contact). -Lorem ipsum dolor sit amet, consectetur adipisicing elit. Commodi tempore ratione necessitatibus culpa maxime delectus, -accusamus harum est porro ut fugiat aperiam, consequuntur explicabo. Modi tenetur incidunt non exercitationem sunt? -Lorem ipsum dolor sit amet consectetur adipisicing elit. Quae magnam, cum iste minima culpa recusandae et reiciendis -veritatis deserunt debitis fuga, atque delectus qui ea dolorum tempore aspernatur nihil nisi! +## Utilisateurs {#users} -### Infrastructure +Vous trouverez ici toutes les informations dont vous pourriez avoir besoin pour +utiliser les services de NETig. -Lorem ipsum dolor sit amet, consectetur adipisicing elit. Commodi tempore ratione necessitatibus culpa maxime delectus, -accusamus harum est porro ut fugiat aperiam, consequuntur explicabo. Modi tenetur incidunt non exercitationem sunt? -Lorem ipsum dolor sit amet consectetur adipisicing elit. Quae magnam, cum iste minima culpa recusandae et reiciendis -veritatis deserunt debitis fuga, atque delectus qui ea dolorum tempore aspernatur nihil nisi! +### NETmail {#netmail} -#### Serveurs +Vous pouvez consulter vos mails depuis le [webmail](https://webmail.netig.net), +mais si vous souhaitez utiliser un client tel que Thunderbird, ou bien K-9 Mail +sur Android voici la configuration : -Lorem ipsum dolor sit amet consectetur adipisicing elit. Soluta, voluptate consequatur. Ex, ipsum sint. Hic, esse modi, -ipsam dicta minima praesentium assumenda unde architecto nostrum quibusdam reprehenderit tenetur qui nulla? Lorem ipsum -dolor sit, amet consectetur adipisicing elit. Repellat iusto eius aspernatur earum, quo reiciendis, magni doloremque -debitis ipsum at laborum deserunt quis molestias facilis provident facere rem! Aliquam, voluptatem? Lorem ipsum, dolor -sit amet consectetur adipisicing elit. Deserunt sunt, porro soluta perferendis, ipsa alias voluptatum facere eos -reprehenderit explicabo dolorem sit accusantium consequatur minima quia molestias culpa temporibus autem. Lorem ipsum -dolor sit amet consectetur adipisicing elit. Sunt alias odio excepturi sed eligendi omnis modi amet dolores saepe, -quibusdam placeat? Praesentium voluptatum molestiae quos laboriosam eligendi facilis minima doloribus. +IMAP -#### Réseau +* Serveur : mail.netig.net +* Type de sécurité : STARTTLS +* Port : 143 +* Nom d'utilisateur : adresse mail complète -Lorem ipsum dolor sit amet consectetur adipisicing elit. Inventore quae reprehenderit nostrum neque nulla dicta quasi -eius perspiciatis cum eos, id, voluptatem quaerat, minus tenetur placeat doloribus ea porro amet. +SMTP -#### Sauvegardes +* Serveur : mail.netig.net +* Type de sécurité : STARTTLS +* Port : 587 +* Nom d'utilisateur : adresse mail complète -Lorem ipsum dolor sit amet, consectetur adipisicing elit. Commodi tempore ratione necessitatibus culpa maxime delectus, -accusamus harum est porro ut fugiat aperiam, consequuntur explicabo. Modi tenetur incidunt non exercitationem sunt? -Lorem ipsum dolor sit amet consectetur adipisicing elit. Quae magnam, cum iste minima culpa recusandae et reiciendis -veritatis deserunt debitis fuga, atque delectus qui ea dolorum tempore aspernatur nihil nisi! +## Administrateurs {#admins} -### Services +Le coins des admins 👨‍💻 ! -Lorem ipsum dolor sit amet, consectetur adipisicing elit. Commodi tempore ratione necessitatibus culpa maxime delectus, -accusamus harum est porro ut fugiat aperiam, consequuntur explicabo. Modi tenetur incidunt non exercitationem sunt? -Lorem ipsum dolor sit amet consectetur adipisicing elit. Quae magnam, cum iste minima culpa recusandae et reiciendis -veritatis deserunt debitis fuga, atque delectus qui ea dolorum tempore aspernatur nihil nisi! +### Infrastructure {#infra} -#### Mail +L'infrastructure "matérielle" de NETig repose sur des VPS (Virtual Private +Server) de petite capacité afin de suivre les besoins au plus près, d'éviter les +surcoûts de location, le gaspillage énergétique, mais également d'améliorer la +fiabilité en cloisonnant les services. -Lorem ipsum dolor sit amet consectetur adipisicing elit. Inventore quae reprehenderit nostrum neque nulla dicta quasi -eius perspiciatis cum eos, id, voluptatem quaerat, minus tenetur placeat doloribus ea porro amet. +Concernant la partie logicielle c'est +[Chimera Linux](https://chimera-linux.org) qui a été choisi comme système +d'exploitation, pour ses bonnes pratiques de sécurité et sa simplicité +d'administration. Les services sont conteneurisés avec +[Nerdctl](https://github.com/containerd/nerdctl) (compatible avec Docker), il +s'agit d'une couche légère de virtualisation qui permet un niveau supplémentaire +de cloisonnement mais également de simplifier les tâches de déploiement. -Lorem ipsum dolor sit amet consectetur adipisicing elit. Soluta, voluptate consequatur. Ex, ipsum sint. Hic, esse modi, -ipsam dicta minima praesentium assumenda unde architecto nostrum quibusdam reprehenderit tenetur qui nulla? Lorem ipsum -dolor sit, amet consectetur adipisicing elit. Repellat iusto eius aspernatur earum, quo reiciendis, magni doloremque -debitis ipsum at laborum deserunt quis molestias facilis provident facere rem! Aliquam, voluptatem? Lorem ipsum, dolor -sit amet consectetur adipisicing elit. Deserunt sunt, porro soluta perferendis, ipsa alias voluptatum facere eos -reprehenderit explicabo dolorem sit accusantium consequatur minima quia molestias culpa temporibus autem. Lorem ipsum -dolor sit amet consectetur adipisicing elit. Sunt alias odio excepturi sed eligendi omnis modi amet dolores saepe, -quibusdam placeat? Praesentium voluptatum molestiae quos laboriosam eligendi facilis minima doloribus. +#### Serveurs {#servers} -### Maintenance +Actuellement les besoins sont faible, un seul VPS suffit, il est fournit par +[HostUp](https://hostup.se/en) en Suède avec Proxmox dans leur datacenter de +Stockholm. -Lorem ipsum dolor sit amet, consectetur adipisicing elit. Commodi tempore ratione necessitatibus culpa maxime delectus, -accusamus harum est porro ut fugiat aperiam, consequuntur explicabo. Modi tenetur incidunt non exercitationem sunt? -Lorem ipsum dolor sit amet consectetur adipisicing elit. Quae magnam, cum iste minima culpa recusandae et reiciendis -veritatis deserunt debitis fuga, atque delectus qui ea dolorum tempore aspernatur nihil nisi! +| | Dwalin | +|----------|--------| +| vCPU | 4 | +| RAM | 16Go | +| Stockage | 500Go | -#### APK +#### Réseau {#network} -Lorem ipsum dolor sit amet consectetur adipisicing elit. Inventore quae reprehenderit nostrum neque nulla dicta quasi -eius perspiciatis cum eos, id, voluptatem quaerat, minus tenetur placeat doloribus ea porro amet. +Les connexion entrantes sont filtrées par un pare-feu, et redirigées sur le +réseau local par un reverse proxy. -#### Nerdctl +| | Dwalin | +|------|------------------| +| IPv4 | 103.177.249.4 | +| IPv6 | 2a13:7c81:157::2 | -Lorem ipsum dolor sit amet consectetur adipisicing elit. Soluta, voluptate consequatur. Ex, ipsum sint. Hic, esse modi, -ipsam dicta minima praesentium assumenda unde architecto nostrum quibusdam reprehenderit tenetur qui nulla? Lorem ipsum -dolor sit, amet consectetur adipisicing elit. Repellat iusto eius aspernatur earum, quo reiciendis, magni doloremque -debitis ipsum at laborum deserunt quis molestias facilis provident facere rem! Aliquam, voluptatem? Lorem ipsum, dolor -sit amet consectetur adipisicing elit. Deserunt sunt, porro soluta perferendis, ipsa alias voluptatum facere eos -reprehenderit explicabo dolorem sit accusantium consequatur minima quia molestias culpa temporibus autem. Lorem ipsum -dolor sit amet consectetur adipisicing elit. Sunt alias odio excepturi sed eligendi omnis modi amet dolores saepe, -quibusdam placeat? Praesentium voluptatum molestiae quos laboriosam eligendi facilis minima doloribus. \ No newline at end of file +#### Sauvegardes {#backups} + +Les données sont sauvegardées automatiquement une fois par jour et stockées sur +le serveur même, ainsi que sur un stockage distant en Allemagne chez +[Hetzner](https://www.hetzner.com) dans leur datacenter de Falkenstein. + +### Maintenance {#maintenance} + +Quelques petites choses à savoir concernant Chimera Linux avant de mettre les +mains dans le cambouis : + +* Sudo : Ne cherchez pas `sudo` c'est l’excellent `doas` d'OpenBSD qui est + utilisé ici ! + +* Environnement utilisateur (userland) : Chimera Linux utilise l'environnement + utilisateur de FreeBSD à la place des outils GNU habituels, globalement les + commandes sont les mêmes mais attention certaines options peuvent parfois être + différentes. + +#### Connexion aux serveurs {#connection} + +... + +#### APK {#apk} + +Le gestionnaire de paquets APK d'Alpine Linux est utilisé, il es simple, rapide +et extrêmement fiable ! + +Mettre à jour les fichiers d'index des dépôts : +``` +# apk update +``` + +Mettre à jour le système (⚠️ ne pas mettre à jour un serveur en production sans +avoir testé la mise à jour sur une machine de test) : +``` +# apk upgrade +``` + +Chercher un paquet : +``` +# apk search +``` + +Obtenir des informations sur un paquet : +``` +# apk info +``` + +Installer un paquet : +``` +# apk add +``` + +Supprimer un paquet : +``` +# apk del +``` + +> Les sous-commandes `add` et `del` ajoutent/enlèvent le nom du/des paquet(s) du +> fichier `/etc/apk/world` qui contient la liste des paquets explicitement +> installés, APK calcule les dépendances à partir de ce fichier. + +#### Nerdctl {#nerdctl} + +... + +#### Services {#services} + +Si nécessaire la documentation spécifique à chaque service si se trouve dans le +`README.md` du service sur [NETgit](https://git.netig.net). + +### Installation d'un serveur {#server-install} + +... + +#### Preparation {#preparation} + +... + +#### Installation du système {#install} + +... \ No newline at end of file diff --git a/src/sass/css/style.scss b/src/sass/css/style.scss index 36c961f..366f2fb 100644 --- a/src/sass/css/style.scss +++ b/src/sass/css/style.scss @@ -109,8 +109,8 @@ h2 { } h3 { - font-size: 2rem; - line-height: 2rem; + font-size: 2.2rem; + line-height: 2.2rem; } h4 { @@ -527,18 +527,33 @@ svg { @media screen and (min-width: 1080px) and (max-resolution: 1x) { min-height: 100vh; } + + ul { + margin-top: 0; + padding-top: 20px; + padding-bottom: 20px; + + @media screen and (min-width: 1080px) and (max-resolution: 1x) { + position: sticky; + top: 0; + } + } } -.doc ul { - margin-top: 0; - padding-top: 20px; - padding-bottom: 20px; +/* Markdown + ------------------------------------------------------------------------ */ - @media screen and (min-width: 1080px) and (max-resolution: 1x) { - position: sticky; - top: 0; - } +tr { + background: $color__ternary; +} +td, th { + padding: 10px; +} + +code { + background: #010101; + padding: 5px; } /* Responsive 1080px diff --git a/src/templates/documentation.html b/src/templates/documentation.html index 2686b0f..48fd8f0 100644 --- a/src/templates/documentation.html +++ b/src/templates/documentation.html @@ -1,29 +1,39 @@ {% extends "base.html" %} {% block content %} -
+ diff --git a/src/templates/page.html b/src/templates/page.html index 3676bcf..5c093e7 100644 --- a/src/templates/page.html +++ b/src/templates/page.html @@ -2,7 +2,7 @@ {% block content %}
-

{{ page.title }}

+

{{ page.title }}

{{ page.content | safe }}
{% endblock content %} \ No newline at end of file