Attività iniziali con Git in Azure Repos

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018

Visual Studio 2022 | Visual Studio 2019 | Visual Studio 2017 | Visual Studio 2015 | Visual Studio 2013

Attività iniziali con lo sviluppo del codice usando Azure Repos e repository Git. È possibile usare i comandi Visual Studio o Git per clonare un repository, definire rami locali, eseguire il commit e eseguire il push delle modifiche e sincronizzarli con altri utenti. Se è necessario creare o importare un repository, vedere Creare un nuovo repository Git nel progetto o Importare un repository Git.

Nota

Questo articolo descrive come usare Visual Studio per gestire Azure Repos repository Git. Usando procedure simili, è possibile usare Visual Studio per gestire i repository di GitHub. Per clonare un repository GitHub, ottenere l'URL come descritto in Clonazione di un repository.

Per una panoramica del flusso di lavoro Git, vedere Azure Repos esercitazione su Git.

Nota

Visual Studio versione 2019 16.8 e versioni successive forniscono un nuovo menu Git per la gestione del flusso di lavoro Git con un cambio di contesto minore rispetto a Team Explorer. Le procedure fornite in questo articolo nella scheda Visual Studio 2019 forniscono informazioni per l'uso dell'esperienza Git e di Team Explorer. Per altre informazioni, vedere Confronto side-by-side di Git e Team Explorer.

Prerequisiti

  • Repos deve essere abilitato nelle impostazioni del progetto di Azure DevOps. Se l'hub Repos e le pagine associate non vengono visualizzate, vedere Attivare o disattivare un servizio Azure DevOps per ripristinare Repos.

  • Per visualizzare il codice nei progetti privati, è necessario essere membro di un progetto di Azure DevOps con livello di accesso di base o superiore. Per i progetti pubblici, tutti possono visualizzare il codice.

  • Per clonare o contribuire al codice per un progetto privato, è necessario essere un membro del gruppo di sicurezza Collaboratori o disporre del set di autorizzazioni corrispondente. Per i progetti pubblici, chiunque può clonare e contribuire al codice. Per altre informazioni, vedere Informazioni su un progetto pubblico?

    Nota

    Per i progetti pubblici, gli utenti hanno concesso l'accesso completo agli stakeholder per Azure Repos.

  • Repos deve essere abilitato nelle impostazioni del progetto di Azure DevOps. Se l'hub Repos e le pagine associate non vengono visualizzate, vedere Attivare o disattivare un servizio Azure DevOps per ripristinare Repos.

  • Per visualizzare il codice, è necessario essere membro del progetto di Azure DevOps con accesso di base o superiore. Se non si è un membro del progetto, aggiungere.

  • Per clonare o contribuire al codice, è necessario essere un membro del gruppo di sicurezza Collaboratori o disporre delle autorizzazioni corrispondenti nel progetto da modificare.

  • Per visualizzare il codice, è necessario essere membro di un progetto di Azure DevOps con accesso di base o superiore. Se non si è un membro del progetto, aggiungere.

  • Per clonare o contribuire al codice, è necessario essere un membro del gruppo di sicurezza Collaboratori o disporre delle autorizzazioni corrispondenti.

Per altre informazioni sulle autorizzazioni e sull'accesso, vedere Repository Git predefinito e autorizzazioni di ramo eInformazioni sui livelli di accesso.

Ottenere il codice

È possibile clonare un repository Git remoto per crearne una copia locale. La clonazione crea entrambe una copia del codice sorgente per l'uso e le informazioni sul controllo della versione in modo che Git possa gestire il codice sorgente.

Se si preferisce creare un repository locale senza clonare, vedere Creare un nuovo repository Git. Dopo aver creato il repository locale, è possibile procedere con il commit, la condivisione e la sincronizzazione del lavoro.

Visual Studio versione 2019 16.8 e versioni successive offre un'esperienza di controllo della versione Git mantenendo l'interfaccia utente git di Team Explorer. È possibile esercitare le funzionalità Git da entrambe le interfacce in modo interscambiabile. Di seguito viene fornito un confronto side-by-side per clonare un repository.

Nota

Uno dei vantaggi della connessione a un progetto tramite Team Explorer è l'accesso all'hub Elementi di lavoro. Per una panoramica delle funzionalità di Team Explorer, vedere Spostarsi in Visual Studio Team Explorer.

Visual Studio Git

  1. Dal menu Git sulla barra dei menu scegliere Clona repository...

Screenshot of the 'Clone Repository' option in the Git menu in Visual Studio 2019.

  1. Nella finestra Clonare un repository immettere il percorso del repository remoto e il percorso della cartella per il repository clonato. Se non si conosce il percorso del repository remoto, selezionare Azure DevOps dalle opzioni Sfoglia un repository.

Screenshot of the 'Clone Repository' window in Visual Studio 2019.

  1. Selezionare Clona. Dopo aver clonato un repository Git, Visual Studio rileva il repository e lo aggiunge all'elenco dei repository locali nel menu Git.

Screenshot of the 'Local Repositories' option in the Git menu in Visual Studio 2019.

Visual Studio Team Explorer

  1. In Team Explorer selezionare Connessione per aprire la pagina Connessione e quindi scegliere Gestisci connessioni>Connessione per Project.

Screenshot of the 'Connect to a Project' link in Team Explorer in Visual Studio 2019.

  1. Nella Connessione in una finestra Project scegliere il repository da clonare e selezionare Clona. Se il repository non viene visualizzato, selezionare Aggiungi Azure DevOps Server per aggiungere un server che ospita un repository. È possibile filtrare l'elenco per trovare il repository.

Screenshot of the 'Connect to a Project' window in Visual Studio 2019.

  1. Verificare il percorso del repository clonato nel computer e quindi selezionare Clona.

Nota

Con Azure DevOps Services, il formato per l'URL del progetto è dev.azure.com/{your organization}/{your project}. Tuttavia, il formato precedente che fa riferimento al visualstudio.com formato è ancora supportato. Per altre informazioni, vedere Introduzione Azure DevOps, Cambiare le organizzazioni esistenti per usare il nuovo URL del nome di dominio.

Eseguire il commit del lavoro

I rami Git isolano le modifiche da altri lavori nel progetto. Il flusso di lavoro Git consigliato consiste nell'usare un nuovo ramo per ogni funzionalità o correzione su cui si lavora. Si apportano commit nel repository Git locale per salvare le modifiche in tale ramo.

Visual Studio Git

  1. Dal menu Git sulla barra dei menu scegliere Nuovo ramo... per aprire la finestra Crea un nuovo ramo .

Screenshot of the 'New Branch' option in the Git menu in Visual Studio 2019.

  1. Nella finestra Crea un nuovo ramo immettere un nome descrittivo di ramo per consentire ad altri utenti di conoscere il funzionamento del ramo. Per impostazione predefinita, Visual Studio crea il nuovo ramo dal ramo corrente. La casella di controllo Check-out branch passa automaticamente al ramo appena creato. Selezionare Crea.

Screenshot of the 'Create a new branch' window in Visual Studio 2019.

  1. Aggiungere un file README.md al repository clonato. In Esplora soluzioni è possibile esplorare il contenuto del repository usando Visualizzazione cartelle o aprire soluzioni Visual Studio nel repository. Git tiene traccia delle modifiche apportate sia all'interno che all'esterno di Visual Studio.

  2. Quando si è soddisfatti delle modifiche, salvarli in Git usando un commit. Nella finestra Modifiche Git immettere un messaggio che descrive le modifiche e quindi selezionare Commit All ( Commit All). Eseguire il commit di tutte le modifiche non installate e ignorare l'area di gestione temporanea. È possibile scegliere di eseguire la fase di tutti i file prima di eseguire il commit selezionando il pulsante fase all + (più) nella parte superiore della sezione Modifiche nella finestra Modifiche git .

Screenshot of the 'Commit All' button in the 'Git Changes' window in Visual Studio 2019.

Selezionare il collegamento informazioni sul commit per ottenere ulteriori dettagli sul commit.

Screenshot showing the commit information link in Visual Studio 2019.

Visual Studio Team Explorer

  1. In Team Explorer selezionare il pulsante Home e scegliere Rami.

Screenshot showing the Branches option in Team Explorer in Visual Studio 2019.

  1. Fare clic con il pulsante destro del mouse sul ramo predefinito, spesso denominato main, quindi scegliere Nuovo ramo locale da...

Screenshot of the 'New Local Branch From' menu option in the context menu of the main branch in Visual Studio 2019.

  1. Immettere un nome di ramo descrittivo per consentire ad altri utenti di sapere cosa contiene il ramo. Selezionare Crea ramo.

Screenshot of the branch name text and 'Create Branch' button in Visual Studio 2019.

  1. Aggiungere un file README.md al repository clonato. Nella visualizzazione Home di Team Explorer è possibile esplorare il contenuto del repository usando Mostra visualizzazione cartelle o aprire Visual Studio soluzioni nel repository. Git tiene traccia delle modifiche apportate sia all'interno che all'esterno di Visual Studio.

  2. Quando si è soddisfatti delle modifiche, salvarli in Git usando un commit. Aprire la visualizzazione Modifiche di Team Explorer selezionando il pulsante Home e scegliendo Modifiche.

Screenshot of the Changes option in Team Explorer in Visual Studio 2019.

  1. Immettere un messaggio che descrive il commit e quindi selezionare Commit All.

Screenshot of commit message text and 'Commit All' button in Visual Studio 2019.

Nota

Se sono presenti più file e non si desidera eseguirne il commit, è possibile fare clic con il pulsante destro del mouse su ogni file e scegliere Fase. Quando sono stati distribuiti tutti i file che si desidera eseguire il commit, selezionare Commit Staged. Commit Staged sostituisce Commit All quando si esegue manualmente la fase delle modifiche.

Visual Studio Git

Screenshot of the Stage option in the 'Git Changes' window in Visual Studio 2019.

Visual Studio Team Explorer

Screenshot of the Stage option in the changed-file context menu in Team Explorer in Visual Studio 2019.

Condividere le modifiche

Dopo aver aggiunto uno o più commit a un ramo e si è pronti per condividere tali modifiche con altri utenti, eseguire il push dei commit in modo che altri possano visualizzarli.

Dopo aver eseguito il push dei commit, è possibile creare una richiesta pull. Una richiesta pull consente ad altri utenti di sapere di aver esaminato le modifiche. Dopo l'approvazione, una richiesta pull aggiunge in genere le modifiche al ramo predefinito del repository remoto.

Visual Studio Git

  1. Nella finestra Modifiche Git selezionare il pulsante push freccia su per eseguire il push del commit.

Screenshot of the up-arrow push button in the 'Git Changes' window of Visual Studio 2019.

In alternativa, è possibile eseguire il push delle modifiche dalla finestra Repository Git . Per aprire la finestra Repository Git , selezionare il collegamento in uscita/in ingresso nella finestra Modifiche Git .

Screenshot of the 'outgoing / incoming' link in the 'Git Changes' window, and the Push link in the 'Git Repository' window of Visual Studio 2019.

In alternativa, è possibile eseguire il push delle modifiche dal menu Git sulla barra dei menu.

Screenshot of the Push option from the Git menu in Visual Studio 2019.

  1. Creare una richiesta pull in modo che altri utenti possano esaminare le modifiche. Se è stato appena eseguito il push delle modifiche dalla finestra Modifiche Git, è possibile selezionare il collegamento Crea una richiesta pull per aprire un Web browser in cui è possibile creare una nuova richiesta pull nel portale Web Azure Repos.

Screenshot of the 'Create a Pull Request' link in the 'Git Changes' window in Visual Studio 2019.

In alternativa, se è stato appena eseguito il push delle modifiche dalla finestra Repository Git , è possibile selezionare il collegamento Crea una richiesta pull nella parte superiore della finestra.

Screenshot of the 'Create a Pull Request' link in the 'Git Repository' window in Visual Studio 2019.

In alternativa, è possibile fare clic con il pulsante destro del mouse su qualsiasi ramo nella finestra Repository Git e scegliere Crea richiesta pull.

Screenshot of the 'Create a Pull Request' menu option from the branch context menu in the 'Git Repository' window in Visual Studio 2019.

Visual Studio Team Explorer

  1. In Team Explorer selezionare Home e quindi scegliere Sincronizza per aprire Sincronizzazione.

Screenshot of the Sync option in Team Explorer in Visual Studio 2019.

È anche possibile passare alla visualizzazione Sincronizzazione da Modifiche scegliendo Sincronizza immediatamente dopo aver eseguito un commit.

Screenshot of the Sync link that appears after making a commit in Visual Studio 2019.

  1. Nella visualizzazione Sincronizzazione scegliere Push per caricare il commit nel repository remoto. Se si tratta del primo push nel repository, verrà visualizzato il messaggio : The current branch does not track a remote branch..., che informa che il commit è stato eseguito il push in un nuovo ramo nel repository remoto e che i commit futuri inviati dal ramo corrente verranno caricati in tale ramo remoto.

Screenshot of the Push link in the Synchronization view of Team Explorer in Visual Studio 2019.

  1. Creare una richiesta pull in modo che altri utenti possano esaminare le modifiche. Aprire Richieste pull in Team Explorer selezionando Home e scegliendo Richieste pull.

Screenshot of the 'Pull Requests' option in Team Explorer in Visual Studio 2019.

  1. In Richieste pull è possibile visualizzare le richieste pull aperte dall'utente, assegnate all'utente e creare nuove richieste pull. Selezionare Nuova richiesta pull per aprire un Web browser in cui è possibile creare una nuova richiesta pull nel portale Web Azure Repos.

Screenshot of the 'New Pull Request' link in the Pull Requests view of Team Explorer in Visual Studio 2019.

Quando la richiesta pull viene aperta nel portale Web di Azure Repos, verificare i rami di origine e di destinazione. In questo esempio si vogliono unire i commit dal add-readme-file ramo al main ramo . Immettere un titolo e una descrizione facoltativa, specificare tutti i revisori, associare facoltativamente eventuali elementi di lavoro e quindi selezionare Crea.

Screenshot of the 'New Pull Request' form in the Azure Repos web portal.

Per altre informazioni sulle richieste pull, vedere l'esercitazione sulle richieste pull .

Sincronizzare con altri utenti

È possibile mantenere sincronizzati i rami locali con le controparti remote eseguendo il pull dei commit creati da altri utenti. Anche se Git è utile per unire le modifiche in ingresso con le modifiche, a volte potrebbe essere necessario risolvere un conflitto di merge. Mentre si sta lavorando al ramo di funzionalità, è consigliabile passare periodicamente al main ramo ed eseguire il pull di nuovi commit per mantenerlo aggiornato con il ramo remoto main .

Visual Studio Git

Nella finestra Modifiche Git è possibile mantenere aggiornato il ramo locale con la controparte remota usando i pulsanti Fetch, Pull, Push e Sync .

Screenshot of the Fetch, Pull, Push and Sync buttons in the 'Git Changes' window of Visual Studio 2019.

Da sinistra a destra nello screenshot precedente, i controlli pulsante sono:

  • Recuperare scarica i commit remoti che non si trovano nel ramo locale, ma non li unisce.
  • Pull esegue un recupero e quindi unisce i commit scaricati nel ramo locale.
  • Il push carica i commit non crittografati nel repository remoto, che li aggiunge al ramo remoto corrispondente.
  • La sincronizzazione esegue un pull e quindi un push.

È anche possibile selezionare Fetch, Pull, Push e Sync dal menu Git.

Screenshot of the Fetch, Pull, Push and Sync options in the Git menu in Visual Studio 2019.

Visual Studio Team Explorer

  1. In Team Explorer selezionare Home e scegliere Sincronizza per aprire Sincronizzazione.

Screenshot of the Sync option in 'Team Explorer' in Visual Studio 2019.

  1. È possibile scaricare le modifiche più recenti nel ramo usando il collegamento Pull . Sono disponibili due collegamenti pull , uno nella parte superiore e uno nella sezione Commit in ingresso . È possibile usare entrambi perché entrambi eseguono la stessa operazione.

Screenshot of the Pull link in the Synchronization view of Team Explorer in Visual Studio 2019.