Gestire le versioni con i repository GitHub
Parte del processo di rilascio inizia con il controllo della versione. Si apprenderà come gestire le versioni nel repository usando GitHub.
Nei moduli seguenti verranno visualizzati i dettagli sulla distribuzione di un componente software dopo la creazione di pacchetti di codice, file binari, note sulla versione e attività correlate.
Le versioni in GitHub sono basate sui tag Git. È possibile pensare a un tag come una foto dello stato corrente del repository. Se è necessario contrassegnare una fase essenziale del codice o il codice finale seguente è stato completato, è possibile creare un tag e usarlo durante il processo di compilazione e rilascio per creare un pacchetto e distribuire tale versione specifica. Per altre informazioni, vedere Viewing your repository's releases and tags (Visualizzazione delle versioni e dei tag del repository).
Quando si creano nuove versioni con note sulla versione, è possibile @mentions collaboratori, aggiungere collegamenti ai file binari e modificare o eliminare le versioni esistenti.
Riferimento all'immagine: Versioni - Microsoft/azure-pipelines-agent (github.com)
È inoltre possibile:
- Pubblicare un'azione da una versione specifica in GitHub Marketplace.
- Scegliere se gli oggetti LFS di Git sono inclusi nei file ZIP e nei tarball creati da GitHub per ogni versione.
- Ricevere notifiche quando vengono pubblicate nuove versioni in un repository.
Creazione di una versione
Per creare una versione, usare il comando gh release create. Sostituire il tag con il nome del tag desiderato per la versione e seguire le istruzioni interattive.
gh release create tag
Per creare una versione preliminare con il titolo e le note specificati.
gh release create v1.2.1 --title
Se si vuole @mention utenti di GitHub nelle note, la versione pubblicata in GitHub.com includerà una sezione Collaboratori con un elenco di avatar di tutti gli utenti menzionati.
È possibile controllare altri comandi e argomenti dal manuale di GitHub CLI.
Modifica di una versione
Non è possibile modificare le versioni con GitHub CLI.
Per modificare, usare il Web browser:
- Passare alla pagina principale del repository in GitHub.com.
- Fare clic su Releases a destra dell'elenco di file.
- Fare clic sull'icona di modifica sul lato destro della pagina, accanto alla versione da modificare.
- Modificare i dettagli per la versione, quindi fare clic su Update release.
Eliminazione di una versione
Per eliminare una versione, usare il comando seguente, sostituire il tag con il tag della versione da eliminare e usare il flag -y per ignorare la conferma.
gh release delete tag -y
Per altre informazioni, vedi:
- Managing releases in a repository (Gestione delle versioni in un repository) - GitHub Docs -Se si vuole eseguire la stessa procedura dal Web browser invece che da GitHub CLI.
- Publishing an action in the GitHub Marketplace (Pubblicazione di un'azione in GitHub Marketplace).
- Managing Git LFS objects in archives of your repository (Gestione degli oggetti LFS di Git negli archivi del repository).
- Viewing your subscriptions (Visualizzazione delle sottoscrizioni).