Un laboratorio autonomo per chi conosce le basi dei database e ha poca esperienza JavaScript. Il catalogo comprende 46 microprove, incluse 14 nuove sfide sugli aggiornamenti. Il percorso essenziale dura circa tre ore stimate, con ambiente già pronto; il consolidamento è separato. La durata e l’autonomia non sono ancora validate con studenti rappresentativi.
Scarica o clona questo repository; se usi uno ZIP, estrailo completamente. Nell’editor scegli Apri cartella e seleziona quella con questo README e compose.yaml. Apri il terminale dell’editor in quella cartella. Non lavorare dentro lo ZIP.
Servono Docker funzionante con Compose, un editor e Internet per il download iniziale. MongoDB 8.0.30 e mongosh sono nell’immagine fissata per digest multiarch: non installarli a parte. Su Windows/macOS avvia Docker Desktop; su Linux serve Docker Engine con plugin Compose. Consigliati 6 GiB disponibili per Docker. I comandi Docker qui sotto funzionano come righe singole in PowerShell, Bash e terminale macOS; non richiedono Bash sul computer. La verifica della portabilità effettiva è riportata nelle evidenze.
Esegui una riga alla volta nel terminale del computer:
docker --version
docker compose version
docker compose -f compose.yaml -p mongodb-day1 config --quiet
docker compose -f compose.yaml -p mongodb-day1 pull mongodb mongodb-check lab checkL’ultimo comando scarica l’unica immagine necessaria. Dopo il download il percorso usa soltanto il repository e Docker; i collegamenti esterni presenti nei materiali sono facoltativi. Se qualcosa fallisce, segui la diagnosi.
docker compose -f compose.yaml -p mongodb-day1 up --wait --wait-timeout 120 mongodb mongodb-check
docker compose -f compose.yaml -p mongodb-day1 run --rm lab doctor
docker compose -f compose.yaml -p mongodb-day1 run --rm lab shellProsegui quando doctor mostra MongoDB raggiungibile: OK. L’ultimo comando apre mongosh. Per riconoscere il contesto e il risultato di un comando esegui lì:
db.getName()
db.runCommand({ping: 1})
exitVedrai shop e un risultato con ok: 1. Questo controllo non inserisce dati ed è distinto dalla prima attività valutata. Ora sei di nuovo nel terminale del computer.
Apri la scheda create: contiene dati iniziali, obiettivo, sintassi, domande e comandi completi. Segui Comprendi → Prevedi → Motiva → Prova → Confronta → Correggi → Trasferisci.
Scrivi nei file indicati sotto risposte/percorso/, dentro la funzione già predisposta. Salva con Ctrl+S o Cmd+S. Non cambiare file in un’altra cartella e controlla che l’estensione sia .js, non .js.txt. Nei file JS non incollare comandi Docker o delimitatori Markdown. La guida alla sintassi è nel prontuario locale.
I tre comandi hanno responsabilità distinte (esempio per create):
docker compose -f compose.yaml -p mongodb-day1 run --rm lab reset create
docker compose -f compose.yaml -p mongodb-day1 run --rm lab run create
docker compose -f compose.yaml -p mongodb-day1 run --rm check createreset prepara gli input e le regole in shop; elimina e ricrea le sei collection didattiche, le destinazioni e i marker del laboratorio. Le altre collection restano intatte. run esegue il file salvato e mostra il risultato: non resetta e non ritenta automaticamente. Ripetere una scrittura può cambiarne l’effetto. check usa database temporanei su un altro MongoDB, prepara ogni scenario e controlla risultati, stato e varianti; non modifica la pratica o i file risposta.
Una prova è VERIFICATA quando soddisfa i requisiti automatici. ERRORE AMBIENTE riguarda Docker, preparazione o verificatore; ERRORE ESECUZIONE riguarda caricamento, funzione o query; DA CORREGGERE indica un requisito non rispettato. Le schede con errore MongoDB atteso sono identificate nel percorso: un errore di caricamento non può superarle. Annota anche ciò che il check non valuta: motivazione e previsione.
Segui il percorso completo per ordine e tempi. Per elencare le prove o verificare un gruppo:
docker compose -f compose.yaml -p mongodb-day1 run --rm lab list
docker compose -f compose.yaml -p mongodb-day1 run --rm check core
docker compose -f compose.yaml -p mongodb-day1 run --rm check consolidamento
docker compose -f compose.yaml -p mongodb-day1 run --rm check allI gruppi eseguono i tuoi file attuali: non aspettarti che un template incompleto superi il check. Nessuna prova dipende dall’esecuzione di un’altra. Completa i quiz su carta o in un file personale, motivando la scelta prima dell’autocorrezione.
| Materiale | Uso |
|---|---|
| Percorso, matrice slide/competenze | Scegliere essenziale, consolidamento o consultazione |
| Prontuario, diagnosi | Sintassi e recupero operativo |
| Catalogo unico | ID, caso, livello, file, ripetizioni e varianti |
schede/percorso/, suggerimenti/percorso/ |
Consegne e tre indizi progressivi |
risposte/percorso/ |
File da completare |
| Correzione e soluzioni commentate | Soluzioni sempre disponibili, senza tentativi minimi, attese o sblocchi; risposte ai quiz separate dalle domande |
fixtures/, verifier/, scripts/ |
Dati e meccanismo di esecuzione e controllo |
| Baseline Giorno 2, ponte facoltativo | Preparazione e indici/explain |
| Fonti e adattamenti, evidenze | Correttezza tecnica, limiti e tempi misurati |
Le precedenti risposte direttamente in risposte/ sono conservate e non sono lette dal nuovo catalogo. Non copiarle sopra i nuovi template: si riferiscono a dataset differenti. Anche le vecchie soluzioni direttamente in soluzioni/ sono materiale precedente, distinto da soluzioni/percorso/.
Quando hai finito le esercitazioni:
docker compose -f compose.yaml -p mongodb-day1 run --rm lab reset day2Attendi Baseline day2-v1: OK. Il comando ricrea la baseline deterministica in shop, non conserva le scritture delle esercitazioni. Non lanciare altri reset Giorno 1 dopo questo passaggio se vuoi mantenere pronta la baseline.
docker compose -f compose.yaml -p mongodb-day1 stopstop conserva il volume di pratica. Per ripartire ripeti l’avvio della sezione 2. Evita down -v se vuoi conservare i dati: elimina i volumi.
Compass è facoltativo: connettiti a mongodb://127.0.0.1:27017/shop. La shell del container vede i file sotto /workspace, non i percorsi del computer. Le fonti originali usano shop_day1; il laboratorio adatta il nome a shop e autorizza solo i database temporanei del check nel reset. Dati, campi e regole dei 23 casi rimangono quelli sorgenti.
Il repository include controlli automatici su ogni push e pull request: verifica editoriale, collegamenti, script shell, configurazione Compose e suite MongoDB isolata. Per riprodurre gli stessi controlli localmente usa python3 tests/static_check.py e bash tests/acceptance.sh. Le regole per nuove schede, fixture e segnalazioni sono in CONTRIBUTING.md; per problemi che possono coinvolgere sicurezza o dati esterni consulta SECURITY.md.
Prima di pubblicare, verifica la licenza scelta dal titolare e controlla che git status --short --ignored mostri soltanto artefatti locali esclusi da .gitignore. Non aggiungere .codegraph/, .serena/, .env, dump, log o percorsi della macchina.
Il repository non impone ancora una licenza: scegli e aggiungi il testo della licenza prima di dichiarare il riuso di codice e materiali didattici. In assenza di una licenza, il copyright resta al titolare e GitHub non concede automaticamente permessi di riuso.
Prima di pubblicare soluzioni/fonti/, verifica anche di avere il diritto di redistribuire il testo delle slide e delle note originali eventualmente incluso nel corso.