SLB05 | Web-Soul | Installer Debian

Installer Docker sur Debian

Docker permet d'exécuter les différents composants de Web-Soul dans des conteneurs isolés. Cette étape consiste à installer Docker et à vérifier que le service fonctionne correctement.

1. Mettre Debian à jour

Avant toute installation, commencez par mettre à jour la liste des paquets :

sudo apt update

Puis installez les mises à jour disponibles :

sudo apt upgrade -y

Vous pouvez vérifier la version de Debian avec :

cat /etc/os-release

Résultat attendu

Le système doit indiquer qu'il s'agit de Debian 13.

2. Installer Docker

Installez les paquets nécessaires :

sudo apt install docker.io docker-compose-plugin -y

Une fois l'installation terminée, vérifiez la version de Docker :

docker --version
docker compose version

Vous devriez obtenir une réponse comparable à :

Docker version 29.x.x
Docker Compose version v2.x.x

3. Vérifier le service Docker

Vérifiez que le service est actif :

sudo systemctl status docker

Si nécessaire, démarrez le service :

sudo systemctl start docker

Et activez son démarrage automatique :

sudo systemctl enable docker

4. Tester Docker

Le test le plus simple consiste à lancer le conteneur officiel hello-world :

sudo docker run hello-world

Si Docker fonctionne correctement, le conteneur affiche un message confirmant que l'installation fonctionne.

5. Utiliser Docker Compose

Web-Soul utilisera Docker Compose pour décrire les différents services de la plateforme.

Créez un répertoire de travail :

mkdir -p ~/web-soul
cd ~/web-soul

Créez ensuite un fichier nommé compose.yml.

Voici un exemple minimal :

services:

  hello:
    image: hello-world

Le fichier peut ensuite être lancé avec :

docker compose up

6. Exemple de configuration JSON

Certains composants de Web-Soul utilisent également des données au format JSON.

{
  "project": "Web-Soul",
  "version": "0.5",
  "services": [
    "traefik",
    "ollama",
    "qdrant",
    "n8n"
  ]
}

7. Exemple de code JavaScript

Le guide pourra également contenir des exemples de scripts JavaScript :

const project = "Web-Soul";

function showProject() {
    console.log(`Projet : ${project}`);
}

showProject();

8. Exemple de PHP

<?php

function web_soul_version() {
    return "0.5";
}

echo web_soul_version();

9. Exemple HTML

Un exemple de HTML peut être présenté directement dans le guide :

<section class="web-soul">
    <h2>Web-Soul</h2>
    <p>Plateforme IA modulaire.</p>
</section>

10. Configuration à vérifier

Élément	Valeur attendue	Vérification
Système	Debian 13	cat /etc/os-release
Docker	Installé	docker --version
Docker Compose	Disponible	docker compose version
Service Docker	Actif	systemctl status docker

11. Points importants

• Travaillez avec un utilisateur disposant des droits nécessaires.
• Vérifiez les commandes avant de les exécuter sur un serveur de production.
• Conservez les fichiers de configuration dans un répertoire clairement identifié.
• Évitez de modifier plusieurs composants simultanément pendant une phase de test.

À retenir

1. Mettre Debian à jour.
2. Installer Docker.
3. Vérifier le service Docker.
4. Tester un premier conteneur.
5. Préparer Docker Compose.

12. Liens internes

Après cette étape, vous pourrez poursuivre avec la préparation du serveur ou passer directement à l'installation de Traefik.

Vous pourrez également revenir à l'index du guide Web-Soul pour consulter les autres étapes.

Conclusion

Docker constitue la base technique sur laquelle les différents services de Web-Soul pourront être déployés. Une fois Docker installé et vérifié, nous pouvons commencer à construire l'infrastructure proprement dite.

Fin du test.