generator

Documentation

Overview

Package generator contains the code to generate Build from BuildConfig as well as REST support to help expose the generator from an API.

Index

• func IsFatal(err error) bool
• type BuildGenerator
  • func (g *BuildGenerator) Clone(ctx kapi.Context, request *buildapi.BuildRequest) (*buildapi.Build, error)
  • func (g *BuildGenerator) FetchServiceAccountSecrets(namespace, serviceAccount string) ([]kapi.Secret, error)
  • func (g *BuildGenerator) Instantiate(ctx kapi.Context, request *buildapi.BuildRequest) (*buildapi.Build, error)
• type Client
  • func (c Client) CreateBuild(ctx kapi.Context, build *buildapi.Build) error
  • func (c Client) GetBuild(ctx kapi.Context, name string) (*buildapi.Build, error)
  • func (c Client) GetBuildConfig(ctx kapi.Context, name string) (*buildapi.BuildConfig, error)
  • func (c Client) GetImageStream(ctx kapi.Context, name string) (*imageapi.ImageStream, error)
  • func (c Client) GetImageStreamImage(ctx kapi.Context, name string) (*imageapi.ImageStreamImage, error)
  • func (c Client) GetImageStreamTag(ctx kapi.Context, name string) (*imageapi.ImageStreamTag, error)
  • func (c Client) UpdateBuildConfig(ctx kapi.Context, buildConfig *buildapi.BuildConfig) error
• type GeneratorClient
• type GeneratorFatalError
  • func (e GeneratorFatalError) Error() string

Functions

func IsFatal

func IsFatal(err error) bool

IsFatal returns true if err is a fatal error

Types

type BuildGenerator

type BuildGenerator struct {
	Client                    GeneratorClient
	DefaultServiceAccountName string
	ServiceAccounts           kcoreclient.ServiceAccountsGetter
	Secrets                   kcoreclient.SecretsGetter
}

BuildGenerator is a central place responsible for generating new Build objects from BuildConfigs and other Builds.

func (*BuildGenerator) Clone

func (g *BuildGenerator) Clone(ctx kapi.Context, request *buildapi.BuildRequest) (*buildapi.Build, error)

Clone returns clone of a Build

func (*BuildGenerator) FetchServiceAccountSecrets

func (g *BuildGenerator) FetchServiceAccountSecrets(namespace, serviceAccount string) ([]kapi.Secret, error)

FetchServiceAccountSecrets retrieves the Secrets used for pushing and pulling images from private Docker registries.

func (*BuildGenerator) Instantiate

func (g *BuildGenerator) Instantiate(ctx kapi.Context, request *buildapi.BuildRequest) (*buildapi.Build, error)

Instantiate returns a new Build object based on a BuildRequest object

type Client

type Client struct {
	GetBuildConfigFunc      func(ctx kapi.Context, name string) (*buildapi.BuildConfig, error)
	UpdateBuildConfigFunc   func(ctx kapi.Context, buildConfig *buildapi.BuildConfig) error
	GetBuildFunc            func(ctx kapi.Context, name string) (*buildapi.Build, error)
	CreateBuildFunc         func(ctx kapi.Context, build *buildapi.Build) error
	GetImageStreamFunc      func(ctx kapi.Context, name string) (*imageapi.ImageStream, error)
	GetImageStreamImageFunc func(ctx kapi.Context, name string) (*imageapi.ImageStreamImage, error)
	GetImageStreamTagFunc   func(ctx kapi.Context, name string) (*imageapi.ImageStreamTag, error)
}

Client is an implementation of the GeneratorClient interface

func (Client) CreateBuild

func (c Client) CreateBuild(ctx kapi.Context, build *buildapi.Build) error

CreateBuild creates a new build

func (Client) GetBuild

func (c Client) GetBuild(ctx kapi.Context, name string) (*buildapi.Build, error)

GetBuild retrieves a build

func (Client) GetBuildConfig

func (c Client) GetBuildConfig(ctx kapi.Context, name string) (*buildapi.BuildConfig, error)

GetBuildConfig retrieves a named build config

func (Client) GetImageStream

func (c Client) GetImageStream(ctx kapi.Context, name string) (*imageapi.ImageStream, error)

GetImageStream retrieves a named image stream

func (Client) GetImageStreamImage

func (c Client) GetImageStreamImage(ctx kapi.Context, name string) (*imageapi.ImageStreamImage, error)

GetImageStreamImage retrieves an image stream image

func (Client) GetImageStreamTag

func (c Client) GetImageStreamTag(ctx kapi.Context, name string) (*imageapi.ImageStreamTag, error)

GetImageStreamTag retrieves and image stream tag

func (Client) UpdateBuildConfig

func (c Client) UpdateBuildConfig(ctx kapi.Context, buildConfig *buildapi.BuildConfig) error

UpdateBuildConfig updates a named build config

type GeneratorClient

type GeneratorClient interface {
	GetBuildConfig(ctx kapi.Context, name string) (*buildapi.BuildConfig, error)
	UpdateBuildConfig(ctx kapi.Context, buildConfig *buildapi.BuildConfig) error
	GetBuild(ctx kapi.Context, name string) (*buildapi.Build, error)
	CreateBuild(ctx kapi.Context, build *buildapi.Build) error
	GetImageStream(ctx kapi.Context, name string) (*imageapi.ImageStream, error)
	GetImageStreamImage(ctx kapi.Context, name string) (*imageapi.ImageStreamImage, error)
	GetImageStreamTag(ctx kapi.Context, name string) (*imageapi.ImageStreamTag, error)
}

GeneratorClient is the API client used by the generator

type GeneratorFatalError

type GeneratorFatalError struct {
	// Reason the fatal error occurred
	Reason string
}

GeneratorFatalError represents a fatal error while generating a build. An operation that fails because of a fatal error should not be retried.

func (GeneratorFatalError) Error

func (e GeneratorFatalError) Error() string

Error returns the error string for this fatal error