Getting started with Konflux
Go to Konflux.
Click Join waitlist.
We include ready-to-use bundled code samples that you can import into our service. In this guide, we’ll walk you through how to fork a sample repository and create your first application. To begin, click Create an application.
Scroll to Select a sample and choose one of the following options:
Decided on a favorite sample? Great! Now let’s fork the code to your repo. By the way, we call this code a component.
These are the many perks to forking one of our samples:
Automated builds for new commits with GitHub webhook integration
Pull request testing
Rebuilding dependencies from source
Scanning your build for vulnerabilities, viruses, and other checks
Return to the app and scroll up to Bring in your own code.
In Git repository URL, paste the URL that you copied previously.
Click Import code.
We now scan your Git repository for source code and detect your runtime and other configuration settings for you to review. You have the option to use our default build pipeline or to customize the pipeline. Let’s stick with the default option for now.
Complete the following steps to finish:
In Application details, enter a name for your app.
In Component name, enter a name for your component.
Leave the toggle set to Default build pipeline.
Scroll to the end of the page and click Create application.
Because your application can run on one or more components, you might want to add more. The additional source code that you add can either be from the same repository that you used when you created your application, or a different Git repository. Remember, we call source code components.
In the Overview tab, select Add component. Follow the process in How to fork a sample to add any additional components.
In Reviewing and configuring, you used the default built pipeline. To add automation, you can upgrade to custom build pipelines.
Custom build pipelines are pipelines as code, set on your component’s repository. With custom build pipelines, pull requests and commits to your main branch automatically rebuild.
By customizing your build pipeline, you can change the tasks that are included, control when those tasks update to newer versions, and accept any changes to the pipeline when you’re ready for them.
To get started, click Manage build pipelines from the Overview page. For more information on this topic, go to Upgrading your build pipeline.
You can view your latest commits, as well as your pipeline runs.
Because you forked your repo, you have permissions to commit to the Git repo. We like to focus on commits, rather than pipelines, so that it’s easy to correlate a developer’s work with what’s going on in the system.
To view your recent commits, go to the Activity tab and click Latest commits.
Didn’t fork your repo? Fret not! You can also view your activity by pipeline runs. A pipeline run is a collection of TaskRuns that are arranged in a specific order of execution.
To view your pipeline runs, go to the Activity, click Pipeline runs, and then select one of the hyperlinks in Name. In the previous view, you can see tasks that you can run based on the pipeline definition while the image is being inspected. You can also click an individual task to see its details.
You can find each component’s route in the Components tab, next to each component’s details.
The Enterprise Contract (EC) is an artifact verifier and customizable policy checker. You can use EC to keep your software supply chain secure and to ensure that container images comply with your organization’s policies.
For more information about EC, refer to Managing compliance with the Enterprise Contract.
Check the status of your application in Environments. You can view information about your environment such as its type, deployment status, and cluster type.
An environment is a set of compute resources that you can use to develop, test, and stage your applications. There is a development environment included for you so that you can explore Konflux.
For information about creating an application with your own cluster, refer to Creating your own environment.
A software bill of materials (SBOM) is a list of all the software libraries that a component uses. You can run 'cosign' in your command line interface (CLI) to inspect the image SBOM.
For more information on this topic, go to Inspecting SBOMs.
To add other users to collaborate in your workspace, follow the instructions in Roles and permissions.
To keep exploring Konflux, we recommend going to Importing and configuring code.