Aller au contenu

Guide de démarrage rapide

Ce guide vous permet de déployer tous les services du serveur IA en moins de 10 minutes.

Prérequis

  • ✅ Serveur IA accessible en SSH (ProbatioVault-IA-Server)
  • ✅ GitLab Runner enregistré sur le serveur
  • ✅ Git configuré en local

Étape 1 : Configurer GitLab CI/CD

1.1 Ajouter la variable vault password

  1. Aller sur https://gitlab.com/probatiovault/probatiovault-ia-server/-/settings/ci_cd
  2. Section Variables → Expand
  3. Add variable :
  4. Key : ANSIBLE_VAULT_PASSWORD
  5. Value : YsepMjCo/T1y2M79RsZYW52CWNDW+k3PL98WFu+7Jb4=
  6. Flags : ☑️ Mask variable, ☑️ Protect variable
  7. Save variables

1.2 Copier vault.yml sur le serveur

# Depuis votre machine locale
scp /Users/loic/Developpement/ProbatioVault/ProbatioVault-IA-Server/ansible/vault.yml \
  ProbatioVault-IA-Server:/opt/probatiovault-ia-server/ansible/vault.yml

Vérification :

ssh ProbatioVault-IA-Server
ls -la /opt/probatiovault-ia-server/ansible/vault.yml
# Doit afficher : -rw-r--r-- 1 loic loic ... vault.yml
exit

Étape 2 : Déclencher le pipeline

2.1 Accéder aux pipelines GitLab

Ouvrir : https://gitlab.com/probatiovault/probatiovault-ia-server/-/pipelines

Le dernier push a déclenché un pipeline automatiquement.

2.2 Déployer les services (ordre recommandé)

Dans l'interface GitLab :

  1. Cliquer sur le pipeline le plus récent (status: manual)
  2. Onglet Jobs
  3. Lancer les jobs dans cet ordre :

Job 1 : Ollama (LLM)

  • Cliquer sur ▶️ ansible:install-ollama
  • Attendre ~10 minutes (téléchargement des modèles ~60 GB)
  • Vérifier les logs : doit afficher "✅ Ollama deployed successfully"
  • Tester : http://192.168.1.82:11434/api/tags

Job 2 : Plex (Media Server)

  • Cliquer sur ▶️ ansible:install-plex
  • Attendre ~2 minutes
  • Vérifier les logs : doit afficher "✅ Plex deployed successfully"
  • Tester : http://192.168.1.82:32400/web

Job 3 : Homer (Dashboard)

  • Cliquer sur ▶️ ansible:install-homer
  • Attendre ~1 minute
  • Vérifier les logs : doit afficher "✅ Homer deployed successfully"
  • Tester : http://192.168.1.82:8080

Job 4 : MkDocs (Documentation)

  • Cliquer sur ▶️ ansible:install-mkdocs
  • Attendre ~2 minutes
  • Vérifier les logs : doit afficher "✅ MkDocs deployed successfully"
  • Tester : http://192.168.1.82:8000

Étape 3 : Vérification finale

3.1 Vérifier tous les services

Ouvrir ces URLs dans votre navigateur :

3.2 Vérifier via SSH (optionnel)

ssh ProbatioVault-IA-Server

# Ollama
systemctl status ollama
curl http://localhost:11434/api/tags

# Plex
systemctl status plexmediaserver
mount | grep plex  # Doit afficher le montage NAS

# Homer
systemctl status nginx
curl http://localhost:8080

# MkDocs
systemctl status mkdocs
curl http://localhost:8000

exit

Étape 4 : Configuration initiale

4.1 Configurer Plex

  1. Ouvrir http://192.168.1.82:32400/web
  2. Se connecter avec un compte Plex (gratuit)
  3. Ajouter une bibliothèque :
  4. Cliquer sur + Add Library
  5. Type : Films, Séries TV, Musique, etc.
  6. Folder : /mnt/nas/plex/Movies, /mnt/nas/plex/TV Shows, etc.
  7. Lancer le scan initial

4.2 Tester Ollama

# Depuis votre machine locale
curl http://192.168.1.82:11434/api/generate -d '{
  "model": "llama3.3:70b-instruct-q4_K_M",
  "prompt": "Quelle est la capitale de la France ?",
  "stream": false,
  "options": {
    "num_ctx": 8192,
    "num_gpu": 999
  }
}'

Ou via le skill /ollama :

/ollama -m llama3.3:70b "Quelle est la capitale de la France ?"

4.3 Personnaliser Homer

  1. SSH sur le serveur :
ssh ProbatioVault-IA-Server
sudo vim /data/homer/config.yml

  1. Ajouter vos services personnalisés (voir docs/dashboard-setup.md)

  2. Redémarrer Nginx :

sudo systemctl restart nginx

Troubleshooting rapide

Job échoue : "Runner not found"

ssh ProbatioVault-IA-Server
sudo gitlab-runner status
sudo gitlab-runner start

Job échoue : "vault.yml not found"

# Copier le vault depuis local
scp ansible/vault.yml ProbatioVault-IA-Server:/opt/probatiovault-ia-server/ansible/

Service ne démarre pas

ssh ProbatioVault-IA-Server
sudo journalctl -u <service-name> -n 50 --no-pager
# Exemples : ollama, plexmediaserver, nginx, mkdocs

Plex ne voit pas les médias

ssh ProbatioVault-IA-Server
mount | grep plex  # Vérifier le montage NAS
sudo -u plex ls /mnt/nas/plex  # Vérifier les permissions

Résumé

Durée totale estimée : ~15 minutes (dont ~10 min pour Ollama)

Services déployés :

Service Port Statut
Homer 8080 ✅
MkDocs 8000 ✅
Ollama 11434 ✅
Plex 32400 ✅

Point d'entrée : http://192.168.1.82:8080 (Homer Dashboard)

Documentation complète :

🎉 Félicitations ! Votre serveur IA est opérationnel.