Nasqueron Agora - User contributions [en]

Operations grimoire/Anubis

2026-02-06T18:08:28Z

Ptdradmin:

'''Anubis''' is a proxy to filter out AI scrapers requests. It will allow sites like [[DevCentral]] to stop to serve heavy traffic for LLM model training.

__TOC__

== Challenges ==
We want to stop scraping traffic, but let legitimate traffic pass (e.g. CLI requests from Conduit).

Anubis is used by a lot of similar software forges from open-source projects: [https://anubis.techaro.lol/docs/user/known-instances Anubis known instances], but it's unclear if someone already succeed to configure it for Phabricator.

It's our current field of investigation by Doba Gui and Dereckson.

At Wikimedia, Andrew Kostka (WMDE) has some experience deploying it, apparently for Wikibase products.

== Implementation (by Doba Gui) ==
=== Isolation via UNIX Sockets ===
To avoid port conflicts (especially the default metrics port 9000), every instance is configured to use UNIX sockets for both traffic and metrics:
* '''Main socket:''' `/run/anubis/{{ instance }}.sock`
* '''Metrics socket:''' `/run/anubis/{{ instance }}-metrics.sock`

=== Dynamic Configuration ===
The Salt states resolve the target application's port from the `docker_containers` pillar. In `anubis_instances`, we define the target:
<pre>
anubis_instances:
devcentral:
target:
service: phabricator
container: devcentral
</pre>

=== Provisioning and Vault ===
Anubis API and Dashboard keys are provisioned in '''Vault''' using a helper script [scripts/fix_anubis_devcentral.sh](cci:7://file:///C:/Users/Gui%20Martinien/Downloads/operations-main/operations-main/scripts/fix_anubis_devcentral.sh:0:0-0:0) and retrieved by Salt during deployment.

== Current work ==
* Doba deployed an experimental run manually on Dwellers to figure how we can build and configure Anubis
* Work to deploy Anubis with Salt: [https://devcentral.nasqueron.org/D3908 D3908]

== Troubleshoot ==
=== Each site must have its own Anubis instance ===
If you serve to protect two different domains, you need two Anubis instances, one per domain.

In December, we noticed strange errors about challenges not found trying to fire the same instance for two different targets from the same domain.

== See also ==
* [https://anubis.techaro.lol/ Anubis website]

Dev zone/Create devserver access/fr

2026-02-04T11:10:07Z

Ptdradmin:

= Guide complet : Configuration de l'accès devserver avec Git et Arcanist =

Ce guide explique comment configurer votre environnement de développement pour contribuer au projet Operations.

== 1. Création du dossier de travail ==

Créez un dossier sur votre PC Windows pour organiser tous les fichiers du projet :

<syntaxhighlight lang="powershell">
C:\STAGE 2025
</syntaxhighlight>

C'est dans ce dossier que vous allez ranger tout ce qui concerne le projet Operations.

----

== 2. Récupération et clonage du dépôt Operations ==

=== 2.1 Récupération de l'URL du dépôt ===

Rendez-vous sur la page du dépôt :
* https://devcentral.nasqueron.org/source/operations/

Copiez l'URL Git pour pouvoir cloner le projet.

=== 2.2 Clonage du dépôt ===

Ouvrez PowerShell et placez-vous dans votre dossier :

<syntaxhighlight lang="powershell">
cd "C:\STAGE 2025"
git clone https://devcentral.nasqueron.org/source/operations.git
</syntaxhighlight>

Git crée un dossier <code>operations</code> avec tous les fichiers du projet.

----

== 3. Gestion de Git et création de branche dans WSL ==

=== 3.1 Se placer dans le dossier du projet ===

Depuis WSL (Ubuntu), placez-vous dans le dossier du projet :

<syntaxhighlight lang="bash">
cd /mnt/c/STAGE\ 2025/operations
</syntaxhighlight>

=== 3.2 Création d'une nouvelle branche ===

Créez une nouvelle branche pour vos modifications :

<syntaxhighlight lang="bash">
git switch -c feature/add-gui-user
</syntaxhighlight>

Avertissement|Si la branche existe déjà, Git affichera :
<code>fatal: a branch named 'feature/add-gui-user' already exists</code>

Dans ce cas, basculez simplement sur la branche existante :
<syntaxhighlight lang="bash">
git switch feature/add-gui-user
</syntaxhighlight>

----

== 4. Modifications dans les fichiers du dépôt ==

=== 4.1 Vérification de l'emplacement des fichiers ===

Vérifiez où se trouvent les vrais fichiers <code>users.sls</code> et <code>groups.sls</code> :

<syntaxhighlight lang="bash">
ls -la pillar/core/
</syntaxhighlight>

Important|Les vrais fichiers sont dans <code>pillar/core/</code>, pas dans <code>operations/pillar/core/</code>.

=== 4.2 Ajout de votre utilisateur dans users.sls ===

Ouvrez le fichier avec VS Code :
<syntaxhighlight>
pillar/core/users.sls
</syntaxhighlight>

Ajoutez votre utilisateur dans la section <code>shellusers:</code> par ordre alphabétique :

<syntaxhighlight lang="yaml">
ptdradmin:
fullname: Doba Gui
ssh_keys:
- ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIAFtlR4OeXNHfJXNrvrLeU9nGu7ufcxc38xUGqlwiY5L doba.guimartinien@gmail.com
uid: 1001
</syntaxhighlight>

=== 4.3 Ajout de votre compte dans groups.sls ===

Ouvrez également le fichier :
<syntaxhighlight>
pillar/core/groups.sls
</syntaxhighlight>

Ajoutez-vous dans le groupe <code>nasqueron</code> :

<syntaxhighlight lang="yaml">
shellgroups:
Members:
- ptdradmin
</syntaxhighlight>
<syntaxhighlight lang="yaml">
nasqueron-dev-docker:
Members:
- ptdradmin
</syntaxhighlight>
<syntaxhighlight lang="yaml">
nasquenautes:
Members:
- ptdradmin
</syntaxhighlight>
----

== 5. Commit des modifications ==

=== 5.1 Suppression des fichiers créés par erreur ===

Si vous avez créé des fichiers vides dans <code>operations/</code> :

<syntaxhighlight lang="bash">
rm -rf operations/
</syntaxhighlight>

=== 5.2 Ajout des bons fichiers ===

<syntaxhighlight lang="bash">
git add pillar/core/users.sls pillar/core/groups.sls
</syntaxhighlight>

=== 5.3 Commit des changements ===

<syntaxhighlight lang="bash">
git commit -m "Create new account for Doba Gui"
</syntaxhighlight>

=== 5.4 Vérification du commit ===

<syntaxhighlight lang="bash">
git show HEAD
</syntaxhighlight>

Vérifiez que vous voyez seulement les lignes que vous avez vraiment modifiées.

=== 5.5 Modification du dernier commit (si nécessaire) ===

Si vous avez corrigé des fichiers après le commit :

<syntaxhighlight lang="bash">
git commit --amend
</syntaxhighlight>

----

== 6. Premier essai de arc diff (échec - arc n'existe pas) ==

Essayez de lancer :

<syntaxhighlight lang="bash">
arc diff
</syntaxhighlight>

'''Erreur attendue :'''
<syntaxhighlight>
arc: command not found
</syntaxhighlight>

Il faut installer Arcanist.

----

== 7. Installation d'Arcanist avec WSL ==

=== Pourquoi installer Arcanist ? ===

Arcanist (ou <code>arc</code>) est l'outil officiel de ligne de commande pour interagir avec Phabricator, le système de revue de code utilisé par le projet Operations.

* Il permet de créer, mettre à jour et soumettre des révisions (<code>arc diff</code>) directement depuis votre environnement local
* Il gère les linters et les tests automatiques configurés par le projet avant l'envoi de modifications
* Sans Arcanist, vous ne pouvez pas soumettre vos changements pour revue ni intégrer les vérifications automatiques du projet

=== 7.1 Mise à jour d'Ubuntu ===

Avant d'installer quoi que ce soit :

<syntaxhighlight lang="bash">
sudo apt update
sudo apt upgrade -y
</syntaxhighlight>

=== 7.2 Installation des dépendances ===

Arcanist a besoin de PHP et Git :

<syntaxhighlight lang="bash">
sudo apt install -y php-cli php-curl php-xml php-mbstring git curl unzip
</syntaxhighlight>

=== 7.3 Téléchargement d'Arcanist ===

Création d'un dossier pour Arcanist :

<syntaxhighlight lang="bash">
mkdir -p ~/phabricator
cd ~/phabricator
</syntaxhighlight>

Téléchargement des fichiers :

<syntaxhighlight lang="bash">
git clone https://github.com/phacility/arcanist.git
git clone https://github.com/phacility/libphutil.git
</syntaxhighlight>

=== 7.4 Rendre arc accessible partout ===

Pour ne pas devoir écrire tout le chemin :

<syntaxhighlight lang="bash">
sudo ln -s ~/phabricator/arcanist/bin/arc /usr/local/bin/arc
</syntaxhighlight>

Si le cache Bash ne reconnaît pas la commande :

<syntaxhighlight lang="bash">
hash -r
</syntaxhighlight>

=== 7.5 Vérification de l'installation ===

Test de la commande :

<syntaxhighlight lang="bash">
arc version
</syntaxhighlight>

Note|Une erreur sur shellcheck-linter peut apparaître, mais la version devrait s'afficher. Répondre "y" pour continuer.

----

== 8. Deuxième essai de arc diff (échec - authentification requise) ==

Retournez dans le projet :

<syntaxhighlight lang="bash">
cd /mnt/c/STAGE\ 2025/operations
arc diff
</syntaxhighlight>

'''Erreur attendue :'''
<syntaxhighlight>
YOU NEED TO AUTHENTICATE TO CONTINUE
</syntaxhighlight>

Il faut installer le certificat.

----

== 9. Authentification Arcanist ==

=== Pourquoi exécuter arc install-certificate ? ===

Cette commande permet d'associer votre environnement local à votre compte Phabricator via un token sécurisé.

* Elle est nécessaire pour que Arcanist puisse créer, mettre à jour et soumettre vos révisions (<code>arc diff</code>) sur le serveur Phabricator
* Sans ce certificat, Arcanist ne peut pas authentifier vos commandes et toutes les opérations de soumission de code échoueront
* Le token est spécifique à votre compte et doit être généré depuis l'interface web de Phabricator

=== 9.1 Installation du certificat ===

<syntaxhighlight lang="bash">
arc install-certificate
</syntaxhighlight>

Suivez le lien fourni, récupérez le token API et collez-le dans le terminal. Arcanist est maintenant connecté à votre compte.

----

== 10. Troisième essai de arc diff (échec - shellcheck-linter manquant) ==

<syntaxhighlight lang="bash">
arc diff
</syntaxhighlight>

Arc vous demande de choisir la branche de référence, choisissez <code>origin/main</code>.

'''Nouvelle erreur :'''
<syntaxhighlight>
Failed to load library at location "shellcheck-linter"
</syntaxhighlight>

----

== 11. Installation de shellcheck-linter ==

<syntaxhighlight lang="bash">
cd ~/phabricator
git clone https://github.com/pinterest/arcanist-linters.git shellcheck-linter
</syntaxhighlight>

----

== 12. Quatrième essai de arc diff (échec - linter invalide) ==

Retournez dans le projet :

<syntaxhighlight lang="bash">
cd /mnt/c/STAGE\ 2025/operations
arc diff
</syntaxhighlight>

'''Nouvelle erreur :'''
<syntaxhighlight>
Linter 'shell' specifies invalid type 'shellcheck'
</syntaxhighlight>

Le type <code>shellcheck</code> n'est pas reconnu.

----

== 13. Correction du linter shellcheck ==

Ouvrez <code>.arclint</code> avec VS Code et modifiez :

'''Avant :'''
<syntaxhighlight lang="json">
"shell": {
"type": "shellcheck",
"include": ["(\\.sh$)"]
}
</syntaxhighlight>

'''Après :'''
<syntaxhighlight lang="json">
"shell": {
"type": "text",
"include": ["(\\.sh$)"]
}
</syntaxhighlight>

Avertissement|Ne pas commiter ce changement, c'est juste pour que ça fonctionne localement.

'''Alternative :''' Bypass des tests si nécessaire :

<syntaxhighlight lang="bash">
arc diff --nolint
</syntaxhighlight>

----

== 14. Cinquième essai de arc diff (échec - problème CRLF) ==

<syntaxhighlight lang="bash">
arc diff
</syntaxhighlight>

Arc détecte 1,011 fichiers modifiés. C'est un problème de fins de ligne Windows/Linux.

=== 14.1 Correction des problèmes de fins de ligne ===

<syntaxhighlight lang="bash">
git config --global core.autocrlf input
git restore .
</syntaxhighlight>

Avertissement|Assurez-vous d'être bien dans <code>/mnt/c/STAGE\ 2025/operations</code> avant d'exécuter ces commandes.

----

== 15. Sixième essai de arc diff (succès !) ==

=== 15.1 Vérification de l'état de Git ===

Pour vous assurer qu'il n'y a pas de fichiers non suivis :

<syntaxhighlight lang="bash">
git status
</syntaxhighlight>

'''Résultat attendu :''' Aucun fichier non commité ne doit apparaître.

=== 15.2 Lancement d'Arcanist ===

<syntaxhighlight lang="bash">
arc diff
</syntaxhighlight>

Arc vous demande si vous voulez amend les changements dans <code>.arclint</code> :
<syntaxhighlight>
Do you want to amend these 1 change(s) to the current commit? [y/N] y
</syntaxhighlight>

Puis il vous demande si vous voulez utiliser le message sauvegardé :
<syntaxhighlight>
Do you want to use this message? [Y/n] Y
</syntaxhighlight>

=== 15.3 Remplissage des informations de révision ===

L'éditeur (nano) s'ouvre avec les informations à remplir :

<syntaxhighlight>
Summary: Ajout de Doba Gui comme user et dans le groupe core
Test Plan: Vérification de la syntaxe YAML et des informations utilisateur
Reviewers: dereckson
Subscribers:
</syntaxhighlight>

=== 15.4 Sauvegarde dans nano ===

# '''Sauvegarder le fichier :'''
#* Appuyez sur '''Ctrl + O''' (la lettre O, pas zéro)
#* Nano vous demandera le nom du fichier → appuyez sur '''Entrée''' pour garder le même
# '''Quitter nano :'''
#* Appuyez sur '''Ctrl + X'''

Après ça, vous retournez dans votre terminal et <code>arc diff</code> continuera le processus.

=== 15.5 Pour mettre à jour une révision existante ===

Si vous voulez mettre à jour une révision existante (ex. : D3888) :

<syntaxhighlight lang="bash">
arc diff --update D3888
</syntaxhighlight>

----

== 16. Vérification finale ==

Vérifiez que tout est propre :

<syntaxhighlight lang="bash">
git status
</syntaxhighlight>

Aucun fichier ne doit rester non commité.

Assurez-vous que votre révision contient bien vos modifications :

<syntaxhighlight lang="bash">
arc diff
</syntaxhighlight>

Succès|À ce stade, votre révision est prête à être relue par votre reviewer.

----

== Résumé des problèmes rencontrés ==

{| class="wikitable"
! Problème !! Solution
|-
| Fichiers vides dans operations/ || <code>rm -rf operations/</code> puis travailler dans <code>pillar/core/</code>
|-
| Cache Bash pour arc || <code>hash -r</code>
|-
| Authentification manquante || <code>arc install-certificate</code>
|-
| Bibliothèque shellcheck-linter manquante || Cloner dans <code>~/phabricator/</code>
|-
| Erreur linter shellcheck || Changer <code>"type": "shellcheck"</code> en <code>"type": "text"</code> dans <code>.arclint</code>
|-
| Problème CRLF/LF || <code>git config --global core.autocrlf input</code> puis <code>git restore .</code>
|}

----

== Points importants à retenir ==

Avertissement|
* '''Toutes les commandes Git et Arcanist doivent être exécutées dans <code>/mnt/c/STAGE\ 2025/operations</code>, et non dans <code>~/phabricator</code>.'''
* '''Ne pas commiter les modifications du fichier <code>.arclint</code> (changement de shellcheck en text).'''
* '''Les vrais fichiers sont dans <code>pillar/core/</code>, pas dans <code>operations/pillar/core/</code>.'''

[[Category:Contributor guide]]
[[Category:Reference]]
[[Category:Internship guide]]

Dev zone/Configuration IRC Ops tmux WeeChat

2026-02-03T16:23:13Z

Ptdradmin: Configuration IRC Ops

= Configuration IRC Ops – tmux + WeeChat sur Eglide =

== Objectif ==
Ce guide décrit la mise en place d’une configuration exacte, fonctionnelle et recommandée pour le travail d’exploitation (ops) via IRC, en utilisant tmux + WeeChat sur Eglide.

Cette configuration permet :
* une connexion IRC persistante ;
* aucune perte de messages ;
* une traçabilité correcte des échanges opérationnels ;
* une utilisation fiable en environnement distant.

Elle est conforme aux pratiques professionnelles des équipes ops.

---

== 1. Pré-requis système (Eglide) ==

=== Hypothèses ===
* Accès SSH valide à Eglide ;
* Système Linux standard (Debian/Ubuntu) ;
* Droits utilisateur normaux avec accès sudo.

=== Connexion SSH ===
<syntaxhighlight lang="bash">
ssh <user>@eglide.nasqueron.org
</syntaxhighlight>

---

== 2. Installation des outils requis ==

=== Installation de tmux ===
<syntaxhighlight lang="bash">
sudo apt update
sudo apt install -y tmux
</syntaxhighlight>

=== Installation de WeeChat ===
<syntaxhighlight lang="bash">
sudo apt install -y weechat weechat-plugins
</syntaxhighlight>

=== Vérification des versions ===
<syntaxhighlight lang="bash">
tmux -V
weechat --version
</syntaxhighlight>

---

== 3. Création d’une session tmux persistante ==

Créer une session tmux dédiée à IRC :
<syntaxhighlight lang="bash">
tmux new -s irc
</syntaxhighlight>

Cette session reste active même après une déconnexion SSH.

=== Commandes tmux essentielles ===
* Détacher la session : <code>Ctrl+b</code> puis <code>d</code>
* Reprendre la session :
<syntaxhighlight lang="bash">
tmux attach -t irc
</syntaxhighlight>

---

== 4. Lancement de WeeChat dans tmux ==

Depuis la session tmux :
<syntaxhighlight lang="bash">
weechat
</syntaxhighlight>

WeeChat devient alors l’interface IRC principale.

---

== 5. Configuration du serveur Libera.Chat (TLS obligatoire) ==

Dans WeeChat, exécuter **exactement** les commandes suivantes.

=== Ajout du serveur Libera.Chat ===
<syntaxhighlight lang="text">
/server add libera irc.libera.chat/6697 -tls
</syntaxhighlight>

=== Activation explicite de TLS ===
<syntaxhighlight lang="text">
/set irc.server.libera.ssl on
</syntaxhighlight>

=== Connexion automatique (recommandée) ===
<syntaxhighlight lang="text">
/set irc.server.libera.autoconnect on
</syntaxhighlight>

---

== 6. Connexion au serveur ==

<syntaxhighlight lang="text">
/connect libera
</syntaxhighlight>

=== Résultat attendu ===
* Message de bienvenue Libera.Chat ;
* Aucune erreur SSL/TLS.

---

== 7. Rejoindre les canaux requis ==

=== Canal principal opérations ===
<syntaxhighlight lang="text">
/join #nasqueron-ops
</syntaxhighlight>

=== Canal secondaire existant ===
<syntaxhighlight lang="text">
/join #wolfplex
</syntaxhighlight>

---

== 8. Configuration minimale recommandée (lisibilité ops) ==

=== Activation des horodatages ===
<syntaxhighlight lang="text">
/set weechat.look.buffer_time_format "%Y-%m-%d %H:%M:%S"
</syntaxhighlight>

=== Mise en évidence des mentions ===
<syntaxhighlight lang="text">
/set weechat.look.highlight on
</syntaxhighlight>

=== Augmentation de l’historique ===
<syntaxhighlight lang="text">
/set weechat.history.max_buffer_lines_number 10000
</syntaxhighlight>

---

== 9. Gestion du pseudonyme IRC ==

Changer de pseudonyme :
<syntaxhighlight lang="text">
/nick VotrePseudo
</syntaxhighlight>

'''Important''' : utiliser le même pseudonyme partout (IRC, commits, discussions ops) afin d’assurer la cohérence d’identité.

---

== 10. Enregistrement NickServ (fortement recommandé) ==

=== Enregistrement du pseudonyme ===
<syntaxhighlight lang="text">
/msg NickServ REGISTER motdepasse email
</syntaxhighlight>

=== Identification manuelle (si SASL non configuré) ===
<syntaxhighlight lang="text">
/msg NickServ IDENTIFY motdepasse
</syntaxhighlight>

---

== 11. Persistance de la configuration ==

WeeChat sauvegarde automatiquement sa configuration.

Forcer la sauvegarde si nécessaire :
<syntaxhighlight lang="text">
/save
</syntaxhighlight>

Les fichiers de configuration sont stockés dans :
<syntaxhighlight lang="text">
~/.weechat/
</syntaxhighlight>

---

== 12. Flux de travail attendu ==

* Connexion SSH à Eglide ;
* Attachement à la session tmux <code>irc</code> ;
* WeeChat déjà connecté à Libera.Chat ;
* Lecture du backlog ;
* Participation aux discussions ops ;
* Déconnexion SSH sans quitter IRC.

➡️ Cette méthode garantit une **présence continue sur IRC**, standard en environnement ops.

---

== Verdict ==

'''Configuration validée – conforme aux pratiques professionnelles ops.'''

* tmux : persistance ✓
* WeeChat : fiabilité ✓
* Libera.Chat (TLS) : sécurité ✓
* Canaux requis : conformité ✓

---

== Évolutions possibles ==

* Ajout de l’authentification SASL automatique ;
* Fourniture d’un fichier <code>weechat.conf</code> prêt à l’emploi ;
* Documentation des règles implicites de communication ops sur <code>#nasqueron-ops</code>.

Template:Note

2025-12-18T10:53:44Z

Ptdradmin: Created page with "= Installation et configuration d'Anubis avec Nginx = == Vue d'ensemble == Anubis est un Web AI Firewall qui protège vos applications web contre les bots malveillants. Ce guide détaille l'installation complète d'Anubis en frontal de Nginx avec communication par socket UNIX. === Architecture === <pre> Client → Nginx (HTTPS) → Anubis (socket UNIX) → Application backend </pre> === Prérequis === * Système Linux (RHEL 10, Debian, Ubuntu ou similaire) * Accès..."

= Installation et configuration d'Anubis avec Nginx =

== Vue d'ensemble ==

Anubis est un Web AI Firewall qui protège vos applications web contre les bots malveillants. Ce guide détaille l'installation complète d'Anubis en frontal de Nginx avec communication par socket UNIX.

=== Architecture ===

<pre>
Client → Nginx (HTTPS) → Anubis (socket UNIX) → Application backend
</pre>

=== Prérequis ===

* Système Linux (RHEL 10, Debian, Ubuntu ou similaire)
* Accès root/sudo
* Nginx installé et configuré
* Application backend fonctionnelle (ex: sur port 8080)
* Certificats SSL/TLS (optionnel mais recommandé)

== Installation d'Anubis ==

=== Méthode 1 : Compilation depuis les sources (RHEL/CentOS) ===

==== Étape 1 : Installer les dépendances ====

<syntaxhighlight lang="bash">
sudo dnf install -y git golang nodejs npm
</syntaxhighlight>

==== Étape 2 : Installer esbuild globalement ====

<syntaxhighlight lang="bash">
sudo npm install -g esbuild
</syntaxhighlight>

Vérifier les versions installées :

<syntaxhighlight lang="bash">
go version # go1.25.3 ou supérieur
node --version # v22.16.0 ou supérieur
npm --version # 10.9.2 ou supérieur
esbuild --version # 0.27.2 ou supérieur
</syntaxhighlight>

==== Étape 3 : Cloner le dépôt Anubis ====

<syntaxhighlight lang="bash">
cd /opt
sudo git clone https://github.com/TecharoHQ/anubis.git
</syntaxhighlight>

==== Étape 4 : Corriger les permissions ====

Note| Le clonage avec sudo crée des fichiers appartenant à root. Il faut corriger cela :

<syntaxhighlight lang="bash">
sudo chown -R $USER:$USER /opt/anubis
</syntaxhighlight>

==== Étape 5 : Installer les dépendances npm ====

<syntaxhighlight lang="bash">
cd /opt/anubis
sudo npm install
</syntaxhighlight>

==== Étape 6 : Générer le code et compiler ====

<syntaxhighlight lang="bash">
cd /opt/anubis
rm -rf bin var # Nettoyer les anciens builds
go mod download # Télécharger les dépendances Go
go generate ./... # Générer le code
go build -o var/anubis cmd/anubis/main.go # Compiler
</syntaxhighlight>

Warning| Ces commandes doivent être exécutées '''sans sudo''' pour éviter les problèmes de permissions.

Vérifier que le binaire a été créé :

<syntaxhighlight lang="bash">
ls -l var/anubis
# Devrait afficher : -rwxr-xr-x. 1 user user 52659096 Dec 17 14:46 var/anubis
</syntaxhighlight>

==== Étape 7 : Installer le binaire ====

<syntaxhighlight lang="bash">
sudo cp var/anubis /usr/bin/anubis
sudo chmod 755 /usr/bin/anubis
</syntaxhighlight>

Vérifier l'installation :

<syntaxhighlight lang="bash">
/usr/bin/anubis --version
# Devrait afficher : Anubis devel
</syntaxhighlight>

=== Méthode 2 : Installation via paquet .deb (Debian/Ubuntu) ===

<syntaxhighlight lang="bash">
sudo apt update
curl -OL https://github.com/TecharoHQ/anubis/releases/download/v1.19.1/anubis_1.19.1_linux_amd64.deb
sudo apt install ./anubis_1.19.1_linux_amd64.deb
</syntaxhighlight>

== Configuration d'Anubis ==

=== Étape 1 : Créer le répertoire de configuration ===

<syntaxhighlight lang="bash">
sudo mkdir -p /etc/anubis
sudo mkdir -p /run/anubis
</syntaxhighlight>

=== Étape 2 : Créer le fichier de configuration principal ===

Créer <code>/etc/anubis/site.env</code> :

<syntaxhighlight lang="bash">
sudo tee /etc/anubis/site.env <<EOF
# Écoute sur socket UNIX
ANUBIS_LISTEN_ADDR=/run/anubis/site.sock
BIND_NETWORK=unix
SOCKET_MODE=0666

# Backend cible (votre application)
ANUBIS_BACKEND=http://127.0.0.1:8080
TARGET=http://127.0.0.1:8080

# Domaine du site
ANUBIS_SITE_DOMAIN=example.com

# Mode de fonctionnement
ANUBIS_MODE=proxy

# Fichier de politiques
POLICY_FNAME=/etc/anubis/site.botPolicies.yaml

# Niveau de difficulté du challenge (1-5)
DIFFICULTY=3

# Logging
LOG_LEVEL=info

# Workers
WORKERS=2

# Servir robots.txt
SERVE_ROBOTS_TXT=true
EOF
</syntaxhighlight>

=== Étape 3 : Créer le fichier de politiques anti-bots ===

Créer <code>/etc/anubis/site.botPolicies.yaml</code> :

<syntaxhighlight lang="bash">
sudo tee /etc/anubis/site.botPolicies.yaml <<EOF
version: 1
policies:
- name: default
rules:
- type: allow
bot: human
- type: challenge
bot: unknown
difficulty: 3
- type: block
bot: malicious
EOF
</syntaxhighlight>

=== Étape 4 : Définir les permissions ===

<syntaxhighlight lang="bash">
sudo chmod 644 /etc/anubis/site.env
sudo chmod 644 /etc/anubis/site.botPolicies.yaml
sudo chown -R root:root /etc/anubis
</syntaxhighlight>

== Configuration du service Systemd ==

=== Créer le fichier de service ===

Pour une '''instance unique''', créer <code>/etc/systemd/system/anubis.service</code> :

<syntaxhighlight lang="bash">
sudo tee /etc/systemd/system/anubis.service <<EOF
[Unit]
Description=Anubis Web AI Firewall
After=network.target

[Service]
Type=simple
User=root
Group=root
WorkingDirectory=/opt/anubis
ExecStart=/usr/bin/anubis
Restart=always
RestartSec=5
EnvironmentFile=/etc/anubis/site.env

[Install]
WantedBy=multi-user.target
EOF
</syntaxhighlight>

Pour des '''instances multiples''' (plusieurs sites), créer <code>/etc/systemd/system/anubis@.service</code> :

<syntaxhighlight lang="bash">
sudo tee /etc/systemd/system/anubis@.service <<EOF
[Unit]
Description=Anubis Web AI Firewall - Instance %i
After=network.target

[Service]
Type=simple
User=root
Group=root
EnvironmentFile=/etc/anubis/%i.env
ExecStart=/usr/bin/anubis
Restart=on-failure
RestartSec=5

[Install]
WantedBy=multi-user.target
EOF
</syntaxhighlight>

=== Activer et démarrer le service ===

<syntaxhighlight lang="bash">
sudo systemctl daemon-reload
sudo systemctl enable anubis
sudo systemctl start anubis
</syntaxhighlight>

Pour les instances multiples :

<syntaxhighlight lang="bash">
sudo systemctl enable anubis@site
sudo systemctl start anubis@site
</syntaxhighlight>

=== Vérifier le statut du service ===

<syntaxhighlight lang="bash">
sudo systemctl status anubis
</syntaxhighlight>

Le service devrait afficher :

<pre>
● anubis.service - Anubis Web AI Firewall
Loaded: loaded
Active: active (running)
</pre>

=== Vérifier les logs ===

<syntaxhighlight lang="bash">
sudo journalctl -u anubis -f
</syntaxhighlight>

=== Vérifier la création du socket ===

<syntaxhighlight lang="bash">
ls -l /run/anubis/site.sock
# Devrait afficher : srwxrw-rw- 1 root root 0 Dec 17 14:46 /run/anubis/site.sock
</syntaxhighlight>

=== Tester Anubis directement ===

<syntaxhighlight lang="bash">
curl --unix-socket /run/anubis/site.sock http://anubis/
</syntaxhighlight>

== Configuration de Nginx ==

=== Étape 1 : Créer l'upstream Anubis ===

Créer <code>/etc/nginx/conf.d/anubis-upstream.conf</code> :

<syntaxhighlight lang="bash">
sudo tee /etc/nginx/conf.d/anubis-upstream.conf <<EOF
upstream anubis_backend {
server unix:/run/anubis/site.sock;
keepalive 32;
}
EOF
</syntaxhighlight>

=== Étape 2 : Configurer le virtual host ===

Créer <code>/etc/nginx/sites-available/example.conf</code> (ou <code>/etc/nginx/conf.d/example.conf</code> sur RHEL) :

<syntaxhighlight lang="nginx">
# Redirection HTTP vers HTTPS
server {
listen 80;
listen [::]:80;
server_name example.com www.example.com;

# Redirection permanente vers HTTPS
return 301 https://$host$request_uri;
}

# Configuration HTTPS avec Anubis
server {
listen 443 ssl http2;
listen [::]:443 ssl http2;
server_name example.com www.example.com;

# Certificats SSL/TLS
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;

# Paramètres SSL recommandés
ssl_session_timeout 10m;
ssl_session_cache shared:SSL:10m;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_prefer_server_ciphers off;
ssl_ciphers HIGH:!aNULL:!MD5;

# Headers de sécurité
add_header X-Frame-Options DENY;
add_header X-Content-Type-Options nosniff;
add_header X-XSS-Protection "1; mode=block";
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;

# Timeouts adaptés à Anubis
proxy_read_timeout 180s;
proxy_send_timeout 180s;
proxy_connect_timeout 10s;

# Taille maximale des uploads
client_max_body_size 10M;

# Proxy vers Anubis
location / {
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header Connection "";

proxy_pass http://anubis_backend;
}
}
</syntaxhighlight>

=== Étape 3 : Activer le site (Debian/Ubuntu) ===

<syntaxhighlight lang="bash">
sudo ln -s /etc/nginx/sites-available/example.conf /etc/nginx/sites-enabled/
</syntaxhighlight>

Note|Sur RHEL/CentOS, le fichier dans <code>/etc/nginx/conf.d/</code> est automatiquement actif.

=== Étape 4 : Tester et recharger Nginx ===

<syntaxhighlight lang="bash">
# Tester la configuration
sudo nginx -t

# Si OK, recharger Nginx
sudo systemctl reload nginx
</syntaxhighlight>

== Vérification du déploiement ==

=== 1. Vérifier qu'Anubis fonctionne ===

<syntaxhighlight lang="bash">
sudo systemctl status anubis
sudo journalctl -u anubis -n 50
</syntaxhighlight>

=== 2. Vérifier le socket UNIX ===

<syntaxhighlight lang="bash">
ls -l /run/anubis/site.sock
sudo ss -xlp | grep anubis
</syntaxhighlight>

=== 3. Vérifier Nginx ===

<syntaxhighlight lang="bash">
sudo systemctl status nginx
sudo nginx -t
</syntaxhighlight>

=== 4. Test d'accès via navigateur ===

Ouvrir <code>https://example.com</code> dans un navigateur. Vous devriez :

# Voir le challenge Anubis si c'est la première visite
# Être redirigé vers votre application après validation
# Voir le header <code>X-Anubis-Status</code> dans les réponses HTTP

=== 5. Test avec curl ===

<syntaxhighlight lang="bash">
# Test complet de la chaîne
curl -I https://example.com

# Devrait retourner un code 200 ou le challenge Anubis
</syntaxhighlight>

=== 6. Vérifier les logs en temps réel ===

<syntaxhighlight lang="bash">
# Logs Anubis
sudo journalctl -u anubis -f

# Logs Nginx
sudo tail -f /var/log/nginx/access.log
sudo tail -f /var/log/nginx/error.log
</syntaxhighlight>

== Flux des requêtes ==

<pre>
1. Client HTTPS → Nginx (port 443)
2. Nginx → Anubis (socket UNIX)
3. Anubis analyse la requête :
- Fingerprint du client
- Headers HTTP
- Comportement
4. Anubis décide :
- Challenge JS → Client doit résoudre
- Allow → Passe au backend
- Block → Requête bloquée
5. Backend traite la requête légitime
6. Backend → Anubis → Nginx → Client
</pre>

== Dépannage ==

=== Le service Anubis ne démarre pas ===

<syntaxhighlight lang="bash">
# Vérifier les logs
sudo journalctl -u anubis -xe

# Vérifier la configuration
cat /etc/anubis/site.env

# Vérifier les permissions
ls -l /usr/bin/anubis
ls -ld /run/anubis
</syntaxhighlight>

=== Le socket n'est pas créé ===

<syntaxhighlight lang="bash">
# Vérifier que le répertoire existe
sudo mkdir -p /run/anubis

# Vérifier les permissions
sudo chmod 755 /run/anubis

# Redémarrer Anubis
sudo systemctl restart anubis
</syntaxhighlight>

=== Nginx ne peut pas se connecter au socket ===

<syntaxhighlight lang="bash">
# Vérifier les permissions du socket
ls -l /run/anubis/site.sock

# Ajuster SOCKET_MODE dans site.env
SOCKET_MODE=0666

# Redémarrer Anubis
sudo systemctl restart anubis
</syntaxhighlight>

=== Erreur "permission denied" lors de la compilation ===

<syntaxhighlight lang="bash">
# Corriger la propriété des fichiers
sudo chown -R $USER:$USER /opt/anubis

# Nettoyer et recompiler
cd /opt/anubis
rm -rf bin var
go generate ./...
go build -o var/anubis cmd/anubis/main.go
</syntaxhighlight>

=== Erreur "esbuild: command not found" ===

<syntaxhighlight lang="bash">
# Réinstaller esbuild
sudo npm install -g esbuild

# Vérifier l'installation
which esbuild
esbuild --version
</syntaxhighlight>

== Optimisations recommandées ==

=== 1. Cache Anubis ===

Ajouter dans <code>/etc/anubis/site.env</code> :

<syntaxhighlight lang="bash">
CACHE_SIZE=50000
CACHE_TTL=300
</syntaxhighlight>

=== 2. Rate limiting ===

<syntaxhighlight lang="bash">
RATE_LIMIT_MODE=smart
FIREWALL_MODE=strict
</syntaxhighlight>

=== 3. Nginx keepalive ===

Dans <code>anubis-upstream.conf</code> :

<syntaxhighlight lang="nginx">
upstream anubis_backend {
server unix:/run/anubis/site.sock;
keepalive 64;
keepalive_requests 1000;
keepalive_timeout 60s;
}
</syntaxhighlight>

=== 4. Logs structurés ===

<syntaxhighlight lang="bash">
LOG_LEVEL=info
LOG_FORMAT=json
</syntaxhighlight>

== Maintenance ==

=== Redémarrer Anubis ===

<syntaxhighlight lang="bash">
sudo systemctl restart anubis
</syntaxhighlight>

=== Recharger la configuration sans interruption ===

<syntaxhighlight lang="bash">
# Éditer la configuration
sudo nano /etc/anubis/site.env

# Redémarrer le service
sudo systemctl restart anubis
</syntaxhighlight>

=== Mettre à jour Anubis ===

<syntaxhighlight lang="bash">
# Arrêter le service
sudo systemctl stop anubis

# Compiler la nouvelle version
cd /opt/anubis
git pull
rm -rf bin var
go generate ./...
go build -o var/anubis cmd/anubis/main.go

# Installer le nouveau binaire
sudo cp var/anubis /usr/bin/anubis
sudo chmod 755 /usr/bin/anubis

# Redémarrer
sudo systemctl start anubis
</syntaxhighlight>

=== Sauvegarder la configuration ===

<syntaxhighlight lang="bash">
sudo tar czf anubis-config-backup-$(date +%Y%m%d).tar.gz /etc/anubis/
</syntaxhighlight>

== Sécurité ==

=== Durcissement du service ===

Éditer <code>/etc/systemd/system/anubis.service</code> et ajouter :

<syntaxhighlight lang="ini">
[Service]
NoNewPrivileges=true
PrivateTmp=true
ProtectSystem=strict
ProtectHome=true
ReadWritePaths=/run/anubis
</syntaxhighlight>

=== Firewall ===

<syntaxhighlight lang="bash">
# Bloquer l'accès direct au backend
sudo firewall-cmd --permanent --add-rich-rule='rule family="ipv4" source address="0.0.0.0/0" port port="8080" protocol="tcp" reject'
sudo firewall-cmd --reload

# Ou avec iptables
sudo iptables -A INPUT -p tcp --dport 8080 -s 127.0.0.1 -j ACCEPT
sudo iptables -A INPUT -p tcp --dport 8080 -j DROP
</syntaxhighlight>

== Instances multiples ==

Pour gérer plusieurs sites avec Anubis :

=== 1. Créer des configurations séparées ===

<syntaxhighlight lang="bash">
sudo cp /etc/anubis/site.env /etc/anubis/site2.env
sudo cp /etc/anubis/site.botPolicies.yaml /etc/anubis/site2.botPolicies.yaml
</syntaxhighlight>

=== 2. Modifier les configurations ===

Éditer <code>/etc/anubis/site2.env</code> :

<syntaxhighlight lang="bash">
ANUBIS_LISTEN_ADDR=/run/anubis/site2.sock
ANUBIS_BACKEND=http://127.0.0.1:8081
ANUBIS_SITE_DOMAIN=example2.com
</syntaxhighlight>

=== 3. Démarrer l'instance ===

<syntaxhighlight lang="bash">
sudo systemctl enable anubis@site2
sudo systemctl start anubis@site2
</syntaxhighlight>

=== 4. Créer l'upstream Nginx correspondant ===

<syntaxhighlight lang="nginx">
upstream anubis_site2 {
server unix:/run/anubis/site2.sock;
}
</syntaxhighlight>

== Monitoring ==

=== Métriques Anubis ===

Anubis expose des métriques (si configuré) :

<syntaxhighlight lang="bash">
# Dans site.env
METRICS_ENABLED=true
METRICS_ADDR=127.0.0.1:9090
</syntaxhighlight>

=== Monitoring avec Prometheus ===

<syntaxhighlight lang="yaml">
scrape_configs:
- job_name: 'anubis'
static_configs:
- targets: ['localhost:9090']
</syntaxhighlight>

== Références ==

* [https://anubis.techaro.lol/docs/ Documentation officielle]
* [https://github.com/TecharoHQ/anubis Dépôt GitHub]
* [https://anubis.techaro.lol/docs/admin/configuration/ Configuration avancée]

== Résumé des commandes ==

<syntaxhighlight lang="bash">
# Installation
cd /opt
sudo git clone https://github.com/TecharoHQ/anubis.git
sudo chown -R $USER:$USER /opt/anubis
cd /opt/anubis
sudo npm install -g esbuild
go generate ./...
go build -o var/anubis cmd/anubis/main.go
sudo cp var/anubis /usr/bin/anubis

# Configuration
sudo mkdir -p /etc/anubis /run/anubis
sudo nano /etc/anubis/site.env
sudo nano /etc/anubis/site.botPolicies.yaml

# Service
sudo systemctl daemon-reload
sudo systemctl enable --now anubis
sudo systemctl status anubis

# Nginx
sudo nginx -t
sudo systemctl reload nginx

# Vérification
curl --unix-socket /run/anubis/site.sock http://anubis/
curl -I https://example.com
</syntaxhighlight>

Fr

2025-12-18T10:16:11Z

Ptdradmin: Created page with "= Documentation - Résolution d'erreur de build Anubis = == Contexte == Installation et configuration d’'''Anubis Web AI Firewall''' sur un serveur '''Red Hat Enterprise Linux 10 (RHEL 10)'''. * '''Serveur :''' dwellers.nasqueron.org * '''Utilisateur :''' ptdradmin * '''Répertoire d’installation :''' /opt/anubis '''Versions des outils :''' * Go : 1.25.3 * Node.js : 22.16.0 * npm : 10.9.2 * esbuild : 0.27.2 == Problème rencontré == === Symptômes === # Échec d..."

= Documentation - Résolution d'erreur de build Anubis =

== Contexte ==
Installation et configuration d’'''Anubis Web AI Firewall''' sur un serveur '''Red Hat Enterprise Linux 10 (RHEL 10)'''.

* '''Serveur :''' dwellers.nasqueron.org
* '''Utilisateur :''' ptdradmin
* '''Répertoire d’installation :''' /opt/anubis

'''Versions des outils :'''
* Go : 1.25.3
* Node.js : 22.16.0
* npm : 10.9.2
* esbuild : 0.27.2

== Problème rencontré ==
=== Symptômes ===
# Échec de la génération de code (<code>go generate ./...</code>)
* Permissions refusées lors de la création de fichiers
* Messages : <code>permission denied</code>
* Erreur : <code>./build.sh: line 48: esbuild: command not found</code>

# Échec de la compilation (<code>go build</code>)
* Le binaire <code>/opt/anubis/var/anubis</code> n'a pas été créé
* Erreur : <code>pattern static/app.js: no matching files found</code>

# Échec du démarrage du service systemd
* Service anubis ne peut pas démarrer
* Erreur : <code>Unable to locate executable '/usr/bin/anubis': No such file or directory</code>

=== Erreurs détaillées ===
<syntaxhighlight lang="bash">
go generate ./...

stringer: writing output: open droneblresponse_string.go: permission denied
(✗) Error [ error=failed to generate code for "/opt/anubis/internal/honeypot/naive/page.templ":
failed to write target file "/opt/anubis/internal/honeypot/naive/page_templ.go":
open /opt/anubis/internal/honeypot/naive/page_templ.go: permission denied ]
mkdir: cannot create directory 'static/js': Permission denied
./build.sh: line 48: esbuild: command not found
lib/challenge/preact/preact.go:20: running "./build.sh": exit status 127
</syntaxhighlight>

<syntaxhighlight lang="bash">
go build -o var/anubis cmd/anubis/main.go

lib/challenge/preact/preact.go:23:12: pattern static/app.js: no matching files found
</syntaxhighlight>

<syntaxhighlight lang="bash">
sudo systemctl status anubis

× anubis.service - Anubis Web AI Firewall
Active: failed (Result: exit-code)
Process: 821872 ExecStart=/usr/bin/anubis (code=exited, status=203/EXEC)

anubis.service: Unable to locate executable '/usr/bin/anubis': No such file or directory
</syntaxhighlight>

== Analyse de la cause racine ==
=== Causes principales ===
* Conflit de permissions dû à l'utilisation de <code>sudo git clone</code>
* Outil ''esbuild'' manquant dans le PATH lors de l’exécution de <code>build.sh</code>

=== Conséquences en cascade ===
* Génération incomplète : fichiers de code généré non créés
* esbuild non trouvé : bundler JavaScript inaccessible
* Assets manquants : fichiers JS comme <code>static/app.js</code> non générés
* Compilation impossible
* Binaire absent : /usr/bin/anubis inexistant
* Service systemd en échec

== Solution ==
<folding summary="Cliquez pour dérouler les étapes complètes de résolution">
=== Étape 1 : Arrêter le service en échec ===
<syntaxhighlight lang="bash">
sudo systemctl stop anubis
</syntaxhighlight>

=== Étape 2 : Installer esbuild globalement ===
<syntaxhighlight lang="bash">
sudo npm install -g esbuild
which esbuild
esbuild --version
</syntaxhighlight>

=== Étape 3 : Corriger la propriété des fichiers ===
<syntaxhighlight lang="bash">
sudo chown -R ptdradmin:ptdradmin /opt/anubis
</syntaxhighlight>

=== Étape 4 : Nettoyer les artéfacts de build partiels ===
<syntaxhighlight lang="bash">
cd /opt/anubis
rm -rf bin var
</syntaxhighlight>

=== Étape 5 : Générer le code sans sudo ===
<syntaxhighlight lang="bash">
go generate ./...
</syntaxhighlight>

* La génération doit se terminer avec succès et produire les fichiers JS :
<syntaxhighlight lang="text">
(✓) Complete [ updates=0 duration=2.753344ms ]
(✓) Complete [ updates=0 duration=4.775691ms ]
app.js
static/app.js 20.3kb
⚡ Done in 12ms
(✓) Complete [ updates=0 duration=2.333324ms ]
(✓) Complete [ updates=0 duration=3.490825ms ]
(✓) Complete [ updates=0 duration=14.668559ms ]
</syntaxhighlight>

=== Étape 6 : Compiler le binaire ===
<syntaxhighlight lang="bash">
go build -o var/anubis cmd/anubis/main.go
</syntaxhighlight>

=== Étape 7 : Vérifier la création du binaire ===
<syntaxhighlight lang="bash">
ls -l var/anubis
</syntaxhighlight>
* Exemple attendu :
<syntaxhighlight lang="text">
-rwxr-xr-x. 1 ptdradmin ptdradmin 52659096 Dec 17 14:46 var/anubis
</syntaxhighlight>

=== Étape 8 : Copier le binaire vers /usr/bin ===
<syntaxhighlight lang="bash">
sudo cp var/anubis /usr/bin/anubis
sudo chmod 755 /usr/bin/anubis
</syntaxhighlight>

=== Étape 9 : Vérifier l'installation ===
<syntaxhighlight lang="bash">
/usr/bin/anubis --version
</syntaxhighlight>
* Exemple attendu : <code>Anubis devel</code>

=== Étape 10 : Démarrer le service ===
<syntaxhighlight lang="bash">
sudo systemctl start anubis
sudo systemctl status anubis
</syntaxhighlight>

* Statut attendu :
<syntaxhighlight lang="text">
● anubis.service - Anubis Web AI Firewall
Loaded: loaded (/etc/systemd/system/anubis.service; enabled; preset: disabled)
Active: active (running) since Wed 2025-12-17 14:46:41 UTC; 6s ago
Main PID: 823482 (anubis)
Tasks: 13 (limit: 203296)
Memory: 15.5M (peak: 18.7M)
</syntaxhighlight>

=== Étape 11 : Commandes complètes de séquence ===
<syntaxhighlight lang="bash">
# Arrêter le service
sudo systemctl stop anubis

# S'assurer que esbuild est installé
sudo npm install -g esbuild
which esbuild
esbuild --version

# Corriger la propriété
sudo chown -R ptdradmin:ptdradmin /opt/anubis

# Nettoyer et reconstruire
cd /opt/anubis
rm -rf bin var
go generate ./...
go build -o var/anubis cmd/anubis/main.go

# Vérifier et installer
ls -l var/anubis
sudo cp var/anubis /usr/bin/anubis
sudo chmod 755 /usr/bin/anubis

# Tester et démarrer
/usr/bin/anubis --version
sudo systemctl start anubis
sudo systemctl status anubis
</syntaxhighlight>
</folding>

== Bonnes pratiques ==
* Ne pas utiliser <code>sudo</code> pour <code>git clone</code>
* Installer tous les outils nécessaires globalement avant le build
* Séparer les opérations utilisateur et root (build vs installation)
* Vérifier les permissions avant de lancer le build
* Utiliser <code>make build</code> si disponible

== Structure de répertoires recommandée ==
<syntaxhighlight lang="text">
/opt/anubis/ # Code source (propriétaire: utilisateur)
├── cmd/
├── internal/
├── lib/
└── var/
└── anubis # Binaire compilé

/usr/bin/anubis # Installation système (root)
/etc/anubis/ # Configuration (root)
├── site.env
└── site.botPolicies.yaml
</syntaxhighlight>

== Vérifications post-installation ==
<syntaxhighlight lang="bash">
sudo systemctl status anubis
sudo journalctl -u anubis -n 50
sudo journalctl -u anubis -f
sudo ss -tulpn | grep anubis
sudo systemctl restart anubis
</syntaxhighlight>

== Résumé ==
* Problèmes : permissions incorrectes et esbuild manquant
* Solutions : installer esbuild globalement, corriger propriété des fichiers, reconstruire sans sudo
* Résultat final : le service Anubis fonctionne correctement et protège le site desk.nasqueron.org

Documentation ZFS

2025-11-28T17:20:09Z

Ptdradmin: Created page with "= Guide Complet : Déploiement de MariaDB avec ZFS sur db-B-001 = Last updated: Friday, November 28, 2025 == Introduction == Ce guide complet explique comment configurer MariaDB avec InnoDB sur un serveur FreeBSD utilisant ZFS pour le stockage, en montant spécifiquement les datasets ''mysql-innodb-data'' et ''mysql-innodb-logs'' en dehors du répertoire ''/var/db/mysql''. == Prérequis == * Serveur FreeBSD 14.3 avec ZFS et MariaDB 10.11.15 installés * Pool ZFS ''arco..."

= Guide Complet : Déploiement de MariaDB avec ZFS sur db-B-001 =
Last updated: Friday, November 28, 2025

== Introduction ==
Ce guide complet explique comment configurer MariaDB avec InnoDB sur un serveur FreeBSD utilisant ZFS pour le stockage, en montant spécifiquement les datasets ''mysql-innodb-data'' et ''mysql-innodb-logs'' en dehors du répertoire ''/var/db/mysql''.

== Prérequis ==
* Serveur FreeBSD 14.3 avec ZFS et MariaDB 10.11.15 installés
* Pool ZFS ''arcology'' opérationnel avec espace disponible
* Accès root ou sudo
* Connaissances de base en administration système et ZFS

== Architecture Cible ==
* Datasets ZFS dédiés pour les données et logs InnoDB
* Points de montage personnalisés : ''/mysql-innodb-data'' et ''/mysql-innodb-logs''
* Configuration optimisée pour les performances
* Système de sauvegarde via snapshots ZFS

== Fichiers de Configuration MariaDB ==
Sur FreeBSD avec MariaDB :
* **Fichier principal de configuration** : ''/usr/local/etc/mysql/my.cnf''
* Fichiers complémentaires :
* ''/usr/local/etc/my.cnf'' (lien symbolique vers le fichier principal)
* ''/usr/local/etc/mysql/conf.d/server.cnf'' (configuration spécifique)

== Étapes de Déploiement ==

=== Phase 1 : Préparation de l'Environnement ===
==== 1.1 Vérification des versions ====
<syntaxhighlight lang="bash">
mysql --version
zpool list
zfs list
</syntaxhighlight>

==== 1.2 Création des datasets ZFS ====
<syntaxhighlight lang="bash">
# Création avec points de montage personnalisés
sudo zfs create -o mountpoint=/mysql-innodb-data arcology/mysql-innodb-data
sudo zfs create -o mountpoint=/mysql-innodb-logs arcology/mysql-innodb-logs

# Configuration des propriétés
sudo zfs set recordsize=16K arcology/mysql-innodb-data
sudo zfs set recordsize=128K arcology/mysql-innodb-logs
sudo zfs set primarycache=metadata arcology/mysql-innodb-data
sudo zfs set primarycache=metadata arcology/mysql-innodb-logs
</syntaxhighlight>

=== Phase 2 : Configuration des Permissions ===
<syntaxhighlight lang="bash">
sudo chown -R mysql:mysql /mysql-innodb-data
sudo chown -R mysql:mysql /mysql-innodb-logs
sudo chmod -R 750 /mysql-innodb-data
sudo chmod -R 750 /mysql-innodb-logs
</syntaxhighlight>

=== Phase 3 : Migration des Données ===
==== 3.1 Arrêt du service MariaDB ====
<syntaxhighlight lang="bash">
sudo service mysql-server stop
</syntaxhighlight>

==== 3.2 Déplacement des fichiers ====
<syntaxhighlight lang="bash">
sudo mv /var/db/mysql/ibdata1 /mysql-innodb-data/
sudo mv /var/db/mysql/ib_logfile* /mysql-innodb-logs/
</syntaxhighlight>

==== 3.3 Création des liens symboliques ====
<syntaxhighlight lang="bash">
sudo ln -s /mysql-innodb-data/ibdata1 /var/db/mysql/ibdata1
sudo ln -s /mysql-innodb-logs/ib_logfile* /var/db/mysql/
</syntaxhighlight>

=== Phase 4 : Configuration de MariaDB ===
==== 4.1 Modification du fichier principal ====
<syntaxhighlight lang="bash">
sudo nano /usr/local/etc/mysql/my.cnf
</syntaxhighlight>

Ajouter/modifier dans le fichier principal :
<syntaxhighlight lang="ini">
[mysqld]
datadir = /var/db/mysql
innodb_data_home_dir = /mysql-innodb-data
innodb_log_group_home_dir = /mysql-innodb-logs
innodb_data_file_path = ibdata1:10M:autoextend
skip-innodb_doublewrite
</syntaxhighlight>

==== 4.2 Vérification de la configuration ====
Pour vérifier que le bon fichier est utilisé :
<syntaxhighlight lang="bash">
mysql --print-defaults
</syntaxhighlight>

==== 4.3 Structure des fichiers de configuration ====
* ''/usr/local/etc/my.cnf'' → Lien symbolique vers ''/usr/local/etc/mysql/my.cnf''
* ''/usr/local/etc/mysql/my.cnf'' → **Fichier principal de configuration**
* ''/usr/local/etc/mysql/conf.d/'' → Répertoire pour les configurations modulaires

=== Phase 5 : Optimisation ===
==== 5.1 Activation de la compression ====
<syntaxhighlight lang="bash">
sudo zfs set compression=lz4 arcology/mysql-innodb-data
sudo zfs set compression=lz4 arcology/mysql-innodb-logs
</syntaxhighlight>

==== 5.2 Autres optimisations ZFS ====
<syntaxhighlight lang="bash">
# Désactivation du cache flush si matériel approprié
sudo zfs set zfs_nocacheflush=1 arcology

# Configuration de l'ARC pour métadonnées seulement
sudo zfs set primarycache=metadata arcology
</syntaxhighlight>

=== Phase 6 : Redémarrage et Vérification ===
<syntaxhighlight lang="bash">
sudo service mysql-server start
sudo tail -n 20 /var/db/mysql/windriver.err
</syntaxhighlight>

Vérification SQL :
<syntaxhighlight lang="sql">
SHOW VARIABLES LIKE 'innodb_data_home_dir';
SHOW VARIABLES LIKE 'innodb_log_group_home_dir';
</syntaxhighlight>

=== Phase 7 : Sauvegarde et Restauration ===
==== 7.1 Création de snapshots ====
<syntaxhighlight lang="bash">
sudo zfs snapshot arcology/mysql-innodb-data@$(date +%Y%m%d)
sudo zfs snapshot arcology/mysql-innodb-logs@$(date +%Y%m%d)
</syntaxhighlight>

==== 7.2 Procédure de restauration ====
<syntaxhighlight lang="bash">
# Arrêter MariaDB avant restauration
sudo service mysql-server stop

# Restauration
sudo zfs rollback arcology/mysql-innodb-data@20231128
sudo zfs rollback arcology/mysql-innodb-logs@20231128

# Redémarrer MariaDB
sudo service mysql-server start
</syntaxhighlight>

== Bonnes Pratiques pour la Configuration ==
1. **Toujours modifier le fichier principal** : ''/usr/local/etc/mysql/my.cnf''
2. Pour des configurations spécifiques, créer des fichiers dans ''/usr/local/etc/mysql/conf.d/''
3. Vérifier la syntaxe après modification :
<syntaxhighlight lang="bash">
sudo mysqld --verbose --help 2>/dev/null | head
</syntaxhighlight>
4. Après modification, toujours redémarrer le service :
<syntaxhighlight lang="bash">
sudo service mysql-server restart
</syntaxhighlight>

== Résolution des Problèmes Courants ==
=== Problème : MariaDB ne démarre pas ===
* Vérifier les permissions :
<syntaxhighlight lang="bash">
ls -la /mysql-innodb-data
ls -la /var/db/mysql/
</syntaxhighlight>
* Consulter les logs :
<syntaxhighlight lang="bash">
sudo tail -n 50 /var/db/mysql/windriver.err
</syntaxhighlight>
* Vérifier la syntaxe du fichier de configuration :
<syntaxhighlight lang="bash">
sudo mysql --print-defaults
sudo mysqld --verbose --help 2>/dev/null | head
</syntaxhighlight>

=== Problème : Performances dégradées ===
* Vérifier la fragmentation :
<syntaxhighlight lang="bash">
zfs get fragmentation arcology/mysql-innodb-data
</syntaxhighlight>
* Surveiller l'utilisation mémoire :
<syntaxhighlight lang="bash">
top
</syntaxhighlight>
* Ajuster ''recordsize'' si nécessaire (16K pour OLTP, 128K pour les logs)

== Commandes Utiles ==
{| class="wikitable"
|-
! Action
! Commande
|-
| Vérifier l'état du pool ZFS
| <syntaxhighlight lang="bash">zpool status arcology</syntaxhighlight>
|-
| Lister les datasets
| <syntaxhighlight lang="bash">zfs list -t all</syntaxhighlight>
|-
| Vérifier les points de montage
| <syntaxhighlight lang="bash">df -h | grep mysql</syntaxhighlight>
|-
| Voir les propriétés d'un dataset
| <syntaxhighlight lang="bash">zfs get all arcology/mysql-innodb-data</syntaxhighlight>
|-
| Prendre un snapshot daté
| <syntaxhighlight lang="bash">sudo zfs snapshot arcology/mysql-innodb-data@$(date +%Y%m%d_%H%M)</syntaxhighlight>
|-
| Voir les snapshots existants
| <syntaxhighlight lang="bash">zfs list -t snapshot</syntaxhighlight>
|-
| Vérifier le fichier de configuration utilisé
| <syntaxhighlight lang="bash">mysql --print-defaults</syntaxhighlight>
|-
| Vérifier la syntaxe de configuration
| <syntaxhighlight lang="bash">sudo mysqld --verbose --help 2>/dev/null | head</syntaxhighlight>
|}

== Annexes ==
=== Configuration Avancée ZFS ===
Pour les environnements de production, considérer :
<syntaxhighlight lang="bash">
# Séparation des logs ZIL sur SSD
sudo zpool add arcology log /dev/ada2

# Configuration L2ARC pour cache supplémentaire
sudo zpool add arcology cache /dev/ada3
</syntaxhighlight>

=== Exemple de Script de Sauvegarde ===
<syntaxhighlight lang="bash">
#!/bin/sh
# Sauvegarde quotidienne des datasets MariaDB
POOL="arcology"
DATE=$(date +%Y%m%d_%H%M)

# Verrouillage des tables
mysql -e "FLUSH TABLES WITH READ LOCK; SYSTEM zfs snapshot $POOL/mysql-innodb-data@db_backup_$DATE; SYSTEM zfs snapshot $POOL/mysql-innodb-logs@db_backup_$DATE; UNLOCK TABLES;"
</syntaxhighlight>

=== Vérification de la Configuration ===
Pour voir tous les paramètres actifs :
<syntaxhighlight lang="sql">
SHOW VARIABLES;
</syntaxhighlight>

Pour voir les paramètres InnoDB spécifiques :
<syntaxhighlight lang="sql">
SHOW VARIABLES LIKE 'innodb%';
</syntaxhighlight>

Operations grimoire/NTP

2025-11-28T08:48:50Z

Ptdradmin: /* FreeBSD */

NTP allows to sync time. That's especially important for accurate logs and TLS certificates.

== Recommended NTP servers ==
There is a CC list of servers by country. France makes sense for most servers to use the country of the datacenter where the server is located.

== By OS ==
NTP is configured in core.

=== FreeBSD ===
We use ntpd service. Each day, drift from NTP servers is checked by periodic <code>480.status-ntpd</code>.

We have enabled the automatic startup of the '''ntpd''' service on all FreeBSD servers to ensure continuous time synchronization. Additionally, the '''ntpd''' configuration has been adjusted to allow automatic connections to time sources, ensuring reliable updates without any manual intervention.

For reference, see:<br>

*[https://devcentral.nasqueron.org/T2192 Default NTP configuration leads to connection refused][Default NTP configuration leads to connection refused
]
* [D3893](https://devcentral.nasqueron.org/D3893)

=== Linux ===
Chrony service is used.

== Troubleshoot ==
=== Update leap seconds ===
Leap seconds file isn't maintained any more by NTP package (see [https://bugs.ntp.org/show_bug.cgi?id=3898 upstream issue])

To update the file, run the hotfix:

$ salt -G 'os:FreeBSD' state.apply hotfixes/leap-seconds.sls

=== ntpq: read: Connection refused ===
Reported as {{T|2192}}. The ntpq command queries a specific NTP server, here localhost:123. If the connection can't be established, it probably means ntpd service isn't started.

NTP status:
ntpq: read: Connection refused

Solution: <code>service ntpd start</code>

== References ==
;NTP
* [https://www.ntppool.org/zone/fr NTP servers in France]
* [https://bugs.ntp.org/show_bug.cgi?id=3898 Bug 3898] - update leap seconds file
;Chrony
* [https://chrony-project.org/ Chrony]

Operations grimoire/NTP

2025-11-27T19:17:32Z

Ptdradmin: /* FreeBSD */

NTP allows to sync time. That's especially important for accurate logs and TLS certificates.

== Recommended NTP servers ==
There is a CC list of servers by country. France makes sense for most servers to use the country of the datacenter where the server is located.

== By OS ==
NTP is configured in core.

=== FreeBSD ===
We use ntpd service. Each day, drift from NTP servers is checked by periodic <code>480.status-ntpd</code>.

We have enabled the automatic startup of the '''ntpd''' service on all FreeBSD servers to ensure continuous time synchronization. Additionally, the '''ntpd''' configuration has been adjusted to allow automatic connections to time sources, ensuring reliable updates without any manual intervention.

For reference, see:<br>

* [rOPS27946aeb13d1 Start ntpd](https://devcentral.nasqueron.org/rOPS27946aeb13d18e3e54b72aabf170bd66e111ca88)
* [D3893](https://devcentral.nasqueron.org/D3893)

=== Linux ===
Chrony service is used.

== Troubleshoot ==
=== Update leap seconds ===
Leap seconds file isn't maintained any more by NTP package (see [https://bugs.ntp.org/show_bug.cgi?id=3898 upstream issue])

To update the file, run the hotfix:

$ salt -G 'os:FreeBSD' state.apply hotfixes/leap-seconds.sls

=== ntpq: read: Connection refused ===
Reported as {{T|2192}}. The ntpq command queries a specific NTP server, here localhost:123. If the connection can't be established, it probably means ntpd service isn't started.

NTP status:
ntpq: read: Connection refused

Solution: <code>service ntpd start</code>

== References ==
;NTP
* [https://www.ntppool.org/zone/fr NTP servers in France]
* [https://bugs.ntp.org/show_bug.cgi?id=3898 Bug 3898] - update leap seconds file
;Chrony
* [https://chrony-project.org/ Chrony]

Operations grimoire/NTP

2025-11-27T19:17:02Z

Ptdradmin: /* NTP Service Configuration on FreeBSD */

NTP allows to sync time. That's especially important for accurate logs and TLS certificates.

== Recommended NTP servers ==
There is a CC list of servers by country. France makes sense for most servers to use the country of the datacenter where the server is located.

== By OS ==
NTP is configured in core.

=== FreeBSD ===
We use ntpd service. Each day, drift from NTP servers is checked by periodic <code>480.status-ntpd</code>.
We have enabled the automatic startup of the '''ntpd''' service on all FreeBSD servers to ensure continuous time synchronization. Additionally, the '''ntpd''' configuration has been adjusted to allow automatic connections to time sources, ensuring reliable updates without any manual intervention.

For reference, see:<br>

* [rOPS27946aeb13d1 Start ntpd](https://devcentral.nasqueron.org/rOPS27946aeb13d18e3e54b72aabf170bd66e111ca88)
* [D3893](https://devcentral.nasqueron.org/D3893)

=== Linux ===
Chrony service is used.

== Troubleshoot ==
=== Update leap seconds ===
Leap seconds file isn't maintained any more by NTP package (see [https://bugs.ntp.org/show_bug.cgi?id=3898 upstream issue])

To update the file, run the hotfix:

$ salt -G 'os:FreeBSD' state.apply hotfixes/leap-seconds.sls

=== ntpq: read: Connection refused ===
Reported as {{T|2192}}. The ntpq command queries a specific NTP server, here localhost:123. If the connection can't be established, it probably means ntpd service isn't started.

NTP status:
ntpq: read: Connection refused

Solution: <code>service ntpd start</code>

== References ==
;NTP
* [https://www.ntppool.org/zone/fr NTP servers in France]
* [https://bugs.ntp.org/show_bug.cgi?id=3898 Bug 3898] - update leap seconds file
;Chrony
* [https://chrony-project.org/ Chrony]

Operations grimoire/NTP

2025-11-27T16:45:15Z

Ptdradmin: /* NTP Service Configuration on FreeBSD */

NTP allows to sync time. That's especially important for accurate logs and TLS certificates.

== Recommended NTP servers ==
There is a CC list of servers by country. France makes sense for most servers to use the country of the datacenter where the server is located.

== By OS ==
NTP is configured in core.

=== FreeBSD ===
We use ntpd service. Each day, drift from NTP servers is checked by periodic <code>480.status-ntpd</code>.
== NTP Service Configuration on FreeBSD ==

We have enabled the automatic startup of the '''ntpd''' service on all FreeBSD servers to ensure continuous time synchronization. Additionally, the '''ntpd''' configuration has been adjusted to allow automatic connections to time sources, ensuring reliable updates without any manual intervention.

For reference, see:
* [rOPS27946aeb13d1 Start ntpd](https://devcentral.nasqueron.org/rOPS27946aeb13d18e3e54b72aabf170bd66e111ca88)
* [D3893](https://devcentral.nasqueron.org/D3893)

=== Linux ===
Chrony service is used.

== Troubleshoot ==
=== Update leap seconds ===
Leap seconds file isn't maintained any more by NTP package (see [https://bugs.ntp.org/show_bug.cgi?id=3898 upstream issue])

To update the file, run the hotfix:

$ salt -G 'os:FreeBSD' state.apply hotfixes/leap-seconds.sls

=== ntpq: read: Connection refused ===
Reported as {{T|2192}}. The ntpq command queries a specific NTP server, here localhost:123. If the connection can't be established, it probably means ntpd service isn't started.

NTP status:
ntpq: read: Connection refused

Solution: <code>service ntpd start</code>

== References ==
;NTP
* [https://www.ntppool.org/zone/fr NTP servers in France]
* [https://bugs.ntp.org/show_bug.cgi?id=3898 Bug 3898] - update leap seconds file
;Chrony
* [https://chrony-project.org/ Chrony]

Operations grimoire/NTP

2025-11-27T16:44:14Z

Ptdradmin: /* FreeBSD */

NTP allows to sync time. That's especially important for accurate logs and TLS certificates.

== Recommended NTP servers ==
There is a CC list of servers by country. France makes sense for most servers to use the country of the datacenter where the server is located.

== By OS ==
NTP is configured in core.

=== FreeBSD ===
We use ntpd service. Each day, drift from NTP servers is checked by periodic <code>480.status-ntpd</code>.
== NTP Service Configuration on FreeBSD ==

We have enabled the automatic startup of the '''ntpd''' service on all FreeBSD servers to ensure continuous time synchronization. Additionally, the '''ntpd''' configuration has been adjusted to allow automatic connections to time sources, ensuring reliable updates without any manual intervention.

For reference, see:
* [rOPS27946aeb13d18e3e54b72aabf170bd66e111ca88](https://devcentral.nasqueron.org/rOPS27946aeb13d18e3e54b72aabf170bd66e111ca88)
* [D3893](https://devcentral.nasqueron.org/D3893)

=== Linux ===
Chrony service is used.

== Troubleshoot ==
=== Update leap seconds ===
Leap seconds file isn't maintained any more by NTP package (see [https://bugs.ntp.org/show_bug.cgi?id=3898 upstream issue])

To update the file, run the hotfix:

$ salt -G 'os:FreeBSD' state.apply hotfixes/leap-seconds.sls

=== ntpq: read: Connection refused ===
Reported as {{T|2192}}. The ntpq command queries a specific NTP server, here localhost:123. If the connection can't be established, it probably means ntpd service isn't started.

NTP status:
ntpq: read: Connection refused

Solution: <code>service ntpd start</code>

== References ==
;NTP
* [https://www.ntppool.org/zone/fr NTP servers in France]
* [https://bugs.ntp.org/show_bug.cgi?id=3898 Bug 3898] - update leap seconds file
;Chrony
* [https://chrony-project.org/ Chrony]

Operations grimoire/NTP

2025-11-27T16:16:06Z

Ptdradmin: /* FreeBSD */

NTP allows to sync time. That's especially important for accurate logs and TLS certificates.

== Recommended NTP servers ==
There is a CC list of servers by country. France makes sense for most servers to use the country of the datacenter where the server is located.

== By OS ==
NTP is configured in core.

=== FreeBSD ===
We use ntpd service. Each day, drift from NTP servers is checked by periodic <code>480.status-ntpd</code>.
We configured the ntpd to allow it to connect automatically. : https://devcentral.nasqueron.org/rOPS27946aeb13d18e3e54b72aabf170bd66e111ca88 or https://devcentral.nasqueron.org/D3893

=== Linux ===
Chrony service is used.

== Troubleshoot ==
=== Update leap seconds ===
Leap seconds file isn't maintained any more by NTP package (see [https://bugs.ntp.org/show_bug.cgi?id=3898 upstream issue])

To update the file, run the hotfix:

$ salt -G 'os:FreeBSD' state.apply hotfixes/leap-seconds.sls

=== ntpq: read: Connection refused ===
Reported as {{T|2192}}. The ntpq command queries a specific NTP server, here localhost:123. If the connection can't be established, it probably means ntpd service isn't started.

NTP status:
ntpq: read: Connection refused

Solution: <code>service ntpd start</code>

== References ==
;NTP
* [https://www.ntppool.org/zone/fr NTP servers in France]
* [https://bugs.ntp.org/show_bug.cgi?id=3898 Bug 3898] - update leap seconds file
;Chrony
* [https://chrony-project.org/ Chrony]

Dev zone/Create devserver access/fr

2025-11-26T14:50:45Z

Ptdradmin:

= Guide complet : Configuration de l'accès devserver avec Git et Arcanist =

Ce guide explique comment configurer votre environnement de développement pour contribuer au projet Operations.

== 1. Création du dossier de travail ==

Créez un dossier sur votre PC Windows pour organiser tous les fichiers du projet :

<syntaxhighlight lang="powershell">
C:\STAGE 2025
</syntaxhighlight>

C'est dans ce dossier que vous allez ranger tout ce qui concerne le projet Operations.

----

== 2. Récupération et clonage du dépôt Operations ==

=== 2.1 Récupération de l'URL du dépôt ===

Rendez-vous sur la page du dépôt :
* https://devcentral.nasqueron.org/source/operations/

Copiez l'URL Git pour pouvoir cloner le projet.

=== 2.2 Clonage du dépôt ===

Ouvrez PowerShell et placez-vous dans votre dossier :

<syntaxhighlight lang="powershell">
cd "C:\STAGE 2025"
git clone https://devcentral.nasqueron.org/source/operations.git
</syntaxhighlight>

Git crée un dossier <code>operations</code> avec tous les fichiers du projet.

----

== 3. Gestion de Git et création de branche dans WSL ==

=== 3.1 Se placer dans le dossier du projet ===

Depuis WSL (Ubuntu), placez-vous dans le dossier du projet :

<syntaxhighlight lang="bash">
cd /mnt/c/STAGE\ 2025/operations
</syntaxhighlight>

=== 3.2 Création d'une nouvelle branche ===

Créez une nouvelle branche pour vos modifications :

<syntaxhighlight lang="bash">
git switch -c feature/add-gui-user
</syntaxhighlight>

Avertissement|Si la branche existe déjà, Git affichera :
<code>fatal: a branch named 'feature/add-gui-user' already exists</code>

Dans ce cas, basculez simplement sur la branche existante :
<syntaxhighlight lang="bash">
git switch feature/add-gui-user
</syntaxhighlight>

----

== 4. Modifications dans les fichiers du dépôt ==

=== 4.1 Vérification de l'emplacement des fichiers ===

Vérifiez où se trouvent les vrais fichiers <code>users.sls</code> et <code>groups.sls</code> :

<syntaxhighlight lang="bash">
ls -la pillar/core/
</syntaxhighlight>

Important|Les vrais fichiers sont dans <code>pillar/core/</code>, pas dans <code>operations/pillar/core/</code>.

=== 4.2 Ajout de votre utilisateur dans users.sls ===

Ouvrez le fichier avec VS Code :
<syntaxhighlight>
pillar/core/users.sls
</syntaxhighlight>

Ajoutez votre utilisateur dans la section <code>shellusers:</code> par ordre alphabétique :

<syntaxhighlight lang="yaml">
ptdradmin:
fullname: Doba Gui
ssh_keys:
- ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIAFtlR4OeXNHfJXNrvrLeU9nGu7ufcxc38xUGqlwiY5L doba.guimartinien@gmail.com
uid: 1001
</syntaxhighlight>

=== 4.3 Ajout de votre compte dans groups.sls ===

Ouvrez également le fichier :
<syntaxhighlight>
pillar/core/groups.sls
</syntaxhighlight>

Ajoutez-vous dans le groupe <code>nasqueron</code> :

<syntaxhighlight lang="yaml">
shellgroups:
Members:
- ptdradmin
</syntaxhighlight>

----

== 5. Commit des modifications ==

=== 5.1 Suppression des fichiers créés par erreur ===

Si vous avez créé des fichiers vides dans <code>operations/</code> :

<syntaxhighlight lang="bash">
rm -rf operations/
</syntaxhighlight>

=== 5.2 Ajout des bons fichiers ===

<syntaxhighlight lang="bash">
git add pillar/core/users.sls pillar/core/groups.sls
</syntaxhighlight>

=== 5.3 Commit des changements ===

<syntaxhighlight lang="bash">
git commit -m "Ajout de Doba Gui comme user et dans le groupe core"
</syntaxhighlight>

=== 5.4 Vérification du commit ===

<syntaxhighlight lang="bash">
git show HEAD
</syntaxhighlight>

Vérifiez que vous voyez seulement les lignes que vous avez vraiment modifiées.

=== 5.5 Modification du dernier commit (si nécessaire) ===

Si vous avez corrigé des fichiers après le commit :

<syntaxhighlight lang="bash">
git commit --amend
</syntaxhighlight>

----

== 6. Premier essai de arc diff (échec - arc n'existe pas) ==

Essayez de lancer :

<syntaxhighlight lang="bash">
arc diff
</syntaxhighlight>

'''Erreur attendue :'''
<syntaxhighlight>
arc: command not found
</syntaxhighlight>

Il faut installer Arcanist.

----

== 7. Installation d'Arcanist avec WSL ==

=== Pourquoi installer Arcanist ? ===

Arcanist (ou <code>arc</code>) est l'outil officiel de ligne de commande pour interagir avec Phabricator, le système de revue de code utilisé par le projet Operations.

* Il permet de créer, mettre à jour et soumettre des révisions (<code>arc diff</code>) directement depuis votre environnement local
* Il gère les linters et les tests automatiques configurés par le projet avant l'envoi de modifications
* Sans Arcanist, vous ne pouvez pas soumettre vos changements pour revue ni intégrer les vérifications automatiques du projet

=== 7.1 Mise à jour d'Ubuntu ===

Avant d'installer quoi que ce soit :

<syntaxhighlight lang="bash">
sudo apt update
sudo apt upgrade -y
</syntaxhighlight>

=== 7.2 Installation des dépendances ===

Arcanist a besoin de PHP et Git :

<syntaxhighlight lang="bash">
sudo apt install -y php-cli php-curl php-xml php-mbstring git curl unzip
</syntaxhighlight>

=== 7.3 Téléchargement d'Arcanist ===

Création d'un dossier pour Arcanist :

<syntaxhighlight lang="bash">
mkdir -p ~/phabricator
cd ~/phabricator
</syntaxhighlight>

Téléchargement des fichiers :

<syntaxhighlight lang="bash">
git clone https://github.com/phacility/arcanist.git
git clone https://github.com/phacility/libphutil.git
</syntaxhighlight>

=== 7.4 Rendre arc accessible partout ===

Pour ne pas devoir écrire tout le chemin :

<syntaxhighlight lang="bash">
sudo ln -s ~/phabricator/arcanist/bin/arc /usr/local/bin/arc
</syntaxhighlight>

Si le cache Bash ne reconnaît pas la commande :

<syntaxhighlight lang="bash">
hash -r
</syntaxhighlight>

=== 7.5 Vérification de l'installation ===

Test de la commande :

<syntaxhighlight lang="bash">
arc version
</syntaxhighlight>

Note|Une erreur sur shellcheck-linter peut apparaître, mais la version devrait s'afficher. Répondre "y" pour continuer.

----

== 8. Deuxième essai de arc diff (échec - authentification requise) ==

Retournez dans le projet :

<syntaxhighlight lang="bash">
cd /mnt/c/STAGE\ 2025/operations
arc diff
</syntaxhighlight>

'''Erreur attendue :'''
<syntaxhighlight>
YOU NEED TO AUTHENTICATE TO CONTINUE
</syntaxhighlight>

Il faut installer le certificat.

----

== 9. Authentification Arcanist ==

=== Pourquoi exécuter arc install-certificate ? ===

Cette commande permet d'associer votre environnement local à votre compte Phabricator via un token sécurisé.

* Elle est nécessaire pour que Arcanist puisse créer, mettre à jour et soumettre vos révisions (<code>arc diff</code>) sur le serveur Phabricator
* Sans ce certificat, Arcanist ne peut pas authentifier vos commandes et toutes les opérations de soumission de code échoueront
* Le token est spécifique à votre compte et doit être généré depuis l'interface web de Phabricator

=== 9.1 Installation du certificat ===

<syntaxhighlight lang="bash">
arc install-certificate
</syntaxhighlight>

Suivez le lien fourni, récupérez le token API et collez-le dans le terminal. Arcanist est maintenant connecté à votre compte.

----

== 10. Troisième essai de arc diff (échec - shellcheck-linter manquant) ==

<syntaxhighlight lang="bash">
arc diff
</syntaxhighlight>

Arc vous demande de choisir la branche de référence, choisissez <code>origin/main</code>.

'''Nouvelle erreur :'''
<syntaxhighlight>
Failed to load library at location "shellcheck-linter"
</syntaxhighlight>

----

== 11. Installation de shellcheck-linter ==

<syntaxhighlight lang="bash">
cd ~/phabricator
git clone https://github.com/pinterest/arcanist-linters.git shellcheck-linter
</syntaxhighlight>

----

== 12. Quatrième essai de arc diff (échec - linter invalide) ==

Retournez dans le projet :

<syntaxhighlight lang="bash">
cd /mnt/c/STAGE\ 2025/operations
arc diff
</syntaxhighlight>

'''Nouvelle erreur :'''
<syntaxhighlight>
Linter 'shell' specifies invalid type 'shellcheck'
</syntaxhighlight>

Le type <code>shellcheck</code> n'est pas reconnu.

----

== 13. Correction du linter shellcheck ==

Ouvrez <code>.arclint</code> avec VS Code et modifiez :

'''Avant :'''
<syntaxhighlight lang="json">
"shell": {
"type": "shellcheck",
"include": ["(\\.sh$)"]
}
</syntaxhighlight>

'''Après :'''
<syntaxhighlight lang="json">
"shell": {
"type": "text",
"include": ["(\\.sh$)"]
}
</syntaxhighlight>

Avertissement|Ne pas commiter ce changement, c'est juste pour que ça fonctionne localement.

'''Alternative :''' Bypass des tests si nécessaire :

<syntaxhighlight lang="bash">
arc diff --nolint
</syntaxhighlight>

----

== 14. Cinquième essai de arc diff (échec - problème CRLF) ==

<syntaxhighlight lang="bash">
arc diff
</syntaxhighlight>

Arc détecte 1,011 fichiers modifiés. C'est un problème de fins de ligne Windows/Linux.

=== 14.1 Correction des problèmes de fins de ligne ===

<syntaxhighlight lang="bash">
git config --global core.autocrlf input
git restore .
</syntaxhighlight>

Avertissement|Assurez-vous d'être bien dans <code>/mnt/c/STAGE\ 2025/operations</code> avant d'exécuter ces commandes.

----

== 15. Sixième essai de arc diff (succès !) ==

=== 15.1 Vérification de l'état de Git ===

Pour vous assurer qu'il n'y a pas de fichiers non suivis :

<syntaxhighlight lang="bash">
git status
</syntaxhighlight>

'''Résultat attendu :''' Aucun fichier non commité ne doit apparaître.

=== 15.2 Lancement d'Arcanist ===

<syntaxhighlight lang="bash">
arc diff
</syntaxhighlight>

Arc vous demande si vous voulez amend les changements dans <code>.arclint</code> :
<syntaxhighlight>
Do you want to amend these 1 change(s) to the current commit? [y/N] y
</syntaxhighlight>

Puis il vous demande si vous voulez utiliser le message sauvegardé :
<syntaxhighlight>
Do you want to use this message? [Y/n] Y
</syntaxhighlight>

=== 15.3 Remplissage des informations de révision ===

L'éditeur (nano) s'ouvre avec les informations à remplir :

<syntaxhighlight>
Summary: Ajout de Doba Gui comme user et dans le groupe core
Test Plan: Vérification de la syntaxe YAML et des informations utilisateur
Reviewers: dereckson
Subscribers:
</syntaxhighlight>

=== 15.4 Sauvegarde dans nano ===

# '''Sauvegarder le fichier :'''
#* Appuyez sur '''Ctrl + O''' (la lettre O, pas zéro)
#* Nano vous demandera le nom du fichier → appuyez sur '''Entrée''' pour garder le même
# '''Quitter nano :'''
#* Appuyez sur '''Ctrl + X'''

Après ça, vous retournez dans votre terminal et <code>arc diff</code> continuera le processus.

=== 15.5 Pour mettre à jour une révision existante ===

Si vous voulez mettre à jour une révision existante (ex. : D3888) :

<syntaxhighlight lang="bash">
arc diff --update D3888
</syntaxhighlight>

----

== 16. Vérification finale ==

Vérifiez que tout est propre :

<syntaxhighlight lang="bash">
git status
</syntaxhighlight>

Aucun fichier ne doit rester non commité.

Assurez-vous que votre révision contient bien vos modifications :

<syntaxhighlight lang="bash">
arc diff
</syntaxhighlight>

Succès|À ce stade, votre révision est prête à être relue par votre reviewer.

----

== Résumé des problèmes rencontrés ==

{| class="wikitable"
! Problème !! Solution
|-
| Fichiers vides dans operations/ || <code>rm -rf operations/</code> puis travailler dans <code>pillar/core/</code>
|-
| Cache Bash pour arc || <code>hash -r</code>
|-
| Authentification manquante || <code>arc install-certificate</code>
|-
| Bibliothèque shellcheck-linter manquante || Cloner dans <code>~/phabricator/</code>
|-
| Erreur linter shellcheck || Changer <code>"type": "shellcheck"</code> en <code>"type": "text"</code> dans <code>.arclint</code>
|-
| Problème CRLF/LF || <code>git config --global core.autocrlf input</code> puis <code>git restore .</code>
|}

----

== Points importants à retenir ==

Avertissement|
* '''Toutes les commandes Git et Arcanist doivent être exécutées dans <code>/mnt/c/STAGE\ 2025/operations</code>, et non dans <code>~/phabricator</code>.'''
* '''Ne pas commiter les modifications du fichier <code>.arclint</code> (changement de shellcheck en text).'''
* '''Les vrais fichiers sont dans <code>pillar/core/</code>, pas dans <code>operations/pillar/core/</code>.'''

[[Category:Contributor guide]]
[[Category:Reference]]
[[Category:Internship guide]]

Dev zone/Create devserver access/fr

2025-11-19T14:35:39Z

Ptdradmin: Created page with "= Guide complet : Configuration de l'accès devserver avec Git et Arcanist = Ce guide explique comment configurer votre environnement de développement pour contribuer au projet Operations. == 1. Création du dossier de travail == Créez un dossier sur votre PC Windows pour organiser tous les fichiers du projet : <syntaxhighlight lang="powershell"> C:\STAGE 2025 </syntaxhighlight> C'est dans ce dossier que vous allez ranger tout ce qui concerne le projet Operations...."

= Guide complet : Configuration de l'accès devserver avec Git et Arcanist =

Ce guide explique comment configurer votre environnement de développement pour contribuer au projet Operations.

== 1. Création du dossier de travail ==

Créez un dossier sur votre PC Windows pour organiser tous les fichiers du projet :

<syntaxhighlight lang="powershell">
C:\STAGE 2025
</syntaxhighlight>

C'est dans ce dossier que vous allez ranger tout ce qui concerne le projet Operations.

----

== 2. Récupération et clonage du dépôt Operations ==

=== 2.1 Récupération de l'URL du dépôt ===

Rendez-vous sur la page du dépôt :
* https://devcentral.nasqueron.org/source/operations/

Copiez l'URL Git pour pouvoir cloner le projet.

=== 2.2 Clonage du dépôt ===

Ouvrez PowerShell et placez-vous dans votre dossier :

<syntaxhighlight lang="powershell">
cd "C:\STAGE 2025"
git clone https://devcentral.nasqueron.org/source/operations.git
</syntaxhighlight>

Git crée un dossier <code>operations</code> avec tous les fichiers du projet.

----

== 3. Gestion de Git et création de branche dans WSL ==

=== 3.1 Se placer dans le dossier du projet ===

Depuis WSL (Ubuntu), placez-vous dans le dossier du projet :

<syntaxhighlight lang="bash">
cd /mnt/c/STAGE\ 2025/operations
</syntaxhighlight>

=== 3.2 Création d'une nouvelle branche ===

Créez une nouvelle branche pour vos modifications :

<syntaxhighlight lang="bash">
git switch -c feature/add-gui-user
</syntaxhighlight>

Avertissement|Si la branche existe déjà, Git affichera :
<code>fatal: a branch named 'feature/add-gui-user' already exists</code>

Dans ce cas, basculez simplement sur la branche existante :
<syntaxhighlight lang="bash">
git switch feature/add-gui-user
</syntaxhighlight>

----

== 4. Modifications dans les fichiers du dépôt ==

=== 4.1 Vérification de l'emplacement des fichiers ===

Vérifiez où se trouvent les vrais fichiers <code>users.sls</code> et <code>groups.sls</code> :

<syntaxhighlight lang="bash">
ls -la pillar/core/
</syntaxhighlight>

Important|Les vrais fichiers sont dans <code>pillar/core/</code>, pas dans <code>operations/pillar/core/</code>.

=== 4.2 Ajout de votre utilisateur dans users.sls ===

Ouvrez le fichier avec VS Code :
<syntaxhighlight>
pillar/core/users.sls
</syntaxhighlight>

Ajoutez votre utilisateur dans la section <code>shellusers:</code> par ordre alphabétique :

<syntaxhighlight lang="yaml">
ptdradmin:
fullname: Doba Gui
ssh_keys:
- ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIAFtlR4OeXNHfJXNrvrLeU9nGu7ufcxc38xUGqlwiY5L doba.guimartinien@gmail.com
uid: 1001
</syntaxhighlight>

=== 4.3 Ajout de votre compte dans groups.sls ===

Ouvrez également le fichier :
<syntaxhighlight>
pillar/core/groups.sls
</syntaxhighlight>

Ajoutez-vous dans le groupe <code>core</code> :

<syntaxhighlight lang="yaml">
core:
Members:
- ptdradmin
</syntaxhighlight>

----

== 5. Commit des modifications ==

=== 5.1 Suppression des fichiers créés par erreur ===

Si vous avez créé des fichiers vides dans <code>operations/</code> :

<syntaxhighlight lang="bash">
rm -rf operations/
</syntaxhighlight>

=== 5.2 Ajout des bons fichiers ===

<syntaxhighlight lang="bash">
git add pillar/core/users.sls pillar/core/groups.sls
</syntaxhighlight>

=== 5.3 Commit des changements ===

<syntaxhighlight lang="bash">
git commit -m "Ajout de Doba Gui comme user et dans le groupe core"
</syntaxhighlight>

=== 5.4 Vérification du commit ===

<syntaxhighlight lang="bash">
git show HEAD
</syntaxhighlight>

Vérifiez que vous voyez seulement les lignes que vous avez vraiment modifiées.

=== 5.5 Modification du dernier commit (si nécessaire) ===

Si vous avez corrigé des fichiers après le commit :

<syntaxhighlight lang="bash">
git commit --amend
</syntaxhighlight>

----

== 6. Premier essai de arc diff (échec - arc n'existe pas) ==

Essayez de lancer :

<syntaxhighlight lang="bash">
arc diff
</syntaxhighlight>

'''Erreur attendue :'''
<syntaxhighlight>
arc: command not found
</syntaxhighlight>

Il faut installer Arcanist.

----

== 7. Installation d'Arcanist avec WSL ==

=== Pourquoi installer Arcanist ? ===

Arcanist (ou <code>arc</code>) est l'outil officiel de ligne de commande pour interagir avec Phabricator, le système de revue de code utilisé par le projet Operations.

* Il permet de créer, mettre à jour et soumettre des révisions (<code>arc diff</code>) directement depuis votre environnement local
* Il gère les linters et les tests automatiques configurés par le projet avant l'envoi de modifications
* Sans Arcanist, vous ne pouvez pas soumettre vos changements pour revue ni intégrer les vérifications automatiques du projet

=== 7.1 Mise à jour d'Ubuntu ===

Avant d'installer quoi que ce soit :

<syntaxhighlight lang="bash">
sudo apt update
sudo apt upgrade -y
</syntaxhighlight>

=== 7.2 Installation des dépendances ===

Arcanist a besoin de PHP et Git :

<syntaxhighlight lang="bash">
sudo apt install -y php-cli php-curl php-xml php-mbstring git curl unzip
</syntaxhighlight>

=== 7.3 Téléchargement d'Arcanist ===

Création d'un dossier pour Arcanist :

<syntaxhighlight lang="bash">
mkdir -p ~/phabricator
cd ~/phabricator
</syntaxhighlight>

Téléchargement des fichiers :

<syntaxhighlight lang="bash">
git clone https://github.com/phacility/arcanist.git
git clone https://github.com/phacility/libphutil.git
</syntaxhighlight>

=== 7.4 Rendre arc accessible partout ===

Pour ne pas devoir écrire tout le chemin :

<syntaxhighlight lang="bash">
sudo ln -s ~/phabricator/arcanist/bin/arc /usr/local/bin/arc
</syntaxhighlight>

Si le cache Bash ne reconnaît pas la commande :

<syntaxhighlight lang="bash">
hash -r
</syntaxhighlight>

=== 7.5 Vérification de l'installation ===

Test de la commande :

<syntaxhighlight lang="bash">
arc version
</syntaxhighlight>

Note|Une erreur sur shellcheck-linter peut apparaître, mais la version devrait s'afficher. Répondre "y" pour continuer.

----

== 8. Deuxième essai de arc diff (échec - authentification requise) ==

Retournez dans le projet :

<syntaxhighlight lang="bash">
cd /mnt/c/STAGE\ 2025/operations
arc diff
</syntaxhighlight>

'''Erreur attendue :'''
<syntaxhighlight>
YOU NEED TO AUTHENTICATE TO CONTINUE
</syntaxhighlight>

Il faut installer le certificat.

----

== 9. Authentification Arcanist ==

=== Pourquoi exécuter arc install-certificate ? ===

Cette commande permet d'associer votre environnement local à votre compte Phabricator via un token sécurisé.

* Elle est nécessaire pour que Arcanist puisse créer, mettre à jour et soumettre vos révisions (<code>arc diff</code>) sur le serveur Phabricator
* Sans ce certificat, Arcanist ne peut pas authentifier vos commandes et toutes les opérations de soumission de code échoueront
* Le token est spécifique à votre compte et doit être généré depuis l'interface web de Phabricator

=== 9.1 Installation du certificat ===

<syntaxhighlight lang="bash">
arc install-certificate
</syntaxhighlight>

Suivez le lien fourni, récupérez le token API et collez-le dans le terminal. Arcanist est maintenant connecté à votre compte.

----

== 10. Troisième essai de arc diff (échec - shellcheck-linter manquant) ==

<syntaxhighlight lang="bash">
arc diff
</syntaxhighlight>

Arc vous demande de choisir la branche de référence, choisissez <code>origin/main</code>.

'''Nouvelle erreur :'''
<syntaxhighlight>
Failed to load library at location "shellcheck-linter"
</syntaxhighlight>

----

== 11. Installation de shellcheck-linter ==

<syntaxhighlight lang="bash">
cd ~/phabricator
git clone https://github.com/pinterest/arcanist-linters.git shellcheck-linter
</syntaxhighlight>

----

== 12. Quatrième essai de arc diff (échec - linter invalide) ==

Retournez dans le projet :

<syntaxhighlight lang="bash">
cd /mnt/c/STAGE\ 2025/operations
arc diff
</syntaxhighlight>

'''Nouvelle erreur :'''
<syntaxhighlight>
Linter 'shell' specifies invalid type 'shellcheck'
</syntaxhighlight>

Le type <code>shellcheck</code> n'est pas reconnu.

----

== 13. Correction du linter shellcheck ==

Ouvrez <code>.arclint</code> avec VS Code et modifiez :

'''Avant :'''
<syntaxhighlight lang="json">
"shell": {
"type": "shellcheck",
"include": ["(\\.sh$)"]
}
</syntaxhighlight>

'''Après :'''
<syntaxhighlight lang="json">
"shell": {
"type": "text",
"include": ["(\\.sh$)"]
}
</syntaxhighlight>

Avertissement|Ne pas commiter ce changement, c'est juste pour que ça fonctionne localement.

'''Alternative :''' Bypass des tests si nécessaire :

<syntaxhighlight lang="bash">
arc diff --nolint
</syntaxhighlight>

----

== 14. Cinquième essai de arc diff (échec - problème CRLF) ==

<syntaxhighlight lang="bash">
arc diff
</syntaxhighlight>

Arc détecte 1,011 fichiers modifiés. C'est un problème de fins de ligne Windows/Linux.

=== 14.1 Correction des problèmes de fins de ligne ===

<syntaxhighlight lang="bash">
git config --global core.autocrlf input
git restore .
</syntaxhighlight>

Avertissement|Assurez-vous d'être bien dans <code>/mnt/c/STAGE\ 2025/operations</code> avant d'exécuter ces commandes.

----

== 15. Sixième essai de arc diff (succès !) ==

=== 15.1 Vérification de l'état de Git ===

Pour vous assurer qu'il n'y a pas de fichiers non suivis :

<syntaxhighlight lang="bash">
git status
</syntaxhighlight>

'''Résultat attendu :''' Aucun fichier non commité ne doit apparaître.

=== 15.2 Lancement d'Arcanist ===

<syntaxhighlight lang="bash">
arc diff
</syntaxhighlight>

Arc vous demande si vous voulez amend les changements dans <code>.arclint</code> :
<syntaxhighlight>
Do you want to amend these 1 change(s) to the current commit? [y/N] y
</syntaxhighlight>

Puis il vous demande si vous voulez utiliser le message sauvegardé :
<syntaxhighlight>
Do you want to use this message? [Y/n] Y
</syntaxhighlight>

=== 15.3 Remplissage des informations de révision ===

L'éditeur (nano) s'ouvre avec les informations à remplir :

<syntaxhighlight>
Summary: Ajout de Doba Gui comme user et dans le groupe core
Test Plan: Vérification de la syntaxe YAML et des informations utilisateur
Reviewers: dereckson
Subscribers:
</syntaxhighlight>

=== 15.4 Sauvegarde dans nano ===

# '''Sauvegarder le fichier :'''
#* Appuyez sur '''Ctrl + O''' (la lettre O, pas zéro)
#* Nano vous demandera le nom du fichier → appuyez sur '''Entrée''' pour garder le même
# '''Quitter nano :'''
#* Appuyez sur '''Ctrl + X'''

Après ça, vous retournez dans votre terminal et <code>arc diff</code> continuera le processus.

=== 15.5 Pour mettre à jour une révision existante ===

Si vous voulez mettre à jour une révision existante (ex. : D3888) :

<syntaxhighlight lang="bash">
arc diff --update D3888
</syntaxhighlight>

----

== 16. Vérification finale ==

Vérifiez que tout est propre :

<syntaxhighlight lang="bash">
git status
</syntaxhighlight>

Aucun fichier ne doit rester non commité.

Assurez-vous que votre révision contient bien vos modifications :

<syntaxhighlight lang="bash">
arc diff
</syntaxhighlight>

Succès|À ce stade, votre révision est prête à être relue par votre reviewer.

----

== Résumé des problèmes rencontrés ==

{| class="wikitable"
! Problème !! Solution
|-
| Fichiers vides dans operations/ || <code>rm -rf operations/</code> puis travailler dans <code>pillar/core/</code>
|-
| Cache Bash pour arc || <code>hash -r</code>
|-
| Authentification manquante || <code>arc install-certificate</code>
|-
| Bibliothèque shellcheck-linter manquante || Cloner dans <code>~/phabricator/</code>
|-
| Erreur linter shellcheck || Changer <code>"type": "shellcheck"</code> en <code>"type": "text"</code> dans <code>.arclint</code>
|-
| Problème CRLF/LF || <code>git config --global core.autocrlf input</code> puis <code>git restore .</code>
|}

----

== Points importants à retenir ==

Avertissement|
* '''Toutes les commandes Git et Arcanist doivent être exécutées dans <code>/mnt/c/STAGE\ 2025/operations</code>, et non dans <code>~/phabricator</code>.'''
* '''Ne pas commiter les modifications du fichier <code>.arclint</code> (changement de shellcheck en text).'''
* '''Les vrais fichiers sont dans <code>pillar/core/</code>, pas dans <code>operations/pillar/core/</code>.'''

Catégorie:Documentation
Catégorie:Guide de contribution
Catégorie:Développement