Verificare in questo ordine: messaggio iniziale nel log, risposta dell’ endpoint di integrità, stato del container “healthy”.
docker logs mesh-clustering | head -20
curl -k https://localhost:<aussen>/clustering/health
docker inspect --format='{{.State.Health.Status}}' mesh-clusteringI problemi di avvio più comuni:
Il materiale del certificato manca o è denominato in modo errato → il servizio risponde tramite HTTP anziché HTTPS.
Risorse non montate → I processi segnalano che il file CSV del catalogo non può essere elaborato.
Un vecchio container, anche se inattivo, occupa il nome → rimuoverlo .
GPU occupata da un altro processo → il servizio continua a funzionare sulla CPU, correttamente, ma in modo nettamente più lento.
Una richiesta o un preset richiede names.language_model “gemma3”, ma l’immagine predefinita non lo contiene più → l’esecuzione fallisce in fase di runtime. Il messaggio di errore è fuorviante («couldn't connect to huggingface.co»); passare a gemma4 oppure utilizzare un'immagine opt-in che includa gemma3.
Al primo avvio di un'immagine gemma4, il test di funzionamento prevede anche di rilevare il valore di picco effettivo della VRAM con nvidia-smi, fintanto che tale valore non è ancora stato misurato (vedi punto in sospeso nel capitolo 4).
Non appena il servizio è in esecuzione, il server delle applicazioni chiama i quattro endpoint nell’ordine indicato nel capitolo 4 – per la configurazione, consultare la sezione 2.2.