Distribuire e configurare un controller di compilazione

Per utilizzare Team Foundation Build, il team deve disporre di almeno 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.

Suggerimento
Se la raccolta di progetti team è ospitata su Team Foundation Service, è possibile utilizzare il Controller di compilazione ospitato invece di distribuire il proprio sistema di compilazione.

Ogni controller di compilazione è dedicato a un'unica raccolta di progetti team.Il controller di compilazione elabora alcune attività prevalentemente leggere, ad esempio determinare il nome della compilazione, creare l'etichetta nel controllo della versione, registrare note e segnalare lo stato della compilazione.Il controller di compilazione utilizza l'attività AgentScope per delegare il lavoro che richiede un utilizzo intensivo del processore, ad esempio la compilazione di codice o l'esecuzione di test, agli agenti di compilazione inclusi nel pool.Questi agenti di compilazione possono essere ospitati nello stesso server di compilazione o in uno diverso.

Poiché un controller di compilazione in genere non richiede tempi di elaborazione significativi, in molti casi è possibile inserirlo nello stesso computer di Team Foundation Server, come illustrato in precedenza, o in una macchina virtuale o fisica a basso consumo.

Tuttavia, un controller di compilazione può richiedere una quantità di memoria significativa in determinate situazioni, pertanto è necessario fornire memoria sufficiente in base alle necessità per fare in modo che funzioni correttamente.Oppure, secondo le necessità del team e le risorse, è possibile eseguire il controller di compilazione in un computer diverso dal Team Foundation Server.

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 controller di compilazione

• Abilitare i processi di compilazione per utilizzare i binari aggiuntivi

• Specificare il numero massimo di compilazioni in esecuzione simultanea

• Rimuovere un controller di compilazione

• Utilizzare il controller di compilazione ospitato in una raccolta di progetti team ospitata in Team Foundation Service

Creare o modificare un controller di compilazione

Per creare o modificare un controller di compilazione dal server di compilazione

1. Accedere al server di compilazione.

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

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.

   [!NOTA]

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

4. Nella pagina Configurazione compilazione:

   • Se un controller non è elencato, scegliere Nuovo controller.

   • Se un controller è già elencato:

     

     Scegliere Proprietà

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

Per modificare un controller 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 il controller di compilazione che si desidera modificare, quindi scegliere Proprietà.

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

Nei campi Nome visualizzato e Descrizione: digitare un nome e una descrizione che consentano ai membri del team di identificare facilmente il controller di compilazione appropriato quando vengono definiti i relativi processi di compilazione.

Vedere le sezioni riportate di seguito per informazioni dettagliate su come configurare il controller di compilazione.

Abilitare i processi di compilazione per utilizzare i binari aggiuntivi

È possibile personalizzare il processo di compilazione in modo più approfondito utilizzando:

• Assembly contenenti attività del flusso di lavoro personalizzate

• Attività MSBuild personalizzate

• Framework di test delle unità di terze parti nelle esecuzioni di test.

Per consentire ai processi di compilazione di utilizzare questi tipi di codice, verificare i file binari nella cartella (o in una qualsiasi delle cartelle figlio) specificata nella casella Percorso controllo della versione a assembly personalizzati.Quando si imposta o si modifica il valore in questa casella, il server di compilazione verrà automaticamente riavviato per caricare gli assembly.

Suggerimento
Se i risultati della compilazione includono un messaggio di errore TF215097, il processo di compilazione può includere un'attività personalizzata che non si trova in questa cartella o in una delle cartelle discendenti.

Per istruzioni su come archiviare i file binari nel controllo della versione, vedere Utilizzare i binari di terze parti che il codice non compila.

Specificare il numero massimo di compilazioni in esecuzione simultanea

Nella maggior parte dei casi, è consigliabile lasciare questo valore impostato su Imposta come predefinito il numero di agenti abilitati.Tuttavia, in alcuni casi, potrebbe essere necessario controllare la profondità della coda di compilazione.Ad esempio:

• Un numero eccessivo di compilazioni è impostato su In esecuzione anche se molte sono bloccate perché sono in attesa che venga loro assegnato un agente di compilazione.Questa situazione può confondere il team.Per evitare il problema, selezionare Specifica il massimo, quindi specificare un valore più basso del numero di agenti di compilazione nel pool del controller di compilazione.

• Progettare un modello di compilazione personalizzato per consentire alle compilazioni di utilizzare più di un agente di compilazione alla volta, da un pool di 12 agenti di compilazione nel controller di compilazione.Le compilazioni elaborate da questo controller di compilazione sono basate su un modello di compilazione personalizzato che delega contemporaneamente tre agenti di compilazione per elaborare la compilazione.Per rendere la coda delle compilazioni più utile, è possibile configurare il controller di compilazione con Numero massimo di compilazioni in esecuzione simultanea impostato su Specifica il massimo, con un valore pari a 4.

Rimuovere un controller di compilazione

1. In Visual Studio, aprire la finestra di dialogo Gestisci controller di compilazione, come illustrato in Modificare un controller di compilazione da Visual Studio.

2. Selezionare e quindi rimuovere ogni agente di compilazione nel controller di compilazione, scegliendo Rimuovi oppure Proprietà, quindi utilizzando la finestra di dialogo Proprietà agente di compilazione per assegnare l'agente di compilazione a un altro controller di compilazione.

3. Selezionare il controller di compilazione che si desidera rimuovere, quindi selezionare Rimuovi.

[!NOTA]

È inoltre possibile utilizzare la console di amministrazione di Team Foundation per rimuovere il controller di compilazione mentre si è connessi al server di compilazione.In tal caso, potrebbe tuttavia essere necessario utilizzare Visual Studio, oppure accedere prima ad altri server di compilazione, per rimuovere tutti gli agenti di compilazione remoti raccolti dal controller di compilazione.

Utilizzare il controller di compilazione ospitato in una raccolta di progetti team ospitata in Team Foundation Service

Se la raccolta di progetti team è ospitata su Team Foundation Service, è possibile ignorare la distribuzione del proprio controller di compilazione e utilizzare invece il controller di compilazione ospitato.Per utilizzare il Controller di compilazione ospitato, selezionarlo quando si definisce il processo di compilazione.

Il controller di compilazione ospitato fornisce un singolo agente di compilazione temporaneo standard.

Per ulteriori informazioni sulle funzionalità del controller di compilazione ospitato, vedere Utilizzare il controller di compilazione ospitato.

Passaggi successivi

• Distribuzione e configurazione degli agenti di compilazione
  Utilizzare un agente di compilazione per eseguire il lavoro che richiede un utilizzo intensivo della compilazione.È inclusa l'estrazione e l'archiviazione di file nel 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
  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
  Dopo avere distribuito il server di compilazione, è possibile gestirlo dalla console di amministrazione di Team Foundation.È possibile gestire il controller e gli agenti di compilazione dalla console di amministrazione di Team Foundation o da Visual Studio.

• Definire il processo di compilazione
  Una volta posizionato il sistema di compilazione, è possibile definire un processo di compilazione contenente le istruzioni sui progetti di codice da compilare, le azioni che avviano una compilazione, i test da eseguire e tutte le altre procedure richieste dal team.