Als vRealize Automation Code Stream-beheerder of -ontwikkelaar kunt u de Gerrit-trigger gebruiken om vRealize Automation Code Stream te integreren met de beoordelingscyclus van de Gerrit-code. De gebeurtenis zorgt ervoor dat een pijplijn wordt uitgevoerd wanneer u een patchset maakt, concepten publiceert, codewijzigingen samenvoegt in het Gerrit-project of rechtstreeks wijzigingen aanbrengt in de Git-tak.

Wanneer u de trigger voor Gerrit toevoegt, selecteert u een Gerrit-luisteraar, een Gerrit-project op de server, en configureert u Gerrit-gebeurtenissen. In dit voorbeeld configureert u eerst een Gerrit-luisteraar, dan gebruikt u die luisteraar in een Gerrit-trigger met twee gebeurtenissen op drie verschillende pijplijnen.

Voorwaarden

Procedure

  1. Klik in vRealize Automation Code Stream op Triggers > Gerrit.
  2. (Optioneel) Klik op het tabblad Luisteraars en klik vervolgens op Nieuwe luisteraar.
    Opmerking: Sla deze stap over als de Gerrit-luisteraar die u voor de Gerrit-trigger wilt gebruiken al is gedefinieerd.
    1. Selecteer een project.
    2. Voer een naam in voor Gerrit-luisteraar.
    3. Selecteer een Git-eindpunt.
    4. Voer de API-token in.
      Het CSP API-token verifieert u voor externe API-verbindingen met vRealize Automation Code Stream. Om het API-token te verkrijgen:
      1. Klik op Token genereren.
      2. Voer het e-mailadres in dat is gekoppeld aan uw gebruikersnaam en wachtwoord en klik op Genereren.
        Het token dat u genereert, is zes maanden geldig. Het wordt ook wel een vernieuwingstoken genoemd.
        • Als u het token als een variabele wilt behouden voor toekomstig gebruik klikt u op Variabele maken, voert u een naam voor de variabele in en klikt u op Opslaan.
        • Als u het token als tekstwaarde wilt behouden voor toekomstig gebruik klikt u op Kopiëren en plakt u het token in een tekstbestand om lokaal op te slaan.
        U kunt ervoor kiezen om beide een variabele te maken en het token in een tekstbestand op te slaan voor toekomstig gebruik.
      3. Klik op Sluiten.
      Als u een variabele heeft gemaakt, wordt in het API-token de naam van de variabele weergegeven die u heeft ingevoerd. Als u de token heeft gekopieerd, geeft het API-token de gemaskeerde token weer.

      Gerrit-luisteraar voor trigger

    5. Om de gegevens van het token en eindpunt te valideren, klikt u op Valideren.
      Uw token verloopt na 90 dagen.
    6. Klik op Maken.
    7. Klik op Verbinden op de luisteraarskaart.
      De luisteraar start de bewaking van alle activiteiten op de Gerrit-server en luistert om een ingeschakelde triggers op die server te horen. Als u wilt stoppen met luisteren naar een trigger op die server, schakelt u de trigger uit.
  3. Klik op het tabblad Triggers en klik vervolgens op Nieuwe Gerrit-trigger.
  4. Selecteer een project op de Gerrit-server.
  5. Voer een naam in.
    De naam van de Gerrit-trigger moet uniek zijn.
  6. Selecteer een geconfigureerde Gerrit-luisteraar.
    vRealize Automation Code Stream gebruikt de selectie van de Gerrit-luisteraar om een lijst te verstrekken met Gerrit-projecten die beschikbaar zijn op de server.
  7. Selecteer een project op de Gerrit-server.
  8. Voer de tak in de opslagplaats in die moet worden gecontroleerd.
  9. (Optioneel) Geef bestandsopnamen of -uitsluitingen als voorwaarden voor de trigger op.
    • U geeft bestandsopnames op om trigger-pijplijnen te hebben. Wanneer een van de bestanden in een commit overeenkomt met de bestanden die zijn opgegeven in de opnamepaden of regex, worden pijplijnen geactiveerd. Met een opgegeven regex worden door vRealize Automation Code Stream alleen de pijplijnen geactiveerd met bestandsnamen in de wijzigingsset die overeenkomen met de opgegeven expressie. Het regex-filter is handig bij het configureren van een trigger voor meerdere pijplijnen op één opslagplaats.
    • U geeft bestandsuitsluitingen op om te voorkomen dat pijplijnen worden geactiveerd. Wanneer alle bestanden in een commit overeenstemmen met de bestanden die zijn opgegeven in de uitsluitingspaden of regex, worden de pijplijnen niet geactiveerd.
    • Wanneer Uitsluiting prioriteren is ingeschakeld, wordt ervoor gezorgd dat er geen pijplijnen worden geactiveerd. De pijplijnen worden zelfs niet geactiveerd als een van de bestanden in een commit overeenkomt met de bestanden die zijn opgegeven in de uitsluitingspaden of regex. De standaardinstelling is uitgeschakeld.
    Als aan voorwaarden voor zowel opname als uitsluiting wordt voldaan, worden er geen pijplijnen geactiveerd.

    In het volgende voorbeeld zijn zowel bestandsopnamen als -uitsluitingen voorwaarden voor de trigger.

    Voorbeeld van bestandsopnamen en -uitsluitingen

    • Bij bestandsopnamen activeert een commit met elke wijziging van runtime/src/main/a.java of elk java-bestand, pijplijnen die in de gebeurtenisconfiguratie zijn ingesteld.
    • Bij bestandsuitsluitingen worden de pijplijnen die in de gebeurtenisconfiguraties zijn ingesteld. niet geactiveerd door een commit met alleen wijzigingen in beide bestanden.
  10. Klik op Nieuwe configuratie.
    1. Selecteer voor de Gerrit-gebeurtenis Patchset gemaakt, Concept gepubliceerd of Wijziging samengevoegd. Voor een directe push naar Git die Gerrit omzeilt, selecteert u Directe Git-push.
    2. Selecteer de pijplijn die u wilt activeren.
      Als de pijplijn is geconfigureerd met aangepaste toegevoegde invoerparameters, worden parameters en waarden weergegeven in de lijst Invoerparameters. U kunt waarden invoeren voor invoerparameters die worden doorgegeven naar de pijplijn met de triggergebeurtenis. Of u kunt de waarden leeg laten of de standaardwaarden gebruiken.
      Opmerking: Als standaardwaarden worden gedefinieerd:
      • Alle waarden die u voor de invoerparameters invoert, overschrijven de standaardwaarden die in het pijplijnmodel zijn gedefinieerd.
      • Standaardwaarden die worden gebruikt om de trigger te configureren, worden niet bijgewerkt als de parameterwaarden in het pijplijnmodel zijn gewijzigd.

      Zie de Vereisten voor informatie over het Automatisch injecteren van invoerparameters voor Gerrit-triggers.

    3. Voor Patchset gemaakt, Concept gepubliceerd en Wijzigingen samengevoegd worden sommige acties standaard met labels weergegeven. U kunt het label wijzigen of opmerkingen toevoegen. Wanneer de pijplijn wordt uitgevoerd, verschijnt het label of de opmerking op het tabblad Activiteit als de Actie die is ondernomen voor de pijplijn.
    4. Klik op Opslaan.
    Als u meerdere triggergebeurtenissen wilt toevoegen aan meerdere pijplijnen, klikt u opnieuw op Nieuwe configuratie.
    In het volgende voorbeeld ziet u gebeurtenissen voor drie pijplijnen:
    • Als een Wijziging samengevoegd-gebeurtenis in het Gerrit-project plaatsvindt, wordt de Gerrit-pijplijn geactiveerd.
    • Als een Patchset gemaakt-gebeurtenis plaatsvindt in het Gerrit-project, worden de Gerrit-trigger-pijplijn en de Gerrit-demo-pijplijn geactiveerd.

    Luisteraar- en Gerrit-triggerconfiguratie

  11. Klik op Maken.
    De trigger wordt weergegeven als een nieuwe kaart en is standaard uitgeschakeld.
  12. Klik op de triggerkaart op Inschakelen.
    Wanneer de trigger is ingeschakeld, gebruikt deze de Gerrit-luisteraar om gebeurtenissen te starten die plaatsvinden op de tak van het Gerrit-project.
    Wanneer u de trigger maakt, neemt u de opslagplaats op waar de code moet worden doorgevoerd. Als u een trigger wilt maken met dezelfde bestandsopname- of uitsluitingsvoorwaarden, maar met een andere opslagplaats, klikt u op Acties > Klonen op de triggerkaart. Klik vervolgens op Openen op de nieuwe trigger en wijzig de parameters.

resultaten

Gefeliciteerd! U heeft een Gerrit-trigger met twee gebeurtenissen op drie verschillende pijplijnen geconfigureerd.

Volgende stappen

Nadat u een codewijziging heeft doorgevoerd in het Gerrit-project, controleert u het tabblad Activiteit voor de Gerrit-gebeurtenis in vRealize Automation Code Stream. Controleer of de lijst met activiteiten vermeldingen bevat die overeenkomen met elke pijplijn-uitvoering die in de trigger is geconfigureerd. Wanneer een gebeurtenis plaatsvindt, worden alleen pijplijnen in de Gerrit-trigger met betrekking tot het specifieke gebeurtenistype uitgevoerd. Als in dit voorbeeld een patchset is gemaakt, worden alleen de Gerrit-trigger-pijplijn en de Gerrit-demo-pijplijn uitgevoerd.

Informatie in de kolommen op het tabblad Activiteit beschrijven elke Gerrit-triggergebeurtenis. U kunt kiezen welke kolommen u wilt weergeven.
  • De kolommen Onderwerp wijzigen en Uitvoeren zijn leeg als de trigger een direct Git-push was.
  • De kolom Gerrit-trigger toont de trigger die de gebeurtenis heeft gemaakt.
  • De Luisteraar is standaard uitgeschakeld. Wanneer dit is geselecteerd, wordt de Gerrit-luisteraar weergegeven die de gebeurtenis heeft ontvangen. Er kan één luisteraar worden gekoppeld aan meerdere triggers.
  • Het Triggertype is standaard uitgeschakeld. Wanneer dit is geselecteerd, wordt aangegeven of de trigger handmatig of automatisch is geactiveerd.

Gerrit-triggeractiviteit

Als u de activiteit voor een voltooide of mislukte uitvoering wilt regelen, klikt u op de drie punten links van een item in het Activiteiten-scherm.
  • Als de pijplijn niet kan worden uitgevoerd vanwege een fout in het pijplijnmodel of een ander probleem corrigeert u de fout en selecteert u Opnieuw uitvoeren om het opnieuw uit te voeren.
  • Als de pijplijn niet kan worden uitgevoerd vanwege een probleem met de netwerkverbinding of een ander probleem, selecteert u Hervatten om dezelfde pijplijnuitvoering te hervatten. Hierdoor wordt er uitvoeringstijd bespaard.
  • Gebruik Uitvoering bekijken om naar het Uitvoerings-scherm te gaan. Zie Hoe kan ik een pijplijn uitvoeren en de resultaten bekijken?.
  • Gebruik Verwijderen om de vermelding uit het Activiteiten-scherm te verwijderen.
Als een Gerrit-gebeurtenis een pijplijn niet activeert, kunt u op de knop Handmatig activeren klikken en de naam van de Gerrit-trigger en de Wijzigings-id invoeren.