Triggering a Run with Custom Parameters

JFrog Pipelines Documentation

ft:sourceType
Paligo

When triggering a run manually, you have the option of triggering it with custom parameters. Use this option to select:

The advantage of triggering a run with custom parameters is that you can temporarily add or update values for a specific step.

Customizing a Run

To trigger a run with custom parameters:

  1. From the Applications tab, go to Pipelines | My Pipelines.

  2. In the Pipelines dashboard that appears, click the name of your pipeline.

  3. Click the step for which you want to use custom configuration and then click the custom trigger

    custom_trigger_button_1a.png

    button.

    180126212.jpg
  4. In the resulting Trigger Run dialog, configure the following and click Trigger Run to configure the following:

Select Steps and Node Pools

When triggering a run, you have the option of selecting specific steps for the run. When you trigger the run, only the steps selected for the run are executed. In addition, you can select specific node pools for the pipeline and individual steps. This provides you the flexibility of selecting node pools that are suitable for specific steps.

180128727.png
Environment Variables

Environment variables can be used to customize a run that is triggered manually.

You can use one or both of these options to add environment variables:

  • Predefine in YAML: This option enables you to add a set of predefined values in the pipelines DSL, which is then available for selection in the UI. Environment variables can be added at the pipeline- or step-level. The pipeline-level environment variables will be carried through to all steps executed in the pipeline run, but the step-level environment variables will apply only to that specific step. Use this option when you have jobs that require environment variable values to be changed frequently.

    For information about setting these values, see Environment Variables Configuration.

  • Add custom variables: This field enables you to manually add one or more environment variables for each run. These custom variables can be applied to a single step or to all the steps. Use this only when you want to perform a quick test and do not expect to repeat the run with the same environment variables.

    Custom variables can be added using:

    • Key-Value field: Use this when you want to quickly add a small number of key-value pairs.

    • Bulk paste: Use this when you want to add a large number of key-value pairs.

      Bulk Paste Example

      key1=value1
      key2=value2
      key3=value3
      key4=value4
      key5=value5
      key6=value6
      key7=value7
      key8=value8
      key9=value9