Diagnosticare i problemi di compilazione

La diagnostica e risolvere i problemi di compilazione sono un'attività normale nello sviluppo di software.Team Foundation Build include strumenti che consentono di diagnosticare e correggere i problemi quali:

• Compilazione non riusciti o completate parzialmente

• Eccezioni, errori, avvisi o

• Eventi imprevisti o risultati

Scegliere l'argomento con cui si desidera procedere

• Determinare perché una compilazione non è in esecuzione

• Individuare informazioni su un problema nella finestra risultati compilazione

• Risolvere i problemi quando si utilizza il controller di compilazione ospitato

• Richiedere e visualizzare i log di diagnostica

  • Ottenere i registri di diagnostica quando si utilizza un controller di compilazione di su locali

  • Ottenere i registri di diagnostica quando si utilizza il controller di compilazione ospitato

  • Visualizzare i log di diagnostica

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

• Ottenere ulteriori consigli

Autorizzazioni necessarie

È necessario essere un membro del gruppo Administrators di Windows nel server di compilazione e del gruppo Administrators di compilazione della raccolta di progetti nella raccolta di progetti team.Vedere Autorizzazioni per Team Foundation Server.

Determinare perché una compilazione non è in esecuzione

Se la compilazione viene nella coda seguente ma non ancora in esecuzione, assicurarsi che il controller di compilazione e almeno uno dei relativi agenti di compilazione siano disponibili e attivati.Se il processo di compilazione sono filtri dall'agente di compilazione, assicurarsi che un agente di compilazione che soddisfa i criteri è disponibile e attivato.Vedere Manage Your Build System, Specificare quali agenti di compilazione elaborano la compilazionee Distribuire e configurare gli agenti di compilazione.

Individuare informazioni su un problema nella finestra risultati compilazione

Se la compilazione è in esecuzione, verrebbe a una parte del processo, o completata, è possibile ottenere ulteriori informazioni sui problemi in finestra risultati compilazione.Scegliere Visualizza registro per visualizzare informazioni più dettagliate:

• Scegliere Errore successivo o Avviso successivo per passare direttamente ai problemi di compilazione.

• Per visualizzare le istanze File di log di MSBuild il collegamento, scegliere per ottenere informazioni più dettagliate sugli eventi che si sono verificati durante l'attività di MSBuild compilare il codice ed effettuare altre attività.

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

Registrare diagnostici di visualizzazione

Se non si dispone di informazioni sufficienti per identificare il problema, è possibile visualizzare ulteriori diagnostici log dettagliati.

Ottenere i registri di diagnostica quando si utilizza un controller di compilazione di su locali

Quando contenga un controller di compilazione di su locali, i log di diagnostica vengono archiviati in cartella di ricezione.In finestra risultati compilazione, scegliere Diagnosticaquindi:

• Se la compilazione viene completata, scegliere Registrare finale partendo da data e ora.

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

  

  Il sistema presenti i registri.

  Quando i registri sono pronti, scegliere Diagnostica, A partire da data e ora per Utente che ha richiesto il log.

Il sistema apre una sottocartella della cartella di ricezione contenente i registri diagnostici.

[!NOTA]

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

Ottenere i registri di diagnostica quando si utilizza il controller di compilazione ospitato

Quando si utilizza, Controller di compilazione ospitatoè consigliabile selezionare Copia dell'output di compilazione nel server per posizione di gestione temporanea.In questo caso, i log di diagnostica vengono archiviati in TFS e visualizzarle e scaricarli dal web browser.

In finestra risultati compilazione, scegliere Azioni, Apri nel browserquindi i risultati di compilazione nel browser, scegliere Diagnostica.È quindi possibile scegliere Visualizza log per aprire un menu da cui è possibile scegliere il log che si desidera visualizzare, oppure scaricare il collega un file .zip.

Visualizzare i log di diagnostica

Dopo avere aperto la cartella di ricezione o scaricare il file .zip, è possibile visualizzare uno dei registri:

• Dal controller di compilazione: ActivityLog

• Per ogni agente di compilazione che hanno partecipato alla compilazione: **ActivityLog.AgentScope.**Build_Agent_ID

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

Il modo migliore per visualizzare i registri è di copiarli nel computer dello sviluppatore e di aprirli da.

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

Alcuni problemi possono essere causati dal sistema di compilazione di su locali.

Suggerimento
Tentare di distribuire il computer dello sviluppatore come server di compilazione in modo da poter eseguire più facilmente di ottenere l'accesso diretto all'ambiente in cui il processo di compilazione.Vedere Distribuire e configurare un server di compilazione.

Controlli dei componenti del sistema di compilazione

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

Accedere al server di compilazione e verificare che funziona correttamente.È inoltre possibile visualizzare i dati di diagnostica dettagliati sul server di compilazione.Vedere Manage Your Build System.

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

Per diagnosticare problemi causati dalle attività di processo di compilazione personalizzato, o per le eccezioni non rilevate, 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. In Visual Studio, la barra dei menu, scegliere Strumenti, Connetti a processo.

4. Nella finestra di dialogo Connetti a processo :

   1. Mostra i processi di tutti gli utentiselezionati.

   2. TFSBuildServiceHost.exeSelezionato.

   3. Scegliere Allega.

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

6. Nella barra dei menu, scegliere Strumenti, Options.Nella finestra di dialogo Options, nel riquadro della struttura ad albero, Debugselezionato.Nell'elenco Generale e deselezionare la casella di controllo Abilita Just My Code.Scegliere OK.

7. In Visual Studio, accodare la compilazione e verificare che funzioni in un controller di compilazione e in un server di compilazione ospitati nel server di compilazione su cui attivare 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 personalizzato.Vedere Debug in Visual Studio.

Suggerimenti

• Durante la diagnosi dei problemi relativi a un processo di compilazione, è salvarti e i problemi dei colleghi del team mettendo in pausalo finché non sia possibile ripristinare il processo:

  • Modificare la definizione di compilazionee quindi nella parte inferiore della scheda Generale, scegliere Sospeso.

  • Durante la definizione di compilazione è in pausa, per la verifica delle correzioni al processo di compilazione, selezionare la compilazione in coda, aprire il menu di scelta rapida e scegliere Avvia ora.

• Se si prevede una delle componenti del sistema di compilazione potrebbe essere la causa di uno dei problemi, è possibile avviare, interrompere, o riavviare un server di compilazione o abilitare o disabilitare un controller o un agente in base alle necessità.Vedere Manage Your Build System.

• Spesso, mentre tentare di risolvere i problemi di processo di compilazione, è necessario accodare una compilazione con le stesse opzioni eseguire ripetutamente le varie correzione.È possibile ritentare rapidamente una compilazione:

  • Da finestra risultati compilazione scegliendo Azioni, Ritenta compilazione.

  • Da Pagina di compilazione in Team Explorer o da esplora compilazione selezionando una compilazione completata, aprendo il menu di scelta rapida e scegliere Ritenta compilazione.