Aller au contenu

Docker: API RealTestData et Web exécutées sur Docker

Cette documentation explique comment installer un moteur Docker et comment installer et exécuter une image Docker locale de l’API RealTestData et du Web sous Windows, Mac et Linux.

Étape 1 - Installer un IDE ou un démon compatible Docker

Sous Windows

Option 1 : Docker Desktop (recommandé)

  1. Télécharger Docker Desktop
  2. Accédez à https://www.docker.com/products/docker-desktop/
  3. Télécharger Docker Desktop pour Windows

  4. Nécessite Windows 10/11 Pro, Enterprise ou Education (64 bits)

  5. Installer Docker Desktop

  6. Exécuter le programme d’installation en tant qu’administrateur
  7. Suivez l’assistant d’installation
  8. Activez l’intégration WSL 2 lorsque vous y êtes invité

  9. Redémarrez votre ordinateur une fois l’installation terminée

  10. Démarrer Docker Desktop

  11. Lancez Docker Desktop depuis le menu Démarrer
  12. Attendez que le moteur Docker démarre (icône en forme de baleine dans la barre d’état système)

  13. Le message « Docker Desktop est en cours d’exécution » devrait s’afficher. statut

  14. Vérifier l’installation

docker --version
docker run hello-world

Option 2 : Moteur Docker (ligne de commande uniquement)

  1. Activer WSL 2
# Exécuter dans PowerShell en tant qu'administrateur
wsl --install
  1. Installer le moteur Docker dans WSL 2
# Dans le terminal WSL 2
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
sudo usermod -aG docker $USER

Option 3 : Rancher Desktop (alternative)

  1. Télécharger depuis https://rancherdesktop.io/
  2. Installer et configurer avec dockerd runtime
  3. Vérifier avec docker --version

Configuration requise

  • Windows 10 version 2004 ou Version supérieure (Build 19041 ou supérieure)
  • Fonctionnalité WSL 2 activée
  • Virtualisation activée dans le BIOS
  • Au moins 4 Go de RAM (8 Go recommandés)

Dépannage

  • Si Docker Desktop ne démarre pas, assurez-vous que la virtualisation est activée dans le BIOS.
  • Pour les problèmes liés à WSL 2, exécutez : « wsl –update »
  • Vérifier les fonctionnalités Windows : Activer/désactiver les fonctionnalités Windows → Activer « Plateforme de machine virtuelle » et « Sous-système Windows pour Linux ».

Sur Mac

Option 1 : Docker Desktop (recommandé)

  1. Télécharger Docker Desktop
  2. Accédez à https://www.docker.com/products/docker-desktop/
  3. Choisissez la version appropriée :
  4. Apple Silicon (M1/M2/M3) : Téléchargez « Mac avec puce Apple »

  5. Intel Mac : Téléchargez « Mac avec puce Intel »

  6. Installer Docker Desktop

  7. Ouvrez le fichier « .dmg » téléchargé
  8. Faites glisser Docker dans le dossier Applications
  9. Lancer Docker depuis Applications

  10. Accorder les autorisations nécessaires lorsque vous y êtes invité

  11. Démarrer Docker Desktop

  12. Docker démarrera automatiquement après l’installation
  13. Rechercher l’icône Docker dans la barre de menus

  14. Cliquer sur l’icône pour voir « Docker Desktop est en cours d’exécution »

  15. Vérifier l’installation

docker --version
docker run hello-world

Option 2 : Moteur Docker via Homebrew

  1. Installer Homebrew (si ce n’est pas déjà fait)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  1. Installer Docker
brew install docker
brew install docker-compose
  1. Démarrer le service Docker
brew services start docker

Option 3 : Rancher Desktop (Alternative)

  1. Télécharger depuis https://rancherdesktop.io/
  2. Installer le paquet « .dmg »
  3. Configurer avec l’environnement d’exécution dockerd
  4. Vérifier avec « docker –version »

Configuration requise (Mac)

  • macOS 10.15 ou version ultérieure
  • Au moins 4 Go de RAM (8 Go recommandés)
  • VirtualBox antérieur à la version 4.3.30 ne doit pas être installé

Sous Linux

Option 1 : Docker Engine (Dépôt officiel)

Pour Ubuntu/Debian : 1. Mettre à jour l’index des paquets

sudo apt-get update
sudo apt-get install ca-certificates curl gnupg lsb-release
  1. Ajouter la clé GPG officielle de Docker
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
  1. Configurer le dépôt
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
  1. Installer le moteur Docker
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
  1. Ajouter un utilisateur au groupe Docker
sudo usermod -aG docker $USER
newgrp docker

Pour CentOS/RHEL/Fedora : 1. Installer avec yum/dnf

# CentOS/RHEL
sudo yum install -y yum-utils
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
sudo yum install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

# Fedora
sudo dnf -y install dnf-plugins-core
sudo dnf config-manager --add-repo https://download.docker.com/linux/fedora/docker-ce.repo
sudo dnf install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
  1. Démarrer le service Docker
sudo system

ctl start docker
sudo systemctl enable docker
  1. Ajouter un utilisateur au groupe docker
sudo usermod -aG docker $USER

Option 2 : Docker Desktop pour Linux

  1. Télécharger depuis https://www.docker.com/products/docker-desktop/
  2. Installer le paquet
# Ubuntu/Debian
sudo dpkg -i docker-desktop-<version>-<arch>.deb

# RHEL/Fedora
sudo rpm -i docker-desktop-<version>-<arch>.rpm

Option 3 : Script d’installation rapide

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
sudo usermod -aG docker $USER

Configuration requise (Linux)

  • Prise en charge du noyau et du processeur 64 bits pour la virtualisation
  • Prise en charge de la virtualisation KVM
  • QEMU doit être en version 5.2 ou ultérieure
  • systemd init system
  • Au moins 4 Go de RAM (8 Go recommandés)

Vérification de l’installation (toutes plateformes)

Après l’installation, quelle que soit la plateforme, vérifiez que Docker fonctionne :

docker --version
docker run hello-world
docker ps

Vous devriez voir : - Informations sur la version de Docker - Message « Bonjour de Docker !» - Liste des conteneurs vide (initialement)

Étape 2 - Télécharger et exécuter les images Docker de RealTestData

RealTestData dispose de deux images Docker et de plusieurs volumes Docker contenant des données. Pour installer et exécuter les images en tant que conteneurs, nous fournissons un script Windows et Mac/Linux.

Lorsque vous avez téléchargé notre package API-WEB, vous trouverez quatre fichiers :

  • rtdall-start.bat pour Windows
  • rtdall-start.sh pour Mac/Linux

Lorsque vous exécutez ce script, les images sont téléchargées ou mises à jour depuis dockerhub. Les images RTDVOLS téléchargent/mettent à jour tous les volumes nécessaires et les ajoutent au référentiel de volumes local ou les mettent à jour dans le référentiel local.

  • rtdall-start-container.bat pour Windows
  • rtdall-start-container.sh pour Mac/Linux

Ces scripts servent uniquement à démarrer les conteneurs en cas d’arrêt. Il n’est pas nécessaire d’exécuter rtdall-start une deuxième fois, une fois que tout est disponible localement et à jour.

Mettez à jour tous les volumes régulièrement.

Vérifier les ressources Docker disponibles localement

Avant d’exécuter les scripts, vous pouvez vérifier les images et volumes Docker déjà disponibles localement :

Vérifier les images Docker

# Lister toutes les images Docker locales
docker images

# Vérifier une image spécifique
docker images realtestdata/rtdapi
docker images realtestdata/rtdweb
docker images realtestdata/rtdvols

Vérifier les volumes Docker

# Lister tous les volumes Docker locaux
docker volume ls

# Obtenir des informations détaillées sur un volume spécifique
docker volume inspect configdata
docker volume inspect resultdata

Vérifier les conteneurs en cours d’exécution

# Lister tous les conteneurs en cours d'exécution
docker ps

# Lister tous les conteneurs (en cours d'exécution et arrêtés)
docker ps -a

Vérifier les réseaux Docker

# Lister tous les réseaux
docker network ls

Terminé Présentation du système

# Obtenir des informations système complètes sur Docker
docker system df

# Afficher l'utilisation du disque par composant Docker
docker system df -v

# Afficher les informations système détaillées
docker info

Ressources locales attendues

Après avoir exécuté les scripts d’installation, vous devriez voir :

Images : - realtestdata/rtdapi:latest - realtestdata/rtdweb:latest - realtestdata/rtdvols:latest

Volumes : - configdata - resultdata - database - full - trial - doc

Réseau : - rtdnet

Conteneurs en cours d’exécution : - rtdapi-container (port 8000) - rtdweb-container (port 5000)

Étape 3 - Exécuter le client web RealTestData

Avant d’accéder à l’interface web, vérifiez que l’API est en cours d’exécution : localhost:8000 devrait afficher « Ceci est l’API RealTestData ».

Ouvrez maintenant le navigateur web de votre choix et saisissez « localhost:5000 » comme URL.

La page d’accueil de RealTestData devrait s’afficher. Pour vous connecter, vous devez vous inscrire via « S’inscrire ». Un utilisateur d’essai sera créé.

Deux utilisateurs d’essai existent déjà : trial/trial test/test

Vous pouvez créer jusqu’à deux utilisateurs d’essai.

Générer permet de générer le fichier de résultats qui sera téléchargé. Une fois que cela fonctionne, vérifiez les différents paramètres.

Étape 4 - Utilisation de l’API sans le client web.

Vous pouvez utiliser l’API sans le client web. Vous trouverez un exemple Python dans le fichier zip : RealTestData_API_Generate.py. Lorsque vous appelez l’API dans un navigateur web et saisissez « localhost:8000/docs/en », vous accédez à la documentation de l’API en anglais (ou en allemand ou en tchèque).

L’appel de « localhost:8000/generate_live » génère les données spécifiées dans le client web sous forme de flux JSON. Vous pouvez intégrer ce flux à votre pipeline CI/CD.