skills.rest
openshift
openshiftCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

konflux-build

Creates manual Konflux PipelineRuns from GitHub PRs to build container images with configurable expiry.

538|560|Updated Jan 18, 2021
Search Tags:#konflux#PipelineRun#openShift#Tekton#github pr#container build#image expiry
One-click install
npx skills add https://github.com/openshift/hypershift --skill konflux-build
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: konflux-build
Source: https://github.com/openshift/hypershift/tree/main/.claude/skills/konflux-build
Command: npx skills add https://github.com/openshift/hypershift --skill konflux-build

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Building a test container image from a pull request on the Konflux platform normally requires hand-editing Tekton pipeline templates, resolving template variables, and managing image expiry settings. This Skill automates that entire flow so developers can produce a PR-based image with a single command.

Core Features & Use Cases

  • Manual PipelineRun Generation: Resolves a PR's head commit and base branch, finds the matching push pipeline template in .tekton/, and generates a concrete PipelineRun YAML.
  • Image Expiry Control: Sets image-expires-after: 30d by default, or produces a permanent image when --non-expiring is passed.
  • End-to-End Execution: Verifies OpenShift login and namespace, creates the PipelineRun, polls for completion, and reports the final @sha256: image digest via skopeo.
  • Use Case: A developer wants to test PR 7813 of openshift/hypershift before merge. They run the command with the PR number and component name, and receive a ready-to-deploy image digest on quay.io.

Quick Start

Ask the assistant to build the hypershift-operator component from PR 7813 as a Konflux image that expires in 30 days.

Frequently Asked Questions about konflux-build

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build a container image from a GitHub PR with Konflux?▼

Provide the PR number or URL plus a component name, and the Skill resolves the PR head commit, finds the matching push pipeline template in .tekton/, generates a PipelineRun, and creates it on the Konflux cluster. The final image digest is reported after the build completes.

How do I build a non-expiring Konflux image for a hotfix?▼

Add the --non-expiring flag to the command. This removes the image-expires-after parameter from the PipelineRun entirely, producing a permanent image instead of the default 30-day expiry.

What access is required to run a manual Konflux PipelineRun?▼

You need the oc CLI logged into the stone-prd-rh01 cluster with access to the crt-redhat-acm-tenant namespace, the gh CLI authenticated for openshift/hypershift, and skopeo installed for image inspection.

Why does the Konflux build fail before creating the PipelineRun?▼

The most common causes are not being logged into the correct OpenShift cluster, being in the wrong namespace, or lacking access to crt-redhat-acm-tenant. The Skill verifies the server URL and project first and stops with instructions if either check fails.

What happens if the PipelineRun is archived before completion?▼

If the PipelineRun disappears before its status can be read, the Skill falls back to using skopeo inspect on the output image URL directly to retrieve the digest and confirm whether the image was published.

Related Skills

Explore More Software Engineering Skills→
RHEcosystemAppEngRHEcosystemAppEng
48

debug-pipeline

Diagnose OpenShift Pipelines (Tekton) failures by analyzing PipelineRun status and TaskRun logs.

Official
Advanced
ValyntValynt

deploy-to-production

Automate production deployments with pre-flight checks, migration testing, and rollback triggers.

Official
Advanced
konflux-cikonflux-ci
8

debugging-pipeline-failures

Diagnose Konflux Tekton pipeline failures using kubectl and Tekton CLI.

Official
Advanced
AI-Strategy-LLCAI-Strategy-LLC

Container App Deploy

Build and push container images to registries with preflight validation and vulnerability scanning.

Official
Intermediate