build

Documentation

Index

• type BuildController
  • func NewBuildController(params *BuildControllerParams) *BuildController
  • func (bc *BuildController) Run(workers int, stopCh <-chan struct{})
• type BuildControllerParams

Types

type BuildController

type BuildController struct {
	// contains filtered or unexported fields
}

BuildController watches builds and synchronizes them with their corresponding build pods. It is also responsible for resolving image stream references in the Build to container images prior to invoking the pod. The build controller late binds image stream references so that users can create a build config before they create the image stream (or before an image is pushed to a tag) which allows actions to converge. It also allows multiple Build objects to directly reference images created by another Build, acting as a simple dependency graph for a logical multi-image build that reuses many individual Builds.

Like other controllers that do "on behalf of" image resolution, the controller resolves the reference which allows users to see what image ID corresponds to a tag simply by requesting resolution. This is consistent with other image policy in the system (image tag references in deployments, triggers, and image policy). The only leaked image information is the ID which is considered acceptable. Secrets are also resolved, allowing a user in the same namespace to in theory infer the presence of a secret or make it usable by a build - but this is identical to our existing model where a service account determines access to secrets used in pods.

func NewBuildController

func NewBuildController(params *BuildControllerParams) *BuildController

NewBuildController creates a new BuildController.

func (*BuildController) Run

func (bc *BuildController) Run(workers int, stopCh <-chan struct{})

Run begins watching and syncing.

type BuildControllerParams

type BuildControllerParams struct {
	BuildInformer                      buildv1informer.BuildInformer
	BuildConfigInformer                buildv1informer.BuildConfigInformer
	BuildControllerConfigInformer      configv1informer.BuildInformer
	ImageConfigInformer                configv1informer.ImageInformer
	ImageStreamInformer                imagev1informer.ImageStreamInformer
	PodInformer                        kubeinformers.PodInformer
	SecretInformer                     kubeinformers.SecretInformer
	ConfigMapInformer                  kubeinformers.ConfigMapInformer
	ServiceAccountInformer             kubeinformers.ServiceAccountInformer
	OpenshiftConfigConfigMapInformer   kubeinformers.ConfigMapInformer
	ControllerManagerConfigMapInformer kubeinformers.ConfigMapInformer
	ProxyConfigInformer                configv1informer.ProxyInformer
	ImageContentSourcePolicyInformer   operatorv1alpha1informer.ImageContentSourcePolicyInformer
	ImageDigestMirrorSetInformer       configv1informer.ImageDigestMirrorSetInformer
	ImageTagMirrorSetInformer          configv1informer.ImageTagMirrorSetInformer
	KubeClient                         kubernetes.Interface
	BuildClient                        buildv1client.Interface
	DockerBuildStrategy                *strategy.DockerBuildStrategy
	SourceBuildStrategy                *strategy.SourceBuildStrategy
	CustomBuildStrategy                *strategy.CustomBuildStrategy
	BuildDefaults                      builddefaults.BuildDefaults
	BuildOverrides                     buildoverrides.BuildOverrides
	InternalRegistryHostname           string
}

BuildControllerParams is the set of parameters needed to create a new BuildController