Set chain options

For any chain, you can select a retention policy, define the conditions for stopping the chain, and choose to queue only one copy of the chain at any time. You can also enable a status badge on the chain.

To configure chain settings:

  1. From the spaces list at the top right, select a space.
  2. On the Products page, open the product or Git repository where the chain is located.

  3. In the sidebar, select Chains.

  4. Open a chain from the chain list and click Edit.

  5. In the chain's editing window, select the Options tab and define the following options:

    Option Description
    Stop early

    Select to stop a chain as soon as one of its steps fails.

    You can use this option as an alternative to the Halt on Failure plugin step.

    Example: You may have a chain with multiple steps where the last step is a build. If any of the earlier steps fails, the chain stops, and the build isn't triggered.

    Stop execution after Specify the number of minutes after which the chain run is stopped. To run the chain indefinitely, enter 0 or leave the field empty.
    Limit queued chains  Select this option to allow only one run of the chain to be in the queue.
    Retention policy 

    Select a policy for removing chain runs from the chain log. For details on how to add retention policies, see Create retention policies.

    Tip: You can override the retention policy for individual chain runs and choose to keep them forever. For details, see View chain runs.

    Status badge

    Each chain has a built-in status badge that is disabled by default. A status badge is a dynamic SVG image that displays the chain name and the result of the latest chain run, for example:

    To make the badge accessible so that it can be included on the PulseUno pages or external sites, select Enable status badge.

    After you enable the badge, its URL is activated.

    To copy the URL so that you can embed the badge elsewhere, click Copy to clipboard next to the URL.

    Note: To access other chains and copy their badge URL, you need the Maintainer role or higher.

    You can embed the badge on any PulseUno page that uses Markdown code. For syntax examples, see Markdown syntax reference.

    Accessible by

    After you have enabled the status badge on a chain, define who can view the badge:

    • Private (default). Logged in users with the Developer role or higher can view the badge.

    • Internal. Any logged in user can view the badge.

    • Public. Anyone can view the badge. Select this option if you want to use the badge externally.

Back to top

See also: