Diagnosticare i problemi nella build

La diagnostica e la correzione dei problemi di compilazione sono attività normali nello sviluppo del software. In Team Foundation Build sono inclusi strumenti che consentono di eseguire il debug e di risolvere problemi quali:

• Compilazioni riuscite o parzialmente riuscite

• Eccezioni, errori o avvisi

• Eventi o risultati imprevisti

Scegliere l'argomento con cui si desidera procedere

• Determinare il motivo per cui una compilazione non è in esecuzione

• Individuare informazioni su un problema nella finestra dei risultati di compilazione

• Richiedere e visualizzare i log di diagnostica

• Verificare il sistema di compilazione ed eseguire il debug del processo di compilazione

• Ottenere ulteriori suggerimenti

Autorizzazioni necessarie

È necessario essere un membro del gruppo Administrators di Windows nel server di compilazione e un membro del gruppo Project Collection Build Administrators nella raccolta del progetto team. Vedere Riferimento alle autorizzazioni per Team Foundation Server.

Determinare il motivo per cui una compilazione non è in esecuzione

Se la compilazione è quella successiva nella coda, ma non è ancora in esecuzione, assicurarsi che il controller di compilazione e almeno uno dei relativi agenti di compilazione siano disponibili e abilitati. Se il processo di compilazione utilizza filtri dell'agente di compilazione, assicurarsi che un agente di compilazione che soddisfi i criteri sia disponibile e abilitato. Vedere Gestire il sistema di compilazione, Specificare quali agenti di compilazione elaborano la compilazione e Distribuire e configurare agenti di compilazione.

Individuare informazioni su un problema nella finestra dei risultati di compilazione

Se la compilazione è in esecuzione, bloccata in alcune parti del processo o completata, è possibile ottenere ulteriori informazioni sui problemi nella finestra dei risultati della compilazione. Scegliere Visualizza log per visualizzare informazioni più dettagliate:

• Per passare direttamente ai problemi nella compilazione, scegliere Errore successivo o Avviso successivo.

• Selezionare qualsiasi istanza del collegamento File di log di MSBuild per visualizzare informazioni più dettagliate sugli eventi che si sono verificati quando l'attività MSBuild ha compilato il codice ed eseguito altre attività.

• È possibile copiare le informazioni e, se lo si desidera, condividerle con le persone che aiutano a risolvere i problemi. Selezionare passaggi specifici nel log o aprire un menu di scelta rapida da qualsiasi punto del log e scegliere Seleziona tutto. È quindi possibile aprire un menu di scelta rapida e scegliere Copia per copiare il testo negli Appunti.

Visualizzare i log di diagnostica

Se non si dispone ancora di informazioni sufficienti per identificare il problema, è possibile visualizzare log di diagnostica più dettagliati. Nella finestra dei risultati della compilazione scegliere Diagnostica, quindi:

• Se la compilazione viene completata, scegliere Log finali al date and time.

• Se la compilazione non è ancora stata completata, scegliere Richiedi log.

  

  Il sistema assembla i log.

  Quando i log sono pronti, scegliere Diagnostica, Al date and time per User who requested the log.

Se dalle fasi di compilazione si ottiene una cartella di ricezione di un percorso UNC, viene visualizzata una sottocartella della cartella di ricezione contenente i log di diagnostica. Dopo avere aperto la cartella di ricezione o scaricato il file con estensione zip, è possibile visualizzare uno dei seguenti registri:

• Dal controller di compilazione: ActivityLog

• Da ogni agente di compilazione che ha partecipato alla compilazione: **ActivityLog.AgentScope.**Build_Agent_ID

• Per ogni soluzione compilata dall'attività MSBuild: Solution_Name

Il modo migliore per visualizzare i log è copiarli e aprirli nel computer di sviluppo.

Nota

Se si utilizza Visual Studio 2010, il menu Diagnostica non viene visualizzato nella finestra dei risultati della compilazione, ma è comunque possibile visualizzare i log di diagnostica nella cartella di ricezione quando la compilazione viene completata.

Verificare il sistema di compilazione ed eseguire il debug del processo di compilazione

Alcuni problemi possono essere causati dal sistema di compilazione locale.

Suggerimento

Provare a distribuire il computer di sviluppo come server di compilazione in modo che sia più semplice ottenere l'accesso diretto all'ambiente in cui il processo di compilazione è in esecuzione.Vedere Distribuire e configurare un server di compilazione.

Controllare i componenti del sistema di compilazione

Assicurarsi che il server di compilazione, il controller e l'agente siano configurati correttamente. Vedere Distribuire e configurare un server di compilazione, Distribuire e configurare un controller di compilazione e Distribuire e configurare agenti di compilazione.

Accedere al server di compilazione e verificare che funzioni correttamente. È anche possibile visualizzare i dati di diagnostica dettagliata sul server di compilazione. Vedere Gestire il sistema di compilazione.

Eseguire il debug di un processo di compilazione nel server di compilazione

Per diagnosticare problemi causati dalle attività del processo di compilazione personalizzato o per le eccezioni non intercettate, provare a eseguire il debug del processo di compilazione nel server di compilazione.

1. Accedere al server di compilazione.

2. Eseguire Visual Studio come amministratore.

3. Dalla barra dei menu di Visual Studio scegliere Strumenti, Connetti a processo.

4. Nella finestra di dialogo Connetti a processo:

   1. Scegliere Mostra i processi di tutti gli utenti.

   2. Selezionare TFSBuildServiceHost.exe.

   3. Scegliere Connetti.

5. Dalla barra dei menu scegliere Debug, Eccezioni. Nella finestra di dialogo Eccezioni selezionare Eccezioni Common Language Runtime. Scegliere OK.

6. Dalla barra dei menu scegliere Strumenti, Opzioni. Nella finestra di dialogo Opzioni selezionare Debug nel riquadro dell'albero. Nell'elenco Generaledeselezionare la casella di controllo Abilita Just My Code. Scegliere OK.

7. In Visual Studio accodare la compilazione e verificare che venga eseguita in un controller di compilazione e in un server di compilazione ospitati nel server di compilazione in cui è stato abilitato il debugger.

È ora possibile eseguire il debug di eccezioni generate durante il processo di compilazione nonché impostare i punti di interruzione ed eseguire il debug delle attività di processo di compilazione personalizzate. Vedere Debug in Visual Studio.

Suggerimenti

• Durante la diagnosi dei problemi relativi a un processo di compilazione, è possibile salvare l'utente e i problemi dei colleghi del team mettendolo in pausa finché non è possibile ripristinare il processo:

  • Modificare la definizione di compilazione, quindi nella parte inferiore della scheda Generale scegliere In pausa.

  • Per testare le correzioni al processo di compilazione, selezionare una compilazione in coda, aprire il menu di scelta rapida e scegliere Avvia ora.

• Se si ritiene che uno dei componenti del sistema di compilazione possa essere la causa di uno dei problemi, è possibile avviare, arrestare o riavviare un server di compilazione oppure disabilitare o abilitare un controller o un agente in base alle esigenze. Vedere Gestire il sistema di compilazione.

• Spesso, mentre si tenta di risolvere i problemi di compilazione, è necessario accodare una compilazione con le stesse opzioni ripetutamente per testare le varie correzioni. È possibile ritentare rapidamente una compilazione:

  • Dalla finestra dei risultati della compilazione scegliendo Azioni, Ritenta compilazione.

  • Dalla pagina delle compilazioni in Team Explorer o da Build Explorer selezionando una compilazione completata, aprendo il relativo menu di scelta rapida e scegliendo Ritenta compilazione.

• Se viene utilizzato il controller di compilazione ospitato, vedere Utilizzare il controller di compilazione ospitato.