Skip to content
the-byte-sizedPublic

About

No description, website, or topics provided.

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

MongoDB Giorno 1 — parti da qui

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.

1. Prerequisiti e preparazione

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 check

L’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.

2. Avvio e controllo neutro

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 shell

Prosegui 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})
exit

Vedrai 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.

3. Svolgere un esercizio

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 create

reset 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.

4. Percorso e autoverifica

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 all

I 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.

5. Mappa del repository

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/.

6. Prepara il Giorno 2 e chiudi

Quando hai finito le esercitazioni:

docker compose -f compose.yaml -p mongodb-day1 run --rm lab reset day2

Attendi 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 stop

stop 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.

7. Pubblicare e contribuire

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.

About

No description, website, or topics provided.

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages