Procedura: creare e gestire agenti di compilazione

Aggiornamento: novembre 2007

Prima di procedere alla creazione di una nuova definizione di compilazione, è necessario configurare un computer da designare come un agente di compilazione. Per ulteriori informazioni, vedere Procedura: configurare e installare Team Foundation Build. Dopo che Team Foundation Build ed i componenti richiesti sono stati installati su uno o più computer, è possibile utilizzare l'interfaccia utente di Visual Studio Team System per creare nuovi agenti di compilazione o gestire quelli esistenti. Ogni agente di compilazione può essere associato soltanto ad una porta. Nella maggior parte dei casi questo indica che ogni agente di compilazione viene associato ad un computer di compilazione. È comunque possibile specificare una porta interattiva che è possibile utilizzare eseguendo tfsbuildservice.exe dalla riga di comando. La porta interattiva consente di eseguire test che comportano l’apertura e la chiusura di Windows Forms. Per ulteriori informazioni, vedere Impostazioni del file TfsBuildService.exe.config nei componenti di Team Foundation Server e Procedura: configurare una porta interattiva per Team Foundation Build.

Autorizzazioni necessarie

Per eseguire questa procedura, è necessario disporre dell'autorizzazione Amministra generazione impostata su Consenti. Per ulteriori informazioni, vedere Autorizzazioni per Team Foundation Server.

Creazione di un nuovo agente di compilazione

Utilizzare la finestra di dialogo Gestisci agenti di compilazione per definire un computer come agente di compilazione.

Per creare un nuovo agente di compilazione

1. Selezionare il progetto team al quale si desidera associare l'agente di compilazione in Team Explorer.

2. Dal menu Compila fare clic su Gestisci agenti di compilazione.

   Viene mostrata la finestra di dialogo Gestisci agenti di compilazione.

3. Fare clic su Nuovo.

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

4. Digitare un nome per l'agente di compilazione nella casella di testo Nome Visualizzato.

   Nella finestra di dialogo Gestisci agenti di compilazione verrà visualizzato il nome.

5. È possibile Inserire una descrizione nella casella di testo Descrizione.

   Ad esempio, "Questo agente di compilazione è dedicato alle compilazioni sequenziali."

6. Nella casella di testo Nome computer, immettere il nome per il computer sul quale è installato Team Foundation Build.

7. Nella casella di testo Porta di comunicazione, immettere il numero della porta utilizzato da Team Foundation per comunicare con Team Foundation Build.

   Il valore predefinito è 9191. Per ulteriori informazioni sulle porte utilizzate da Team Foundation, vedere Architettura di sicurezza di Team Foundation Server.

8. Selezionare l'opzione Richiedi canale sicuro (HTTPS) se si desidera configurare l'agente di compilazione affinché richieda HTTPS e Secure Sockets Layer (SSL).

   Per ulteriori informazioni sui passaggi necessari per l'utilizzo di HTTPS, vedere Procedura: impostare un agente di compilazione per l'utilizzo di HTTPS e Secure Sockets Layer (SSL).

9. Nella casella di testo Cartella di lavoro, specificare la directory di lavoro sull'agente di compilazione.

   Il valore predefinito è $(Temp)\$(BuildDefinitionPath). La proprietà BuildDefinitionPath si espande in <progetto team>\<Nome definizione di compilazione>. È anche possibile utilizzare BuildDefinitionId che si espande in un identificatore intero, univoco nella definizione di compilazione. BuildDefinitionId normalmente viene utilizzato per creare un percorso più corto.

   Nota:
   Fare clic sul pulsante Predefinito per ripristinare i valori delle caselle di testo Comunicazioni e Cartella di lavoro rispettivi valori predefiniti.

   Attivo è l'impostazione predefinita per lo Stato agente. Altri valori vengono mostrati per visualizzare appropriatamente lo stato dell'agente.

Modifica e rimozione di agenti di compilazione

È inoltre possibile utilizzare la finestra di dialogo Gestisci agenti di compilazione per la modifica e la rimozione di agenti di compilazione che sono già stati definiti.

Per rimuovere un agente di compilazione

1. In Team Explorer, selezionare il progetto team che contiene l'agente di compilazione che si desidera rimuovere.

2. Dal menu Compila fare clic su Gestisci agenti di compilazione.

   Viene mostrata la Finestra di dialogo Gestisci agenti di compilazione.

3. Selezionare l'agente di compilazione che si desidera rimuovere dalla lista Agenti di compilazione, quindi fare clic su Rimuovi.

   L'agente di compilazione viene rimosso dall'elenco.

Per modificare un agente di compilazione

1. In Team Explorer, selezionare il progetto Team che contiene l'agente di compilazione che si desidera modificare.

2. Dal menu Compila fare clic su Gestisci agenti di compilazione.

   Viene mostrata la finestra di dialogo Gestisci agenti di compilazione.

3. Selezionare dalla lista Agenti di compilazione l'elemento che si vuole modificare e quindi fare clic su Modifica.

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

4. Nella finestra di dialogo Proprietà agente di compilazione, è possibile modificare qualsiasi voce e quindi fare clic su OK per salvare.

5. Per disattivare un agente di compilazione, selezionare Disattivato dal menu a discesa Stato agente.

   Quando lo stato dell'agente di compilazione è impostato su Disattivato, qualsiasi compilazione presente in coda vi rimarrà, in stato attivo, fino a che lo stato dell’agente di compilazione non sarà nuovamente impostato su Attivo.

Vedere anche

Attività

Procedura dettagliata: creazione di una definizione di compilazione in Team Foundation Build

Procedura: stabilire le autorizzazioni per l'agente di Team Foundation Build

Procedura: configurare e installare Team Foundation Build

Procedura dettagliata: personalizzazione di Team Foundation Build con un'attività personalizzata

Concetti

Cenni preliminari su Team Foundation Build

Altre risorse

Utilizzo delle definizioni di compilazione in Team Foundation Build