Creare e utilizzare agenti di compilazione

Per utilizzare Team Foundation Build, il team deve disporre di almeno un agente di compilazione. Un agente di compilazione esegue 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, l'esecuzione di test e l'unione dei file nel controllo della versione. Ogni agente di compilazione è dedicato e viene controllato da un unico controller di compilazione.

Prima di iniziare

• È consigliabile acquisire informazioni sul ruolo svolto dagli agenti di compilazione in un sistema di compilazione, oltre che sulle diverse modalità per utilizzarli. Per ulteriori informazioni, vedere Informazioni sul sistema Team Foundation Build.

• Un agente di compilazione è ospitato su un computer di compilazione. Pertanto, prima di poter creare e utilizzare un agente di compilazione, è necessario configurare un computer di compilazione. Ogni computer di compilazione può ospitare uno o più agenti di compilazione. Per ulteriori informazioni, vedere Configurare un computer di compilazione.

In questo argomento

• Autorizzazioni necessarie

• Creare un agente di compilazione

• Modificare un agente di compilazione

• Finestra di dialogo Proprietà agente di compilazione

  • Ulteriori informazioni sulla proprietà Cartella di lavoro

• Utilizzare l'agente di compilazione per eseguire test

• Installare software aggiuntivo

  • Installare il software necessario per compilare il codice

  • Installare il software necessario per eseguire altre attività

• Assegnare tag a un agente di compilazione

• Rimuovere un agente di compilazione

Autorizzazioni necessarie

Per eseguire questa procedura, è necessario essere un membro del gruppo Administrators sul computer di compilazione e l'autorizzazione Gestisci risorse di compilazione deve essere impostata su Consenti. Per ulteriori informazioni, vedere Autorizzazioni per Team Foundation Server.

Creare un agente di compilazione

Per creare un agente di compilazione

1. Accedere al computer di compilazione sul quale si desidera creare l'agente di compilazione.

2. Fare clic su Start, scegliere Tutti i programmi, Microsoft Team Foundation Server 2010, quindi fare clic su Console di amministrazione di Team Foundation.

   Verrà visualizzata la Console di amministrazione di Team Foundation.

3. Nel riquadro della struttura ad albero espandere il nome del server, quindi fare clic sul nodo Team Foundation Build.

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

   Se il messaggio Servizio di compilazione configurato per... non viene visualizzato, vedere Configurare un computer di compilazione.

4. Fare clic su Nuovo agente.

   Verrà visualizzata la finestra di dialogo Proprietà agente di compilazione. Per ulteriori informazioni, vedere Proprietà agente di compilazione più avanti in questo argomento.

5. Dopo avere terminato di modificare le proprietà dell'agente, scegliere OK.

6. Fare clic sul collegamento Avvia se viene visualizzato immediatamente sotto il nome dell'agente di compilazione.

Modificare un agente di compilazione

È possibile modificare un agente di compilazione da un computer client o direttamente sul computer di compilazione che ospita l'agente di compilazione.

Per modificare un agente di compilazione da un computer client

1. In Visual Studio scegliere Gestisci controller di compilazione dal menu Compila.

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

2. Fare clic sull'agente di compilazione che si desidera modificare, quindi su Proprietà.

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

Per modificare un agente di compilazione sul computer di compilazione

1. Accedere al computer di compilazione che esegue l'agente di compilazione che si desidera modificare.

2. Fare clic su Start, scegliere Tutti i programmi, Microsoft Team Foundation Server 2010, quindi fare clic su Console di amministrazione di Team Foundation.

   Verrà visualizzata la Console di amministrazione di Team Foundation.

3. Nel riquadro della struttura ad albero espandere il nome del server, quindi fare clic sul nodo Team Foundation Build.

4. Immediatamente sotto il nome dell'agente di compilazione che si desidera modificare fare clic su Proprietà.

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

Finestra di dialogo Proprietà agente di compilazione

Nella finestra di dialogo Proprietà agente di compilazione è possibile visualizzare o modificare il nome visualizzato e la descrizione, oltre ad altre proprietà che influiscono sul funzionamento dell'agente di compilazione.

Nome visualizzato, Descrizione

Immettere un nome e una descrizione che consentano ai membri del team di identificare e ottenere facilmente importanti informazioni sull'agente di compilazione.

Controller

Specificare il controller di compilazione con cui si desidera controllare questo agente di compilazione. Il controller di compilazione può essere eseguito sullo stesso computer di compilazione di questo agente di compilazione o su uno diverso.

Nome computer

In questa casella viene visualizzato il nome del computer di compilazione che ospita questo agente di compilazione.

Cartella di lavoro

Utilizzare questa casella per specificare il percorso della cartella di lavoro. Per ulteriori informazioni, vedere Ulteriori informazioni sulla proprietà Cartella di lavoro.

Il servizio agente di compilazione è abilitato

Selezionare questa casella di controllo per consentire il funzionamento di questo agente di compilazione oppure deselezionarla se si desidera disabilitarlo ed evitare che gli vengano assegnate le compilazioni.

Suggerimento
È consigliabile disabilitare un agente di compilazione quando si esegue la manutenzione sul computer di compilazione.

Ulteriori informazioni sulla proprietà Cartella di lavoro

L'agente di compilazione utilizza la cartella di lavoro per le operazioni in cui l'agente deve 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.

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ù flessibile 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.

  Ad esempio, si è configurato servizio Team Foundation Build per l'esecuzione con un account denominato BuildSvcAcct. Si specifica $(HomeDrive)\Builds come cartella di lavoro per un agente di compilazione su un computer di compilazione in cui viene eseguito Windows Server 2008. Di conseguenza, l'agente di compilazione utilizzerà in genere come cartella di lavoro una directory fisica il cui percorso è analogo al seguente: C:\Builds.

  Suggerimento
  Per elencare le variabili di ambiente sul computer 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 un insieme 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 un insieme 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 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 non verranno eseguite correttamente e nel log verrà registrato questo errore: TF10128: il percorso PhysicalPath supera i 259 caratteri consentiti. Digitare o selezionare un percorso più breve. Questo errore può apparire strano perché in genere non è possibile visualizzare i percorsi fisici creati dall'agente di compilazione.

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

Sottodirectory create nella cartella di lavoro

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

Utilizzare l'agente di compilazione per eseguire test

È possibile progettare un processo di compilazione per eseguire uno o più test automatizzati. Come illustrato nella tabella seguente, alcuni tipi di test e operazioni di test richiedono un agente di compilazione che soddisfi requisiti speciali.

Per ulteriori informazioni su come definire un processo di compilazione che esegue test, vedere Utilizzare il sistema di compilazione per eseguire test.

Installare software aggiuntivo

Affinché l'agente di compilazione esegua determinate attività, potrebbe essere necessario installare software aggiuntivo nel computer di compilazione.

Installare il software necessario per compilare il codice

Per la compilazione di gran parte dei progetti più tipici, non è richiesto alcun software aggiuntivo. Ad esempio, senza software aggiuntivi installati, un agente di compilazione può compilare un'applicazione WPF Visual C# di base.

Tuttavia, è necessario installare software aggiuntivo per compilare altri tipi di progetti. Ad esempio, è necessario installare Visual Studio per compilare un progetto di installazione.

Per verificare che l'agente di compilazione possa compilare i progetti

1. Installare una versione ed edizione qualsiasi di Visual Studio utilizzata dal team nel computer di compilazione nel quale viene eseguito l'agente di compilazione.

2. Installare qualsiasi altro software e componente installati nell'ambiente di sviluppo e necessari per compilare l'applicazione.

Installare il software necessario per eseguire altre attività

Per l'esecuzione di varie altre attività, potrebbe essere necessario installare software aggiuntivo nel computer di compilazione. Nella tabella seguente viene identificata un'attività comune dell'agente di compilazione e il software necessario per eseguirla.

Assegnare tag a un agente di compilazione

Man mano che la dimensione del sistema di compilazione aumenta, sarà probabilmente 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 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 computer 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 computer di compilazione.

Utilizzare i tag per rappresentare le funzionalità dell'agente di compilazione

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

Utilizzare i tag per bilanciare il carico del processo di compilazione

È possibile utilizzare i tag per bilanciare il carico del lavoro relativo al processo di compilazione che il team deve eseguire. Ad esempio, è possibile disporre di una definizione di compilazione denominata Check-in Build che convalida le archiviazioni. Per ulteriori informazioni, vedere Definire una compilazione di archiviazione gestita per convalidare le modifiche. Questa definizione di compilazione viene eseguita spesso ed è possibile eseguirne solo un'istanza per volta. Viene pertanto configurato un computer di compilazione che dispone di hardware dalle prestazioni elevate (ad esempio, un processore multicore e un'unità disco rigido veloci). Si crea quindi un agente di compilazione in tale computer e si assegna a esso il tag check-in. Si configura la definizione di compilazione per l'esecuzione solo su un agente di compilazione che dispone del tag check-in.

Si dispone di un'altra definizione di compilazione denominata Fast Track Build, utilizzata per elaborare le compilazioni di un progetto con priorità assoluta alle quali sta lavorando un team. Si configura un altro agente di compilazione che soddisfa i requisiti di questo progetto speciale. Si assegna a tale agente il tag FastTrack, quindi si configura la definizione di compilazione per l'esecuzione solo su un agente di compilazione che dispone di questo tag.

Per applicare un tag a un agente di compilazione su un computer client

1. Scegliere Gestisci controller di compilazione dal menu Compila.

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

2. Fare clic sull'agente di compilazione a cui si desidera applicare un tag, quindi su Proprietà.

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

3. Utilizzare uno dei metodi seguenti per applicare uno o più tag:

   • Selezionare uno o più tag dall'elenco.

   • Fare clic sul collegamento Aggiungi nuovo tag. Nella finestra di dialogo Aggiungi nuovo tag digitare il nome del tag che si desidera applicare.

Per applicare un tag a un agente di compilazione sul computer di compilazione

1. Accedere al computer di compilazione che esegue l'agente di compilazione che si desidera modificare.

2. Fare clic su Start, scegliere Tutti i programmi, Microsoft Team Foundation Server 2010, quindi fare clic su Console di amministrazione di Team Foundation.

   Verrà visualizzata la Console di amministrazione di Team Foundation.

3. Nel riquadro della struttura ad albero espandere il nome del server, quindi fare clic sul nodo Team Foundation Build.

4. Immediatamente sotto il nome dell'agente di compilazione fare clic su Proprietà.

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

5. Utilizzare uno dei metodi seguenti per applicare uno o più tag:

   • Selezionare uno o più tag dall'elenco.

   • Fare clic sul collegamento Aggiungi nuovo tag. Nella finestra di dialogo Aggiungi nuovo tag digitare il nome del tag che si desidera applicare.

Rimuovere un agente di compilazione

È possibile rimuovere un agente di compilazione utilizzando un computer client o direttamente dal computer di compilazione che ospita l'agente di compilazione.

Nota   La rimozione dell'agente di compilazione non implica la disinstallazione di servizio Team Foundation Build dal computer di compilazione.

Per rimuovere un agente di compilazione utilizzando un computer client

1. Scegliere Gestisci controller di compilazione dal menu Compila.

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

2. Fare clic sul controller di compilazione o sull'agente di compilazione che si desidera rimuovere, quindi su Elimina.

Per rimuovere un agente di compilazione dal computer di compilazione

1. Accedere al computer di compilazione che esegue l'agente di compilazione che si desidera modificare.

2. Fare clic su Start, scegliere Tutti i programmi, Microsoft Team Foundation Server 2010, quindi fare clic su Console di amministrazione di Team Foundation.

   Verrà visualizzata la Console di amministrazione di Team Foundation.

3. Nel riquadro della struttura ad albero espandere il nome del server, quindi fare clic sul nodo Team Foundation Build.

4. Immediatamente sotto il nome dell'agente di compilazione fare clic su Elimina.

Vedere anche

Altre risorse

Definire il processo di compilazione

Cronologia delle modifiche