Eseguire e testare il container in locale

Prima della distribuzione, esegua il container sulla propria macchina. Trovare i bug locally è molto meno costoso che eseguire il debug nel cloud.

Avvii l'immagine con docker run. Senza il mapping delle porte il container viene eseguito, ma nulla sull'host può raggiungere l'API al suo interno.

Il flag -p associa una porta dell'host alla porta del container. Ora localhost:8000 raggiunge l'API del modello in esecuzione all'interno.

Aggiunga -d per scollegarsi dal processo ed eseguirlo in background. Il terminale rimane libero mentre il servizio continua a rispondere.

Verifichi cosa è attivo con docker ps. Il comando mostra l'ID di ogni container, l'immagine, lo stato e le porte mappate.

Confermi che il servizio sia attivo chiamando il suo endpoint /health. Una risposta 200 indica che è pronto a ricevere previsioni.

Invii un payload di esempio con POST a /predict e legga il risultato. In questo modo verifica che il modello venga caricato e risponda dall'inizio alla fine.

Quando qualcosa non sembra corretto, controlli docker logs. Il container scrive gli errori di avvio e i trace direttamente nel proprio flusso di log.

Apra una shell in un container in esecuzione con docker exec per ispezionare file o ambiente dall'interno.

Concluda arrestando il container con docker stop. Aggiunga --rm in fase di esecuzione, così il container verrà rimosso automaticamente quando termina.

Se qui viene eseguito senza errori e risponde correttamente, si comporterà allo stesso modo nel cloud. Il Local testing è l'ultimo controllo di sicurezza.

Ha eseguito l'immagine, mappato la port, controllato lo stato di salute, inviato una previsione, letto i log e ripulito l'ambiente. Il container è pronto per il deployment. 🐳