environment

Documentation

Overview

Package environment describes the operating environment for Tiller.

Tiller's environment encapsulates all of the service dependencies Tiller has. These dependencies are expressed as interfaces so that alternate implementations (mocks, etc.) can be easily generated.

Index

• Constants
• Variables
• type Engine
• type EngineYard
  • func (y EngineYard) Default() Engine
  • func (y EngineYard) Get(k string) (Engine, bool)
• type Environment
  • func New() *Environment
• type KubeClient
• type PrintingKubeClient
  • func (p *PrintingKubeClient) Build(ns string, reader io.Reader) (kube.Result, error)
  • func (p *PrintingKubeClient) BuildUnstructured(ns string, reader io.Reader) (kube.Result, error)
  • func (p *PrintingKubeClient) Create(name, ns string, r io.Reader, timeout int64, shouldWait bool) error
  • func (p *PrintingKubeClient) Delete(ns string, r io.Reader) error
  • func (p *PrintingKubeClient) DeleteWithTimeout(ns string, r io.Reader, timeout int64, shouldWait bool) error
  • func (p *PrintingKubeClient) Get(ns string, r io.Reader) (string, error)
  • func (p *PrintingKubeClient) Update(name, ns string, currentReader, modifiedReader io.Reader, force bool, ...) error
  • func (p *PrintingKubeClient) UpdateWithOptions(name, ns string, currentReader, modifiedReader io.Reader, ...) error
  • func (p *PrintingKubeClient) Validate(ns string, reader io.Reader) error
  • func (p *PrintingKubeClient) WaitAndGetCompletedPodPhase(namespace string, reader io.Reader, timeout time.Duration) (v1.PodPhase, error)
  • func (p *PrintingKubeClient) WaitUntilCRDEstablished(reader io.Reader, timeout time.Duration) error
  • func (p *PrintingKubeClient) WatchUntilReady(ns string, r io.Reader, timeout int64, shouldWait bool) error

Constants

const (
	// DefaultTillerNamespace is the default namespace for Tiller.
	DefaultTillerNamespace = "kube-system"

	// DefaultTillerPort defines the default port tiller listen on for client traffic
	DefaultTillerPort = 44134

	// DefaultTillerProbePort defines the default port to listen on for probes
	DefaultTillerProbePort = 44135

	// GoTplEngine is the name of the Go template engine, as registered in the EngineYard.
	GoTplEngine = "gotpl"
)

Variables

var DefaultEngine = GoTplEngine

DefaultEngine points to the engine that the EngineYard should treat as the default. A chart that does not specify an engine may be run through the default engine.

Types

type Engine

type Engine interface {
	// Render renders a chart.
	//
	// It receives a chart, a config, and a map of overrides to the config.
	// Overrides are assumed to be passed from the system, not the user.
	Render(*chart.Chart, chartutil.Values) (map[string]string, error)
}

Engine represents a template engine that can render templates.

For some engines, "rendering" includes both compiling and executing. (Other engines do not distinguish between phases.)

The engine returns a map where the key is the named output entity (usually a file name) and the value is the rendered content of the template.

An Engine must be capable of executing multiple concurrent requests, but without tainting one request's environment with data from another request.

type EngineYard

type EngineYard map[string]Engine

EngineYard maps engine names to engine implementations.

func (EngineYard) Default

func (y EngineYard) Default() Engine

Default returns the default template engine.

The default is specified by DefaultEngine.

If the default template engine cannot be found, this panics.

func (EngineYard) Get

func (y EngineYard) Get(k string) (Engine, bool)

Get retrieves a template engine by name.

If no matching template engine is found, the second return value will be false.

type Environment

type Environment struct {
	// EngineYard provides access to the known template engines.
	EngineYard EngineYard
	// Releases stores records of releases.
	Releases *storage.Storage
	// KubeClient is a Kubernetes API client.
	KubeClient KubeClient
}

Environment provides the context for executing a client request.

All services in a context are concurrency safe.

func New

func New() *Environment

New returns an environment initialized with the defaults.

type KubeClient

type KubeClient interface {
	// Create creates one or more resources.
	//
	// reader must contain a YAML stream (one or more YAML documents separated
	// by "\n---\n").
	Create(name, namespace string, reader io.Reader, timeout int64, shouldWait bool) error

	// Get gets one or more resources. Returned string hsa the format like kubectl
	// provides with the column headers separating the resource types.
	//
	// namespace must contain a valid existing namespace.
	//
	// reader must contain a YAML stream (one or more YAML documents separated
	// by "\n---\n").
	Get(namespace string, reader io.Reader) (string, error)

	// Delete destroys one or more resources.
	//
	// namespace must contain a valid existing namespace.
	//
	// reader must contain a YAML stream (one or more YAML documents separated
	// by "\n---\n").
	Delete(namespace string, reader io.Reader) error

	// DeleteWithTimeout destroys one or more resources. If shouldWait is true, the function
	// will not return until all the resources have been fully deleted or the provided
	// timeout has expired.
	//
	// namespace must contain a valid existing namespace.
	//
	// reader must contain a YAML stream (one or more YAML documents separated
	// by "\n---\n").
	DeleteWithTimeout(namespace string, reader io.Reader, timeout int64, shouldWait bool) error

	// WatchUntilReady watch the resource in reader until it is "ready".
	//
	// For Jobs, "ready" means the job ran to completion (excited without error).
	// For all other kinds, it means the kind was created or modified without
	// error.
	WatchUntilReady(namespace string, reader io.Reader, timeout int64, shouldWait bool) error

	// Deprecated; use UpdateWithOptions instead
	Update(name, namespace string, originalReader, modifiedReader io.Reader, force bool, recreate bool, timeout int64, shouldWait bool) error

	// UpdateWithOptions updates one or more resources or creates the resource
	// if it doesn't exist.
	//
	// namespace must contain a valid existing namespace.
	//
	// reader must contain a YAML stream (one or more YAML documents separated
	// by "\n---\n").
	UpdateWithOptions(name, namespace string, originalReader, modifiedReader io.Reader, opts kube.UpdateOptions) error

	Build(namespace string, reader io.Reader) (kube.Result, error)

	// BuildUnstructured reads a stream of manifests from a reader and turns them into
	// info objects. Manifests are not validated against the schema, but it will fail if
	// any resoures types are not known by the apiserver.
	//
	// reader must contain a YAML stream (one or more YAML documents separated by "\n---\n").
	BuildUnstructured(namespace string, reader io.Reader) (kube.Result, error)

	// Validate reads a stream of manifests from a reader and validates them against
	// the schema from the apiserver. It returns an error if any of the manifests does not validate.
	//
	// reader must contain a YAML stream (one or more YAML documents separated by "\n---\n").
	Validate(namespace string, reader io.Reader) error

	// WaitAndGetCompletedPodPhase waits up to a timeout until a pod enters a completed phase
	// and returns said phase (PodSucceeded or PodFailed qualify).
	WaitAndGetCompletedPodPhase(namespace string, reader io.Reader, timeout time.Duration) (v1.PodPhase, error)

	WaitUntilCRDEstablished(reader io.Reader, timeout time.Duration) error
}

KubeClient represents a client capable of communicating with the Kubernetes API.

A KubeClient must be concurrency safe.

type PrintingKubeClient

type PrintingKubeClient struct {
	Out io.Writer
}

PrintingKubeClient implements KubeClient, but simply prints the reader to the given output.

func (*PrintingKubeClient) Build

func (p *PrintingKubeClient) Build(ns string, reader io.Reader) (kube.Result, error)

Build implements KubeClient Build.

func (*PrintingKubeClient) BuildUnstructured

func (p *PrintingKubeClient) BuildUnstructured(ns string, reader io.Reader) (kube.Result, error)

BuildUnstructured implements KubeClient BuildUnstructured.

func (*PrintingKubeClient) Create

func (p *PrintingKubeClient) Create(name, ns string, r io.Reader, timeout int64, shouldWait bool) error

Create prints the values of what would be created with a real KubeClient.

func (*PrintingKubeClient) Delete

func (p *PrintingKubeClient) Delete(ns string, r io.Reader) error

Delete implements KubeClient delete.

It only prints out the content to be deleted.

func (*PrintingKubeClient) DeleteWithTimeout

func (p *PrintingKubeClient) DeleteWithTimeout(ns string, r io.Reader, timeout int64, shouldWait bool) error

DeleteWithTimeout implements KubeClient DeleteWithTimeout.

It only prints out the content to be deleted.

func (*PrintingKubeClient) Get

func (p *PrintingKubeClient) Get(ns string, r io.Reader) (string, error)

Get prints the values of what would be created with a real KubeClient.

func (*PrintingKubeClient) Update

func (p *PrintingKubeClient) Update(name, ns string, currentReader, modifiedReader io.Reader, force bool, recreate bool, timeout int64, shouldWait bool) error

Update implements KubeClient Update.

func (*PrintingKubeClient) UpdateWithOptions

func (p *PrintingKubeClient) UpdateWithOptions(name, ns string, currentReader, modifiedReader io.Reader, opts kube.UpdateOptions) error

UpdateWithOptions implements KubeClient UpdateWithOptions.

func (*PrintingKubeClient) Validate

func (p *PrintingKubeClient) Validate(ns string, reader io.Reader) error

Validate implements KubeClient Validate

func (*PrintingKubeClient) WaitAndGetCompletedPodPhase

func (p *PrintingKubeClient) WaitAndGetCompletedPodPhase(namespace string, reader io.Reader, timeout time.Duration) (v1.PodPhase, error)

WaitAndGetCompletedPodPhase implements KubeClient WaitAndGetCompletedPodPhase.

func (*PrintingKubeClient) WaitUntilCRDEstablished

func (p *PrintingKubeClient) WaitUntilCRDEstablished(reader io.Reader, timeout time.Duration) error

func (*PrintingKubeClient) WatchUntilReady

func (p *PrintingKubeClient) WatchUntilReady(ns string, r io.Reader, timeout int64, shouldWait bool) error

WatchUntilReady implements KubeClient WatchUntilReady.