Manage Your Build System

Sono stati configurati i server di compilazione, inclusi i controller di compilazione e gli agenti di compilazione.Sono stati definiti i processi di compilazione per soddisfare le esigenze del team.Il team è ora in esecuzione e gestisce le compilazioni automatizzate per compilare e testare l'applicazione.

Occasionalmente, in determinate situazioni sarà necessario monitorare e gestire il sistema di compilazione, ad esempio quando si esegue la diagnosi dei problemi o il ridimensionamento del sistema di compilazione.

Autorizzazioni necessarie

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

Scegliere l'argomento con cui si desidera procedere

• Controllare lo stato, gestire e modificare i controller e gli agenti da Visual Studio

• Controllare lo stato, gestire e modificare il server, il controller e gli agenti dalla console di amministrazione

• Avviare, arrestare o riavviare un server di compilazione

• Riavviare un controller di compilazione o un agente di compilazione

• Abilitare o disabilitare un controller di compilazione o un agente di compilazione

• Specificare il numero massimo di compilazioni in esecuzione simultanea per un controller

• Registrare o annullare la registrazione di un server di compilazione

• Monitorare l'integrità del server di compilazione

• Utilizzare i log eventi per diagnosticare problemi

• Eseguire le operazioni successive

Controllare lo stato, gestire e modificare i controller e gli agenti da Visual Studio

Talvolta si desidera controllare lo stato e gestire i controller di compilazione e gli agenti di compilazione, ad esempio, quando un processo di compilazione in coda non viene avviato o non riesce ad avanzare.È possibile eseguire tutte queste operazioni direttamente da Visual Studio.

1. In Visual Studio, in Team Exlporer:

   1. Se non si è già connessi a un progetto team nella raccolta di progetti team, allora connettersi al progetto team.

   2. Selezionare Home, quindi selezionare Compilazioni.

2. Nella pagina delle compilazioni selezionare Azioni, quindi Gestisci controller di compilazione.

Passaggi successivi

• Controllare lo stato dei controller e degli agenti

  • Se lo Stato è Disponibile e lo Stato è Abilitato, allora il componente funziona correttamente.

  • Se lo Stato è Disabilitato, è possibile selezionare il componente, scegliere Proprietà e quindi riabilitare il componente.

  • Se lo Stato è Offline, allora il componente è disconnesso.Accedere al server di compilazione e verificare che sia registrato e sia possibile connettersi a Team Foundation Server.

• Visualizzare, modificare, abilitare o disabilitare un controller o un agente
  Selezionarlo e scegliere Proprietà, quindi vedere Distribuire e configurare un controller di compilazione o Distribuire e configurare gli agenti di compilazione.

• Rimuovere un controller o un agente
  Vedere Rimuovere un controller di compilazione o Rimuovere un agente di compilazione.

• Gestire o risolvere i problemi relativi a un server di compilazione, un controller o un agente
  Vedere la sezione riportata di seguito, per ulteriori informazioni.

Controllare lo stato, gestire e modificare il server, il controller e gli agenti dalla console di amministrazione

Per verificare o gestire i componenti del sistema di compilazione, talvolta è necessario disporre delle funzionalità aggiuntive disponibili quando si accede al server di compilazione.

1. Accedere al server di compilazione che si desidera configurare.

2. Dal menu Start di Windows, eseguire Console di Amministrazione di Team Foundation Server.

   Verrà visualizzata la Console di amministrazione di Team Foundation.

3. Nel riquadro della struttura ad albero espandere il nome del server.

4. Selezionare il nodo Configurazione compilazione.

[!NOTA]

Nel caso in cui venga visualizzato il messaggio Configura funzionalità installate anziché una visualizzazione come quella precedente, vedere Distribuzione un server di compilazione.

Passaggi successivi

• Controllare lo stato dei controller e degli agenti

  • Se uno dei controller di compilazione o di agenti di compilazione sta elaborando una compilazione, è possibile visualizzare i messaggi sul lavoro in corso in tempo reale dalla Console di amministrazione di Team Foundation.

    

    Per ulteriori informazioni sul controllo di un processo di compilazione in esecuzione, vedere Eseguire, monitorare e gestire compilazioni e Diagnosticare i problemi di compilazione.

  • Se un controller o un agente è rosso, il componente viene disconnesso.Verificare che il server di compilazione possa connettersi a Team Foundation Server.

• Utilizzo del server di compilazione

  

  • Scegliere Riavvia, Arresta, o Avvia per avviare, arrestare o riavviare il server di compilazione.

  • Scegliere Proprietà per distribuire e configurare un server di compilazione.

  • Scegliere Registra o Annulla registrazione per registrare o annullare la registrazione di un server di compilazione.

  • Scegliere Eventi… per utilizzare i log eventi per diagnosticare i problemi.

  • Monitorare l'integrità del server di compilazione.

• Utilizzo del controller di compilazione
  

  • Selezionare Proprietà e visualizzare Distribuire e configurare un controller di compilazione.

  • Scegliere Riavvia per riavviare il controller.

  • Scegliere Abilita o Disabilita per abilitare o disabilitare l'agente.

• Utilizzo dell'agente di compilazione
  

  • Selezionare Proprietà e visualizzare Distribuire e configurare gli agenti di compilazione.

  • Scegliere Riavvia per riavviare l'agente.

  • Scegliere Abilita o Disabilita per abilitare o disabilitare l'agente.

Avviare, arrestare o riavviare un server di compilazione

È consigliabile arrestare il server di compilazione quando se ne esegue la manutenzione.Dalla Console di amministrazione di Team Foundation scegliere Interrompi per fare in modo che tutti i controller e gli agenti di compilazione siano ospitati nel server di compilazione offline.Scegliere Avvia quando si è pronti ad attivare il servizio dei controller e degli agenti.

Se il server di compilazione non riesce a rispondere (ad esempio, se un processo di compilazione non riesce ad avviare o ad eseguire avanzamenti tempestivi), potrebbe essere utile selezionare Riavvia.Quando si riavvia il server di compilazione, il processo del servizio Team Foundation Build vien chiuso e riavviato in uno stato quasi aggiornato come al riavvio del computer.Se su questo server di compilazione è in corso l'elaborazione di alcune compilazioni da parte del controller di compilazione o di qualsiasi agente di compilazione, tali compilazioni vengono annullate.

Riavviare un controller di compilazione o un agente di compilazione

Quando il riavvio del server di compilazione è troppo dannoso e non necessario, è possibile selezionare il collegamento Riavvia del controller o dell'agente di compilazione dalla Console di amministrazione di Team Foundation.Quando si riavvia un controller di compilazione, questo ricarica gli assembly e tutte le compilazioni in fase di elaborazione vengono arrestate.Quando si riavvia un agente di compilazione, il dominio applicazione viene ignorato, gli assembly ricaricati e la compilazione che sta eseguendo l'elaborazione viene arrestata.

Abilitare o disabilitare un controller di compilazione o un agente di compilazione

È possibile disabilitare un controller o un agente un agente per impedire l'assegnazione delle compilazioni.Se si disabilita un controller o un agente che stanno sviluppando una compilazione, la compilazione completata prima che il componente è disabilitata.

Questa funzionalità consente di ottimizzare o modificare temporaneamente il funzionamento del sistema di compilazione.Se, ad esempio, si sospetta che un server di compilazione stia eseguendo un numero eccessivo di compilazioni dal momento che l'elaborazione delle compilazioni è troppo lenta,è possibile disabilitare alcuni agenti di compilazione e valutarne le conseguenze sulle prestazioni.Sarà quindi possibile riabilitare in un secondo momento uno o più agenti di compilazione, se necessario.

Per disabilitare o abilitare un controller di compilazione o un agente di compilazione:

• Dalla finestra di dialogo Gestisci controller di compilazione di Visual Studio selezionare il controller o l'agente di compilazione che si desidera disabilitare o abilitare, quindi scegliere Proprietà.Verrà visualizzata la finestra di dialogo Proprietà controller di compilazione o Proprietà agente di compilazione.Deselezionare o selezionare la casella di controllo Il servizio controller di compilazione è abilitato o Il servizio agente di compilazione è abilitato.

• Dalla Console di amministrazione di Team Foundation, individuare il controller o l'agente di compilazione che si desidera disabilitare o abilitare, quindi scegliere il collegamento Disabilita o Abilita.

Registrare o annullare la registrazione di un server di compilazione

Dalla Console di amministrazione di Team Foundation scegliere Annulla registrazione se si desidera che il server di compilazione resti al di fuori del sistema di compilazione.Quando si seleziona Annulla registrazione, viene chiesto se si desidera eliminare eventuali controller di compilazione e agenti di compilazione eseguiti sul server di compilazione.

• Selezionare No se si desidera rimuovere temporaneamente le autorizzazioni di questo server di compilazione.I controller e gli agenti nel server di compilazione non vengono eliminati dalla raccolta di progetti team e vengono visualizzati con StatoOffline nella finestra di dialogo Gestisci controller di compilazione di Visual Studio.Sarà possibile selezionare in seguito Registra e ripristinare il controller di compilazione e gli agenti di compilazione.

• Selezionare Sì se si desidera eliminare tutte le impostazioni di configurazione per questa compilazione dalla raccolta di progetti team.Tutte le informazioni su eventuali controller di compilazione e agenti di compilazione verranno eliminate.

Se viene visualizzato il messaggio Il servizio di compilazione non è registrato, è possibile selezionare Registra per concedere nuovamente le autorizzazioni al server di compilazione e consentirgli di ospitare i controller di compilazione e gli agenti di compilazione.

Suggerimento

È inoltre possibile sostituire un server di compilazione esistente quando si distribuisce un nuovo server di compilazione.Ad esempio, è possibile ospitare la stessa configurazione e l'insieme di controller di compilazione e di agenti di compilazione su un nuovo computer, più potente.Vedere Configurare il servizio Team Foundation Build tramite lo strumento di configurazione di Team Foundation Server.

Monitorare l'integrità del server di compilazione

Durante l'accesso al server di compilazione, è possibile confermare che servizio Team Foundation Build è in esecuzione e ottenere informazioni sulle risorse che sta utilizzando e confermare l'integrità generale del server di compilazione.

1. Eseguire la Gestione attività di Windows (Gestione attività su Windows 8).

2. In Windows 8, se il collegamento Ulteriori informazioni viene visualizzato, selezionarlo.

3. Scegliere la scheda Processo.

4. Nelle versioni di Windows diverse da Windows 8, assicurarsi di aver selezionato Mostra i processi di tutti gli utenti.

5. In quale versione di Windows è in esecuzione il server di compilazione?

   • Windows 8: individuare il processo Host del servizio Visual Studio Team Foundation Build.Deve trovarsi nella sezione Processi in background, o se il server di compilazione è in esecuzione in modalità interattiva, nella sezione Applicazioni.Osservare la memoria CPU, il disco e le risorse di rete che il processo utilizza.

   • Un'altra versione di Windows: individuare il processo TFSBuildServiceHost.exe.Osservare la CPU e le risorse di memoria che il processo utilizza.

6. Utilizzare le altre schede in Gestione attività per confermare l'integrità generale del server di compilazione.Ad esempio, è possibile scegliere la scheda Prestazioni per confermare che il computer dispone del processore e delle risorse di memoria sufficienti.È quindi possibile scegliere Monitoraggio risorse (in Windows 8, in Apri Monitoraggio risorse).

Utilizzare i log eventi per diagnosticare problemi

Utilizzare il Visualizzatore eventi per ottenere le informazioni che consentono di monitorare il funzionamento del server di compilazione corretto e la diagnosi dei problemi relativi al server di compilazione o al processo di compilazione.

Visualizzare gli eventi recenti

Iniziare a selezionare gli eventi più recenti.Dalla Console di amministrazione di Team Foundation, scegliere Eventi… per aprire il Visualizzatore eventi e visualizzare i messaggi informativi, di avviso e di errore più recenti.

Visualizzare il log operativo

Per ottenere informazioni più dettagliate in un periodo di tempo più lungo, nel riquadro della struttura ad albero del visualizzatore eventi espandere Registri applicazioni e servizi, Microsoft, Team Foundation Server, Servizi di compilazione, quindi selezionare Operativo.

Visualizza log analitici

Nella maggior parte dei casi non è necessario leggere i messaggi interni esposti dal registro analitico.Tuttavia, questi dati potrebbero essere utili quando si utilizza il servizio clienti per risolvere un problema.

Per abilitare il registro analitico

1. Nel Visualizzatore eventi, selezionare Visualizza, Visualizza registri analitici e di debug.

2. Nel riquadro della struttura ad albero, espandere Registri applicazioni e servizi, Microsoft, Team Foundation Server, Servizi di compilazione, quindi scegliere Analitico.

3. Mentre Analitico è ancora selezionato, aprire il menu di scelta rapida e quindi scegliere Abilita.

Suggerimento
Per impostazione predefinita quando questo log raggiunge un limite di dati, il Visualizzatore eventi smette di raccogliere i dati.Per modificare il limite o per modificare questo comportamento, selezionare il nodo Analitico, aprire il menu di scelta rapida e scegliere Proprietà.

Personalizzare e visualizzare i dati

Per salvare i dati in un file permanente semplice da analizzare e visualizzare, nel riquadro della struttura ad albero, selezionare uno dei nodi descritti in precedenza, aprire il menu di scelta rapida e quindi selezionare Salva tutti gli eventi….Utilizzare la finestra di dialogo Salva con nome per salvare i dati nel formato che soddisfa le esigenze.

Passaggi successivi

• Distribuire e utilizzare un server di compilazione
  Per utilizzare Team Foundation Build con un Team Foundation Server locale, è necessario implementare almeno un server di compilazione.Il server può essere distribuito in un computer fisico o in una macchina virtuale.

• Distribuire e configurare un controller di compilazione
  Utilizzare un controller di compilazione per eseguire le attività leggere e distribuire il lavoro che richiede un utilizzo intensivo del processo di compilazione nel pool di agenti di compilazione.È possibile ospitare un solo controller di compilazione in un server di compilazione.

• Distribuzione e configurazione degli agenti di compilazione
  Utilizzare un agente di compilazione per eseguire il lavoro della compilazione che richiede un utilizzo intensivo del processore e che comprende il recupero di file dal controllo della versione, il provisioning dell'area di lavoro, la compilazione del codice e l'esecuzione di test.È possibile ospitare uno o più agenti di compilazione in un server di compilazione.

• Configurare cartelle di ricezione
  È possibile impostare e preparare una o più cartelle di ricezione in modo che il sistema di compilazione possa mettere a disposizione del team i file binari, i risultati test e i file di log.

• Scalabilità orizzontale del sistema di Team Foundation Build
  Mentre il team e la codebase aumentano, è possibile aumentare gradualmente il sistema di compilazione con relativa facilità.