U kunt de output van een taak in uw pijplijn laten bepalen of de pijplijn wordt uitgevoerd of stopt op basis van een voorwaarde die u opgeeft. Om de pijplijn te laten slagen of mislukken op basis van de uitvoer van de taak, gebruikt u de voorwaardetaak.

U gebruikt de voorwaardetaak als een beslissingspunt in uw pijplijn. Met behulp van de Voorwaarde-taak met een voorwaarde-expressie die u opgeeft, kunt u alle properties in uw pijplijn, fasen en taken evalueren.

Het resultaat van de Voorwaarde-taak bepaalt of de volgende taak in de pijplijn wordt uitgevoerd.

  • Bij een ware voorwaarde kan de pijplijnuitvoering verder gaan.
  • Bij een onware voorwaarde wordt de pijplijn gestopt.

Zie Hoe gebruik ik variabele bindingen in Code Stream-pijplijnen? voor voorbeelden van hoe u de outputwaarde van de ene taak kunt gebruiken als de input voor de volgende taak door de taken te verbinden met een Voorwaarde-taak.

Tabel 1. De relatie tussen de Voorwaarde-taak en diens voorwaarde-expressie en de pijplijn
Voorwaarde-taak Waarop dit invloed heeft Wat het doet

Voorwaarde-taak

Pijplijn

De voorwaardetaak bepaalt of de pijplijn wordt uitgevoerd of stopt op dat moment, op basis van het feit of de uitvoer van de taak waar of onwaar is.

Voorwaarde-expressie

Output Voorwaarde-taak

Wanneer de pijplijn wordt uitgevoerd, bepaalt de voorwaarde-expressie die u opneemt in de Voorwaarde-taak of de outputstatus waar of onwaar is. Een voorwaarde-expressie kan bijvoorbeeld vereisen dat de voorwaardetaak de uitvoerstatus Voltooid heeft of het buildnummer 74 gebruiken.

De voorwaarde-expressie wordt weergegeven op het tabblad Taak in de voorwaardetaak.

De ondersteunde constructs voor de voorwaardelijke expressie worden weergegeven en bieden voorbeelden voor pijplijnvariabelen, variabelen voor taakuitvoer, waarden en operatoren.

De voorwaardetaak verschilt in functie en gedrag van de instelling Op voorwaarde in andere taaktypen.

De instelling Op voorwaarde is beschikbaar in andere taaktypen.

In andere taaktypen bepaalt Op voorwaarde of de huidige taak wordt uitgevoerd, in plaats van opeenvolgende taken, op basis van of de voorwaarde-expressie waar of onwaar retourneert. De voorwaarde-expressie voor instelling Op voorwaarde produceert een uitvoerstatus waar of onwaar voor de huidige taak wanneer de pijplijn wordt uitgevoerd. De instelling Op voorwaarde wordt op het tabblad Taak weergegeven met een eigen voorwaarde-expressie.

In dit voorbeeld wordt de Voorwaarde-taak gebruikt.

Voorwaarden

  • Verifieer dat er een pijplijn bestaat en dat deze fasen en taken bevat.

Procedure

  1. Bepaal in uw pijplijn het beslissingspunt waar de Voorwaarde-taak moet verschijnen.
  2. Voeg de voorwaardetaak toe vóór de taak die afhankelijk is van de status geslaagd of mislukt.
  3. Voeg een voorwaarde-expressie toe aan de Voorwaarde-taak.
    Bijvoorbeeld: "${Stage1.task1.output.status}" == "COMPLETED" || ${input.buildNumber} == 74
    Voeg een voorwaardetaak toe met een voorwaarde-expressie die waar of onwaar retourneert wanneer de pijplijn wordt uitgevoerd.
  4. Valideer de taak.
  5. Sla de pijplijn op. Vervolgens schakelt u de pijplijn in en voert u deze uit.

resultaten

Bekijk de uitvoeringen van de pijplijn en kijk of de pijplijn nog steeds wordt uitgevoerd of stopt bij de voorwaardetaak.

Volgende stappen

Als u een pijplijnimplementatie terugdraait, kunt u ook de voorwaardetaak gebruiken. Bij het terugdraaien van een pijplijn helpt de Voorwaarde-taak Code Stream bijvoorbeeld om een pijplijnfout te markeren op basis van de voorwaarde-expressie en kan één terugdraaistroom worden geactiveerd voor verschillende fouttypen.

Zie Hoe kan ik mijn implementatie terugdraaien in Code Stream? om een implementatie terug te draaien.