Attivare un rilascio da una compilazione

Avviare un rilascio automaticamente quando si compila un'app con Team Foundation Build. È possibile scegliere la fase iniziale del processo di rilascio. Per attivare un rilascio da una compilazione, è necessario configurare sia il processo di compilazione che il percorso di rilascio.

Se il percorso di rilascio precedente non è ancora stato creato, vedere qui per eseguire questa operazione.

Inoltre, se il sistema di compilazione non è ancora stato impostato, impostarlo ora.

Configurare il processo di compilazione

1. Se non è disponibile l'autorizzazione per modificare le definizioni di compilazione, ottenerle ora.

2. In Visual Studio, andare in Team Explorer e connettersi al progetto team da usare (scelta rapida da tastiera: CTRL+0, C).

3. Nella pagina Compilazioni (scelta rapida da tastiera; CTRL+0, B) creare o modificare una definizione di compilazione.

4. Nella scheda Processo della definizione di compilazione scegliere la configurazione da usare per il rilascio (ad esempio, debug o rilascio). Impostare Compilazione di rilascio su True. Scegliere la fase specifica che si vuole attivare per il rilascio o lasciare questo campo vuoto se si vuole iniziare con la prima fase.

   

   Se la sezione Rilascio non viene visualizzata:

   • D: Uso il modello predefinito. Quale modello di processo di compilazione è necessario usare per Release Management e come è possibile aggiungerlo a TFS?

   • D: Uso il modello di aggiornamento. Quale modello di processo di compilazione è necessario usare per Release Management?

   • D: Uso un modello di processo di compilazione personalizzato. Come è possibile aggiungere logica del flusso di lavoro per attivare un rilascio?

   Se sono disponibili componenti con file di configurazione per cui sono necessari valori diversi in base all'ambiente di destinazione, è possibile rappresentare il file di configurazione in formato token.

5. Specificare tutte le altre impostazioni richieste dal processo di compilazione, quindi salvare la definizione di compilazione.

Configurare il modello di rilascio

1. Se Release Management Client per Visual Studio 2013 non è installato nel server di compilazione, installarlo ora. Configurare Release Management Client per la connessione a Release Management Server.

   Dopo aver installato il client nel server di compilazione, è necessario riavviare i servizi di compilazione. Eseguire questa operazione nella Console di amministrazione di Team Foundation Server.

2. Nel modello di rilascio scegliere la definizione di compilazione impostata per attivare una compilazione e selezionare la casella di controllo per abilitare il processo di compilazione per attivare un rilascio.

   

   Se la selezione della definizione di compilazione non viene visualizzata, è necessario aggiungere la connessione a TFS a Release Management Client. Aggiungere la connessione nella scheda Gestisci TFS della sezione Amministrazione.

   Dopo che il rilascio è stato attivato, ne vengono eseguiti i passaggi nella fase selezionata. Se le opzioni Passaggio di accettazione e Fase di distribuzione non vengono impostate su Automatizzato per questa fase, il rilascio non verrà avviato. È necessario contrassegnare questi passaggi come automatizzati nel percorso di rilascio.

Domande e risposte

D: Uso il modello predefinito.Quale modello di processo di compilazione è necessario usare per Release Management e come è possibile aggiungerlo a TFS?

R: Se si usa il modello predefinito, è sufficiente sostituirlo con il modello di processo di gestione del rilascio corrispondente.

1. Se non è disponibile l'autorizzazione per collaborare sui file o per modificare le definizioni di compilazione, ottenerla ora.

2. In Visual Studio, andare in Team Explorer e connettersi al progetto team da usare (scelta rapida da tastiera: CTRL+0, C).

3. Nella cartella Unità:\Programmi (x86)\ Microsoft Visual Studio 12.0\ReleaseManagement\bin individuare il modello necessario. In alternativa, scaricare il modello in questa directory dal file con estensione zip disponibile in questo post di blog.

   • TFS 2013

     • TFVC: ReleaseTfvcTemplate.12.xaml.

     • Git: ReleaseGitTemplate.12.xaml

   • TFS 2012: ReleaseDefaultTemplate.11.1.xaml

   • TFS 2010: ReleaseDefaultTemplate.xaml

4. Aggiungere il modello al controllo della versione. È consigliabile inserire il modello nella cartella BuildProcessTemplates del progetto team.

   • TFVC: Aggiungere file al server

   • Git - Gestire file nel computer di sviluppo

5. Nella pagina Compilazioni (scelta rapida da tastiera CTRL + 0, B) creare o modificare una definizione di compilazione.

6. Nella scheda Processo scegliere Nuovo per selezionare il modello da usare per il File processo di compilazione. Dovrebbe essere possibile individuare e selezionare il modello appena aggiunto.

D: Uso un modello di processo di compilazione personalizzato.Come è possibile aggiungere logica del flusso di lavoro per attivare un rilascio?

R: Aggiungere sezioni al modello di processo di compilazione personalizzato per fornire la logica del flusso di lavoro. Scaricare il file di frammenti di codice con tali sezioni qui. Usare i frammenti di codice per aggiungere questi argomenti ConfigurationsToRelease, ReleaseBuild, ReleaseTargetStage e DropBuild al modello di processo di compilazione.

Salvare il modello di processo di compilazione Se si usa il controllo della versione di Team Foundation, archiviarlo. Se si usa Git, eseguire il commit e il push del modello di processo di compilazione.

D: Uso il modello di aggiornamento.Quale modello di processo di compilazione è necessario usare per Release Management?

R: Per altre informazioni sulle operazioni da effettuare, vedere qui.

D: È possibile distribuire i componenti dell'applicazione su computer diversi?

R: Sì, è possibile creare componenti tramite Release Management Client e aggiungerli al modello di rilascio.

È quindi possibile aggiungere questi componenti alla compilazione.

Quando viene visualizzata la finestra Componenti, fare doppio clic sul componente da aggiungere.

Ogni componente aggiunto deve essere configurato come Compilazioni con applicazione o Compilazioni esterne.

Un simbolo "\" nel percorso specificato da Destinazione finale della compilazione indica che la compilazione si trova nella radice della cartella di ricezione.

D: Quali strumenti è possibile usare per distribuire un componente?

R: Per ogni componente definito, è possibile selezionare lo strumento da usare nella scheda Distribuzione. Per altre informazioni su ogni strumento, vedere qui.

Sostituire il valore del campo Argomenti con informazioni specifiche per la distribuzione del componente.

Per usare uno strumento personalizzato, aggiungerlo innanzitutto nella pagina Inventario, quindi selezionarlo nella scheda Distribuzione.

Verificare che i file cui fa riferimento il comando siano disponibili nel percorso del pacchetto al momento della distribuzione.

D: Perché il rilascio non è stato avviato?

Di seguito vengono indicati alcuni dei problemi possibili:

• Configurazione della compilazione per l'attivazione di un rilascio (Compilazione di rilascio=True) e deselezione della casella di controllo Si può attivare un rilascio da una compilazione? per il modello di rilascio. Questa condizione provoca effettivamente un errore di compilazione e di conseguenza il rilascio non viene avviato.

• Configurazione del modello di rilascio per l'uso di una definizione di compilazione non impostata per attivare un rilascio (Compilazione di rilascio=False) o non contenente la logica di rilascio corretta.

• Modello di rilascio contenente un componente configurato per essere compilato in modo indipendente.

• Opzioni Passaggio di accettazione e Fase di distribuzione non impostate su Automatizzato per la fase selezionata per l'attivazione dal rilascio. In questo caso il rilascio non verrà avviato. È necessario impostare tali passaggi come automatizzati per questo percorso di rilascio.

• Release Management Client non installato nel computer che esegue il server Team Foundation Build.

• Tempo necessario per completare una distribuzione superiore a 10 minuti. È possibile modificare il valore assegnato al Timeout della distribuzione attivata da TFS nella scheda Amministrazione, pagina Impostazioni.

D: Come è possibile gestire i file di configurazione per cui sono necessari valori diversi in base all'ambiente di destinazione?

R: Usare dei file di configurazione in formato token.

Per ogni file di configurazione della soluzione che richiede valori diversi in ambienti differenti, creare una versione del file in formato token.

Se ad esempio la soluzione contiene un file denominato web.config, eseguire una copia di tale file e assegnargli il nome web.config.token. Il file web.config non cambia e viene usato quando l'applicazione viene eseguita localmente. Il file web.config.token contiene i token anziché i valori effettivi.

Se ad esempio il file web.config contiene la riga seguente:

<add key="SMTPHostServer" value="mysmtp.myserver.domain"/>

il file web.config.token conterrà la riga indicata di seguito, dove SMTPHostServer è il token:

<add key="SMTPHostServer" value="SMTPHostServer"/>

Mantenere sincronizzati i file locali e i file in formato token.

D: Come è possibile definire i file da ricercare per sostituire i token con variabili?

R: Per ogni componente definito, è possibile specificare il filtro di estensione di file nella scheda Variabili di configurazione.

L'istanza di Deployment Agent specificata per il componente usa criteri di ricerca per eseguire la ricerca dei set di file per cui è necessario sostituire i token con variabili. Separare due o più estensioni di file usando un punto e virgola (;).