Promuovere lo sviluppo Git da un elemento di lavoro in Azure Boards

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Uno dei modi in cui il team può guidare lo sviluppo e rimanere sincronizzati consiste nel collegare gli elementi di lavoro agli oggetti creati durante lo sviluppo, ad esempio rami, commit, richieste pull e compilazioni. È possibile iniziare questo collegamento creando un ramo da uno o più elementi di lavoro. Successivamente, è possibile creare richieste pull, aprire rapidamente i commit e mantenere un record di operazioni di sviluppo eseguite per completare operazioni specifiche.

Questo articolo illustra come eseguire le attività seguenti:

  • Come creare un nuovo ramo o una richiesta pull da un elemento di lavoro
  • Completare la richiesta pull
  • Eseguire un merge di squash
  • Creare un ramo per diversi elementi di lavoro
  • Collegare un elemento di lavoro a oggetti di sviluppo e compilazione esistenti

Questo articolo illustra la creazione di nuovi rami, l'aggiunta di collegamenti ai commit e l'aggiunta di richieste pull a un repository Git ospitato in Azure DevOps. Per collegare i commit e le richieste pull di GitHub, vedere Collegare i commit e le richieste pull di GitHub agli elementi di lavoro.

Suggerimento

È possibile configurare il collegamento automatico e altre impostazioni che collegano elementi di lavoro a commit Git, richieste pull, compilazioni e altro ancora. Per ulteriori informazioni, vedi le seguenti risorse:

Controllo di sviluppo

Il controllo Sviluppo registra tutti i processi di sviluppo Git che supportano il completamento dell'elemento di lavoro. Questo controllo può mostrare le informazioni del team necessarie per eseguire il passaggio di sviluppo successivo e ridurre al minimo i passaggi di spostamento per eseguire attività di sviluppo comuni. Supporta anche la tracciabilità, fornendo visibilità su tutti i rami, i commit, le richieste pull e le compilazioni correlate all'elemento di lavoro.

Screenshot del modulo dell'elemento di lavoro, controllo Sviluppo.

Screenshot del modulo dell'elemento di lavoro, controllo sviluppo, Azure DevOps Server 2019.

Da esso, è possibile accedere rapidamente a rami, richieste pull e commit collegati all'elemento di lavoro. È anche possibile avviare una richiesta pull per un ramo creato o collegato a dall'elemento di lavoro.

Tenere presente che il controllo Sviluppo viene visualizzato solo all'interno del modulo dell'elemento di lavoro del portale Web. L'esperienza di rilevamento degli elementi di lavoro e i moduli visualizzati in Visual Studio o in altri client supportati non visualizzano diverse funzionalità disponibili nel portale Web.

Prerequisiti

  • Connettersi a un progetto. Se non si ha ancora un progetto, crearne uno.
  • È necessario essere aggiunti a un progetto come membro del gruppo di sicurezza Collaboratori o Amministratori progetti. Per essere aggiunto, aggiungere utenti a un progetto o a un team.
  • Per visualizzare o modificare gli elementi di lavoro, è necessario disporre degli elementi di lavoro Visualizza in questo nodo e Modificare gli elementi di lavoro in questo nodo le autorizzazioni impostate su Consenti. Per impostazione predefinita, il gruppo Collaboratori dispone di questo set di autorizzazioni. Per altre informazioni, vedere Impostare le autorizzazioni e l'accesso per il rilevamento del lavoro.
  • Connettersi a un progetto. Se non si ha ancora un progetto, crearne uno.
  • È necessario essere aggiunti a un progetto come membro del gruppo di sicurezza Collaboratori o Amministratori progetti. Per essere aggiunto, aggiungere utenti a un progetto o a un team.
  • Per visualizzare o modificare gli elementi di lavoro, è necessario disporre degli elementi di lavoro Visualizza in questo nodo e Modificare gli elementi di lavoro in questo nodo le autorizzazioni impostate su Consenti. Per impostazione predefinita, il gruppo Collaboratori dispone di questo set di autorizzazioni. Per altre informazioni, vedere Impostare le autorizzazioni e l'accesso per il rilevamento del lavoro.

Processo del flusso di lavoro

Prendere in considerazione la creazione di un nuovo ramo quando non sono presenti artefatti di codice collegati. Se esiste un ramo, ma nessuna richiesta pull, è consigliabile creare una richiesta pull. Ecco una sequenza di flusso di lavoro tipica quando si usa un repository Git.

  1. Iniziare a lavorare sull'elemento di lavoro creando un ramo. È possibile aggiungere un nuovo ramo Git dalla sezione Sviluppo...

    Screenshot del controllo Sviluppo, collegamento Crea ramo.

    ... oppure, dal menu Azioni del modulo.

    Modulo elemento di lavoro storia utente, menu Azione, aggiungi nuovo ramo.

    Assegnare un nome al ramo e selezionare il repository.

    Finestra di dialogo Crea un ramo

    Quando si creano rami, questi vengono collegati automaticamente all'elemento di lavoro.

    Nota

    È possibile creare un ramo solo dopo aver aggiunto file al ramo principale, che è consigliabile etichettare main o un'altra etichetta distintiva. Il sistema aggiunge automaticamente un file README al repository iniziale creato con ogni nuovo progetto.

  2. Il sistema si apre al repository e al ramo creato.

    È possibile modificare un file all'interno del portale Web.

    In alternativa, se sono presenti modifiche estese ai file o se è necessario aggiungere file, lavorare da Visual Studio o da un altro IDE supportato. Aggiungere un nuovo ramo locale dal ramo creato. Per altre informazioni, vedere Aggiornare il codice con recupero e pull, Scaricare le modifiche con recupero. Durante il funzionamento di qualsiasi processo di modifica e commit del codice, è consigliabile usare un'edizione di Visual Studio.

  3. Aggiungere o modificare i file nel ramo creato.

    Da Visual Studio o da un altro IDE supportato, eseguire il commit e il push delle modifiche dal ramo locale al repository.

    Commit e push delle modifiche

    Se è la prima volta che si esegue il push delle modifiche da un nuovo ramo, pubblicare il ramo prima di eseguire il push delle modifiche. Per altre informazioni, vedere Condividere il codice con push.

  4. Creare una richiesta pull dal modulo dell'elemento di lavoro.

    Si crea una richiesta pull per unire le modifiche apportate a un ramo principale e ottenere le modifiche esaminate da altri membri del team.

    Screenshot del controllo Sviluppo, collegamento Crea richiesta pull.

  5. La visualizzazione passa alla pagina Code, Pull Requests (Richieste pull). Completare la creazione della richiesta pull come illustrato.

    Visualizzazione codice, pagina Richiesta pull.

    Nota

    Dopo aver creato una richiesta pull, non è possibile creare una nuova richiesta pull per lo stesso ramo finché non si completa la richiesta pull precedente.

    Pagina Richiesta pull, Crea richiesta pull.

    Selezionare la casella Per le modifiche di Squash durante l'unione e quindi completare l'unione .

    Finestra di dialogo Completa richiesta pull, selezionare squash-merge

  6. Al termine, dovrebbe essere visualizzata una schermata simile come indicato di seguito.

    Richiesta pull, notifica completata

  7. Aprire il modulo dell'elemento di lavoro o aggiornare il modulo, espandere la sezione Sviluppo (scegliere Ingrandisci sviluppo ) e vengono visualizzati i collegamenti aggiunti per supportare le operazioni completate.

    Screenshot del modulo elemento di lavoro, sezione Sviluppo, collegamenti aggiunti.

Creare un ramo per diversi elementi di lavoro

È anche possibile aggiungere un nuovo ramo dall'elemento di lavoro elencato nel backlog o nella scheda senza dover aprire l'elemento di lavoro. Usando la selezione multipla, è possibile selezionare diversi elementi di lavoro e creare un nuovo ramo in cui sono tutti collegati al ramo.

Ad esempio, qui vengono selezionati i primi cinque elementi da collegare a un nuovo ramo.

Screenshot della selezione di più elementi dal backlog, collegamento Crea ramo.

E si specifica il nome del ramo.

Finestra di dialogo Crea nuovo ramo

Tutti gli elementi elencati nella sezione Sviluppo vengono visualizzati anche nella scheda Collegamenti. Tutte le azioni di sviluppo avviate dalla sezione Sviluppo vengono registrate anche nella scheda Cronologia.

Scheda Collegamenti, collegamenti di sviluppo

Per collegare un elemento di lavoro a un oggetto esistente, scegliere l'icona Aggiungi collegamento Aggiungi collegamenti e quindi scegliere il tipo di collegamento.

Selezionare l'icona Aggiungi collegamenti e quindi scegliere il tipo di collegamento.

Se si vuole rimuovere un collegamento, è possibile farlo dalla sezione Sviluppo evidenziandolo prima e quindi scegliere Rimuovi collegamento .

Sezione Sviluppo, eliminare un collegamento

In alternativa, è possibile selezionarlo dalla scheda Collegamenti e scegliere Azioni per il collegamento e quindi scegliere l'opzione Rimuovi collegamento.

Elementi di lavoro associati nella compilazione

Con i commit Git, tutti gli elementi di lavoro collegati a un commit sono elencati nella pagina Elementi di lavoro associati nella pagina di riepilogo della compilazione.

Elementi di lavoro collegati elencati in Elementi di lavoro associati nella pagina di riepilogo della compilazione.

I collegamenti mostrati in questa sezione vengono visualizzati a causa di queste azioni:

  • Creazione di un ramo, un commit o una richiesta pull dall'elemento di lavoro
  • Specifica dell'ID dell'elemento di lavoro durante un commit, una richiesta pull o un'altra operazione Git o TFVC supportata
  • In particolare, il collegamento dell'elemento di lavoro dalla sezione Sviluppo o dalla scheda Collegamenti a un ramo di codice sorgente, una compilazione o un'altra operazione Git o TFVC supportata.

Passando il puntatore del mouse su qualsiasi voce elencata nella sezione Sviluppo, il collegamento ipertestuale viene attivato all'oggetto associato.

I tipi di collegamento che è possibile aggiungere all'interno della sezione di sviluppo sono Branch, Build, Changeset, Commit, Found in build, Integrated in build, Pull Request e Versioned Item.

Tipi di collegamento da artefatto a artefatto

Per altre informazioni sul controllo collegamenti o per personalizzare il controllo Collegamenti di sviluppo, vedere Elementi LinksControlOptions, Controllo collegamenti di sviluppo.