diff --git a/content/operations/acces.md b/content/operations/acces.md index 76ea226..4885e47 100644 --- a/content/operations/acces.md +++ b/content/operations/acces.md @@ -7,4 +7,4 @@ extra: parent: 'operations/_index.md' --- -Ici l'on traite de comment gagner accès au cluster de Deuxfleurs, quand on a reçu la _terrible responsabilité_ de sysadmin. Vous êtes prêt⋅e ? Alors entrez dans [le dépôt des secrets](./pass/). +Ici l'on traite de comment gagner accès au cluster de Deuxfleurs, quand on a reçu la _terrible responsabilité_ de sysadmin. Vous êtes prêt⋅e ? Alors entrez dans [le dépôt des secrets](@/operations/pass.md). diff --git a/content/operations/guide_création_nœud.md b/content/operations/guide_création_nœud.md index 11cbc27..4115aef 100644 --- a/content/operations/guide_création_nœud.md +++ b/content/operations/guide_création_nœud.md @@ -16,7 +16,7 @@ Configurons d'abord quelques paramètres dans l'UEFI de la machine. Démarrez-l ## Installation de NixOS -> Aucun écran ou clavier n'est disponible pour l'ordinateur cible ? NixOS peut être installé en SSH. Suivre les instructions sur [cette page](/operations/deploiement/noeud/ssh-sans-ecran). +> Aucun écran ou clavier n'est disponible pour l'ordinateur cible ? NixOS peut être installé en SSH, une page y est dédiée : [Installer NixOS sans écran](@/operations/SSH_sans_écran.md). Pour installer NixOS, nous aurons besoin d'une clé USB avec une image amorçable (*live*) de NixOS dessus. Nous pouvons télécharger la distribution linux en 64 bits et en version minimale (sans interface graphique et avec moins d'utilitaires) sur le [site officiel](https://nixos.org/download.html). Pour écrire l'image sur le support USB, on peut faire `dd if=chemin-vers-le-fichier-iso of=/dev/sdX status=progress; sync`, en remplaçant `sdX` par le fichier périphérique correspondant à la clé, trouvé avec `lsblk` par exemple. Alternativement, cela peut être l'occasion de créer une clé USB formatée avec [Ventoy](https://ventoy.net), un utilitaire très pratique diff --git a/content/operations/matrix.md b/content/operations/matrix.md index ab1c255..bfcde55 100644 --- a/content/operations/matrix.md +++ b/content/operations/matrix.md @@ -71,12 +71,9 @@ Do the same thing for the `synapse` service. Now, you need a way to access the cluster to deploy this file. To do this, you must bind nomad on your machine through a SSH tunnel. -Check the end of [the parent `README.md`](../README.md) to do it. If you have access to the Nomad web UI when entering http://127.0.0.1:4646 you are ready to go. -You must have installed the Nomad command line tool on your machine (also explained in [the parent `README.md`](../README.md)). - Now, on your machine and from the `app/im/deploy` folder, you must be able to run: ``` diff --git a/content/operations/noeud.md b/content/operations/noeud.md index 8e07f74..31604d4 100644 --- a/content/operations/noeud.md +++ b/content/operations/noeud.md @@ -11,6 +11,6 @@ extra: # Déployer un nœud au sein de l'infrastructure Deuxfleurs Déployer un nœud au sein de l'infrastructure Deuxfleurs demande un certaine préparation et représente un processus particulier. -Avant de se lancer, [mieux vaut vérifier les prérequis pour y parvenir](./prerequis/). Une fois ceci fait, on peut suivre [le guide décrivant la procédure](./guide-creation-noeud/). +Avant de se lancer, [mieux vaut vérifier les prérequis pour y parvenir](@/operations/prérequis.md). Une fois ceci fait, on peut suivre [le guide décrivant la procédure](@/operations/guide_création_nœud.md). -Si vous avez une machine à installer, mais aucun écran & clavier à brancher dessus pour la configurer, référez-vous au [guide d'installation de NixOs en SSH](./ssh-sans-ecran/). +Si vous avez une machine à installer, mais aucun écran & clavier à brancher dessus pour la configurer, référez-vous au [guide d'installation de NixOs en SSH](@/operations/SSH_sans_écran.md). diff --git a/content/operations/sauvegardes.md b/content/operations/sauvegardes.md index 860733d..5c62980 100644 --- a/content/operations/sauvegardes.md +++ b/content/operations/sauvegardes.md @@ -10,26 +10,26 @@ extra: # Données sauvegardées -[restic](./restic/) - Nous utilisons restic pour sauvegarder les logiciels +[restic](@/operations/restic.md) - Nous utilisons restic pour sauvegarder les logiciels qui utilisent le système de fichier (Cryptpad, Dovecot, et Plume) ainsi que Consul. À terme, nous aimerions être en mesure de tout pouvoir stocker directement sur Garage et rendre obsolète ce mode de sauvegarde. -[pg\_basebackup](./pg_basebackup/) - Nous utilisons cet outils pour sauvegarder l'ensemble +[pg\_basebackup](@/operations/pg_basebackup.md) - Nous utilisons cet outils pour sauvegarder l'ensemble des tables gérées par notre base de données SQL sans impacter trop les performances. Le tout est réalisé par un script python qui chiffre avec [age](https://github.com/FiloSottile/age) et envoie le backup via S3. À terme, nous aimerions utiliser [wal-g](https://github.com/wal-g/wal-g) à la place. -[rclone](./rclone/) - Combiné avec btrfs, nous copions sur un système de fichier à plat +[rclone](@/operations/rclone.md) - Combiné avec btrfs, nous copions sur un système de fichier à plat le contenu de notre cluster afin de faire face en cas de corruption. À terme, nous aimerions remplacer cet outil par quelque chose de similaire à [s3s3mirror](https://github.com/cobbzilla/s3s3mirror). # Localisation des sauvegardes -[Suresnes](/infrastructures/machines/support/#suresnes-mercure) - À Suresnes, nous avons une instance Minio +[Suresnes](@/infrastructures/support.md#suresnes-mercure) - À Suresnes, nous avons une instance Minio dédiée aux sauvegardes de données. Elle reçoit les sauvegardes du système de fichier, de consul et de Postgres. -[Rennes 2](/infrastructures/machines/support/#rennes-2-jupiter) - À Rennes, nous avons un simple serveur Debian +[Rennes 2](@/infrastructures/support.md#rennes-jupiter) - À Rennes, nous avons un simple serveur Debian avec une partition en BTRFS. Il se charge de sauvegarder toutes les nuits le contenu de notre instance de production de Garage. À terme il est possible qu'on décide de rationaliser nos sauvegardes et de choisir de sauvegarder S3. diff --git a/content/prise_en_main/avec-un-générateur.md b/content/prise_en_main/avec-un-générateur.md index 24a5efd..f71c4ff 100644 --- a/content/prise_en_main/avec-un-générateur.md +++ b/content/prise_en_main/avec-un-générateur.md @@ -13,7 +13,7 @@ Si vous souhaitez par exemple écrire un blog, vous allez probablement avoir une ### Choisir un générateur et un thème Il existe de nombreux générateurs de sites statiques. On peut citer [Hugo](https://gohugo.io/), [Jekyll](https://jekyllrb.com/), [Zola](https://www.getzola.org/), et bien d'autres... En général, ils se ressemblent beaucoup. À titre indicatif, pour ce guide, nous utilisons Zola. Nous baserons nos exemples sur lui. Si votre système d'exploitation est Linux, cherchez dans votre gestionnaire de paquet si vous trouvez l'un d'entre eux. Zola est ainsi facilement installable sur Arch, Ubuntu, et Fedora. -Une fois un générateur de site statique installé, rendez-vous sur le site officiel de celui-ci pour choisir un thème. Chez Zola, il faut aller [ici](https://www.getzola.org/themes/). Si vous cliquez sur l'un d'entre eux, vous aurez des instructions sur comment l'installer. Il s'agit souvent de télécharger le thème dans le dossier correspondant à votre site, et de modifier le fichier `config.toml`, nécessaire pour Zola, afin de sélectionner le thème. +Une fois un générateur de site statique installé, rendez-vous sur le site officiel de celui-ci pour choisir un thème. Chez Zola, il faut aller [sur leur galerie](https://www.getzola.org/themes/). Si vous cliquez sur l'un d'entre eux, vous aurez des instructions sur comment l'installer. Il s'agit souvent de télécharger le thème dans le dossier correspondant à votre site, et de modifier le fichier `config.toml`, nécessaire pour Zola, afin de sélectionner le thème. ### Décrire le contenu Pour écrire le contenu de vos pages, ou de vos billets de blog par exemple, il vous faudra utiliser la syntaxe Markdown. Rassurez-vous, elle a été pensée pour être très simple et peut-être apprise en quelques minutes. Voici un exemple : @@ -31,15 +31,15 @@ Voici du texte pour introduire la liste à puce qui va suivre : ``` Quand on écrit du texte sans mettre quoi que ce soit autour ou avant, cela deviendra du texte tout à fait normal. On peut mettre un ou plusieurs dièses au début de la ligne pour en faire un titre. On peut mettre du texte en italique ou en gras avec des astérisques. Un astérisque en début de ligne provoque une liste à puces. Bref, cette syntaxe n'est pas compliquée, et vous pouvez facilement trouver plein de tutoriels en ligne pour la connaître. [Framasoft, par exemple, propose un bon guide](https://docs.framasoft.org/fr/grav/markdown.html). -Une fois votre fichier écrit, enregistrez-le avec l'extension `.md`, par exemple sous le nom `recette-tartre-au-citron.md`. L'idée est qu'à chaque page de votre site correspond un fichier `.md`, et ceux-ci seront regroupés dans un dossier. Vous trouverez [ici](https://git.deuxfleurs.fr/Deuxfleurs/guide.deuxfleurs.fr/src/branch/main/content) les fichiers Markdown écrits pour faire ce guide. +Une fois votre fichier écrit, enregistrez-le avec l'extension `.md`, par exemple sous le nom `recette-tartre-au-citron.md`. L'idée est qu'à chaque page de votre site correspond un fichier `.md`, et ceux-ci seront regroupés dans un dossier. Vous trouverez [dans notre forge](https://git.deuxfleurs.fr/Deuxfleurs/guide.deuxfleurs.fr/src/branch/main/content) les fichiers Markdown écrits pour faire ce guide. Cependant, il reste juste une petite chose à faire lorsque vous avez fini votre texte : écrire l'en-tête au dessus du markdown, qui donnera au générateur des informations importantes sur ce contenu. On encadre cet en-têtre avec trois signes plus. Voici un exemple basé sur cette page : ``` -+++ -title = "Avec un générateur" -description = "Créer du contenu avec un générateur" -date = 2022-09-01 -+++ +--- +title: "Avec un générateur" +description: "Créer du contenu avec un générateur" +date: 2022-09-01 +--- # Titre Texte de la page... @@ -47,4 +47,4 @@ Texte de la page... Comme vous l'avez peut-être compris, il s'agit de donner le titre de cette page, sa description, et sa date d'écriture. D'autres informations peuvent être rajoutées, cela dépend du générateur et du thème sélectionnés. ### Générer les pages -Vous avez donc des fichiers `.md` renfermant vos contenus, et un thème qui vous plaît. Avec un terminal, positionnez-vous dans le dossier racine de votre site projet. Si vous utilisez Zola, celui-ci devrait contenir un fichier `config.toml`, vous pouvez alors faire `zola build`. Cela va générer l'intégralité de votre site dans le dossier `public/`. Vous constaterez donc qu'il sera rempli de fichiers `.html` et `.css`, [vous êtes alors prêt(e) à passer à la publication](../../publier-le-contenu/) ! +Vous avez donc des fichiers `.md` renfermant vos contenus, et un thème qui vous plaît. Avec un terminal, positionnez-vous dans le dossier racine de votre site projet. Si vous utilisez Zola, celui-ci devrait contenir un fichier `config.toml`, vous pouvez alors faire `zola build`. Cela va générer l'intégralité de votre site dans le dossier `public/`. Vous constaterez donc qu'il sera rempli de fichiers `.html` et `.css`, [vous êtes alors prêt(e) à passer à la publication](@/prise_en_main/publier-le-contenu.md) ! diff --git a/content/prise_en_main/aws-cli.md b/content/prise_en_main/aws-cli.md index c801b5a..63a4c89 100644 --- a/content/prise_en_main/aws-cli.md +++ b/content/prise_en_main/aws-cli.md @@ -7,7 +7,7 @@ extra: parent: "prise_en_main/publier-le-contenu.md" --- -Nous allons désormais verser votre site sur Garage, ce dernier le servira à toutes les personnes qui voudront le voir. Vous aurez besoin de l'identifiant de votre clé d'accès et de la clé d'accès secrète, obtenus dans la partie «[Initialiser votre accès](../initialiser-votre-acces/)». +Nous allons désormais verser votre site sur Garage, ce dernier le servira à toutes les personnes qui voudront le voir. Vous aurez besoin de l'identifiant de votre clé d'accès et de la clé d'accès secrète, obtenus dans la partie «[Initialiser votre accès](@/prise_en_main/initialiser-votre-accès.md)». ### Paramétrer votre accès localement Pour verser votre site sur Garage, nous allons utiliser l'outil de base pour faire des commandes S3 : [aws-cli](https://github.com/aws/aws-cli) et son binaire, `aws`. À chaque fois, il aura besoin de savoir : diff --git a/content/prise_en_main/creer-du-contenu.md b/content/prise_en_main/creer-du-contenu.md index 149d74c..49b1841 100644 --- a/content/prise_en_main/creer-du-contenu.md +++ b/content/prise_en_main/creer-du-contenu.md @@ -10,4 +10,4 @@ extra: Votre site est désormais complètement configuré. Avant de publier du contenu, il faut écrire celui-ci ! -Vous pouvez, au choix, [l'écrire à la main](./a-la-main/), ou vous [faire assister par un générateur](./avec-un-generateur/). +Vous pouvez, au choix, [l'écrire à la main](@/prise_en_main/à-la-main.md), ou vous [faire assister par un générateur](@/prise_en_main/avec-un-générateur.md). diff --git a/content/prise_en_main/initialiser-votre-accès.md b/content/prise_en_main/initialiser-votre-accès.md index 5782306..819e0e4 100644 --- a/content/prise_en_main/initialiser-votre-accès.md +++ b/content/prise_en_main/initialiser-votre-accès.md @@ -31,4 +31,4 @@ Si `exemple-un.fr` n'est pas à gauche dans la même colonne que `exemple-deux.e exemple-un.fr 4bdce6:exemple-un.fr 56a0f10929f0d63d0177415a22a0b636cf1efe92845f2b00e04b91298656e78e exemple-deux.eu 941956ebfffa8fd564ad6b40e4bb5ac2f2b93bdbba1d1bf88fe6daff2cf4df6c ``` -C'est réglé. [Vous pouvez désormais vous occuper du DNS](../mettre-place-dns/). +C'est réglé. [Vous pouvez désormais vous occuper du DNS](@/prise_en_main/mettre-place-DNS.md). diff --git a/content/prise_en_main/mettre-place-DNS.md b/content/prise_en_main/mettre-place-DNS.md index 5e396a2..b125d4c 100644 --- a/content/prise_en_main/mettre-place-DNS.md +++ b/content/prise_en_main/mettre-place-DNS.md @@ -35,4 +35,4 @@ Choisissez alors «ALIAS» comme type, et `garage.deuxfleurs.fr` comme nom d'hô ![dns5.png](/img/dns5.png) -Maintenant que votre configuration DNS est réglée, vous pouvez [préparer votre contenu](../créer-du-contenu/) ! +Maintenant que votre configuration DNS est réglée, vous pouvez [préparer votre contenu](@/prise_en_main/creer-du-contenu.md) ! diff --git a/content/prise_en_main/publier-le-contenu.md b/content/prise_en_main/publier-le-contenu.md index 48d1416..b58c2e7 100644 --- a/content/prise_en_main/publier-le-contenu.md +++ b/content/prise_en_main/publier-le-contenu.md @@ -8,12 +8,12 @@ extra: parent: "prise_en_main/web.md" --- -Nous allons désormais verser votre site sur Garage, et ce dernier le servira à toutes les personnes qui voudront le voir. Vous aurez besoin de l'identifiant de votre clé d'accès et de la clé d'accès secrète, obtenus dans la partie «[Initialiser votre accès](../initialiser-votre-acces/)». +Nous allons désormais verser votre site sur Garage, et ce dernier le servira à toutes les personnes qui voudront le voir. Vous aurez besoin de l'identifiant de votre clé d'accès et de la clé d'accès secrète, obtenus dans la partie «[Initialiser votre accès](@/prise_en_main/initialiser-votre-accès.md)». Vous avez le choix entre trois méthodes : -* [Faire ça en ligne de commande avec `aws-cli`](aws-cli/). C'est la méthode la plus habituelle et la plus éprouvée, cependant il faut utiliser le terminal, et être sur linux est grandement conseillé pour celle-ci. -* [Faire ça avec l'utilitaire graphique `rclone`](rclone/). Cette méthode vous paraîtra peut-être moins intimidante grâce à l'interface graphique du logiciel rclone. Celui-ci tourne sur Linux, Windows, et MacOS. -* [Faire ça avec l'utilitaire graphique `winscp`](winscp/). Cette méthode propose elle également une interface graphique, mais ne fonctionne que sur Windows. +* [Faire ça en ligne de commande avec `aws-cli`](@/prise_en_main/aws-cli.md). C'est la méthode la plus habituelle et la plus éprouvée, cependant il faut utiliser le terminal, et être sur linux est grandement conseillé pour celle-ci. +* [Faire ça avec l'utilitaire graphique `rclone`](@/prise_en_main/rclone.md). Cette méthode vous paraîtra peut-être moins intimidante grâce à l'interface graphique du logiciel rclone. Celui-ci tourne sur Linux, Windows, et MacOS. +* [Faire ça avec l'utilitaire graphique `winscp`](@/prise_en_main/winscp.md). Cette méthode propose elle également une interface graphique, mais ne fonctionne que sur Windows. ### Bravo ! Une fois l'un de ces trois guides suivi, vous aurez désormais votre propre site web accessible publiquement en ligne ! diff --git a/content/prise_en_main/web.md b/content/prise_en_main/web.md index ecac65c..ca8fc2b 100644 --- a/content/prise_en_main/web.md +++ b/content/prise_en_main/web.md @@ -9,18 +9,19 @@ extra: Vous en avez marre de faire toute votre communication associative via Facebook ? Vous voulez créer votre propre site pour raconter vos dernières vacances ou publier vos poèmes ? Bref, publier en indépendance ? Deuxfleurs peut vous aider en vous fournissant l'hébergement. Suivez le guide ! -1. [Statique ? Comment ça ?](./statique-comment-ca/) -2. [Initialiser votre accès](./initialiser-votre-acces/) -3. [Mettre en place le DNS](./mettre-place-dns/) -4. [Créer du contenu](./créer-du-contenu/) -5. [Publier le contenu](./publier-le-contenu/) +1. [Statique ? Comment ça ?](@/prise_en_main/statique-comment-ça.md) +2. [Initialiser votre accès](@/prise_en_main/initialiser-votre-accès.md) +3. [Mettre en place le DNS](@/prise_en_main/mettre-place-DNS.md) +4. [Créer du contenu](@/prise_en_main/creer-du-contenu.md) +5. [Publier le contenu](@/prise_en_main/publier-le-contenu.md) # Ils nous font confiance pour leur site web + - [declic-lelivre.com](https://declic-lelivre.com) - *Exploitation des données privées, surveillance généralisée, addiction au smartphone, disparition de pans entiers de l'économie... Les critiques du monde du numérique ne cessent de s'amplifier ; difficile d'ignorer les conséquences de l'utilisation d'Amazon, Facebook, Google, Instagram ou Netflix. Et s'il existait un autre Internet, respectueux de nos libertés ?* + - [giraud.eu](https://giraud.eu) - *Site d'un ingénieur en informatique* - [anneprudhomoz.fr](https://anneprudhomoz.fr) - *De la terre, du fer, de l'eau, beaucoup de feu, un peu d'huile, encore du béton et du plâtre ! ... sans oublier le crayon à papier et les carnets.* - [colineaubert.com](https://colineaubert.com) - *D'un côté graphiste, illustratrice et conceptrice d'outils pédagogiques, je mets en images et en mots différents sujets scientifiques et culturels.* - [estherbouquet.com](https://estherbouquet.com) - *Esther Bouquet questions how narratives—both historical and literary—are being built by creating tangible experiences ranging from the size of the sheet of paper to the volume of a space; somewhere between writing, archiving, drawing, designing, and programming.* - [quentin.dufour.io](https://quentin.dufour.io) - *Portfolio et blog d'un ingénieur en informatique* - [erwan.dufour.io](https://erwan.dufour.io) - *Portfolio et blog d'un passionné d'électronique* - [rfid.deuxfleurs.fr](https://rfid.deuxfleurs.fr) - *Rencontres Francophones de l'Infonuagique Décentralisé* - - [giraud.eu](https://giraud.eu) - *Site d'un ingénieur en informatique* diff --git a/content/prise_en_main/à-la-main.md b/content/prise_en_main/à-la-main.md index ee1eb45..bc4c3ad 100644 --- a/content/prise_en_main/à-la-main.md +++ b/content/prise_en_main/à-la-main.md @@ -38,4 +38,4 @@ body ``` Encore une fois, plein de ressources sont disponibles en ligne, et Mozilla propose encore une fois [une bonne base](https://developer.mozilla.org/fr/docs/Web/CSS). -Une fois que vous avez tous vos fichiers `.html` et `.css` réunis, [vous pouvez passer à la publication](../../publier-le-contenu/) ! +Une fois que vous avez tous vos fichiers `.html` et `.css` réunis, [vous pouvez passer à la publication](@/prise_en_main/publier-le-contenu.md) ! diff --git a/content/vie_associative/AG2022.md b/content/vie_associative/AG2022.md index 4be7718..1c8f550 100644 --- a/content/vie_associative/AG2022.md +++ b/content/vie_associative/AG2022.md @@ -29,7 +29,7 @@ Deuxfleurs porte 3 actions principales : la **conception** de nos outils numéri # Changement du mode de scrutin -> ## Modification de l'article 8 de nos [statuts](/Association/Statuts) +> ## Modification de l'article 8 de nos [statuts](@/vie_associative/statuts.md) > > [...] Elle [L'Assemblée Générale] pourvoit, au scrutin secret, à la nomination ou au renouvellement des membres du conseil d'administration via un scrutin **au jugement majoritaire**. Elle fixe le montant de la cotisation annuelle. Les décisions de l'assemblée sont prises à la majorité des membres présents ou représentés. Chaque membre présent ne peut détenir plus d'une procuration. diff --git a/content/vie_associative/nouvelle_personne_ca.md b/content/vie_associative/nouvelle_personne_ca.md index 0acf804..9995ca6 100644 --- a/content/vie_associative/nouvelle_personne_ca.md +++ b/content/vie_associative/nouvelle_personne_ca.md @@ -19,4 +19,4 @@ extra: * La former à l'utilisation de [HomeBank](http://homebank.free.fr/fr/) pour la comptabilité. Notre fichier de sauvegarde HomeBank étant stocké dans `git`, former l'administrateur⋅ice à `git`. -* S'assurer qu'elle dispose de comptes admin sur les services qui ne sont pas gérés par le [Bottin](/Technique/Developpement/Bottin). +* S'assurer qu'elle dispose de comptes admin sur les services qui ne sont pas gérés par le [Bottin](@/infrastructures/bottin.md).