Come integrare Automation Pipelines con Gerrit

Automation Pipelines consente di attivare una pipeline se si verifica una revisione del codice nel progetto Gerrit. La definizione del trigger per Gerrit include il progetto Gerrit e le pipeline da eseguire per tipi di evento diversi.

Il trigger per Gerrit utilizza un listener Gerrit nel server Gerrit da monitorare. Per definire un endpoint Gerrit in Automation Pipelines, è necessario selezionare un progetto e immettere l'URL del server Gerrit. È quindi possibile specificare l'endpoint quando si crea un listener Gerrit in tale server.

La procedura seguente illustra come definire un endpoint Gerrit che è possibile utilizzare nella definizione del listener Gerrit. Nel caso in cui sia necessario modificare un endpoint, un passaggio facoltativo alla fine della procedura illustra come e quando eseguire l'aggiornamento.

Prerequisiti

• Se si utilizza un server Gerrit locale, verificare che sia possibile accedere a Automation Assembler per aggiungere un proxy cloud. Per un esempio, vedere Impostazione di Automation Pipelines per modellare il processo di rilascio.
• Verificare di essere un membro di un progetto in Automation Pipelines. Se non si è membri, chiedere a un amministratore di Automation Pipelines di essere aggiunti come membri di un progetto. Vedere Come aggiungere un progetto in Automation Pipelines.

Procedura

1. Definire un endpoint Gerrit.
   1. Fare clic su Configura > Endpoint e quindi su Nuovo endpoint.
   2. Selezionare un progetto e, per il tipo di endpoint, selezionare Gerrit . Quindi, immettere un nome e una descrizione.
   3. Se l'endpoint è un componente business critical nell'infrastruttura, abilitare Contrassegna come limitato.
   4. Immettere l'URL del server Gerrit.
      Per utilizzare la porta predefinita, è possibile specificare un numero di porta con l'URL o lasciare il valore vuoto.
   5. Immettere un nome utente e una password per il server Gerrit.
      Se la password deve essere crittografata, fare clic su Crea variabile e selezionare il tipo:

      • Segreta. La password viene risolta quando un utente con un ruolo qualsiasi esegue la pipeline.
      • Limitata. La password viene risolta quando un utente con ruolo di amministratore esegue la pipeline.

      Come valore, immettere la password che deve essere sicura, ad esempio la password di un server Jenkins.

   6. Per la chiave privata, immettere la chiave SSH utilizzata per accedere in modo sicuro al server Gerrit.
      Questa chiave è la chiave privata RSA che si trova nella directory .ssh.
   7. (Facoltativo) Se alla chiave privata è associata una frase d'accesso, immetterla.
      Per crittografare la passphrase, fare clic su Crea variabile e selezionare il tipo:

      • Segreta. La password viene risolta quando un utente con un ruolo qualsiasi esegue la pipeline.
      • Limitata. La password viene risolta quando un utente con ruolo di amministratore esegue la pipeline.

      Come valore, immettere la passphrase che deve essere sicura, ad esempio la passphrase per un server SSH.

2. Fare clic su Convalida e verificare che l'endpoint Gerrit in Automation Pipelines si connetta al server Gerrit.
   Se non si connette, correggere gli eventuali errori, quindi fare di nuovo clic su Convalida.
   
3. Fare clic su Crea.
4. (Facoltativo) Prima di aggiornare un endpoint Gerrit per modificare un URL o una chiave privata, ad esempio, verificare se l'endpoint è connesso a un listener Gerrit.
   • Se l'endpoint non è connesso a un listener Gerrit, eseguire i passaggi seguenti per aggiornare l'endpoint:
     1. Fare clic su Configura > Endpoint, quindi fare clic su Apri sull'endpoint che si desidera aggiornare.
     2. Aggiornare la definizione dell'endpoint.
     3. (Facoltativo) Se si sta modificando il proxy cloud, riavviare il proxy cloud precedente una volta per rimuovere tutte le connessioni precedenti prima di avviare il nuovo proxy cloud e stabilire una nuova connessione.
     4. Fare clic su Convalida per verificare che l'endpoint Gerrit in Automation Pipelines si connetta al server Gerrit.
     5. Fare clic su Salva.
   • Se l'endpoint è connesso a un listener Gerrit, eseguire i passaggi seguenti per aggiornare l'endpoint:
     1. Disconnettere tutti i listener Gerrit collegati. Vedere Come utilizzare il trigger Gerrit in Automation Pipelines per eseguire una pipeline.
     2. Eseguire i passaggi per configurare il nuovo endpoint.
     3. (Facoltativo) Se si sta modificando il proxy cloud, riavviare il proxy cloud precedente una volta per rimuovere tutte le connessioni precedenti prima di avviare il nuovo proxy cloud e stabilire una nuova connessione.
     4. Convalidare e salvare la definizione dell'endpoint aggiornata.
     5. Connettere nuovamente i listener Gerrit.
     Nota: Se i listener Gerrit non si disconnettono, è possibile che i valori dell'endpoint Gerrit corrente vengano modificati in modo che i listener non possano più comunicare con il server Gerrit. Se si verifica questo problema, apportare innanzitutto modifiche alla definizione dell'endpoint in modo che i listener possano comunicare con il server Gerrit. Disconnettere quindi i listener Gerrit e riconnetterli.

Operazioni successive

Per ulteriori informazioni, rivedere le altre sezioni. Vedere Come utilizzare il trigger Gerrit in Automation Pipelines per eseguire una pipeline.