Amministratori e sviluppatori di vRealize Automation Code Stream possono utilizzare il trigger Gerrit per integrare vRealize Automation Code Stream con il ciclo di vita di revisione del codice Gerrit. L'evento attiva una pipeline da eseguire quando si crea un set di patch, si pubblicano bozze, si uniscono modifiche al codice nel progetto Gerrit o si inseriscono direttamente le modifiche nel ramo Git.
Prerequisiti
- Verificare di essere un membro di un progetto in vRealize Automation Code Stream. In caso contrario, chiedere a un amministratore di vRealize Automation Code Stream di essere aggiunti come membri di un progetto. Vedere Come aggiungere un progetto in vRealize Automation Code Stream.
- Verificare che in vRealize Automation Code Stream sia presente un endpoint Gerrit configurato. Vedere Come integrare vRealize Automation Code Stream con Gerrit.
- Per attivare le pipeline, verificare di aver impostato le proprietà di input in modo che inviino i parametri Gerrit quando viene eseguita la pipeline.
Per informazioni sulla creazione dei parametri di input, vedere Pianificazione di una creazione nativa di integrazione e consegna continue in vRealize Automation Code Stream prima dell'aggiunta manuale di attività.
Procedura
- (Facoltativo) Fare clic sulla scheda Listener, quindi su Nuovo listener .
Nota: Ignorare questo passaggio se il listener Gerrit che si intende utilizzare per il trigger Gerrit è già definito.
- Selezionare un progetto.
- Immettere un nome per il listener Gerrit.
- Selezionare un endpoint Gerrit
- Immettere il token dell'API.
Il token dell'API CSP autentica l'utente per le connessioni API esterne con vRealize Automation Code Stream. Per ottenere il token API:
- Fare clic su Genera Token.
- Immettere l'indirizzo e-mail associato al nome utente e alla password, quindi fare clic su Genera.
Il token generato è valido per sei mesi. È anche noto come token di aggiornamento.
- Per mantenere il token come una variabile per un utilizzo futuro, fare clic su Crea variabile, assegnare un nome alla variabile e fare clic su Salva.
- Per mantenere il token come valore di testo per un utilizzo futuro, fare clic su Copia e incollare il token in un file di testo da salvare in locale.
- Fare clic su Chiudi.
Se è stata creata una variabile, nel token dell'API viene visualizzato il nome della variabile immesso. Se il token è stato copiato, il token dell'API mostra il token mascherato.
- Per convalidare i dettagli del token e dell'endpoint, fare clic su Convalida.
Il token scade dopo 90 giorni.
- Fare clic su Crea.
- Nella scheda del listener, fare clic su Connetti.
Il listener avvia il monitoraggio di tutte le attività nel server Gerrit e ascolta tutti i trigger abilitati in tale server. Per interrompere l'ascolto di un trigger in tale server, disabilitare il trigger.
- (Facoltativo) Specificare inclusioni o esclusioni di file come condizioni per il trigger.
- È possibile specificare le inclusioni dei file per disporre di pipeline di trigger. Quando uno qualsiasi dei file in un commit corrisponde ai file specificati nel regex o nei percorsi di inclusione, vengono attivate le pipeline. Con un regex specificato, vRealize Automation Code Stream attiva solo le pipeline i cui nomi file nell'insieme di modifiche corrispondono all'espressione specificata. Il filtro regex è utile quando si configura un trigger per più pipeline in un singolo repository.
- È possibile specificare esclusioni di file per impedire l'attivazione delle pipeline. Quando tutti file in un commit corrispondono ai file specificati nel regex o nei percorsi di esclusione, le pipeline non vengono attivate.
- Quando attivata, Assegna priorità all'esclusione garantisce che le pipeline non vengano attivate. Le pipeline non vengono attivate anche se uno qualsiasi dei dati in un commit corrisponde ai dati specificati nel regex nei percorsi di esclusione. L'opzione è disattivata per impostazione predefinita.
Nell'esempio seguente sia le inclusioni che le esclusioni sono condizioni per l'attivazione.
- Per le inclusioni dei file, un commit con una modifica a runtime/src/main/a.java o a qualsiasi file java attiva le pipeline configurate nella configurazione dell'evento.
- Per le esclusioni dei file, solo un commit con modifiche in entrambi i file non attiva le pipeline configurate nelle configurazioni dell'evento.
- Fare clic su Nuova configurazione.
- Per un evento Gerrit, selezionare Set di patch creato, Bozza pubblicata o Unione modifiche. In alternativa, per un inserimento diretto a Git che escluda Gerrit, selezionare Inserimento Git diretto.
- Selezionare la pipeline da attivare.
Se la pipeline è stata configurata con parametri di input aggiunti personalizzati, nell'elenco Parametri di input vengono visualizzati i parametri e i valori. È possibile immettere valori per i parametri di input da trasmettere alla pipeline con l'evento trigger. In alternativa, è possibile lasciare vuoti i valori oppure utilizzare i valori predefiniti.Nota: Se sono definiti valori predefiniti:
- Tutti i valori immessi per i parametri di input sostituiranno i valori predefiniti definiti nel modello della pipeline.
- I valori predefiniti utilizzati per configurare il trigger non verranno aggiornati se i valori dei parametri nel modello della pipeline vengono modificati.
Per informazioni sui parametri di input di invio automatico per i trigger Gerrit, vedere i Prerequisiti.
- Per Set di patch creato, Bozza pubblicata e Unione modifiche, alcune azioni vengono visualizzate con etichette per impostazione predefinita. È possibile modificare l'etichetta o aggiungere commenti. Quindi, quando la pipeline viene eseguita, l'etichetta o il commento vengono visualizzati nella scheda Attività come Azione intrapresa per la pipeline.
- Fare clic su Salva.
Per aggiungere più eventi trigger in più pipeline, fare di nuovo clic su Nuova configurazione.Nell'esempio seguente è possibile visualizzare gli eventi per tre pipeline:- Se si verifica un evento Unione modifiche nel progetto Gerrit, viene attivata Gerrit-Pipeline.
- Se si verifica un evento Set di patch creato nel progetto Gerrit, vengono attivate Gerrit-Trigger-Pipeline e Gerrit-Demo-Pipeline.
risultati
Operazioni successive
Dopo avere confermato una modifica del codice nel progetto Gerrit, selezionare la scheda Attività per l'evento Gerrit in vRealize Automation Code Stream. Verificare che l'elenco di attività includa voci corrispondenti a ogni esecuzione della pipeline configurata nel trigger. Quando si verifica un evento, verranno eseguite solo le pipeline nel trigger Gerrit correlate al tipo di evento specifico. In questo esempio, se viene creato un set di patch, vengono eseguite solo Gerrit-Trigger-Pipeline e Gerrit-Demo-Pipeline.
Le informazioni nelle colonne della scheda Attività descrivono ciascun evento del trigger Gerrit. È possibile scegliere le colonne da visualizzare.
- Le colonne Modifica oggetto ed Esecuzione sono vuote se il trigger è un inserimento Git diretto.
- La colonna Trigger Gerrit mostra il trigger che ha creato l'evento.
- Il listener è disattivato per impostazione predefinita. Quando questa opzione è selezionata, viene visualizzato il listener Gerrit che ha ricevuto l'evento. Un listener può essere associato a più trigger.
- Il tipo di trigger è disattivato per impostazione predefinita. Quando questa opzione è selezionata, mostra se il trigger è stato attivato manualmente o automaticamente.
Per controllare l'attività per un'esecuzione completata o non riuscita, fare clic sui tre puntini a sinistra di una voce nella schermata Attività.
- Se la pipeline non viene eseguita a causa di un errore nel modello della pipeline o di un altro problema, correggere l'errore e selezionare Esegui nuovamente per eseguirla di nuovo.
- Se la pipeline non viene eseguita a causa di un problema di connettività di rete o di un altro problema, selezionare Riprendi per riavviare la stessa esecuzione della pipeline. In questo modo si abbreviano i tempi di esecuzione.
- Utilizzare Visualizza esecuzione per passare alla schermata Esecuzione. Vedere Come eseguire una pipeline e visualizzare i risultati.
- Utilizzare Elimina per eliminare la voce dalla schermata Attività.
