Admin : Mise en place et documentation d’exploitation DSH

2026-08-21T23:30:54Z

Mise en place et documentation d’exploitation DSH

Nouvelle page

= Trace install tas - DeepSeek Harness (DSH) =


== Rôle et état ==

DeepSeek Harness (<code>dsh</code>) fournit une interface Web d’agent de codage reliée au modèle Qwen3.8 servi par Ollama ROCm local. L’installation est réalisée sur <code>tas</code> en Podman rootless, avec une image locale versionnée :

* image : <code>localhost/deepseek-harness:0.1.0-rc.7</code> ;
* conteneur : <code>deepseek-harness</code> ;
* interface locale : <code>http://127.0.0.1:3080</code> ;
* commande exécutée dans le conteneur : <code>dsh web --host 127.0.0.1 --port 3080 --no-open</code> ;
* fournisseur : Ollama ROCm sur <code>http://127.0.0.1:11434/v1</code> ;
* modèle par défaut : <code>qwen3.8-q8-256k:latest</code>.

Le service n’est pas exposé directement sur le réseau : le réseau host est utilisé uniquement pour permettre à DSH d’atteindre Ollama sur la boucle locale, tandis que DSH écoute lui-même sur <code>127.0.0.1:3080</code>.

Mise en place vérifiée le 22 août 2026 :

* <code>deepseek-harness.service</code> est actif ;
* <code>deepseek-harness-autostart.service</code> est actif et activé ;
* le conteneur répond HTTP 200 sur <code>http://127.0.0.1:3080/</code> ;
* l’image locale utilisée est <code>localhost/deepseek-harness:0.1.0-rc.7</code> ;
* la commande <code>dsh</code> n’est pas installée sur l’hôte : elle est exécutée dans le conteneur, ce qui évite de mélanger l’installation DSH avec les outils de l’utilisateur <code>loic</code>.


== Fichiers et stockage ==

* Quadlet : <code>/home/loic/.config/containers/systemd/deepseek-harness.container</code>
* Volume workspace : <code>/home/loic/.config/containers/systemd/deepseek-harness-workspace.volume</code>
* Volume d’état : <code>/home/loic/.config/containers/systemd/deepseek-harness-state.volume</code>
* Wrapper d’automatisation : <code>/home/loic/.config/systemd/user/deepseek-harness-autostart.service</code>
* Workspace persistant : Nextcloud <code>/minidev/deepseek-harness</code>
* État et journaux : volume Podman <code>deepseek-harness-state</code>

Le workspace est monté dans le conteneur sous <code>/workspace</code>. L’état DSH est monté sous <code>/root/.dsh</code> et n’est pas mélangé au workspace Nextcloud.


== Mode d’automatisation ==

Le runtime est géré par Podman rootless et Quadlet, via systemd utilisateur. <code>deepseek-harness.container</code> génère l’unité <code>deepseek-harness.service</code>. Le wrapper <code>deepseek-harness-autostart.service</code> est une unité <code>oneshot</code> persistante, activée dans <code>default.target</code>, qui tire l’unité Quadlet au démarrage de la session utilisateur.

Le conteneur redémarre automatiquement après une panne grâce à :

<syntaxhighlight lang="ini">Restart=on-failure
RestartSec=10
TimeoutStartSec=900</syntaxhighlight>
Le démarrage automatique ne repose donc pas sur un cron ni sur une commande lancée manuellement à chaque connexion.


== Démarrage ==

Démarrer le wrapper persistant (et donc le service DSH) :

<syntaxhighlight lang="bash">systemctl --user start deepseek-harness-autostart.service</syntaxhighlight>
Le démarrage direct du service généré reste possible :

<syntaxhighlight lang="bash">systemctl --user start deepseek-harness.service</syntaxhighlight>
Après une modification d’un Quadlet, régénérer les unités puis redémarrer :

<syntaxhighlight lang="bash">systemctl --user daemon-reload
systemctl --user restart deepseek-harness.service</syntaxhighlight>
Pour activer le démarrage automatique s’il a été désactivé :

<syntaxhighlight lang="bash">systemctl --user enable deepseek-harness-autostart.service</syntaxhighlight>

== Arrêt ==

Arrêt normal du service généré :

<syntaxhighlight lang="bash">systemctl --user stop deepseek-harness.service</syntaxhighlight>
Pour arrêter également le wrapper persistant :

<syntaxhighlight lang="bash">systemctl --user stop deepseek-harness-autostart.service</syntaxhighlight>
Pour empêcher le redémarrage automatique à la prochaine session, désactiver le wrapper :

<syntaxhighlight lang="bash">systemctl --user disable deepseek-harness-autostart.service</syntaxhighlight>
Ces commandes arrêtent le service et le conteneur, mais ne suppriment ni l’image, ni les volumes, ni les données du workspace.

Pour un arrêt complet et explicite :

<syntaxhighlight lang="bash">systemctl --user stop deepseek-harness-autostart.service
systemctl --user stop deepseek-harness.service</syntaxhighlight>

== Contrôles ==

<syntaxhighlight lang="bash">systemctl --user status deepseek-harness.service
systemctl --user status deepseek-harness-autostart.service
podman ps --filter name=deepseek-harness
curl -fsS http://127.0.0.1:3080/ | head
journalctl --user -u deepseek-harness.service -n 100 --no-pager</syntaxhighlight>
Contrôle de la commande DSH dans le conteneur :

<syntaxhighlight lang="bash">podman exec deepseek-harness dsh --help
podman exec deepseek-harness sh -lc 'find /root/.dsh -maxdepth 2 -type f -print'</syntaxhighlight>
Le service utilise le réseau hôte, mais DSH et Caddy restent liés à la boucle locale ; aucun port DSH n’est publié directement sur le réseau.


== Mise à jour contrôlée ==

L’image actuellement utilisée est une image locale épinglée. Avant toute évolution, sauvegarder les Quadlets, le workspace <code>/minidev/deepseek-harness</code> et le volume d’état <code>deepseek-harness-state</code>. Après remplacement validé de l’image ou modification d’un Quadlet :

<syntaxhighlight lang="bash">systemctl --user daemon-reload
systemctl --user restart deepseek-harness.service
systemctl --user is-active deepseek-harness.service
curl -fsS http://127.0.0.1:3080/ >/dev/null</syntaxhighlight>
Ne pas supprimer l’ancienne image ni les volumes tant que le nouveau service n’a pas été validé.


== Retour arrière et précautions ==

La version DSH est épinglée à <code>0.1.0-rc.7</code>. Pour revenir à l’état précédent, arrêter et désactiver le wrapper ; aucune suppression n’est nécessaire :

<syntaxhighlight lang="bash">systemctl --user disable --now deepseek-harness-autostart.service</syntaxhighlight>
Les autres services locaux (OpenClaw, Ollama, Caddy et SGLang) ne sont pas modifiés par cette installation.

Trace install tas - DeepSeek Harness (DSH) - Historique des versions

Admin : Mise en place et documentation d’exploitation DSH

Admin : Mise en place et documentation d’exploitation DSH