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"
|
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,
|
## Utilisateurs {#users}
|
||||||
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
|
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,
|
### NETmail {#netmail}
|
||||||
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!
|
|
||||||
|
|
||||||
#### 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,
|
IMAP
|
||||||
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.
|
|
||||||
|
|
||||||
#### 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
|
SMTP
|
||||||
eius perspiciatis cum eos, id, voluptatem quaerat, minus tenetur placeat doloribus ea porro amet.
|
|
||||||
|
|
||||||
#### 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,
|
## Administrateurs {#admins}
|
||||||
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!
|
|
||||||
|
|
||||||
### Services
|
Le coins des admins 👨💻 !
|
||||||
|
|
||||||
Lorem ipsum dolor sit amet, consectetur adipisicing elit. Commodi tempore ratione necessitatibus culpa maxime delectus,
|
### Infrastructure {#infra}
|
||||||
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!
|
|
||||||
|
|
||||||
#### 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
|
Concernant la partie logicielle c'est
|
||||||
eius perspiciatis cum eos, id, voluptatem quaerat, minus tenetur placeat doloribus ea porro amet.
|
[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,
|
#### Serveurs {#servers}
|
||||||
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.
|
|
||||||
|
|
||||||
### 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,
|
| | Dwalin |
|
||||||
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
|
| vCPU | 4 |
|
||||||
veritatis deserunt debitis fuga, atque delectus qui ea dolorum tempore aspernatur nihil nisi!
|
| RAM | 16Go |
|
||||||
|
| Stockage | 500Go |
|
||||||
|
|
||||||
#### APK
|
#### Réseau {#network}
|
||||||
|
|
||||||
Lorem ipsum dolor sit amet consectetur adipisicing elit. Inventore quae reprehenderit nostrum neque nulla dicta quasi
|
Les connexion entrantes sont filtrées par un pare-feu, et redirigées sur le
|
||||||
eius perspiciatis cum eos, id, voluptatem quaerat, minus tenetur placeat doloribus ea porro amet.
|
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,
|
#### Sauvegardes {#backups}
|
||||||
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
|
Les données sont sauvegardées automatiquement une fois par jour et stockées sur
|
||||||
debitis ipsum at laborum deserunt quis molestias facilis provident facere rem! Aliquam, voluptatem? Lorem ipsum, dolor
|
le serveur même, ainsi que sur un stockage distant en Allemagne chez
|
||||||
sit amet consectetur adipisicing elit. Deserunt sunt, porro soluta perferendis, ipsa alias voluptatum facere eos
|
[Hetzner](https://www.hetzner.com) dans leur datacenter de Falkenstein.
|
||||||
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,
|
### Maintenance {#maintenance}
|
||||||
quibusdam placeat? Praesentium voluptatum molestiae quos laboriosam eligendi facilis minima doloribus.
|
|
||||||
|
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 {
|
h3 {
|
||||||
font-size: 2rem;
|
font-size: 2.2rem;
|
||||||
line-height: 2rem;
|
line-height: 2.2rem;
|
||||||
}
|
}
|
||||||
|
|
||||||
h4 {
|
h4 {
|
||||||
@ -527,9 +527,8 @@ svg {
|
|||||||
@media screen and (min-width: 1080px) and (max-resolution: 1x) {
|
@media screen and (min-width: 1080px) and (max-resolution: 1x) {
|
||||||
min-height: 100vh;
|
min-height: 100vh;
|
||||||
}
|
}
|
||||||
}
|
|
||||||
|
|
||||||
.doc ul {
|
ul {
|
||||||
margin-top: 0;
|
margin-top: 0;
|
||||||
padding-top: 20px;
|
padding-top: 20px;
|
||||||
padding-bottom: 20px;
|
padding-bottom: 20px;
|
||||||
@ -538,7 +537,23 @@ svg {
|
|||||||
position: sticky;
|
position: sticky;
|
||||||
top: 0;
|
top: 0;
|
||||||
}
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Markdown
|
||||||
|
------------------------------------------------------------------------ */
|
||||||
|
|
||||||
|
tr {
|
||||||
|
background: $color__ternary;
|
||||||
|
}
|
||||||
|
|
||||||
|
td, th {
|
||||||
|
padding: 10px;
|
||||||
|
}
|
||||||
|
|
||||||
|
code {
|
||||||
|
background: #010101;
|
||||||
|
padding: 5px;
|
||||||
}
|
}
|
||||||
|
|
||||||
/* Responsive 1080px
|
/* Responsive 1080px
|
||||||
|
|||||||
@ -1,29 +1,39 @@
|
|||||||
{% extends "base.html" %}
|
{% extends "base.html" %}
|
||||||
|
|
||||||
{% block content %}
|
{% block content %}
|
||||||
<div class="doc col--1-4">
|
<div class="col--1-4">
|
||||||
<div class="docnav">
|
<div class="docnav">
|
||||||
<ul>
|
<ul>
|
||||||
<li><a href="#infrastructure">Infrastructure</a></li>
|
<li><a href="#users">Utilisateurs</a></li>
|
||||||
<ul>
|
<ul>
|
||||||
<li><a href="#serveurs">Serveurs</a></li>
|
<li><a href="#netmail">NETmail</a></li>
|
||||||
<li><a href="#reseau">Réseau</a></li>
|
|
||||||
<li><a href="#sauvegardes">Sauvegardes</a></li>
|
|
||||||
</ul>
|
</ul>
|
||||||
<li><a href="#services">Services</a></li>
|
<li><a href="#admins">Administrateurs</a></li>
|
||||||
<ul>
|
<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>
|
</ul>
|
||||||
<li><a href="#maintenance">Maintenance</a></li>
|
<li><a href="#maintenance">Maintenance</a></li>
|
||||||
<ul>
|
<ul>
|
||||||
|
<li><a href="#connection">Connexion aux serveurs</a></li>
|
||||||
<li><a href="#apk">APK</a></li>
|
<li><a href="#apk">APK</a></li>
|
||||||
<li><a href="#nerdctl">Nerdctl</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>
|
||||||
</ul>
|
</ul>
|
||||||
</div>
|
</div>
|
||||||
<div class="content">
|
<div class="content">
|
||||||
<div class="anchor" id="{{ page.slug }}"></div>
|
<div class="anchor" id="{{ page.slug }}"></div>
|
||||||
<h2>{{ page.title }}</h2>
|
<h1>{{ page.title }}</h1>
|
||||||
{{ page.content | safe }}
|
{{ page.content | safe }}
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
|||||||
@ -2,7 +2,7 @@
|
|||||||
|
|
||||||
{% block content %}
|
{% block content %}
|
||||||
<div class="content">
|
<div class="content">
|
||||||
<h2>{{ page.title }}</h2>
|
<h1>{{ page.title }}</h1>
|
||||||
{{ page.content | safe }}
|
{{ page.content | safe }}
|
||||||
</div>
|
</div>
|
||||||
{% endblock content %}
|
{% endblock content %}
|
||||||
Loading…
x
Reference in New Issue
Block a user