template

Documentation

Overview

Package template provides TemplateProcessor, capable of transforming Template objects into Config objects.

Index

• func AddParameter(t *api.Template, param api.Parameter)
• func GetParameterByName(t *api.Template, name string) *api.Parameter
• type Processor
  • func NewProcessor(generators map[string]Generator) *Processor
  • func (p *Processor) GenerateParameterValues(t *api.Template) error
  • func (p *Processor) Process(template *api.Template) (*configapi.Config, fielderrors.ValidationErrorList)
  • func (p *Processor) SubstituteParameters(params []api.Parameter, item runtime.Object) (runtime.Object, error)

Functions

func AddParameter

func AddParameter(t *api.Template, param api.Parameter)

AddParameter adds new custom parameter to the Template. It overrides the existing parameter, if already defined.

func GetParameterByName

func GetParameterByName(t *api.Template, name string) *api.Parameter

GetParameterByName searches for a Parameter in the Template based on its name.

Types

type Processor

type Processor struct {
	Generators map[string]Generator
}

Processor process the Template into the List with substituted parameters

func NewProcessor

func NewProcessor(generators map[string]Generator) *Processor

NewProcessor creates new Processor and initializes its set of generators.

func (*Processor) GenerateParameterValues

func (p *Processor) GenerateParameterValues(t *api.Template) error

GenerateParameterValues generates Value for each Parameter of the given Template that has Generate field specified where Value is not already supplied.

Examples:

from | value ----------------------------- "test[0-9]{1}x" | "test7x" "[0-1]{8}" | "01001100" "0x[A-F0-9]{4}" | "0xB3AF" "[a-zA-Z0-9]{8}" | "hW4yQU5i"

func (*Processor) Process

func (p *Processor) Process(template *api.Template) (*configapi.Config, fielderrors.ValidationErrorList)

Process transforms Template object into List object. It generates Parameter values using the defined set of generators first, and then it substitutes all Parameter expression occurrences with their corresponding values (currently in the containers' Environment variables only).

func (*Processor) SubstituteParameters

func (p *Processor) SubstituteParameters(params []api.Parameter, item runtime.Object) (runtime.Object, error)

SubstituteParameters loops over all Environment variables defined for all ReplicationController and Pod containers and substitutes all Parameter expression occurrences with their corresponding values.

Example of Parameter expression:

• ${PARAMETER_NAME}