Condividi tramite

Distribuire e configurare gli agenti di compilazione

  • Articolo

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.

Due server 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.

SuggerimentoSuggerimento

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

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 Configurare le funzionalità installateConfigura 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

      Agente di compilazione

      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 Icona HomeHome, quindi selezionare Icona CompilazioniCompilazioni.

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

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

    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.

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.

SuggerimentoSuggerimento

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

Bb399135.collapse_all(it-it,VS.110).gifUtilizzare 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.

    SuggerimentoSuggerimento

    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.

Bb399135.collapse_all(it-it,VS.110).gifEsempio 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

Bb399135.collapse_all(it-it,VS.110).gifVerificare 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\.

Bb399135.collapse_all(it-it,VS.110).gifSottodirectory create nella cartella di lavoro

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

Sottodirectory

Utilizzata per archiviare file...

Sources

Letti dall'agente di compilazione, ad esempio i file di origine.I file scaricati vengono specificati nelle impostazioni Area di lavoro per ogni definizione di compilazione.Vedere Utilizzare aree di lavoro di compilazione.

Binaries

Compilati dall'agente di compilazione, ad esempio file di applicazione compilati.

TestResults

Generati dai test eseguiti dall'agente di compilazione.

Abilitare l'agente di compilazione per eseguire test

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

Nota importanteImportante

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:

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 il seguente tag...

Attività identificata dal tag eseguita dall'agente di compilazione

x86

Compilazione di applicazioni a 32 bit

x64

Compilazione di applicazioni a 64 bit

bvt

Eseguire i test di verifica della compilazione eseguiti dal compilazione BVT notturna.

WindowsStore

Compilare e testare un'applicazione Windows Store.

IIS

Compilazione, installazione di appoggio e hosting di un'applicazione Web ASP.NET nel computer su cui viene eseguito l'agente di compilazione.

interattivo

Eseguire le attività che richiedono un agente in un server di compilazione in esecuzione in modalità interattiva.

È 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.

SuggerimentoSuggerimento

È 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