Definire una compilazione utilizzando il modello di aggiornamento

Articolo
08/11/2011

È possibile utilizzare il modello di aggiornamento per continuare a utilizzare definizioni di compilazione legacy in Visual Studio Team Foundation Server 2010. In particolare, è possibile utilizzare questo modello per eseguire i tipi di oggetti di compilazione seguenti:

Definizioni di compilazione create tramite Visual Studio Team System 2008 Team Foundation Server.
Tipi di compilazione creati tramite Visual Studio 2005 Team Foundation Server.

Quando inizialmente si esegue l'aggiornamento a Team Foundation Server 2010, il sistema crea automaticamente una definizione di compilazione del modello di aggiornamento per ogni definizione di compilazione legacy e per ogni tipo di compilazione presente nel sistema.

Inoltre, quando si utilizza una versione precedente di ALM di Visual Studio per creare una definizione di compilazione o un tipo di compilazione in un server che esegue Team Foundation Server 2010, il sistema creerà automaticamente una definizione di compilazione del modello di aggiornamento.

Per modificare la maggior parte degli aspetti di questi oggetti di compilazione legacy, è necessario modificare il file TFSBuild.proj. Per ulteriori informazioni, vedere Destinazioni, attività e proprietà di Team Foundation Build. È tuttavia possibile modificare alcune impostazioni nell'oggetto della definizione di compilazione aprendo il nodo Compilazioni in Team Explorer. Tali impostazioni vengono descritte in questo argomento

Autorizzazioni necessarie

Per eseguire questa procedura, è necessario che l'autorizzazione Modifica definizione di compilazione sia impostata su Consenti. Per ulteriori informazioni, vedere Autorizzazioni per Team Foundation Server.

Per modificare una definizione di compilazione del modello di aggiornamento

In Team Explorer espandere il progetto team nel quale si desidera definire la compilazione, quindi espandere il nodo Compilazioni.
Fare clic con il pulsante destro del mouse sulla definizione di compilazione che si desidera modificare, quindi scegliere Modifica definizione di compilazione.
Nella scheda Impostazioni predefinite compilazione scegliere un controller di compilazione dal menu Controller di compilazione.
Fare clic sulla scheda Processo.
Verificare che sotto il modello del processo di compilazione sia visualizzato Modello di aggiornamento.
Espandere il nodo Obbligatorio.
In Percorso della cartella di configurazione verificare che il percorso alla cartella che contiene il file TFSBuild.proj sia specificato correttamente.
Utilizzare le informazioni riportate più avanti in questo argomento per completare i campi che forniscono la funzionalità da inserire in questa definizione di compilazione.
Dopo avere completato i campi nella scheda Processo, è necessario modificare i campi nelle schede Trigger, Area di lavoro, Impostazioni predefinite compilazione e Criteri di conservazione.

Per ulteriori informazioni, vedere Creare una definizione di compilazione di base.

In questo argomento

Informazioni sui parametri del processo di compilazione per il modello di aggiornamento
Specificare il livello di dettaglio del log
Specificare quali agenti di compilazione elaborano la compilazione
Specificare i limiti di tempo dell'agente di compilazione
Specificare i parametri avanzati del processo di compilazione

Informazioni sui parametri del processo di compilazione per il modello di aggiornamento

In questo argomento viene illustrato come modificare una compilazione utilizzando i parametri del processo di compilazione per le compilazioni basate sul modello di aggiornamento. Queste informazioni devono corrispondere a Visual Studio Application Lifecycle Management (ALM) purché siano vere le condizioni seguenti:

Si collabora a un progetto team creato da uno dei due modelli di processo inclusi in ALM di Visual Studio: MSF for Agile Software Development v5.0 o MSF for CMMI Process Improvement v5.0.
Nessun membro del team ha rimosso o personalizzato il modello di aggiornamento.

Specificare il livello di dettaglio del log

Per specificare il livello di dettaglio del log visualizzato nella finestra Risultati compilazione, espandere il nodo Base, quindi selezionare un valore nell'elenco Livello di dettaglio registrazione. Nella tabella riportata di seguito sono elencati i valori del livello di dettaglio registrazione e gli effetti corrispondenti.

Valore	Errori durante la compilazione	Avvisi di compilazione	Importanza elevata Compilazione Messaggi	Importanza normale Compilazione Messaggi	Importanza bassa Compilazione Messaggi	Proprietà attività di flusso di lavoro (input e output)
Minimal	S	N	N	N	N	N
Normal	S	S	S	N	N	N
Detailed	S	S	S	S	N	N
Diagnostic	S	S	S	S	S	S

Il valore del livello di dettaglio registrazione specificato influisce inoltre sul livello di dettaglio dei messaggi generati da MSBuild. Per ulteriori informazioni, vedere Riferimenti alla riga di comando di MSBuild.

Per ulteriori informazioni sui report di compilazione, vedere Visualizzare la finestra Risultati compilazione.

Specificare quali agenti di compilazione elaborano la compilazione

Per specificare quali agenti di compilazione vengono utilizzati per elaborare la compilazione, espandere il nodo Avanzate, espandere il nodo Impostazioni agente, quindi compilare una delle seguenti caselle:

Filtro nomi: è possibile filtrare gli agenti di compilazione utilizzati per elaborare questa definizione di compilazione digitando il nome dell'agente in questo campo. È inoltre possibile specificare un set di nomi tramite i caratteri jolly * e ? . Ad esempio, è possibile specificare CI * per indicare qualsiasi agente il cui nome inizia con i caratteri CI. Gli agenti che possono corrispondere a questi criteri includono CI, CI1 o CI_Agente2.
Filtro tag: specificare uno o più tag per assicurarsi che questa compilazione verrà eseguita solo gli agenti di compilazione con tag corrispondenti. Ad esempio, viene impostato un agente di compilazione su un computer di compilazione progettato per elaborare le compilazioni di archiviazione gestita. Viene applicato il tag gestito a questo agente di compilazione. Infine viene applicato il tag gestito alla definizione di compilazione in modo che venga elaborata solo dall'agente anch'esso contrassegnato con il tag gestito. Per specificare tag, fare clic sul pulsante con i puntini di sospensione (...).

Nota

Il pool di agenti di compilazione disponibili per l'elaborazione di questa compilazione è determinato dal controller di compilazione specificato per questa definizione di compilazione. Per modificare il controller di compilazione, fare clic sulla scheda Impostazioni predefinite compilazione, quindi scegliere un controller di compilazione dal menu Controller di compilazione.

Specificare i limiti di tempo dell'agente di compilazione

Per specificare limiti di tempo, espandere il nodo Avanzate, espandere il nodo Impostazioni agente, quindi specificare i parametri seguenti.

Per...	Impostare il parametro…	Seguendo queste istruzioni…
Specificare il tempo massimo consentito all'agente di compilazione per elaborare la compilazione	Tempo massimo di esecuzione	Digitare un valore per l'intervallo di tempo nel formato hh:mm:ss. Ad esempio, la compilazione non verrà completata e restituirà un errore di timeout se si specifica il valore 04.30.15 e l'agente di compilazione non ha completato il lavoro dopo 4 ore, 30 minuti e 15 secondi. Specificare il valore 00.00.00 se si desidera assegnare all'agente di compilazione un tempo illimitato per elaborare la compilazione.
Specificare il tempo massimo consentito per assegnare la richiesta di compilazione a un agente di compilazione	Tempo massimo di attesa	Digitare un valore per l'intervallo di tempo nel formato hh:mm:ss. Ad esempio, la compilazione non verrà completata e restituirà un errore di timeout se si specifica il valore 01.30.45 e la compilazione non è stata assegnata a un agente di compilazione dopo 1 ora, 30 minuti e 45 secondi. Specificare il valore 00.00.00 se si desidera assegnare al controller di compilazione un tempo illimitato per trovare un agente di compilazione per elaborare la definizione di compilazione.

Specificare i parametri avanzati del processo di compilazione

Per completare correttamente alcuni degli scenari meno comuni, è necessario modificare i parametri del processo di compilazione nel nodo Avanzate.

Per...	Impostare il parametro…	Seguendo queste istruzioni…
Specificare la sottodirectory in cui si trovano i binari dopo la compilazione	Sottodirectory dei binari	Se non si specifica una sottodirectory, il sistema utilizzerà una sottodirectory denominata Binaries.
Utilizzare la definizione del tipo di compilazione esistente nel computer locale	Non scaricare tipo di compilazione	Impostare questo flag su True se si desidera utilizzare la definizione del tipo di compilazione esistente nel computer locale, anziché scaricarla da Team Foundation Server. Il percorso locale utilizzato è l'area di lavoro locale per il tipo di compilazione. Questo parametro viene in genere impostato temporaneamente su True per consentire l'esecuzione del debug di un file TFSBuild.proj.
Generare file di log di errore e avviso per singoli progetti	File di log per progetto	Impostare questo valore su True per generare file di log di errore e avviso per singoli progetti anziché per singole combinazioni di piattaforma e configurazione.
Specificare gli argomenti della riga di comando da passare a MSBuild	Argomenti MSBuild	Se il processo di compilazione richiede il passaggio di argomenti a MSBuild, digitarli nel parametro Argomenti MSBuild. Per ulteriori informazioni, vedere Riferimenti alla riga di comando di MSBuild.
Specificare il numero di bit della versione MSBuild utilizzati per elaborare la compilazione	Piattaforma MSBuild	Specificare uno dei seguenti valori: Specificare Auto se si desidera eseguire MSBuild con lo stesso numero di bit della CPU del servizio Team Foundation Build installato nell'agente di compilazione. Specificare X86 per elaborare sempre questa compilazione utilizzando la versione a 32 bit di MSBuild. Poiché Visual Studio 2010 viene eseguito come un'applicazione a 32 bit, si possono verificare problemi quando la compilazione viene elaborata da un agente di compilazione che esegue la versione a 64 bit di servizio Team Foundation Build. Specificando X86, è possibile risolvere questi tipi di problemi. Specificare X64 per elaborare sempre questa compilazione utilizzando la versione a 64 bit di MSBuild. Nota Se si specifica questo valore, è necessario assicurarsi che la compilazione venga elaborata da un agente di compilazione ospitato da un computer di compilazione a 64 bit, utilizzando ad esempio un tag come spiegato precedentemente in questo argomento.In caso contrario, la compilazione non verrà completata.
Impostare MSBuild affinché ottenga e utilizzi in modo ricorsivo file presenti in Percorso della cartella di configurazione	Tipo di ricorsione	Specificare uno dei seguenti valori: Un livello se la cartella specificata in Percorso della cartella di configurazione contiene file che devono essere elaborati da MSBuild. Completo se la cartella specificata in Percorso della cartella di configurazione o una sottodirectory di tale cartella contiene file che devono essere elaborati da MSBuild.
Specificare la sottodirectory utilizzata per eseguire il mapping dell'area di lavoro e della compilazione	Sottodirectory origini	Impostare questo valore sulla sottodirectory delle origini appropriata per gli agenti di compilazione che utilizzano questo computer di compilazione. Se non si specifica una sottodirectory, il sistema utilizzerà una sottodirectory denominata Sources.
Specificare la sottodirectory utilizzata per archiviare i risultati dei test	Sottodirectory dei risultati di test	Impostare questo valore sulla sottodirectory dei risultati dei test appropriata per gli agenti di compilazione che utilizzano questo computer di compilazione. Se non si specifica una sottodirectory, il sistema utilizzerà una sottodirectory denominata TestResults.