Onboard a new Application
Onboard a sample application to Konflux using the UI or Kubernetes manifests, observe a build, and pull the resulting image.
Onboard a new Application to Konflux
A step-by-step tutorial for onboarding an application to Konflux, running integration tests, and configuring releases.
This tutorial walks you through the full lifecycle of onboarding a containerized application to Konflux: from creating a build pipeline, through running integration tests, to publishing a release to a container registry.
All commands shown in this tutorial assume you are in the repository root.
Tutorial Steps
| Step | Description |
|---|---|
| Onboarding | Fork an example repository, onboard it to Konflux via the UI or Kubernetes manifests, observe the build pipeline, and pull the resulting image. |
| Integration Tests | Configure Enterprise Contract integration tests to automatically validate your builds after each pipeline run. |
| Configure Releases | Set up ReleasePlan and ReleasePlanAdmission resources to publish your application to a container registry. |
Prerequisites
Before starting, make sure you have:
- A running Konflux deployment. See the Installation guide.
- Access to a GitHub account where you can fork repositories and create a GitHub App.
- (For Option 1 — UI onboarding) A Quay.io account with an organization for image auto-provisioning.
Integration Tests
Configure and run integration tests for your application after each build pipeline completes.
Configure Releases
Configure ReleasePlan and ReleasePlanAdmission resources to release your application to a container registry.