Gruppi di attività nelle pipeline classiche

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Nelle pipeline classiche un gruppo di attività incapsula una sequenza di attività già definite in una pipeline in una singola attività riutilizzabile. Il nuovo gruppo di attività viene aggiunto automaticamente al catalogo attività e può essere aggiunto alle pipeline nel progetto esattamente come altre attività. I gruppi di attività vengono archiviati a livello di progetto e non sono accessibili all'esterno dell'ambito del progetto.

I gruppi di attività sono un modo per standardizzare e gestire a livello centrale i passaggi di distribuzione per tutte le applicazioni. Quando si apporta una modifica centralmente a un gruppo di attività, la modifica viene riflessa automaticamente in tutte le definizioni della pipeline che usano il gruppo di attività. Non è necessario modificare ogni definizione singolarmente.

Nota

I gruppi di attività non sono supportati nelle pipeline YAML. È invece possibile usare modelli.

Prerequisiti

• Un'organizzazione e un progetto di Azure DevOps in cui si dispone dell'autorizzazione per creare pipeline.
• Pipeline classica creata nel progetto.

Estrarre i parametri dell'attività come variabili

Quando si crea un gruppo di attività, è possibile scegliere di estrarre i parametri dalle attività incapsulate come variabili di configurazione e astrarre il resto delle informazioni sull'attività. Le variabili usate nelle attività vengono estratte e convertite automaticamente in parametri per il gruppo di attività e i valori di queste variabili di configurazione vengono convertiti in valori predefiniti per il gruppo di attività.

È anche possibile modificare i valori predefiniti per i parametri quando si salva il nuovo gruppo di attività. Quando si accoda un'esecuzione o una versione della pipeline, le attività incapsulate vengono estratte e i valori immessi per i parametri del gruppo di attività vengono applicati alle attività.

Prima di creare un gruppo di attività, assicurarsi di definire tutti i parametri da configurare nelle esecuzioni della pipeline come variabili, ad esempio $(MyVariable). Tutti i parametri dell'attività che non hanno valori o hanno valori specificati anziché le variabili diventano parametri fissi e non vengono esposti al gruppo di attività come parametri configurabili.

È anche possibile configurare le condizioni delle attività in un gruppo di attività, ad esempio Esegui questa attività solo quando un'attività precedente non è riuscita per un'attività script di PowerShell e queste condizioni vengono mantenute con il gruppo di attività.

Nota

I gruppi di attività sono supportati nelle pipeline classiche e nelle pipeline di versione classica.

Creare un gruppo di attività

Quando si salva un nuovo gruppo di attività, specificare un nome e una descrizione e selezionare una categoria per il gruppo di attività nel catalogo attività.

1. Aprire la pipeline in cui si vuole creare un nuovo gruppo di attività.

2. Per assicurarsi che nessuna delle attività che si intende includere contenga parametri collegati, selezionare Scollega tutto nel pannello delle impostazioni della pipeline e quindi selezionare Conferma.

   

3. Selezionare una sequenza di attività della pipeline da trasformare in un gruppo di attività, fare clic con il pulsante destro del mouse per aprire il menu di scelta rapida e quindi scegliere Crea gruppo di attività.

   

4. Specificare un nome e una descrizione per il nuovo gruppo di attività e la categoria nel riquadro Aggiungi attività a cui si vuole aggiungerlo.

5. Seleziona Crea. Il nuovo gruppo di attività viene creato e sostituisce le attività selezionate nella pipeline.

6. Tutte le '$(vars)' attività sottostanti, ad eccezione delle variabili predefinite, eseguono come parametri obbligatori per il gruppo di attività appena creato ed è possibile modificare i valori, se necessario.

   Ad esempio, se si dispone di un input foobar di attività che non si intende parametrizzare, l'input dell'attività viene convertito nel parametro 'foobar'del gruppo di attività . È possibile specificare il valore predefinito per il parametro 'foobar' del gruppo di attività per $(foobar) assicurarsi che in fase di esecuzione l'attività espansa ottenga l'input previsto.

7. Salvare la pipeline aggiornata.

Gestire i gruppi di attività

Tutti i gruppi di attività nel progetto corrente sono elencati in Pipeline nella pagina Gruppi di attività.

Nella parte superiore della pagina Gruppi di attività è possibile selezionare Importa per importare le definizioni dei gruppi di attività salvate in precedenza. È possibile usare questa funzionalità per trasferire gruppi di attività tra progetti e aziende oppure replicare e salvare copie dei gruppi di attività.

È anche possibile selezionare Sicurezza nella parte superiore della pagina per definire chi può usare, modificare, eliminare o impostare le autorizzazioni per tutti i gruppi di attività nel progetto.

Per gestire un gruppo di attività, fare clic con il pulsante destro del mouse o selezionare l'icona Altre azioni per il gruppo e selezionare una delle opzioni seguenti dal menu di scelta rapida:

• Selezionare Elimina per eliminare il gruppo di attività e quindi selezionare di nuovo Elimina nella schermata di conferma.
• Selezionare Esporta per salvare una copia del gruppo di attività come pipeline JSON.
• Selezionare Sicurezza per definire chi può usare, modificare, eliminare o impostare le autorizzazioni per il gruppo di attività.

Per aprire la pagina dei dettagli del gruppo di attività per la modifica, selezionare il nome del gruppo di attività nella pagina Gruppi di attività.

• Nella scheda Attività è possibile modificare le attività che costituiscono il gruppo di attività. Per ogni attività incapsulata è possibile modificare i valori dei parametri per i parametri non variabili, modificare le variabili di parametro esistenti o convertire i valori dei parametri in e da variabili. Quando si salvano le modifiche, tutte le definizioni che usano il gruppo di attività selezionano le modifiche.

  Tutti i parametri delle variabili del gruppo di attività vengono visualizzati come parametri obbligatori nella definizione della pipeline. È anche possibile impostare i valori predefiniti per i parametri del gruppo di attività.

• Nella scheda Cronologia è possibile visualizzare la cronologia delle modifiche apportate al gruppo.

• Nella scheda Riferimenti è possibile visualizzare gli elenchi di tutte le pipeline e di altri gruppi di attività che fanno riferimento a questo gruppo di attività. Questo elenco consente di assicurarsi che le modifiche non abbiano effetti imprevisti su altri processi.

Creare versioni di anteprima e aggiornate dei gruppi di attività

Tutte le attività predefinite di Azure Pipelines vengono con controllo delle versioni. Il controllo delle versioni consente alle pipeline di continuare a usare la versione esistente di un'attività mentre vengono sviluppate, testate e rilasciate nuove versioni. È possibile eseguire la versione dei gruppi di attività personalizzati nello stesso modo per offrire gli stessi vantaggi.

1. Per eseguire la versione di un gruppo di attività, dopo averlo modificato, selezionare Salva come bozza anziché Salva.

   

2. La stringa -test viene aggiunta al numero di versione del gruppo di attività. Quando si è soddisfatti delle modifiche, scegliere Pubblica bozza. Nella schermata Pubblica bozza di gruppo di attività selezionare Pubblica come anteprima se si vuole pubblicare la nuova versione come anteprima e quindi selezionare Pubblica.

   

3. È ora possibile usare il gruppo di attività aggiornato nei processi di rilascio. È possibile modificare il numero di versione nelle pipeline che usano già il gruppo di attività oppure scegliere il gruppo di attività con versione nel riquadro Aggiungi attività . Come per le attività predefinite, l'impostazione predefinita quando si aggiunge un gruppo di attività è la versione non di anteprima più recente.

   

4. Dopo aver completato il test del gruppo di attività aggiornato, scegliere Pubblica anteprima e quindi selezionare Pubblica. La stringa di anteprima viene rimossa dal numero di versione e la versione ora viene visualizzata nelle definizioni come versione pronta per la produzione.

   

5. È ora possibile selezionare la nuova versione pronta per la produzione in una pipeline che contiene già il gruppo di attività. Quando si aggiunge il gruppo di attività dal pannello Aggiungi attività , viene selezionata automaticamente la nuova versione pronta per la produzione. È possibile modificare la pipeline per usare una versione precedente.

   

Usare le versioni del gruppo di attività

Gli aggiornamenti del gruppo di attività possono essere aggiornamenti secondari o principali della versione.

Creare un aggiornamento della versione secondaria

Per creare un aggiornamento della versione secondaria, salvare direttamente il gruppo di attività dopo averlo modificato anziché salvarlo come bozza.

Il numero di versione non cambia e le modifiche più recenti vengono visualizzate automaticamente nella definizione della pipeline. Ad esempio, se il gruppo di attività è versione 1, è possibile avere un numero qualsiasi di aggiornamenti di versione secondaria, ad 1.1esempio , 1.2e 1.3. Nella pipeline la versione del gruppo di attività viene visualizzata come 1.*.

Usare gli aggiornamenti delle versioni secondarie per piccole modifiche nel gruppo di attività, quando si prevede che le pipeline usino la nuova modifica senza modificare il numero di versione nella definizione della pipeline.

Creare un aggiornamento della versione principale

Per creare una nuova versione principale, salvare gli aggiornamenti del gruppo di attività come bozza e creare un'anteprima, convalidare le modifiche e quindi pubblicare l'anteprima.

Questo processo consente di spostare il gruppo di attività in una nuova versione. Se si dispone di un gruppo di attività con versione 1.*, le nuove versioni vengono pubblicate come 2.*, 3.*, 4.*e così via.

Viene visualizzata una notifica sulla disponibilità della nuova versione in tutte le definizioni della pipeline che usano il gruppo di attività. Gli utenti devono eseguire l'aggiornamento esplicito alla nuova versione del gruppo di attività se vogliono usarla nelle pipeline.

Quando si apportano modifiche sostanziali che potrebbero interrompere le pipeline esistenti, è possibile testare e implementare le modifiche come nuova versione principale. Gli utenti possono scegliere di eseguire l'aggiornamento alla nuova versione o di rimanere nella versione corrente. Questa funzionalità è identica a quella di un normale aggiornamento della versione dell'attività.

Testare un aggiornamento della versione secondaria

Se l'aggiornamento del gruppo di attività non è una modifica che causa un'interruzione, ma si vuole prima testare e quindi forzare tutte le pipeline a usare le modifiche più recenti, seguire questa procedura:

1. Salvare le modifiche del gruppo di attività come bozza. Con le modifiche viene creato un nuovo gruppo di attività bozza denominato <Taskgroupname> (Bozza).
2. Aggiungere questo gruppo di attività bozza direttamente alla pipeline di test.
3. Convalidare le modifiche nella pipeline di test. Quando si è certi delle modifiche, tornare al gruppo di attività principale, eseguire le stesse modifiche e salvarle direttamente. Le modifiche vengono salvate come aggiornamento della versione secondaria.
4. Le nuove modifiche vengono ora visualizzate in tutte le pipeline che usano questo gruppo di attività. È ora possibile eliminare il gruppo di attività bozza.

Assistenza e supporto

• Esplorare i suggerimenti per la risoluzione dei problemi.
• Ottenere consigli su Stack Overflow.
• Pubblicare domande, cercare risposte o suggerire una funzionalità nella community di sviluppatori di Azure DevOps.
• Ottenere supporto per Azure DevOps.

Contenuto correlato

• Attività
• Processi attività