Vai al contenuto

Docker: API e WEB RealTestData in esecuzione su Docker

Questa documentazione descrive come installare un motore Docker e come installare ed eseguire un’immagine Docker locale dell’API e del WEB RealTestData da Windows, Mac e Linux

Passaggio 1: Installa un IDE o un demone compatibile con Docker

Su Windows

Opzione 1: Docker Desktop (consigliata)

  1. Scarica Docker Desktop
  2. Vai su https://www.docker.com/products/docker-desktop/
  3. Scarica Docker Desktop per Windows

  4. Richiede Windows 10/11 Pro, Enterprise o Education (64 bit)

  5. Installa Docker Desktop

  6. Esegui il programma di installazione come amministratore
  7. Segui la procedura guidata di installazione
  8. Abilita l’integrazione con WSL 2 quando richiesto

  9. Riavvia il computer al termine dell’installazione

  10. Avvia Docker Desktop

  11. Avvia Docker Desktop dal menu Start
  12. Attendi l’avvio del motore Docker (icona a forma di balena nella barra delle applicazioni)

  13. Dovresti vedere “Docker Desktop” “in esecuzione”

  14. Verifica installazione

docker --version
docker run hello-world

Opzione 2: Docker Engine (solo riga di comando)

  1. Abilita WSL 2
# Esegui in PowerShell come amministratore
wsl --install
  1. Installa Docker Engine in WSL 2
# Nel terminale WSL 2
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
sudo usermod -aG docker $USER

Opzione 3: Rancher Desktop (alternativa)

  1. Scarica da https://rancherdesktop.io/
  2. Installa e configura con dockerd runtime
  3. Verifica con docker --version

Requisiti di sistema

  • Versione Windows 10 2004 o superiore (Build 19041 o superiore)
  • Funzionalità WSL 2 abilitata
  • Virtualizzazione abilitata nel BIOS
  • Almeno 4 GB di RAM (8 GB consigliati)

Risoluzione dei problemi

  • Se Docker Desktop non si avvia, assicurarsi che la virtualizzazione sia abilitata nel BIOS
  • Per problemi con WSL 2, eseguire: wsl --update
  • Verificare le funzionalità di Windows: Attivare/disattivare le funzionalità di Windows → Abilitare “Piattaforma macchina virtuale” e “Sottosistema Windows per Linux”

Su Mac

Opzione 1: Docker Desktop (consigliata)

  1. Scarica Docker Desktop
  2. Vai su https://www.docker.com/products/docker-desktop/
  3. Scegli la versione appropriata:
  4. Apple Silicon (M1/M2/M3): Scarica “Mac con chip Apple”

  5. Intel Mac: Scarica “Mac con chip Intel”

  6. Installa Docker Desktop

  7. Apri il file scaricato File .dmg
  8. Trascina Docker nella cartella Applicazioni
  9. Avvia Docker da Applicazioni

  10. Concedi le autorizzazioni necessarie quando richiesto

  11. Avvia Docker Desktop

  12. Docker si avvierà automaticamente dopo l’installazione
  13. Cerca l’icona di Docker Whale nella barra dei menu

  14. Fai clic sull’icona per visualizzare “Docker Desktop è in esecuzione”

  15. Verifica installazione

docker --version
docker run hello-world

Opzione 2: Docker Engine tramite Homebrew

  1. Installa Homebrew (se non già installato)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  1. Installa Docker
brew install docker
brew install docker-compose
  1. Avvia Docker Service
brew services start docker

Opzione 3: Rancher Desktop (alternativa)

  1. Scarica da https://rancherdesktop.io/
  2. Installa il pacchetto .dmg
  3. Configura con il runtime dockerd
  4. Verifica con docker --version

Requisiti di sistema (Mac)

  • macOS 10.15 o successivo
  • Almeno 4 GB di RAM (8 GB consigliati)
  • VirtualBox precedente alla versione 4.3.30 non deve essere installato

Su Linux

Opzione 1: Docker Engine (repository ufficiale)

Per Ubuntu/Debian: 1. Aggiorna l’indice dei pacchetti

sudo apt-get update
sudo apt-get install ca-certificates curl gnupg lsb-release
  1. Aggiungi la chiave GPG ufficiale di 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. Configura il repository
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. Installa Docker Engine
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
  1. Aggiungi utente al gruppo Docker
sudo usermod -aG docker $USER
newgrp docker

Per CentOS/RHEL/Fedora: 1. Installa usando 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. Avvia il servizio Docker
sudo system

ctl start docker
sudo systemctl enable docker
  1. Aggiungi utente al gruppo Docker
sudo usermod -aG docker $USER

Opzione 2: Docker Desktop per Linux

  1. Scarica da https://www.docker.com/products/docker-desktop/
  2. Installa il pacchetto
# Ubuntu/Debian
sudo dpkg -i docker-desktop-<versione>-<arch>.deb

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

Opzione 3: Script di installazione rapida

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

Requisiti di sistema (Linux)

  • Supporto kernel e CPU a 64 bit per la virtualizzazione
  • Supporto per la virtualizzazione KVM
  • QEMU deve essere versione 5.2 o successiva
  • systemd init system
  • Almeno 4 GB di RAM (8 GB consigliati)

Verifica dell’installazione (tutte le piattaforme)

Dopo l’installazione su qualsiasi piattaforma, verifica il funzionamento di Docker:

docker --version
docker run hello-world
docker ps

Dovresti visualizzare: - Informazioni sulla versione di Docker - Messaggio “Hello from Docker!” - Elenco dei container vuoto (inizialmente)

Passaggio 2: Scarica ed esegui le immagini Docker di RealTestData

RealTestData ha 2 immagini Docker e diversi volumi Docker con dati. Per installare ed eseguire le immagini come container, forniamo uno script per Windows e Mac/Linux.

Scaricando il nostro pacchetto API-WEB, sono inclusi 4 file:

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

Eseguendo questo script, le immagini verranno scaricate o aggiornate da DockerHub.

Le immagini RTDVOLS scaricano/aggiornano tutti i volumi necessari e li aggiungono al repository locale o li aggiornano nel repository locale.

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

Questi script servono per avviare i container solo in caso di arresto. Non è necessario eseguire rtdall-start una seconda volta, quando tutto è disponibile in locale e aggiornato.

Aggiorna regolarmente tutti i volumi.

Verifica le risorse Docker disponibili localmente

Prima di eseguire gli script, puoi verificare quali immagini e volumi Docker sono già disponibili localmente:

Verifica le immagini Docker

# Elenca tutte le immagini Docker locali
immagini Docker

# Verifica un'immagine specifica
immagini Docker realtestdata/rtdapi
immagini Docker realtestdata/rtdweb
immagini Docker realtestdata/rtdvols

Verifica i volumi Docker

# Elenca tutti i volumi Docker locali
docker volume ls

# Ottieni informazioni dettagliate su un volume specifico
docker volume inspect configdata
docker volume inspect resultdata

Verifica i container in esecuzione

# Elenca tutti i container in esecuzione
docker ps

# Elenca tutti i container (in esecuzione e arrestati)
docker ps -a

Verifica le reti Docker

# Elenca tutto reti
docker network ls

Panoramica completa del sistema

# Ottiene informazioni complete sul sistema Docker
docker system df

# Mostra l'utilizzo del disco da parte dei componenti Docker
docker system df -v

# Mostra informazioni di sistema dettagliate
docker info

Risorse locali previste

Dopo aver eseguito correttamente gli script di installazione, dovresti vedere:

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

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

Rete: - rtdnet

Contenitori in esecuzione: - rtdapi-container (porta 8000) - rtdweb-container (porta 5000)

Passaggio 3 - Eseguire il Webclient RealTestData

Prima di accedere alla WebUI, verificare che l’API sia in esecuzione: localhost:8000 dovrebbe visualizzare “Questa è l’API RealTestData”.

Ora apri un browser web a tua scelta e inserisci localhost:5000 come URL. Dovresti visualizzare la homepage di RealTestData. Per accedere, devi registrarti tramite “Registrati”. Verrà creato un utente di prova. È possibile creare fino a 2 utenti di prova. Esistono già 2 utenti di prova: trial/trial test/test

Con “Genera” puoi generare il file dei risultati che verrà scaricato. Una volta che questo funziona, controlla le diverse impostazioni.

Passaggio 4 - Utilizzo dell’API senza il webclient.

È possibile utilizzare l’API senza il webclient. È possibile trovare un esempio Python nel file Zip: RealTestData_API_Generate.py. Quando si richiama l’API in un browser web e si digita localhost:8000/docs/en, si troverà la documentazione API in inglese (o in de - tedesco o in cz - ceco).

Chiamando localhost:8000/generate_live verranno generati i dati specificati nel client web come flusso JSON. È possibile integrare questo flusso nella pipeline CI/CD.