Create a manual PipelineRun to test tag pipeline changes before merging.

**Usage**: `/test-tag-pipeline <tag-name> [branch-spec]`

Views1
PublishedJun 17, 2026

Loading actions...

5 minBeginnerprompt8 files

Skill content

Main instructions and any bundled files for this skill.

markdown

Prompt Playground

2 Variables

Fill Variables

Preview

Create a manual PipelineRun to test tag pipeline changes before merging.

**Usage**: `/test-tag-pipeline <tag-name> [branch-spec]`

**Arguments**:
- `tag-name` (required): The existing tag to rebuild (e.g., `v0.1.69`)
- `branch-spec` (optional): The branch containing the updated pipeline (defaults to `main`)
  - Format: `[fork:]branch-name`
  - If no fork specified, defaults to `openshift`

**What this does**:
1. Verifies you are logged into the Konflux instance
2. Gets the commit SHA that the tag points to
3. Fetches the tag pipeline definition from the specified branch/fork
4. Replaces template variables with actual values for the tag
5. Creates a manual PipelineRun that uses the updated pipeline to build the tag's commit
6. Outputs the PipelineRun name for monitoring

**Examples**:
```bash
# Test main branch pipeline with v0.1.69 tag
/test-tag-pipeline v0.1.69

# Test PR branch pipeline with v0.1.69 tag
/test-tag-pipeline v0.1.69 build-gomaxprocs-image

# Test fork branch pipeline with v0.1.69 tag
/test-tag-pipeline v0.1.69 celebdor:OCPBUGS-63194-part2
```

**Implementation**:

IMPORTANT: Execute the commands exactly as shown with only the arguments provided by the user. If no branch argument is specified, the template `{{args.1:-main}}` will correctly default to `main`. Do NOT substitute the current git branch or any other inferred values.

Step 1: Verify authentication to Konflux
```bash
oc whoami
```

If the authentication check fails, inform the user they need to log in first:
```bash
oc login --web https://api.stone-prd-rh01.pg1f.p1.openshiftapps.com:6443
```

Step 2: Create the PipelineRun
```bash
bash hack/tools/scripts/create-manual-tag-pipelinerun.sh {{args.0}} {{args.1:-main}}
```

After the PipelineRun is created, extract the name from the output and construct the web UI URL:
- Base URL: https://konflux-ui.apps.stone-prd-rh01.pg1f.p1.openshiftapps.com
- Pattern: /ns/crt-redhat-acm-tenant/applications/hypershift-operator/pipelineruns/{pipelinerun-name}

Example: https://konflux-ui.apps.stone-prd-rh01.pg1f.p1.openshiftapps.com/ns/crt-redhat-acm-tenant/applications/hypershift-operator/pipelineruns/hypershift-operator-main-manual-v0.1.69-xxxxx

Display the full URL to the user so they can monitor progress in the web UI.

You can also monitor it from the CLI with:
```bash
# Watch the PipelineRun status
oc get pipelinerun <name> -w
```

Step 3: After the PipelineRun completes successfully, create a Snapshot to trigger Enterprise Contract validation:
```bash
bash hack/tools/scripts/create-snapshot-from-pipelinerun.sh <pipelinerun-name>
```

After the Snapshot is created, extract the snapshot name from the output and get the EC PipelineRuns:
```bash
oc get pipelinerun -l appstudio.openshift.io/snapshot=<snapshot-name> -o name
```

For each EC PipelineRun, construct and display the web UI URL:
- Base URL: https://konflux-ui.apps.stone-prd-rh01.pg1f.p1.openshiftapps.com
- Pattern: /ns/crt-redhat-acm-tenant/applications/hypershift-operator/pipelineruns/{ec-pipelinerun-name}

Example: https://konflux-ui.apps.stone-prd-rh01.pg1f.p1.openshiftapps.com/ns/crt-redhat-acm-tenant/applications/hypershift-operator/pipelineruns/hypershift-operator-enterprise-contract-xxxxx

Display the full URLs to the user so they can monitor EC validation in the web UI.

You can also monitor from the CLI with:
```bash
# Watch the snapshot status
oc get snapshot <snapshot-name> -w

# Check EC test results
oc get pipelinerun -l appstudio.openshift.io/snapshot=<snapshot-name>
```

**Notes**:
- This is useful for testing pipeline fixes before merging PRs
- The PipelineRun uses the updated pipeline definition but builds the original tag's commit
- The two-step process allows the PipelineRun to complete (20+ minutes) before creating the Snapshot
- Requires `yq` and `oc` CLI tools to be installed
- See `hack/tools/scripts/create-manual-tag-pipelinerun.sh` and `hack/tools/scripts/create-snapshot-from-pipelinerun.sh` for implementation details
Share: