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..."

2025-12-18T10:16:11Z

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..."

New page

= 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

Fr - Revision history