Distribuire e configurare gli agenti di compilazione

Per utilizzare Team Foundation Build, il team deve disporre di almeno un agente di compilazione per eseguire il lavoro che richiede un utilizzo intensivo del processo di compilazione.

Ogni agente di compilazione è dedicato e viene controllato da un unico controller di compilazione.Gli agenti di compilazione possono essere ospitati nello stesso server di compilazione che ospita il controller di compilazione, ma non è necessario e, in alcuni casi, le esigenze del team possono essere soddisfatte in modo più efficiente da un singolo server di compilazione per ospitare un controller di compilazione che controlla gli agenti di compilazione su più server di compilazione.

L'agente di compilazione esegue i passaggi del processo di compilazione contenuti nell'attività AgentScope.Im genere, in queste operazioni sono inclusi l'estrazione del controllo della versione, il provisioning dell'area di lavoro, la compilazione del codice, l'esecuzione di test e l'unione dei file in un unico controllo della versione.

Verificare che il server di compilazione che ospita gli agenti di compilazione disponga di funzionalità sufficienti di elaborazione e di archiviazione che rispondano alla dimensione e alla complessità della codebase e che esegui il test per la raccolta di progetti team.In genere, è opportuno ospitare non più di un agente di compilazione per core di processore sul server di compilazione.È inoltre possibile migliorare le prestazioni dedicando un singolo disco rigido fisico nella directory di lavoro di ogni agente di compilazione.

Suggerimento
Se la raccolta di progetti team è ospitata su Team Foundation Service e le necessità del team possono essere soddisfatte da un agente di compilazione singolo standard, è possibile utilizzare il Controller di compilazione ospitato anziché implementare il proprio agente 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

• Creare o modificare un'agente di compilazione

• Installare Visual Studio e un altro software per abilitare la compilazione e altre funzionalità

• Specifica la directory di lavoro

• Abilitare l'agente di compilazione per eseguire test

• Assegnare i tag per rappresentare le funzionalità o gli scopi dell'agente di compilazione

• Implementare un agente di compilazione che può compilare e testare un'applicazione di Windows Store

• Rimuovere un agente di compilazione

Creare o modificare un'agente di compilazione

Per creare o modificare un agente di compilazione dal 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 della console di amministrazione di Team Foundation, espandere il nome del server, quindi selezionare il nodo Configurazione di compilazione.

   Le informazioni sul server di compilazione verranno visualizzate nel riquadro del contenuto.

   Se viene visualizzato il messaggio Configura funzionalità installate, vedere Distribuzione di un server di compilazione.

4. Nella pagina Configurazione compilazione:

   • Per creare un nuovo agente di compilazione, scegliere Nuovo agente.

   • Per modificare un agente di compilazione esistente

     

     scegliere Proprietà.

   Verrà visualizzata la finestra di dialogo Proprietà agente di compilazione.

Per modificare un agente di compilazione 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.

   Verrà visualizzata la finestra di dialogo Gestisci controller di compilazione.

   

3. Selezionare l'agente di compilazione che si desidera modificare, quindi selezionare Proprietà.

   Verrà visualizzata la finestra di dialogo Proprietà agente di compilazione.

Nome visualizzato, Descrizione: digitare un nome e una descrizione per consentire ai membri del team di identificare facilmente l'agente di compilazione.

Controller: selezionare il controller di compilazione con cui si desidera controllare questo agente di compilazione.Il controller di compilazione può essere eseguito sullo stesso server di compilazione di questo agente di compilazione o su uno diverso.

Vedere le sezioni riportate di seguito per informazioni dettagliate su come configurare l'agente di compilazione.

Installare Visual Studio e un altro software per abilitare la compilazione e altre funzionalità

È consigliabile installare nell'agente di compilazione la versione di Visual Studio che il team utilizza nei computer di sviluppo.Vedere Installazione di Visual Studio.Installare inoltre qualsiasi altro software e componente installato nei computer di sviluppo e necessari per compilare l'applicazione.In caso contrario, potrebbero essere causati problemi, ad esempio i progetti di codice che non riescono ad eseguire la compilazione.

Specifica la directory di lavoro

È possibile specificare la directory della cartella di lavoro utilizzata dall'agente di compilazione per leggere o scrivere nei file.I file di origine, ad esempio, vengono copiati nelle sottodirectory di questa cartella e i file binari vengono creati e archiviati in altre sottodirectory di questa cartella.

Suggerimento
È inoltre possibile migliorare le prestazioni dedicando un singolo disco rigido fisico nella directory di lavoro di ogni agente di compilazione.

Utilizzare i token della cartella di lavoro

Anche se è possibile specificare un percorso letterale per la proprietà Cartella di lavoro (ad esempio, c:\temp\build\), viene utilizzato un approccio più semplice e duraturo in modo da utilizzare i token per specificare il percorso.È possibile utilizzare due tipi di token:

• Variabili di ambiente
  Le variabili di ambiente contengono informazioni sull'ambiente per il sistema e l'utente connesso.La variabile più tipica che è possibile utilizzare è SYSTEMDRIVE, ma in alcuni casi è anche possibile utilizzare le variabili come USERNAME o HOMEPATH.

  Suggerimento
  Per elencare le variabili di ambiente sul server di compilazione, aprire un prompt dei comandi e digitare set.

• Variabili di Team Foundation Build
  È possibile utilizzare le variabili riportate di seguito in una directory di lavoro dell'agente di compilazione.

  • $(BuildAgentId): un numero intero generato automaticamente che identifica in modo univoco un agente di compilazione all'interno di una raccolta di progetti team.

  • $(BuildAgentName): nome dell'agente di compilazione specificato nella casella Nome visualizzato.

  • $(BuildDefinitionId): un numero intero generato automaticamente che identifica in modo univoco una definizione di compilazione all'interno di una raccolta di progetti team.

  • $(BuildDefinitionPath): il nome del progetto team e quello della definizione di compilazione, separati da una barra rovesciata.

Esempio di cartella di lavoro

Si dispone, ad esempio, di un agente di compilazione denominato BuildBot3.Sono state definite due compilazioni denominate NightlyBuild e WeeklyBuild in un progetto team denominato CoolApp.Nella casella Cartella di lavoro si specifica il valore seguente: $(SystemDrive)\TeamBuilds\$(BuildAgentName)\$(BuildDefinitionPath).Di conseguenza, l'agente di compilazione BuildBot3 crea e utilizza le due cartelle di lavoro seguenti:

C:\TeamBuilds\BuildBot3\CoolApp\NightlyBuild

C:\ TeamBuilds\BuildBot3\CoolApp\WeeklyBuild

Verificare che il percorso nome della cartella di lavoro non sia troppo lungo

La cartella di lavoro specificata non deve provocare la generazione da parte dell'agente di compilazione di percorsi fisici contenenti più di 259 caratteri.In caso contrario, le compilazioni potrebbero avere esito negativo e generare il seguente errore: TF10128: The pathPhysicalPath contains more than the allowed 259 characters. Type or select a shorter path.

Per risolvere questo problema, specificare una cartella di lavoro che restituisca un percorso fisico più breve.È possibile, ad esempio, specificare $(HOMEDRIVE)\bld\$(BuildAgentID)\$(BuildDefinitionID), che restituirà una cartella di lavoro come: c:\bld\3\2\.

Sottodirectory create nella cartella di lavoro

L'agente di compilazione crea e utilizza le sottodirectory seguenti in questo percorso.

Abilitare l'agente di compilazione per eseguire test

È possibile definire un processo di compilazione per eseguire uno o più test automatizzati.

Importante
Molti tipi di test e di operazioni di test richiedono l'installazione sull'agente di compilazione della stessa versione di Visual Studio che il team utilizza nel computer di sviluppo.Vedere Installazione di Visual Studio.

L'agente di compilazione può eseguire:

• Code coverage

• Test codificati dell'interfaccia utente (richiede un server di compilazione in esecuzione in modalità interattiva.Vedere Eseguire il server di compilazione in modalità interattiva e Test dell'interfaccia utente con test codificati automatizzati dell'interfaccia utente).

• Generazione di dati di test del database

• Unit test database

• Test generici

• Test di carico

• Unit test

• Test ordinati

• Analisi dell'impatto sui test

• Test Web

Assegnare i tag per rappresentare le funzionalità o gli scopi dell'agente di compilazione

Man mano che la dimensione del sistema di compilazione aumenta, potrebbe essere necessario definire agenti di compilazione specializzati.Ogni qualvolta un agente di compilazione dispone di funzionalità speciali o è destinato a un tipo specifico di utilizzo, è consigliabile assegnare uno o più tag a tale agente.In questo modo, quando un membro del team crea una definizione di compilazione che richiede un determinato tipo di agente di compilazione, può specificare il tag nella definizione di compilazione.

È possibile assegnare tag dalla finestra di dialogo Proprietà agente di compilazione, descritta in precedenza.È quindi possibile applicare i tag alle definizioni di compilazione.

Nella tabella seguente vengono riportati esempi di nomi di tag e vengono descritte le funzionalità dell'agente di compilazione che possono rappresentare.

È possibile applicare più di un tag a un agente di compilazione.Ad esempio, è possibile creare un agente di compilazione con i tag x86 e Release per indicare un agente configurato per la compilazione della configurazione per il rilascio di un'applicazione a 32 bit.

Se si eseguono più agenti di compilazione sullo stesso server di compilazione, è probabile che dispongano tutti delle stesse funzionalità.Può pertanto essere utile applicare gli stessi tag a tutti gli agenti di compilazione su tale server di compilazione.

Rimuovere un agente di compilazione

1. In Visual Studio, aprire la finestra di dialogo Gestisci controller di compilazione, come illustrato precedentemente in Crea o modifica un agente di compilazione.

2. Selezionare l'agente di compilazione che si desidera eliminare, quindi selezionare Rimuovi.

Suggerimento
È inoltre possibile utilizzare la console di amministrazione di Team Foundation per rimuovere l'agente di compilazione mentre si è connessi al server di compilazione.

Passaggi successivi

• Scalabilità orizzontale del sistema di Team Foundation Build
  Man mano che le dimensioni del team e della codebase aumentano, è possibile espandere in maniera incrementale il sistema di compilazione con relativa facilità.

• Gestire il sistema di compilazione
  Occasionalmente, è necessario monitorare e gestire il sistema di compilazione.

• Utilizzare il sistema di compilazione per compilare, testare e distribuire l'applicazione
  Dopo aver posizionato il sistema di compilazione, il team è pronto per creare un processo di compilazione semplice (ad esempio, una compilazione di integrazione continuata) e per trarre vantaggio dalla compilazione e dal test automatizzato dell'applicazione.