Create chains

You can create, modify, or remove chains in PulseUno.

Note: To work with chains, you need maintainer, owner, or administrator permissions. For details, see Manage members and teams.

Create chains

When you create a chain, you add a sequence of plugin steps to it.

To create a chain:

  1. On the top navigation bar, select a space from the spaces list.
  2. On the Products page, open the product or Git repository where you want to create a chain.

  3. On the sidebar, select Chains.

  4. On the Chains page, click New . The chain's editing window opens.

  5. In the Steps tab, enter a title and, optionally, additional information about the chain.

  6. Click Add Step to Chain next to the chain title.

  7. In the Add Step list, find a plugin or action from one of the categories. You can use search to find plugins.

    To add a step to the chain, click Add next to the plugin.

  8. Click the step you just added to set its parameters. For details, see Use plugins.

  9. Add more steps as required.
  10. To change the running order of steps, drag them to different positions.

  11. To remove a step from the chain, select the step, click Delete , and confirm.
  12. (Optional) Set the chain's options, add variables, and specify triggers for running the chain. For details, see Modify chains.
  13. Click Save & Continue.

Back to top

Duplicate chains

You can create a chain by making a copy of another chain.

To duplicate a chain:

  1. On the top navigation bar, select a space from the spaces list.
  2. On the Products page, open the product or Git repository where you want to create a chain.

  3. On the sidebar, select Chains.

  4. On the Chains page, select the chain to duplicate.

  5. Click Duplicate on the toolbar.

  6. In the Duplicate Chain dialog box, enter a title for the new chain and click Duplicate.

    The chain's editing window opens, where you can make changes to existing steps, settings, and variables. For details, see Modify chains.

Back to top

Modify chains

You can edit the chain's configuration options, add or remove plugin steps, change the running order of steps, add variables and capabilities, set the chain run schedule, and enable a chain badge.

To modify a chain:

  1. On the top navigation bar, select a space from the spaces list.
  2. On the Products page, open the product or Git repository where the chain is located.

  3. On the sidebar, select Chains.

  4. In the chain list, click a chain's name to open the chain.

  5. On the chain page, click Edit.

  6. In the chain's editing window, switch between the tabs to configure the chain:

    Tab Description
    Steps Add or remove chain steps and modify plugin parameters. For details about plugins, see Use plugins.
    Triggers Change the streams on which to run the chain, and set a chain run schedule. For details, see Schedule chain runs.
    Variables Add or remove chain variables. For details, see Define chain and global variables.
    Options

    Set chain options:

    • Add or remove capabilities to restrict which agents can run the chain. For details, see Add capabilities to chains.

    • Enable ongoing detection of dependency vulnerabilities. For details, see Enable ongoing vulnerability detection.

    • Stop a chain if a step fails.

    • Choose to ignore the chain run state when estimating the state of related changesets.

    • Limit the queue to only one chain run in the queue.

    • Set a policy for retaining the logs created by a chain.

    • Enable a status badge on a chain.

    • For chains that are triggered when a pull request is published, require a successful chain run before merging the pull request.

    For details, see Set chain options.

  7. To review the history of changes to the chain, select the History tab.

  8. Click Save & Continue.

Note: If an existing chain uses a missing plugin, PulseUno displays a warning. To save changes to the chain, you need to remove or replace such plugin.

Back to top

Delete chains

As an administrator, you can remove chains from your product or Git repository.

When you delete a chain, PulseUno retains the following information:

  • Activity events involving the deleted chain.
  • Findings or measurements that the deleted chain added to reviews.
  • Any panels that contain measurements from the deleted chain.

To delete chains:

  1. On the top navigation bar, select a space from the spaces list.
  2. On the Products page, open a product or Git repository.

  3. On the sidebar, select Chains.

  4. Select one or more chains from the chain list, click Delete , and confirm.

Back to top

See also: