doc and titles sizes
This commit is contained in:
julien
parent
2417f877c6
commit
90b4d9cbef
1
.gitignore
vendored
Normal file
1
.gitignore
vendored
Normal file
@ -0,0 +1 @@
|
||||
public/
|
||||
@ -4,83 +4,155 @@ slug = "documentation"
|
||||
template = "documentation.html"
|
||||
+++
|
||||
|
||||
En cours d'écriture 📝 !
|
||||
En cours d'écriture 📝...<br>
|
||||
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.
|
||||
#### 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 :
|
||||
|
||||
* <s>Sudo</s> : 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 <quelque_chose>
|
||||
```
|
||||
|
||||
Obtenir des informations sur un paquet :
|
||||
```
|
||||
# apk info <paquet>
|
||||
```
|
||||
|
||||
Installer un paquet :
|
||||
```
|
||||
# apk add <paquet>
|
||||
```
|
||||
|
||||
Supprimer un paquet :
|
||||
```
|
||||
# apk del <paquet>
|
||||
```
|
||||
|
||||
> 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}
|
||||
|
||||
...
|
||||
@ -109,8 +109,8 @@ h2 {
|
||||
}
|
||||
|
||||
h3 {
|
||||
font-size: 2rem;
|
||||
line-height: 2rem;
|
||||
font-size: 2.2rem;
|
||||
line-height: 2.2rem;
|
||||
}
|
||||
|
||||
h4 {
|
||||
@ -527,9 +527,8 @@ svg {
|
||||
@media screen and (min-width: 1080px) and (max-resolution: 1x) {
|
||||
min-height: 100vh;
|
||||
}
|
||||
}
|
||||
|
||||
.doc ul {
|
||||
ul {
|
||||
margin-top: 0;
|
||||
padding-top: 20px;
|
||||
padding-bottom: 20px;
|
||||
@ -538,7 +537,23 @@ svg {
|
||||
position: sticky;
|
||||
top: 0;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/* Markdown
|
||||
------------------------------------------------------------------------ */
|
||||
|
||||
tr {
|
||||
background: $color__ternary;
|
||||
}
|
||||
|
||||
td, th {
|
||||
padding: 10px;
|
||||
}
|
||||
|
||||
code {
|
||||
background: #010101;
|
||||
padding: 5px;
|
||||
}
|
||||
|
||||
/* Responsive 1080px
|
||||
|
||||
@ -1,29 +1,39 @@
|
||||
{% extends "base.html" %}
|
||||
|
||||
{% block content %}
|
||||
<div class="doc col--1-4">
|
||||
<div class="col--1-4">
|
||||
<div class="docnav">
|
||||
<ul>
|
||||
<li><a href="#infrastructure">Infrastructure</a></li>
|
||||
<li><a href="#users">Utilisateurs</a></li>
|
||||
<ul>
|
||||
<li><a href="#serveurs">Serveurs</a></li>
|
||||
<li><a href="#reseau">Réseau</a></li>
|
||||
<li><a href="#sauvegardes">Sauvegardes</a></li>
|
||||
<li><a href="#netmail">NETmail</a></li>
|
||||
</ul>
|
||||
<li><a href="#services">Services</a></li>
|
||||
<li><a href="#admins">Administrateurs</a></li>
|
||||
<ul>
|
||||
<li><a href="#mail">Mail</a></li>
|
||||
<li><a href="#infra">Infrastructure</a></li>
|
||||
<ul>
|
||||
<li><a href="#servers">Serveurs</a></li>
|
||||
<li><a href="#network">Réseau</a></li>
|
||||
<li><a href="#backups">Sauvegardes</a></li>
|
||||
</ul>
|
||||
<li><a href="#maintenance">Maintenance</a></li>
|
||||
<ul>
|
||||
<li><a href="#connection">Connexion aux serveurs</a></li>
|
||||
<li><a href="#apk">APK</a></li>
|
||||
<li><a href="#nerdctl">Nerdctl</a></li>
|
||||
<li><a href="#services">Services</a></li>
|
||||
</ul>
|
||||
<li><a href="#server-install">Installation d'un serveur</a></li>
|
||||
<ul>
|
||||
<li><a href="#preparation">Preparation</a></li>
|
||||
<li><a href="#install">Installation du système</a></li>
|
||||
</ul>
|
||||
</ul>
|
||||
</ul>
|
||||
</div>
|
||||
<div class="content">
|
||||
<div class="anchor" id="{{ page.slug }}"></div>
|
||||
<h2>{{ page.title }}</h2>
|
||||
<h1>{{ page.title }}</h1>
|
||||
{{ page.content | safe }}
|
||||
</div>
|
||||
</div>
|
||||
|
||||
@ -2,7 +2,7 @@
|
||||
|
||||
{% block content %}
|
||||
<div class="content">
|
||||
<h2>{{ page.title }}</h2>
|
||||
<h1>{{ page.title }}</h1>
|
||||
{{ page.content | safe }}
|
||||
</div>
|
||||
{% endblock content %}
|
||||
Loading…
x
Reference in New Issue
Block a user