Aggiornamento test + altre fix

Author: Antonio Musarra

images/asciinema/demo_esecuzione_prima_migrazione_full_3x.gif

@@ -10,8 +10,8 @@ layout: default
 
 ## Contatti
 
-- **Email:** [[email protected]]
+- **Email:** [[email protected]] | [[email protected]]
 - **LinkedIn:** [https://www.linkedin.com/in/amusarra/]
 - **Website:** [https://www.sogei.it]
-- **GitHub**: [https://github.com]
+- **My GitHub Repositories**: [https://github.com/amusarra]
 - **My Blog**: [https://www.dontesta.it]

images/background_slide_1.png

@@ -53,4 +53,10 @@ merge changes
 commit id: "v5" tag: "Version 5" type: HIGHLIGHT
 ```
 
-</div>
+</div>
+
+<!--
+Alla pari di qualunque progetto software (C/C++, Erlang, Java, etc.) anche per le DDL/DML del database dovremmo arrivare a una situazione di versioning come quella mostrata.
+
+Soffermarsi un attimo per spiegare il minimo indispensabile su questo diagramma.
+-->

images/repository_esempio_on_github.png

@@ -13,8 +13,10 @@ layout: default
 - **Rollback**
   - La capacità di annullare una migrazione, tornando a una versione precedente dello schema. Questo è utile per gestire errori o modifiche non desiderate.
 - **Script di seed e fixture**
-  - Script utilizzati per popolare il database con dati iniziali o di esempio, necessari per testare l'applicazione.
+  - Script utilizzati per popolare il database con dati iniziali o di esempio, necessari per testare l'applicazione (vedi integration test).
 
 </v-clicks>
 
-
+<!--
+Per la documentazione è preferibile usare l'approccio doc-as-code di cui recentemente ho fatto un post sul gruppo Ready2Learn di Viva Engage o Yammer.
+-->

pages/1_11_about_me.md

@@ -9,7 +9,7 @@ layout: default
 - **Coerenza**
   - Garantisce che tutti i membri del team di sviluppo lavorino con la stessa versione dello schema del database, riducendo il rischio di conflitti e incoerenze.
 - **Tracciabilità**
-  - Ogni modifica al database è tracciata con un record chiaro di chi ha fatto cosa e quando. Questo facilita il debug e la manutenzione.
+  - Ogni modifica al database è tracciata con un record chiaro di chi ha fatto cosa e quando. Questo facilita il debug e la manutenzione; inoltre, è utile per scopi di audit e conformità.
 - **Automazione**
   - Le migrazioni possono essere automatizzate, facilitando l'implementazione delle modifiche in ambienti diversi, come sviluppo, test e produzione.
 - **Riproducibilità**

pages/1_1_introduzione.md

@@ -17,6 +17,15 @@ Per migliorare la sicurezza quando si utilizzano strumenti di <span v-mark.red="
 
 </v-clicks>
 
+<!--
+Per la terza strategia "Utilizzo di un servizio intermedio", è possibile utilizzare tre possibili pattern k8s (Kubernetes) che sono:
+1. Job
+2. Init Container
+3. Operator
+
+Nel caso in cui la propria applicazione sia sviluppata tramite il framewrok Java Quarkus, questo, prevede OOTB dei pattern per assolvere nel modo ottimale all'esecuzione dei task di migrazione.
+-->
+
 ---
 level: 2
 ---
@@ -55,4 +64,4 @@ level: 2
 
   Implementando queste strategie, è possibile ridurre significativamente il rischio associato alla concessione di privilegi elevati agli utenti delle applicazioni durante le migrazioni del database, mantenendo al contempo un flusso di lavoro efficiente per la gestione delle migrazioni stesse.
 
-</div>
+</div>

pages/1_2_componenti_chiave_database_versioning.md

@@ -15,4 +15,7 @@ layout: default
 
 </v-clicks>
 
-
+<!--
+Esistono diversi strumenti a supporto delle attività di versioning del database; qui mostrerò quelli più comuni per l'ambienti Java e Python.
+Flyway e Liquibase sono integrati con i framework Java cloud-native più conosciuti come Spring Boot e Quarkus.
+-->

pages/1_3_benefici_database_versioning.md

@@ -32,4 +32,8 @@ ALTER TABLE users ADD COLUMN last_login TIMESTAMP;
 
   Per eseguire la migrazione è sufficiente eseguire il comando `flyway migrate` nella directory contenente gli script di migrazione.
 
-</v-clicks>
+</v-clicks>
+
+<!--
+Qui vedremo dei semplici script SQL (DDL) di migrazione applicando la migrazione usando Flyway da CLI, senza quindi nessuna integrazione con Quarkus, Spring Boot o altro framework di sviluppo Java.
+-->

pages/1_4_sicurezza_operazioni_deployment.md

@@ -6,12 +6,16 @@ layout: default
 
 Brevemente vedremo com'è strutturato un classico progetto di migrazione del database usando **Flyway** e come gestire le migrazioni attraverso la CLI (Command Line Interface) messa a disposizione. La versione di riferimento è la OSS Edition v10.13.0
 
-<span v-click>Un progetto standard (standalone) in genere include: script di migrazione, configurazione di Flyway e uno script di esecuzione.</span>
+<span v-click>Un progetto standard (standalone) in genere include: script di migrazione, configurazione di Flyway e uno script di esecuzione (quest'ultimo opzionale e costruito sulla base delle proprie esigenze).</span>
 
 <v-clicks>
 
 ```shell {lineNumbers: false}
-.
+# V: Indica che si tratta di una migrazione versionata. È un prefisso obbligatorio.
+# <Version>: Numero di versione della migrazione. Può essere un numero intero (es. 1, 2, 3) o semantic version. Le versioni devono seguire un ordine naturale per Flyway.
+# __: Doppio underscore come separatore tra il numero di versione e la descrizione. È obbligatorio.
+# <Description>: Descrizione della migrazione. Deve essere una stringa descrittiva senza spazi (può usare underscore 
+# _ o trattini - per separare le parole). La descrizione è facoltativa ma consigliata per rendere il file di migrazione leggibile e comprensibile.
 ├── flyway.toml
 ├── migrate.sh
 └── sql
@@ -23,17 +27,35 @@ Brevemente vedremo com'è strutturato un classico progetto di migrazione del dat
 
 </v-clicks>
 
-<br>
-
 <v-clicks>
 
 - **flyway.toml**: contiene le configurazioni di Flyway (comprese le informazioni di connessioni dal database)
 - **migrate.sh**: script shell che esegue la migrazione
 
+</v-clicks>
+
+<div v-click="5"
+   class="top-20 left-40 transition forward:delay-500" style="position: absolute">
+  <img src="/images/repository_esempio_on_github.png" height="80%" width="80%" style="border-style: solid; border-color: #ecf3ec; border-width: 1px"/>
+</div>
+
+<!--
+Come scritto e detto in qualche slide precedente, Flyway (https://flywaydb.org/) è uno strumento Open Source sviluppa da RedGate e fornito in tre diverse edizioni ogni delle quali con caratteristiche diverse che possono essere valutate qui https://www.red-gate.com/products/flyway/editions.
+
 È quindi richiesto avere Flyway installato sulla propria macchina o sulla quella dedicata all'esecuzione dello script. 
 Puoi scaricarlo dal sito ufficiale di Flyway [qui](https://documentation.red-gate.com/fd/command-line-184127404.html).
 
-</v-clicks>
+Tipi di Migrazioni
+Oltre alle migrazioni versionate, Flyway supporta anche altri tipi di migrazioni:
+
+1. Migrazioni Ripetibili: Questi script vengono eseguiti ogni volta che cambiano. Utilizzano il prefisso R al posto di V.
+2. Migrazioni Baseline: Utilizzate per baselining di un database già esistente. Utilizzano il prefisso B al posto di V.
+3. Migrazioni Patch: Utilizzate per correggere i dati senza cambiare la struttura del database. Utilizzano il prefisso P al posto di V.
+
+Il pattern dei file di migrazione può essere configurato tramite le proprietà di Flyway se desideri utilizzare un pattern diverso dal default.
+
+Il progetto di esempio è disponibile sul mio repository GitHub e come potete vedere con l'uso dei tag è possibile gestire le varie versioni dello schema del database.
+-->
 
 ---
 level: 2
@@ -70,6 +92,9 @@ il formato tradizionale (legacy) conf (properties format). Per maggiori consulta
 
 </v-clicks>
 
+<!--
+Tramite la configurazione è possibile diversificare per ambiente di deployment, questo è fondamentale quando occorre agire sui diversi ambienti, come sviluppo, validazione, pre-produzione e produzione, a maggior ragione nel caso in cui volessi sfruttare gli ambienti di CI/CD.
+-->
 
 ---
 level: 2
@@ -256,6 +281,5 @@ level: 2
 A seguire un video che mostra l'esecuzione di una serie di migrazioni partendo da zero. Il video è accelerato 5 volte per questioni di tempo. Qui https://asciinema.org/a/660361 puoi trovare il video completo.
 
 <div class="centered-image">
-<img v-click width="70%" height="70%" src="/images/asciinema/demo_esecuzione_prima_migrazione_full_5x.gif" alt="Esecuzione della prima migrazione del database"/>
+<img v-click width="70%" height="70%" src="/images/asciinema/demo_esecuzione_prima_migrazione_full_3x.gif" alt="Esecuzione della prima migrazione del database"/>
 </div>
-

pages/1_5_strumenti_comuni_database_versioning.md

@@ -40,5 +40,7 @@ level: 2
 3. Risorse Online - Frameworks Java
    - **Quarkus: Using Flyway**: guida ufficiale su come utilizzare Flyway con Quarkus (https://quarkus.io/guides/flyway).
    - **Quarkus: Using Liquibase:** guida ufficiale su come utilizzare Liquibase con Quarkus (https://quarkus.io/guides/liquibase).
+   - **Using Liquibase with Spring Boot**: lo scopo di questo tutorial è guidarti attraverso il processo di utilizzo di Liquibase come parte del flusso di lavoro Spring Boot (https://contribute.liquibase.com/extensions-integrations/directory/integration-docs/springboot/).
+   - **Intro to Database Migrations in Spring Boot 3 with Flyway**: in questo video è mostrato come integrare Flyway in un'applicazione Spring Boot 3 e utilizzarlo per gestire in modo efficace le migrazioni dei database. Concetti di base di Flyway, come la sua configurazione, la creazione ed esecuzione di script di migrazione e il controllo delle versioni del database (https://www.youtube.com/watch?v=p1V5GcKUJv0).
 
 </v-clicks>

pages/1_6_esempio_script_flyway.md

@@ -83,6 +83,14 @@ htmlAttrs:
 }
 </style>
 
+<!--
+Con questa presentazione, vorrei discutere con voi un tema su cui sono abbastanza sensibile; credo che sia giunto il momento di affrontarlo in modo concreto e fare quel passo in più necessario per iniziare il processo di automazione anche per quel che riguarda le basi di dati applicative.
+
+Per facilitare lo svolgimento di questa presentazione, vi prego di mettere da parte tutte le vostre domande che affronteremo alla fine di questa presentazione.
+
+Bene! Iniziamo
+-->
+
 ---
 src: ./pages/1_1_introduzione.md
 ---