DevOps Bootcamp · Lezione

Semantic Versioning con i tag

Applichi i principi del Semantic Versioning al progetto e utilizzi i tag Git per contrassegnare i punti significativi della cronologia.

Semantic Versioning con i tag è una lezione DevOps Bootcamp gratuita su CoddyKit. Questa è la lezione 1 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento DevOps Bootcamp, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso DevOps Bootcamp include 4 lezioni in totale.

Che cos'è il versioning del software?

Immagini di costruire una casa. Non vorrebbe usare insieme vecchi progetti e progetti nuovi, vero?

Il versioning del software aiuta a tenere traccia delle modifiche apportate al codice.
Assegna a ogni release un identificatore univoco, ad esempio un numero di versione.
Questo aiuta sviluppatori e utenti a capire cosa è nuovo, cosa è stato corretto e cosa potrebbe non funzionare più.

È fondamentale per gestire le dipendenze e comunicare le modifiche in modo efficace.

Introduzione al Semantic Versioning (SemVer)

Il Semantic Versioning (o SemVer) è uno standard ampiamente adottato per assegnare i numeri di versione.

Utilizza il semplice formato MAJOR.MINOR.PATCH:

MAJOR: per modifiche importanti e incompatibili.
MINOR: per nuove funzionalità compatibili con le versioni precedenti.
PATCH: per piccole correzioni di bug, anch'esse compatibili con le versioni precedenti.

Questo sistema comunica chiaramente l'impatto di una nuova release.

Capire la versione MAJOR

Il numero di versione MAJOR viene incrementato quando si apportano modifiche incompatibili alle API.

Ciò significa che, se qualcuno utilizza il software, l'aggiornamento a una nuova versione MAJOR potrebbe rendere incompatibile il codice esistente.

Esempio: da 1.0.0 a 2.0.0.
Comunichi sempre chiaramente le modifiche incompatibili nelle note di rilascio!

Indica un aggiornamento significativo che richiede l'attenzione degli utenti.

Capire la versione MINOR

La versione MINOR viene incrementata quando si aggiungono nuove funzionalità in modo compatibile con le versioni precedenti.

Gli utenti possono eseguire l'aggiornamento a una nuova versione MINOR senza temere che il codice esistente smetta di funzionare.

Esempio: da 1.2.0 a 1.3.0.
Vengono aggiunte nuove funzionalità, mentre quelle precedenti continuano a funzionare come previsto.

Quando la versione MINOR viene incrementata, la versione PATCH viene reimpostata su 0 (ad esempio, 1.2.5 diventa 1.3.0).

Capire la versione PATCH

La versione PATCH viene incrementata quando si apportano correzioni di bug compatibili con le versioni precedenti.

Si tratta in genere di piccole modifiche interne che non aggiungono nuove funzionalità né rendono incompatibili quelle esistenti.

Esempio: da 1.2.3 a 1.2.4.
Gli utenti possono eseguire l'aggiornamento con tranquillità per ottenere le correzioni dei bug.

Le release PATCH sono spesso fondamentali per la stabilità e la sicurezza.

Perché SemVer è importante

L'adozione del Semantic Versioning offre diversi vantaggi:

Chiarezza: gli sviluppatori comprendono immediatamente l'impatto di un aggiornamento.
Prevedibilità: aiuta a evitare problemi imprevisti nei progetti dipendenti.
Gestione delle dipendenze: gli strumenti possono aggiornare automaticamente alle versioni sicure.
Comunicazione: fornisce un linguaggio comune per parlare delle release.

Contribuisce a creare fiducia e rende lo sviluppo software più solido.

Usare i tag Git per il versioning

Git dispone di una funzionalità chiamata tag che consente di contrassegnare come importanti punti specifici nella cronologia del repository.

È perfetta per contrassegnare le versioni delle release, come v1.0.0 o v2.1.5.

Un tag è simile a un segnalibro permanente che rimanda a uno specifico commit.
Consente di fare facilmente riferimento in seguito a una versione rilasciata del codice.

I tag vengono spesso usati per indicare i punti di rilascio ufficiali nella cronologia di un progetto.

Tag annotati e tag leggeri

Git offre due tipi principali di tag:

Tag leggeri: semplici puntatori a un commit. Sono soltanto un nome.
Tag annotati: oggetti Git completi. Contengono il nome e l'indirizzo email dell'autore del tag, la data e un messaggio.

Per le release, sono preferibili i tag annotati perché memorizzano metadati importanti e possono essere firmati per garantirne l'autenticità.

Consideri un tag annotato come un piccolo commit di release autonomo.

Creare un tag annotato

Per creare un tag annotato, utilizzi il comando git tag -a, seguito dal nome del tag e da un messaggio.

Ecco come contrassegnare la prima release stabile:

git init
echo "Initial content" > README.md
git add README.md
git commit -m "First commit"
git tag -a v1.0.0 -m "Initial stable release"
git log --oneline --decorate

Visualizzare e controllare i tag

Dopo aver creato i tag, può elencarli o visualizzarne i dettagli.

Utilizzi git tag per elencare tutti i tag nel repository.
Utilizzi git show <tagname> per visualizzare il commit associato a un tag e i relativi metadati.

Provi a eseguire l'esempio per vedere come funziona:

git init
echo "Feature A" > a.txt
git add a.txt
git commit -m "Add feature A"
git tag -a v0.1.0 -m "First feature release"
echo "Bug Fix B" > b.txt
git add b.txt
git commit -m "Fix bug B"
git tag -a v0.1.1 -m "Bug B fixed"
git tag
git show v0.1.0

Verifica rapida: impatto di SemVer

Consideri un progetto attualmente alla versione 1.5.2. Il team decide di aggiungere una nuova funzionalità compatibile con le versioni precedenti e di correggere un bug minore.

Quale dovrebbe essere il numero di versione successivo secondo il Semantic Versioning?

Riepilogo: SemVer e tag Git

Ottimo lavoro! Ha appreso gli elementi essenziali del Semantic Versioning e come usare i tag Git per contrassegnare le release.

SemVer (MAJOR.MINOR.PATCH) offre un modo chiaro per comunicare le modifiche.
MAJOR: modifiche incompatibili.
MINOR: nuove funzionalità compatibili con le versioni precedenti.
PATCH: correzioni di bug compatibili con le versioni precedenti.
Tag Git: fungono da segnalibri permanenti per commit specifici, ideali per contrassegnare le versioni delle release.
Tag annotati: preferibili per le release grazie ai relativi metadati.

Queste conoscenze sono fondamentali per gestire efficacemente le release e collaborare!

Domande Frequenti

La lezione «Semantic Versioning con i tag» è gratuita?

Sì — il testo completo di «Semantic Versioning con i tag» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso DevOps Bootcamp, passa a CoddyKit PRO. Il corso DevOps Bootcamp include 4 lezioni in totale.

Cosa imparerò in «Semantic Versioning con i tag»?

Applichi i principi del Semantic Versioning al progetto e utilizzi i tag Git per contrassegnare i punti significativi della cronologia. Eserciti DevOps Bootcamp con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare DevOps Bootcamp?

Non è richiesta alcuna esperienza precedente. DevOps Bootcamp su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 1 di 4.

Quanto tempo richiede la lezione «Semantic Versioning con i tag»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione DevOps Bootcamp?

Sì. Ogni lezione DevOps Bootcamp include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

← Torna a DevOps Bootcamp