README
¶
Knative build
This repository contains a work-in-progress build system that is designed to address a common need for cloud native development.
A Knative build extends Kubernetes and utilizes existing Kubernetes primitives to provide you with the ability to run on-cluster container builds from source. For example, you can write a build that uses Kubernetes-native resources to obtain your source code from a repository, build a container image, then run that image.
While Knative builds are optimized for building, testing, and deploying source code, you are still responsible for developing the corresponding components that:
- Retrieve source code from repositories.
- Run multiple sequential jobs against a shared filesystem, for example:
- Install dependencies.
- Run unit and integration tests.
- Build container images.
- Push container images to an image registry, or deploy them to a cluster.
The goal of a Knative build is to provide a standard, portable, reusable, and performance optimized method for defining and running on-cluster container image builds. By providing the “boring but difficult” task of running builds on Kubernetes, Knative saves you from having to independently develop and reproduce these common Kubernetes-based development processes.
While today, a Knative build does not provide a complete standalone CI/CD solution, it does however, provide a lower-level building block that was purposefully designed to enable integration and utilization in larger systems.
Learn more
To learn more about builds in Knative, see the Knative build documentation.
To learn more about Knative in general, see the Overview.
Developing Knative builds
If you are interested in contributing to Knative builds:
- Visit the How to contribute page for information about how to become a Knative contributor.
- Learn how to set up your development environment.
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
controller
command
|
|
|
creds-init
command
|
|
|
git-init
command
|
|
|
logs
command
|
|
|
nop
command
|
|
|
webhook
command
|
|
|
pkg
|
|
|
apis/build/v1alpha1
Package v1alpha1 is the v1alpha1 version of the API.
|
Package v1alpha1 is the v1alpha1 version of the API. |
|
builder
Package builder provides common methods for Builder implementations.
|
Package builder provides common methods for Builder implementations. |
|
builder/cluster
Package cluster provides a Builder that runs workloads on-cluster.
|
Package cluster provides a Builder that runs workloads on-cluster. |
|
builder/cluster/convert
Package convert provides methods to convert a Build CRD to a k8s Pod resource.
|
Package convert provides methods to convert a Build CRD to a k8s Pod resource. |
|
builder/nop
Package nop provides a no-op builder implementation.
|
Package nop provides a no-op builder implementation. |
|
builder/validation
Package validation provides methods to surface validation errors.
|
Package validation provides methods to surface validation errors. |
|
reconciler/buildtemplate/resources/names
Package names holds simple functions for synthesizing resource names.
|
Package names holds simple functions for synthesizing resource names. |
|
test
|
|
|
panic
command
|
|
|
workingdir
command
|